Skip to main content

Pagination

List endpoints use cursor-based pagination. Request a page size with limit (1–100, default 20), and pass the next_cursor from the previous response as starting_after to fetch the next page:
When next_cursor is null, you have reached the last page. See Conversations.

Idempotency

Send an Idempotency-Key header on POST /v1/calculate to make the request safe to retry. The key is an opaque string you choose (a UUID is a good choice).
  • Same key, same body — returns the original result rather than running the calculation again. This is also how you poll a natural-language request that is still in_progress: retry with the same key until it completes.
  • Same key, different body — rejected with 409 error_idempotency_conflict.