Request Headers

The headers used by documented API requests and when each one is required.

Headers

Header	Where used	Example
Authorization	All documented endpoints	`Bearer <BEARER_TOKEN>`
Content-Type	POST requests with a JSON body	`application/json`
Idempotency-Key	Create requests (see Idempotency)	`<UNIQUE_KEY>`

Authorization

Every documented request authenticates with a bearer token in the Authorization header. See Authentication.

Content-Type

Requests with a JSON body set Content-Type: application/json. GET requests that take no body do not need it.

Idempotency-Key

Create requests use a unique idempotency key so retrying the same operation is safe. Generate a new key for each logical create, and reuse the same key when retrying that same operation.

Response Format

The documented successful response pattern.

Error Handling

Handle failures appropriately.