Error Code Catalog
| HTTP | Code | Meaning |
|---|---|---|
| 400 | bad_request | Payload/query/path validation failed. |
| 401 | unauthorized | Missing or invalid bearer API key. |
| 403 | forbidden | API key valid, missing required scope. |
| 404 | not_found | Resource does not exist for tenant. |
| 409 | conflict | Idempotency conflict/state conflict. |
| 422 | unprocessable_entity | Semantic validation failed. |
| 429 | rate_limited | Too many requests. Retry later. |
| 500 | internal_error | Unexpected server-side failure. |
Error payload shape
{
"error": {
"code": "bad_request",
"message": "Validation failed",
"request_id": "req_abc123"
}
}