auth

Poll a device-code grant for completion

Anonymous (the device_code is the credential). Returns pending, completed (with the minted agent_token — surfaced ONCE), or cancelled. After completion the record is consumed and further polls 410.

get/api/agent/signup/poll

Request

  • Base URL: https://www.immersivecommons.com
  • URL: https://www.immersivecommons.com/api/agent/signup/poll
  • Auth: none required

Query parameters

device_codestring

The device_code from /start. Omit for the self-describe contract.

Response

Grant status (pending/completed/cancelled) or the self-describe contract.

status'pending' | 'completed' | 'cancelled' required
user_idstring
agent_tokenstring

Plaintext, surfaced ONCE — store it on the agent.

tierstring
pending_tierstring
granted_scopesstring[]
sandboxboolean

Present + true when the minted token is a sandbox/test-mode token (mirrors the sandbox flag sent to /start).

reasonstring

On cancellation.

next_stepsobject

Changes

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