Error Codes
Last updated: Phase 8.5
Authentication
| Code | HTTP | Description |
|---|---|---|
AUTH.INVALID_CREDENTIALS | 401 | Wrong email or password |
AUTH.UNAUTHENTICATED | 401 | Missing or invalid token |
AUTH.INSUFFICIENT_PERMISSIONS | 403 | Token lacks required ability |
AUTH.INVALID_API_KEY | 401 | Missing, invalid, or revoked API key |
AUTH.API_KEY_NOT_FOUND | 404 | API key not found for this tenant |
AUTH.TOKEN.REQUIRED | 401 | No authentication provided |
AUTH.TOKEN.INVALID_SCOPE | 403 | Token missing required scope |
Tenant
| Code | HTTP | Description |
|---|---|---|
TENANT.NOT_FOUND | 404 | Tenant does not exist |
TENANT.INVALID_STATE | 409 | Invalid lifecycle transition |
TENANT.STATUS.SUSPENDED | 403 | Tenant is suspended |
TENANT.RESOLUTION.REQUIRED | 400 | Multi-tenant user must specify X-Tenant-ID |
TENANT.RESOLUTION.NO_TENANTS | 403 | User has no active tenants |
TENANT.RESOLUTION.ACCESS_DENIED | 403 | User does not belong to specified tenant |
License
| Code | HTTP | Description |
|---|---|---|
LICENSE.NOT_FOUND | 404 | License key does not exist |
LICENSE.REVOKED | 403 | License has been revoked |
Activation
| Code | HTTP | Description |
|---|---|---|
ACTIVATION.INVALID | 400 | Activation is invalid or license not active |
ACTIVATION.LIMIT_EXCEEDED | 403 | Maximum activations reached |
Entitlements
| Code | HTTP | Description |
|---|---|---|
ENTITLEMENTS.MISSING | 403 | Required entitlement not available |
ENTITLEMENTS.LIMIT_EXCEEDED | 403 | Usage limit exceeded |
Catalog
| Code | HTTP | Description |
|---|---|---|
CATALOG.NOT_FOUND | 404 | Product, plan, or addon not found |
Validation
| Code | HTTP | Description |
|---|---|---|
VALIDATION.FAILED | 422 | Request body validation failed |
Rate Limit
| Code | HTTP | Description |
|---|---|---|
RATE_LIMIT.EXCEEDED | 429 | Too many requests |
Internal
| Code | HTTP | Description |
|---|---|---|
INTERNAL.ERROR | 500 | Unexpected server error |