RequestsHeaders

Requests

Headers

Every request and response header the API uses.

Request headers

HeaderRequiredDescription
AuthorizationYesBearer <api-key>. See Authentication.
Content-TypeNoThe API reads the body as JSON, whatever this header says. The examples in these docs send application/json.
Idempotency-KeyNoOn create generation only: 1 to 255 printable ASCII characters. See Generations.

Response headers

HeaderReturnedDescription
Request-IdEvery response from an endpointreq_ followed by lowercase letters and digits. Error bodies repeat it as request_id. Include it when you contact support.
Cache-ControlEvery response from an endpointno-store. Do not cache API responses.
Content-TypeEvery response from an endpointapplication/json

Responses sent before an endpoint runs, such as 405 for an unsupported method, have no Request-Id header and no JSON body.