internal_error

Summary

internal_error is the default fallback code returned when a server-side error occurs and no more specific error code has been mapped for the condition. The handler logs the underlying error to slog along with the request_id before returning this envelope.

Cause

An unhandled internal exception or unexpected condition in the platform. This should be rare, since most common failure modes have specific codes.

Resolution

Retry with exponential backoff (1-2-4-8 seconds, max 5 attempts). If the error persists, contact support with the request_id so the underlying log entry can be investigated.

Example response

{
  "error": {
    "code": "internal_error",
    "message": "an internal error occurred",
    "request_id": "req_01900000abc"
  }
}

Next steps

• See the retry policy for backoff guidance.
• Contact support with the request_id if the issue persists.