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

Auth: Bearer

HTML: https://cooperemail.com/docs/reference/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

```json
{
  "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

The live `message` is the sentence for that code. Branch on `code`.

```json
{
  "error": {
    "type": "not_found",
    "code": "inbox_not_found",
    "docs_url": "https://cooperemail.com/docs#inbox_not_found"
  }
}
```

## Idempotency

This route does not document Idempotency-Key or client_id.
