Guides

These guides go deeper than the quickstart. Each one covers a specific cross-cutting concern that applies regardless of which resource you are working with.

Pagination

Walk every item across pages with for await, getNextPage(), or pages().

Errors

The full error hierarchy for both SDKs — status codes, error codes, and typed subclasses.

Retries & idempotency

Automatic retries with exponential backoff and per-call idempotency keys.

Streaming

Stream conversation messages in real time over Server-Sent Events.

Request IDs

Tag every request with a correlation ID and surface it from responses and errors.

Configuration

All client constructor options — base URL, timeout, retries, headers, and HTTP client.

CORS and the playground

Required CORS headers so the interactive playground can reach the API from the browser.