Make a connect link
A signed link that connects a tool (or, with connectionId, reconnects one) in one click, for anyone in the workspace who can add tools. Post it in chat. It works for 24 hours.
sessionbetter-auth.session_token<token>Set by POST /api/auth/sign-in/email.
ws*stringThe workspace id (from GET /api/me).
application/json- body
type*string1 <= length <= 40connectionId?string^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidwhy?stringlength <= 300{ url, label, expiresAt }.
application/jsoncurl -X POST 'https://app.useroster.work/api/workspaces/string/connect-links' \ -H 'Content-Type: application/json' \ -d '{ "type": "string"}'{ "url": "https://roster.example.com/connect/eyJ3cyI6…", "label": "Connect Linear", "expiresAt": "2026-11-04T09:00:00.000Z"}Check a connection again POST
Asks the tool who the connection's credential belongs to. Keeps `account` when it works; sets `status: "needs_reconnect"` and `statusDetail` when the tool refuses it. Connections also become `needs_reconnect` on their own when a tool refuses them while a hire works.
Open a connect link GET
What a connect link is for: the workspace, the tool, the connection to reconnect, why it was asked for, and whether you can connect tools there (owners and admins). 410 when it has expired.