Skip to content
Docs

Open a connect link

GET
/api/connect-links/{token}

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.

Authorization

session
cookiebetter-auth.session_token<token>

Set by POST /api/auth/sign-in/email.

Path Parameters

token*string

Response Body

The link.

application/json
Example Request
curl -X GET 'https://app.useroster.work/api/connect-links/string'
Example Response
{  "workspaceId": "acme",  "type": "linear",  "name": "Linear",  "why": "to file the bug Sam reported",  "canConnect": true,  "expiresAt": "2026-11-04T09:00:00.000Z"}

Make a connect link POST

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.

Connect a tool in one click POST

For catalog entries with `oneClick: true`: makes the connection (`status: "pending"`) and answers the tool's page to approve it; afterwards the tool sends people back to `returnTo` (a path in the app), connected. Cancelling there removes the pending connection. With `connectionId`, reconnects that connection instead.