v2

latestOpenAPI 3.1.0Proprietary2026-07-26127193620.1 KB
Agent

Verify agent signup and create OAuth tokens

Verifies the email code for an agent signup session and creates the account when needed. When the session was started with a signup_code, the reserved code is redeemed; sessions started without a code skip the redemption step. An org-scoped OAuth session for CLI authentication is minted and the raw tokens are returned exactly once. For existing users, the optional org_id selects which accessible workspace should receive the new session (no signup-code redemption is performed for existing users regardless of how the session was started).

post/agent/signup/verify

Headers

Idempotency-Keystring

Optional client-supplied idempotency key. Retrying a request with the same key returns the original result instead of performing the action a second time; if omitted the server derives one from the canonical payload hash. Safe to retry network failures without duplicating side effects.

Request body

signup_tokenstring required
verification_codestring required
org_idstring uuid

Optional workspace id to target when the verified email already belongs to multiple workspaces

Response

Agent signup verified and OAuth tokens created

successtrue required