Skip to main content

api_key_expired

The key was recognised, but its expiry date has passed and it no longer authenticates. Nothing was sent and nothing was charged.

Status: 401

{
  "status": 401,
  "type": "api_key_expired",
  "message": "This API key has expired. Create a replacement key.",
  "request_id": "req_01J8K2P...",
  "doc_url": "https://docs.epostix.com/errors/api_key_expired"
}

Why you got this​

  • Every Epostix key carries a mandatory expiry date. There is no non-expiring key.
  • The date chosen when the key was created has now passed.
  • A deployment is still holding a key that was rotated out and left to lapse.

How to fix it​

Create a replacement key with the same scopes, domain restrictions and IP allow-list as the old one, then deploy it. Watch for successful calls to confirm the new key is the one your traffic is using, and only then delete the expired one.

Run the same sequence ahead of the date next time. Overlapping the two keys for a deployment cycle means rotation never causes an outage, and the key you retire is one you already know nothing is calling. See Authentication for creating a key and setting its expiry.

Is it safe to retry​

No, not with the same key. It fails identically until you replace it. Retry with the new key once it is deployed. The rejected request created nothing, so nothing can be duplicated.