---
url: /errors/unexpected_error.md
---
# `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:

```json
{
  "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.