Pagination
List endpoints use cursor-based pagination. Request a page size withlimit (1–100, default 20), and pass the next_cursor from the previous response as starting_after to fetch the next page:
next_cursor is null, you have reached the last page. See
Conversations.
Idempotency
Send anIdempotency-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.

