API errors

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

1 {
2   "error": {
3     "type": "not_found_error",
4     "message": "Video not found",
5     "param": "video_id",
6     "details": [...]
7   }
8 }

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

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.