agent-auth

Start or renew a claim

Binds an anonymous registration to the email of the person the agent acts for and returns a code for that person, or mints a new code for a pending registration whose code expired.

post/agent/identity/claim

Request

  • Base URL: https://api.letsship.ai/v1
  • URL: https://api.letsship.ai/v1/agent/identity/claim
  • Auth: none declared

Request body

claim_tokenstring required
emailstring required

Example request

{
  "email": "ada@example.com"
}

Response

Claim started.

registration_idstring required
claim_attempt_idstring required
status'initiated' required
expires_atstring required

Example response

{
  "claim_attempt": {
    "user_code": "482913",
    "verification_uri": "https://letsship.ai/claim?claim_attempt_token=cat_...",
    "expires_in": 600,
    "interval": 5
  }
}

Changes

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