Skip to main content
POST
Poll for desktop pairing approval

Body

application/json
device_code
string
required

Response

Pairing status (pending or approved).

status
enum<string>
required

pending — keep polling. approved — the desktop should store raw_key (which is returned exactly once) and stop polling.

Available options:
pending,
approved
raw_key
string

The dk-... credential that authenticates the desktop. Only present when status=approved; subsequent polls will return 404 (the pairing row is deleted on read).

agent_key
string

The linked ak-... credential for local agent registration on the platform's WebSocket. Minted alongside raw_key during client pair. Only present when status=approved; delivered once with raw_key.