Skip to content

POST · public

POST /api/v1/identity/verify

Summary

Check an agent identity token. No API key. Body is token, audience, and optional consume. Signature, kid, iss, aud, and exp/nbf (30 second skew) are checked, then one indexed lookup confirms the inbox exists and the account is not suspended. consume true makes the jti single-use. A replay is HTTP 200 with valid false and error token_already_used. A bad token is HTTP 200 with valid false and an error code. A malformed body is HTTP 400. Limited to 120 requests a minute per IP. Offline JWKS verification cannot see revocation or single-use. When signing is not configured the route is HTTP 503 identity_unavailable.

Request

{
  "token": "eyJ...",
  "audience": "https://your-service.example",
  "consume": true
}

Response

The OpenAPI document does not declare a JSON response schema for this call. The summary is the contract.

Errors

  • HTTP 503 identity_unavailable
  • HTTP 429 rate_limited

Idempotency

This route does not document Idempotency-Key or client_id.