unexpected_error

unexpected_error

Description

An unexpected server-side error occurred while handling the request.

HTTP Status

500 Internal Server Error

doc_url Format

The doc_url value is an absolute URL and changes by environment:

<docs-base-url>/errors/unexpected_error

Typical Causes

• An unhandled code path was reached.
• A downstream dependency failed in a way the controller did not expect.
• The endpoint hit a bug or invariant violation.

Example

Response:

{
  "errors": [
    {
      "code": "unexpected_error",
      "message": "An unexpected error occurred",
      "doc_url": "https://docs.example.com/errors/unexpected_error"
    }
  ]
}

How To Fix

1. Retry if the operation is safe and idempotent.
2. Check service logs and dependency health.
3. Contact platform support if the error persists.