Errors are JSON with a stable machine-readable code and a human message. Match on code, never on message.
{
"error": {
"code": "image_unreachable",
"message": "We could not fetch the image at image_url.",
"doc_url": "https://kibbe.ai/docs/errors#image_unreachable"
}
}| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_request | Malformed body or unknown parameter. |
| 401 | key_unknown · key_revoked | Missing, wrong or revoked key. |
| 403 | scope_denied | Restricted key attempted a write. |
| 404 | not_found | No item, catalog or job with that id. |
| 422 | image_unreachable | The image URL could not be fetched or decoded. |
| 429 | rate_limited | Over budget. See Retry-After. |
| 5xx | internal | Our fault. Safe to retry with backoff. |