Skip to main content
Use this endpoint when providers need cloud-compatible identity tokens minted by Clawb.

POST /v1/token/exchange

Auth

Workspace API key (same auth model as /v1/check).

Success response

Error patterns

  • 401 missing_api_key when provider key is required and missing.
  • 403 policy_denied when policy evaluation blocks the request.
  • 403 policy_challenge when a challenge is required.
  • 400 invalid_signature when signature material does not verify.
  • 400 replay_detected when nonce was already used.
  • 400 timestamp_out_of_range when request timestamp is outside allowed skew.

Security notes

  • agent_request.nonce is replay-protected.
  • agent_request.timestamp_ms is bounded by server skew checks.
  • Returned JWT includes standard claims (iss, sub, aud, exp) plus a clawb_claims object.