Skip to main content
The Reflection API is an HTTPS API with JSON request and response bodies.

Base URLs

The endpoints in this reference are served from the OpenAI-compatible base URL. See OpenAI compatibility for how they relate to the OpenAI API.

Authentication

Send your API key in the Authorization header of every request:
Request header

Requests and responses

  • Send request bodies as JSON with Content-Type: application/json. A body sent without that header returns 415.
  • Responses are JSON, except streamed chat completions, which use text/event-stream. See Streaming.
  • Timestamps are Unix times in seconds.
  • Errors return a JSON error object. See Errors.
  • Responses include an x-request-id header that identifies the request. See Request IDs.
  • Responses can include x-ratelimit- headers that report your organization’s remaining capacity. See Rate limits.
  • Responses to authenticated requests, including error responses, include a reflection-data-retention header. See Data retention.

Data retention

Every response to an authenticated request, including an error response, has a reflection-data-retention header that reports the data retention the request was served under: A request whose retention can’t be determined is reported as zero. More values may be added; read a value you don’t recognize as promising nothing about what is kept.

Endpoints

Last modified on October 16, 2026