Skip to content
Docs

API tokens

GET
/api/workspaces/{ws}/api-tokens

Tokens agents use to work in this workspace through Roster's MCP server. Your own; owners and admins see everyone's. Never the token itself: only its first characters, and when it was last used. Made and revoked in the app only.

Authorization

session
cookiebetter-auth.session_token<token>

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

Path Parameters

ws*string

The workspace id (from GET /api/me).

Response Body

The tokens, newest first.

application/json
Example Request
curl -X GET 'https://app.useroster.work/api/workspaces/string/api-tokens'
Example Response
{  "tokens": [    {      "id": "7c1d…",      "workspaceId": "ws_1",      "userId": "u_1",      "name": "Claude Code on my laptop",      "scope": "user",      "prefix": "rst_u_3kf9",      "lastUsedAt": "2026-11-09T10:12:00.000Z",      "revokedAt": null,      "createdAt": "2026-11-09T09:00:00.000Z"    }  ]}