v21

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-042830148.8 KB
Agent Auth

Poll for Agent Authorization Result

Agent polls this endpoint to check if the user has approved the authorization.

Returns {"status": "pending"} while waiting for user approval. Returns {"status": "approved", "api_key": "sk_...", "email": "..."} once approved.

One-shot delivery: the API key is returned exactly once. After delivery, the token is deleted and subsequent polls return {"status": "pending"}.

Recommended polling interval: 5 seconds. Token expires after 10 minutes.

get/v1/agent-auth/token/{token}

Path parameters

tokenstring required
Example:a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6a7b8c9d0e1f2a3b4c5d6a7b8c9d0e1f2

The token the agent generated locally and included in the approval URL.

Response

Current authorization status

OR

Example response

{
  "status": "pending"
}
All 28 operations