Skip to main content

internal_error

Something went wrong on our side. The request may or may not have been processed, which is the important part.

Status: 500

{
  "status": 500,
  "type": "internal_error",
  "message": "An internal error occurred",
  "request_id": "req_01J8K2P...",
  "doc_url": "https://docs.epostix.com/errors/internal_error"
}

Why you got this​

There is nothing wrong with your request. A dependency failed, or a code path we did not expect was reached.

The message is deliberately generic. request_id is what identifies the failure in our logs, so it is the field to keep.

How to fix it​

Retry with exponential backoff, and cap the attempts rather than looping forever.

Reuse the same Idempotency-Key on the retry. A 500 does not tell you whether the send happened. Retrying with the same key returns the original result if it did, and sends once if it did not. Retrying with a fresh key can send a second email.

Failed requests are not cached, so a retry with the same key genuinely runs again when the first attempt did not complete.

If it persists, open a support ticket and quote request_id. With it we can find the exact call rather than asking you to reproduce it.

Is it safe to retry​

Yes, with backoff, and with the same Idempotency-Key if the original request had one. Retry without a key only when you are certain a duplicate would be harmless.