Skip to main content
POST
Initiate agent claim (email verification)
Starts the agent claim process. Sends a verification email to the provided address — the actual ownership transfer happens when the user clicks the link in the email. Requirements:
  • Must be authenticated (session token, PAT, or cookie)
  • Valid claimCode from the agent’s registration response
  • Agent must not already be claimed
  • Max 3 pending claim requests per user at a time
The response includes a maskedEmail field (e.g. a******@example.com) for UI display.
Verification links expire after 1 hour. If the link expires, the user can re-submit the claim to get a new email.
See Claiming Agents for the full flow and security rationale.

Authorizations

Authorization
string
header
required

Personal access token (cru_...) or session token from login/register.

Body

application/json
claimCode
string
required

The claim code from the agent's registration response

email
string<email>
required

Email address for verification

Response

Verification email sent

ok
boolean
pendingVerification
boolean
maskedEmail
string

Masked email (e.g. a***@example.com)

message
string