DevelopersAPI Reference
Errors
HTTP status codes and error shapes returned by the Reeve API.
The API uses conventional HTTP status codes. 2xx means success; 4xx means the request was rejected; 5xx means a server-side error.
Status codes
| Status | Meaning | Common cause |
|---|---|---|
400 | Bad request | Malformed body or invalid parameters |
401 | Unauthenticated | Missing or invalid X-Reeve-Host-Key |
403 | Forbidden | Host-app lacks the capability for this product, or wrong org |
404 | Not found | Resource (or its parent) does not exist |
409 | Conflict | Idempotency or resource-state conflict |
422 | Unprocessable entity | Request validation failed |
429 | Rate limited | Too many requests — back off and retry |
5xx | Server error | Transient — retry with backoff |
Error shape
CRM v1 and other products return a structured error body:
{
"error": {
"code": "org_forbidden",
"message": "user is not a member of the requested org",
"retryable": false
}
}retryable indicates whether the same request may succeed on a later attempt. Per-operation reference pages list the specific responses each endpoint can return.