Errors And Status Codes
Error Format
Most errors use this shape:
{
"error": {
"code": "STRING_CODE",
"message": "Human readable message",
"details": []
}
}
Common Status Codes
| Code | Meaning |
|---|---|
| 200 | Success |
| 201 | Created |
| 204 | No content |
| 400 | Bad request or validation error |
| 401 | Unauthorized |
| 404 | Not found |
| 409 | Conflict |
| 500 | Server error |
Validation Errors
When a request fails schema validation, details contains the validation issues.
Tenant Errors
If the tenant-id header is missing, the API returns a 400 error.