Agent Auth

Verify agent email OTP

Promote a restricted agent key to full access by submitting the 6-digit OTP received via email.

On success the org transitions status: unverified → verified, the plan upgrades from free-agent-unverified to free-agent, and the key immediately gains full write access.

On any failure (wrong OTP / expired / already burned after 10 attempts / unknown org) the response is a generic 400 validation_error — no information is leaked about which precondition failed.

post/v1/agent/verify

Request

  • Base URL: https://api.chronary.ai
  • URL: https://api.chronary.ai/v1/agent/verify
  • Auth: HTTP bearer

Request body

otpstring required

Example request

{
  "otp": "123456"
}

Response

OTP verified; full access unlocked.

verifiedtrue required
messagestring required

Example response

{
  "verified": true,
  "message": "Full access unlocked"
}

Changes

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