The API uses standard HTTP status codes to indicate success or failure:

  • 2xx: Success
  • 400: Bad request (invalid parameters)
  • 401: Unauthorized (invalid token)
  • 404: Resource not found
  • 429: Rate limit exceeded
  • 500: Server error

Error responses include a JSON body with details:

{
  "error": {
    "code": "invalid_parameter",
    "message": "The parameter 'content' is required",
    "param": "content"
  }
}