post/extension/token

Request

  • Base URL: https://api.useanima.sh/v1
  • URL: https://api.useanima.sh/v1/extension/token
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

agentIdstring

Agent requesting the extension token. Required for pre_approved policy checks.

Response

OK

exchangeCodestring required

One-time exchange code. The extension trades this for the real token via API.

policy'session' | 'pre_approved' | 'prompt_owner' required

The auth policy that was applied

tokenTtl'15m' | '1h' | 'session' required

Token TTL setting that was applied

requiresApprovalboolean required

Whether the owner must approve this token in the extension UI

expiresAtstring date-time nullable required

ISO 8601 expiration time. Null for session-based (browser manages lifecycle).

connectUrlstring uri required

URL to open in the browser to authenticate the extension

Changes

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