Error Codes

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

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

Cause: Invalid request body or missing required fields.Common triggers:

Missing required fields (name, english_name for categories; title, type, status, primary_category for posts)
Invalid field types (string where integer expected)
Invalid enum values (wrong type or status value for posts)

404 Not Found

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

Cause: Rate limit exceeded.Solution: Implement exponential backoff and caching. See Rate Limits.

Overview

Content Delivery API

Content Management API

SDKs

Reference

Deprecated

HTTP Status Codes

Error Response Format

CDS Errors

CMS Errors

Common Error Scenarios

401 Unauthorized

400 Bad Request

404 Not Found

429 Too Many Requests

Overview

Content Delivery API

Content Management API

SDKs

Reference

Deprecated

​HTTP Status Codes

​Error Response Format

​CDS Errors

​CMS Errors

​Common Error Scenarios

​401 Unauthorized

​400 Bad Request

​404 Not Found

​429 Too Many Requests

HTTP Status Codes

Error Response Format

CDS Errors

CMS Errors

Common Error Scenarios

401 Unauthorized

400 Bad Request

404 Not Found

429 Too Many Requests