HTTP Status Codes
| Status Code | Meaning | Description |
|---|---|---|
200 | OK | Request successful |
201 | Created | Resource created successfully (CMS POST) |
400 | Bad Request | Invalid request parameters or body |
401 | Unauthorized | Missing or invalid authentication credentials |
403 | Forbidden | Insufficient permissions for this operation |
404 | Not Found | Resource does not exist |
429 | Too Many Requests | Rate limit exceeded |
500 | Internal Server Error | Server-side error |
Error Response Format
CDS Errors
{
"detail": "Invalid Auth Credentials"
}
CMS Errors
{
"error": {
"code": "BAD_REQUEST_ERROR",
"description": "Something Went Wrong"
}
}
Common Error Scenarios
401 Unauthorized
Show Details
Show Details
Cause: Missing or invalid authentication credentials.Solution: Ensure your
Authorization header is present and uses valid Base64-encoded credentials.# Correct
-H 'Authorization: Basic <BASE64_AUTH_TOKEN>'
# Wrong - header missing or wrong scheme
-H 'Authorization: Bearer token' # Not supported
400 Bad Request
Show Details
Show Details
Cause: Invalid request body or missing required fields.Common triggers:
- Missing required fields (
name,english_namefor categories;title,type,status,primary_categoryfor posts) - Invalid field types (string where integer expected)
- Invalid enum values (wrong
typeorstatusvalue for posts)
404 Not Found
Show Details
Show Details
Cause: The requested resource does not exist.Common triggers:
- Invalid ID or slug in URL path
- Resource was deleted
- Wrong
publisher_id
429 Too Many Requests
Show Details
Show Details
Cause: Rate limit exceeded.Solution: Implement exponential backoff and caching. See Rate Limits.