API error · HTTP 401

`token_expired`

Access token has expired

HTTP status	401 Unauthorized
`code`	`token_expired`
`title`	Access token has expired
Retry?	Refresh the token once

What it means

The access token is past its 15-minute lifetime.

What to do

Get a new token and retry once. Cache tokens and renew them about 60 seconds before they expire, rather than requesting one for every call (§4.1).

Example response

Branch on code, never on title or detail. detail varies; quote request_id to support.

HTTP

HTTP/1.1 401 Unauthorized
Content-Type: application/problem+json

{
  "type": "https://www.underwritinguk.ai/developers/errors/token_expired",
  "title": "Access token has expired",
  "status": 401,
  "code": "token_expired",
  "detail": "Access token has expired.",
  "request_id": "7b0b1e5c-2f7e-4a52-9a43-5b0d0f0e9d11"
}

All error codes · Error catalogue in the integration guide (§15) · Error handling and retries (§12.4)