> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aurous-labs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# chat_provider_unknown_error

> The upstream model returned an unmapped error.

**Code**: `chat_provider_unknown_error`
**HTTP status**: `502`
**Type**: `server_error`

## When it fires

The upstream chat model returned an error that the platform's error-mapping table doesn't yet recognize. Logged at ERROR so engineering can add the mapping in the next release. Any held credits are released.

## How to recover

Retry with exponential backoff — the failure is treated as transient until classified. If the error keeps recurring on the same request shape, open a support ticket with the `request_id` so we can capture the upstream signal and pin the mapping.
