Account

Start a device authorization flow

Issues a device code and user code so a CLI or headless client can sign in through the browser. Claim flows may attach an explicit server-side claim handoff.

post/v1/auth/device

Request

  • Base URL: https://api.spacefast.com
  • URL: https://api.spacefast.com/v1/auth/device
  • Auth: none declared

Request body

clientId'spacefast-cli' | 'spacefast-mcp'

Spacefast client starting the flow, shown on the verification page. Omit it unless you are the Spacefast MCP server.

access'read' | 'agent' | 'agent-personal-pages'

Access profile the device requests. One word with a server-owned meaning; the approver can narrow the resulting scopes on the verification page but never widen them.

Response

Response for status 200

$schemastring uri

Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

Changes

No recorded changes to this operation across all 1 revision of this API.