Poll subscription authorization
Acts only on your own subscriptions in this workspace, not another member's.
Use a personal API token or an OAuth access token issued for the REST API; MCP-audience tokens are rejected. Provider must be codex, xai or cursor; Claude uses /claude/complete. Send the unchanged poll token from start, plus deviceAuthId and userCode for Codex or deviceCode for xAI. Cursor needs only pollToken. Keep polling pending at the start interval. connected means credentials were saved server-side. HTTP 400 can terminate polling with status: denied, status: expired (xAI), or status: failed and error: save_failed (Codex). Stop polling on terminal statuses.
/v1/workspaces/{workspaceId}/subscriptions/{provider}/pollA personal access token, which starts with sntr_. Create one on the dashboard's CLI & API page (https://app.sinatra.dev/tokens). It acts as you in every workspace you belong to, with your role in each, and expires after at most 365 days. The CLI's browser sign-in sends an OAuth access token here instead.
In: header
Path Parameters
The workspace's id, from GET /v1/me.
Subscription provider: codex, claude, xai or cursor. Polling supports only codex, xai and cursor.
"codex" | "xai" | "cursor"1 <= length1 <= length1 <= length1 <= lengthResponse Body
curl -X POST "https://api.sinatra.dev/v1/workspaces/string/subscriptions/codex/poll" \ -H "Content-Type: application/json" \ -d '{ "deviceAuthId": "string", "userCode": "string", "pollToken": "string" }'{
"status": "pending"
}{
"error": "string",
"reason": "string",
"requestId": "string",
"refusal": "string",
"billingUrl": "string",
"settingsUrl": "string",
"plan": "string",
"running": 0,
"queued": 0,
"taskId": "string",
"messageId": "string"
}{
"error": "string",
"reason": "string",
"requestId": "string",
"refusal": "string",
"billingUrl": "string",
"settingsUrl": "string",
"plan": "string",
"running": 0,
"queued": 0,
"taskId": "string",
"messageId": "string"
}{
"error": "string",
"reason": "string",
"requestId": "string",
"refusal": "string",
"billingUrl": "string",
"settingsUrl": "string",
"plan": "string",
"running": 0,
"queued": 0,
"taskId": "string",
"messageId": "string"
}{
"error": "string",
"reason": "string",
"requestId": "string",
"refusal": "string",
"billingUrl": "string",
"settingsUrl": "string",
"plan": "string",
"running": 0,
"queued": 0,
"taskId": "string",
"messageId": "string"
}{
"error": "string",
"reason": "string",
"requestId": "string",
"refusal": "string",
"billingUrl": "string",
"settingsUrl": "string",
"plan": "string",
"running": 0,
"queued": 0,
"taskId": "string",
"messageId": "string"
}{
"error": "string",
"reason": "string",
"requestId": "string",
"refusal": "string",
"billingUrl": "string",
"settingsUrl": "string",
"plan": "string",
"running": 0,
"queued": 0,
"taskId": "string",
"messageId": "string"
}{
"error": "string",
"reason": "string",
"requestId": "string",
"refusal": "string",
"billingUrl": "string",
"settingsUrl": "string",
"plan": "string",
"running": 0,
"queued": 0,
"taskId": "string",
"messageId": "string"
}{
"error": "string",
"reason": "string",
"requestId": "string",
"refusal": "string",
"billingUrl": "string",
"settingsUrl": "string",
"plan": "string",
"running": 0,
"queued": 0,
"taskId": "string",
"messageId": "string"
}