> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.reka.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.reka.ai/_mcp/server.

# Errors

# API errors

Errors are returned as a JSON response with the following shape:

```json
{
  "error": {
    "type": "not_found_error",
    "message": "Video not found",
    "param": "video_id",
    "details": [...]
  }
}
```

| Field                | Type   | Description                                                     |
| -------------------- | ------ | --------------------------------------------------------------- |
| `type`               | string | Error category for client-side handling (see table below)       |
| `message`            | string | Human-readable explanation                                      |
| `param` (optional)   | string | When present, indicates with request parameter caused the error |
| `details` (optional) | array  | When present, provides additional information on request errors |

## Error Types and HTTP Status Codes

| Status | Error Type             | Client Action                                                                                   |
| ------ | ---------------------- | ----------------------------------------------------------------------------------------------- |
| 400    | `validation_error`     | Fix your request and retry                                                                      |
| 401    | `authentication_error` | Ensure that you're using a valid Reka API key                                                   |
| 404    | `not_found_error`      | Resource not found                                                                              |
| 429    | `rate_limit_error`     | Wait until your rate limit is restored and retry, or upgrade your API tier for higher limits    |
| 500    | `server_error`         | Retry with backoff. If this persists, contact Reka at [contact@reka.ai](mailto:contact@reka.ai) |

## Request ID

Every response includes an `X-Request-ID` header for log correlation:

```
X-Request-ID: a1b2c3d4e5f6...
```

This is not duplicated in the response body. Please include this ID when reporting issues.