Skip to content

KEY_EXPIRED — API key past expiry

Summary

The key was created with an expiry date and that date has passed. Default keys never expire — this only happens to keys you explicitly marked as time-limited.

HTTP status

401 Unauthorized. Standard envelope.

Example response

{
  "success": false,
  "error": {
    "code": "KEY_EXPIRED",
    "message": "This API key expired on 2026-04-12T00:00:00Z.",
    "request_id": "req_01HXJZK4ABCDEF",
    "doc_url": "https://docs.surveycoder.io/errors/key-expired"
  }
}

Why this happens

You created the key with an expires_at value (e.g. a 30-day demo key for a contractor) and that date has now passed.

How to fix it

Create a fresh key at surveycoder.io/api-keys — either with a new expiry or with no expiry at all.
Update every place the old key was stored.
If you want a reminder before the next expiry, the dashboard sends an email 7 days out.