Getting started
Errors
Errors return a consistent JSON shape with an HTTP status code, a machine-readablecode, and a human-readable message.
| Status | Code | Meaning |
|---|---|---|
| 400 | validation_error | The request body is malformed or missing required fields. |
| 401 | unauthorized | The API key is missing, invalid, or revoked. |
| 403 | forbidden | The key does not have permission to perform this action. |
| 404 | not_found | The resource does not exist, or your key may not read it. |
| 429 | rate_limited | Too many requests. Wait for Retry-After, then retry. Always retry safe. |
| 500 | internal_error | Something went wrong on our end. Retry safe. |