Property APIGuides
Errors
The error contract — stable codes, no prose parsing
Errors are machine-readable: the body is always { "error": "<code>" } where
<code> is a stable snake_case string. Parse the code, never the HTTP reason
phrase. The OpenAPI document lists each operation's possible codes in its
error responses' x-error-codes extension.
| Status | Meaning | Examples |
|---|---|---|
| 400 | The request is invalid | invalid_limit, search_requires_criteria |
| 404 | Nothing at this resource within your entitlement scope | not_found |
| 409 | A uniqueness or idempotency constraint rejected a write | request_conflict |
| 503 | Fail-closed read — retry with backoff | service_unavailable |