Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
The structured error shape and status codes the Agent API returns
code, a human message,
and, where useful, a hint on how to resolve it. The HTTP status matches the
code.
{
"code": "not_found",
"message": "job not found",
"hint": "Verify the resource id; list resources first to get valid ids."
}
| HTTP | code | When |
|---|---|---|
| 400 | invalid_argument | A parameter or body field is missing or malformed |
| 401 | unauthenticated | Missing or invalid x-api-key on a write operation |
| 403 | permission_denied | The key lacks access to the resource |
| 404 | not_found | Unknown or malformed resource id, or unknown endpoint |
| 405 | method_not_allowed | Wrong HTTP method for the endpoint |
| 409 | already_exists | The resource already exists |
| 429 | rate_limited | Too many requests; slow down and retry |
| 500 | internal | An unexpected server error; retry later |
404 not_found
rather than a server error, so you can treat “bad id” and “missing job” the
same way.