Skip to content

POST · Bearer

POST /api/v1/inboxes/:id/identity-token

Summary

Mint a short-lived JWT that proves this key controls the inbox. audience is required and is an https origin or an absolute URI of at most 255 characters. ttl_seconds defaults to 300 and is an integer from 60 to 3600. nonce is optional and at most 128 characters. The response is token, token_type agent_identity+jwt, expires_at, issuer, jwks_uri, and claims. Claims include the inbox id, the lowercased address, and cooper.owner_verified as a boolean. They do not include an account id, a plan, an API key, or the owner's email or name. Requires message_send, so a read-only key cannot mint one. An inbox-scoped key for another inbox is HTTP 404 inbox_not_found. A suspended account is HTTP 403 account_suspended. Minting is limited to 60 an hour per inbox, then HTTP 429 rate_limited with Retry-After. When signing is not configured the route is HTTP 503 identity_unavailable. MCP: cooper_identity_token. Guide: /docs/sign-in-with-cooper.

Request

{
  "audience": "https://your-service.example",
  "ttl_seconds": 300,
  "nonce": "login-1"
}

Response

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

Errors

  • HTTP 404 inbox_not_found
  • HTTP 403 account_suspended
  • HTTP 429 rate_limited
  • HTTP 503 identity_unavailable
  • HTTP 400 invalid_audience
  • HTTP 400 invalid_ttl
  • HTTP 400 invalid_nonce
  • HTTP 403 permission_denied

Idempotency

This route does not document Idempotency-Key or client_id.