HTTP Status Code Mapping
Last updated: Phase 8.5
| Status | Meaning | Common Codes |
|---|---|---|
| 200 | Success | — |
| 201 | Created | Activation created, API key created |
| 202 | Accepted | Usage recorded, tenant provisioning started |
| 204 | No Content | Logout successful |
| 400 | Bad Request | ACTIVATION.INVALID, TENANT.RESOLUTION.REQUIRED |
| 401 | Unauthorized | AUTH.UNAUTHENTICATED, AUTH.INVALID_CREDENTIALS, AUTH.INVALID_API_KEY |
| 403 | Forbidden | AUTH.INSUFFICIENT_PERMISSIONS, LICENSE.REVOKED, ACTIVATION.LIMIT_EXCEEDED, TENANT.STATUS.SUSPENDED |
| 404 | Not Found | TENANT.NOT_FOUND, LICENSE.NOT_FOUND, CATALOG.NOT_FOUND |
| 409 | Conflict | TENANT.INVALID_STATE, INVOICE.ALREADY_FINALIZED |
| 422 | Unprocessable Entity | VALIDATION.FAILED |
| 429 | Too Many Requests | RATE_LIMIT.EXCEEDED |
| 500 | Internal Server Error | INTERNAL.ERROR |
| 502 | Bad Gateway | BILLING.*_STRIPE_ERROR (Stripe API failures) |