post/extension/connect

Request

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

Request body

ttl'15m' | '1h' | 'session'

Override the org tokenTtl for this connection. Shorten-only: a value longer than the org setting (15m < 1h < session) is rejected.

Response

OK

agentIdstring required

Agent the connection is bound to.

connectUrlstring uri required

Open in a Puppeteer-driven browser to connect the extension.

expiresAtstring date-time nullable required

Token expiry (null for session).

exchangeExpiresAtstring date-time required

Single-use code expiry (~60s).

policy'session' | 'pre_approved' required

Effective org auth policy. Never prompt_owner — headless connect refuses that policy.

Changes

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