v2

latestOpenAPI 3.1.0Proprietary2026-07-26127193620.1 KB
Agent

Start an agent account email claim

Begins upgrading an emailless agent account into a full developer account by confirming an email address. Authenticated by the agent's own API key (the org is taken from the credential). Sends a verification code to the supplied email and returns the claim session id plus resend timing. Submit the code to /agent/claim/verify to complete the upgrade. Confirming an email that already belongs to a Primitive account is rejected.

post/agent/claim/start

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

emailstring email required

Email to confirm. Must not already belong to a Primitive account.

Response

Claim started and verification email sent

successtrue required