internal_error

​

What triggers it

• Unhandled exceptions on a code path we haven’t covered.
• Database / Redis connectivity loss.
• Storage layer (S3) refused the call for a reason we can’t classify.
• A feature flag is in an inconsistent state.

​

Response shape

{
  "error": {
    "code": "internal_error",
    "message": "An unexpected error occurred.",
    "remediation": "Retry with the same Idempotency-Key. If the issue persists, share the requestId with support.",
    "docUrl": "https://docs.letmepost.dev/errors/internal_error",
    "requestId": "req_01HY6X4AWBJM2K9F2PTQMRD9JQ",
    "traceId": "abc123..."
  }
}

​

How to handle

1. Retry once with the same Idempotency-Key.
2. If it fails again, file an issue or open a support thread with the requestId.
3. We do not return server stack traces; please don’t try to parse message for diagnosis.

​

Related

• Idempotency — every retry is safe with a key.
• platform_unavailable — third-party outage, not ours.