Errors

The error envelope every failed coss.com API request returns, its HTTP status codes, and what each error type means.

Errors use conventional HTTP status codes and always share one envelope:

{
  "error": {
    "type": "invalid_request_error",
    "code": "validation_error",
    "message": "Invalid request body: `subject`: Too small: expected string to have >=1 characters",
    "param": "subject",
    "issues": [{ "path": "subject", "message": "Too small: expected string to have >=1 characters" }],
    "request_id": "req_01k7c8m4q2f3e9v6t5r1n0p8yz"
  }
}

Error types

Each endpoint page lists the codes it can return.

Last updated