Errors
Standard error responses returned by the PlayaOS API.
Error Format
All errors return a JSON body with two fields:
{
"error": "Human-readable description",
"code": "MACHINE_READABLE_CODE"
}HTTP Status Codes
| Status | Meaning |
|---|---|
400 | Bad request — invalid query parameters or request body |
401 | Unauthorized — missing or invalid API key |
403 | Forbidden — key lacks the required scope |
404 | Not found — resource doesn't exist in this org |
409 | Conflict — business rule violation (e.g. duplicate signup) |
500 | Internal server error — something went wrong on our end |
Error Codes
| Code | Status | Description |
|---|---|---|
AUTH_REQUIRED | 401 | API key is missing, malformed, or revoked |
FORBIDDEN | 403 | Key exists but lacks the required scope for this endpoint |
NOT_FOUND | 404 | Resource not found in this org |
VALIDATION | 400 | Query parameters failed validation |
CONFLICT | 409 | Business rule violation |
UNKNOWN | 500 | Unexpected server error |