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.

Premium Scheduling Note

Premium-scheduling HTTP endpoints normalize unexpected failures to internal_server_error today. They do not currently emit unexpected_error on the public API surface.