Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
The error format, every code the API returns, and when to retry.
{
"error": {
"code": "not_found",
"message": "No such brand in this workspace."
}
}
error.code in your integration. The message is written for people reading logs and
may be reworded.
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_request | The request body or a parameter is malformed |
| 400 | missing_parameter | A required parameter is missing |
| 400 | invalid_date | A date is not valid ISO 8601 |
| 400 | invalid_engine | Unknown engine identifier |
| 401 | missing_api_key | No Authorization header |
| 401 | invalid_api_key | The key is unknown or has been revoked |
| 402 | subscription_required | Your subscription is inactive or past due |
| 403 | plan_not_eligible | Your plan does not include API access |
| 403 | brand_scope_forbidden | This key is limited to specific brands and cannot create new ones |
| 404 | not_found | The record does not exist, or is not accessible with this key |
| 405 | method_not_allowed | That method is not supported on this endpoint |
| 409 | plan_limit_reached | Your plan’s prompt allowance is full |
| 429 | rate_limited | Too many requests for this key |
| 429 | endpoint_rate_limited | Too many requests to this endpoint |
| 429 | concurrency_limited | Too many generation requests running at once |
| 500 | internal_error | Something went wrong on our side |
| Situation | Retry |
|---|---|
429 | Yes, after the time in the matching *-Reset header. See Rate limits |
500 | Yes, once or twice with an increasing delay |
Any other 4xx | No. The request needs to change first |
POST /v1/brands/{id}/prompts is safe. Prompts you already
track come back as already_tracked rather than being duplicated, so you do not need an
idempotency key.
X-Request-Id from the failing response