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

# Errors

> Error shapes, status codes, and request tracing.

Errors are JSON with a human-readable `detail`:

```json theme={null}
{ "detail": "Invalid or revoked API key." }
```

Validation `422`s carry the standard structured `detail` list naming the
offending parameter.

## Request tracing

Responses carry an `X-Request-Id` header (the rare unhandled 500 is the
one exception). Quote it when you contact support and we can trace the
exact request in our logs.

## Status codes

| Code          | Meaning                                                                                                                          |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `401`         | Missing, invalid, revoked, or expired key                                                                                        |
| `403`         | Key's user belongs to no organization, or a read-only key called an action                                                       |
| `404`         | Resource doesn't exist or isn't visible to the key's user                                                                        |
| `409`         | Conflict: a duplicate analysis already in flight, a webhook URL already registered, or an idempotency key from another workspace |
| `413` / `415` | Upload too large / unsupported file type                                                                                         |
| `422`         | Invalid parameters (the body names the parameter)                                                                                |
| `429`         | Daily per-key limit reached — honor `Retry-After`                                                                                |
| `503`         | A dependency is temporarily unavailable — retry with backoff. A failed read is **never** disguised as an empty result            |