Error: token_expired

The credential authenticated but has passed its expiry.

token_expired

HTTP status: 401

The token was valid but has passed its expiry. The request was not processed.

Why this happens

  • A time-limited token reached its expiry and was not rotated.
  • A rotation completed and the old token's 24-hour overlap window has now closed.

What to do

  1. Mint a fresh token from the Dashboard at dashboard.isaapi.com → API Keys and update your secrets manager.
  2. If you rotated recently, switch every caller to the new value before the 24-hour overlap window closes — see Authentication → Rotation.
  3. Update ISA_TOKEN (or your secrets manager) and reconstruct the client so the next request carries the new token.

Example response

{
  "type": "https://zyins.isaapi.com/errors/token-expired",
  "title": "Token expired",
  "status": 401,
  "detail": "The token expired at 2026-05-14T14:32:01Z. Mint a fresh token from the Dashboard.",
  "code": "token_expired",
  "param": null,
  "request_id": "req_01HZK2N5GQR9T8X4B6FJW3Y1AS"
}

SDK exceptions

LanguageException class
TypeScriptIsaTokenExpiredError
PythonIsaTokenExpiredError
Go*zyins.TokenExpiredError
PHPIsa\Sdk\Zyins\Exception\IsaTokenExpiredException
C#IsaTokenExpiredException

See also