Account

Approve a device authorization

Approves a pending device login with an enforced team scope and an explicit scope checklist. If an explicit claim handoff is attached, the anonymous space is claimed into the chosen destination team after approval wins. The CLI receives a one-time API key on its next poll.

post/v1/auth/device/approve

Request

  • Base URL: https://api.spacefast.com
  • URL: https://api.spacefast.com/v1/auth/device/approve
  • Auth: API key in cookie __Host-better-auth.session_token

Request body

userCodestring required

User code shown on the device being approved (dashes ignored).

claimTeamIdstring

Explicit destination team for a claim handoff. Required when the flow carries a claim.

scopesstring[] required

OAuth scopes the approver granted — a subset of the scopes the device requested. Authority is these scopes' actions, bounded per team by the holder's live role on every request.

agentContinuationboolean

Applies when the device flow carries an anonymous-space claim. Keeps the publishing agent authorized after the claim through the one-time claim-token exchange. Defaults to false.

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.