List endpoints use one of three shapes. Each endpoint’s reference page says which it uses.
Cursor pages
Used by conversations, messages and widget threads.
Pass limit to size the page, and pass the previous response’s next_cursor as cursor to get the next page. Keep going while has_more is true; do not infer the end from a short page.
Treat cursors as opaque strings.
Offset pages
Used by documents.
Increase offset by limit for each page while has_more is true.
Unpaged lists
Assistants, knowledge sources, ingestion jobs, collections, API keys and widget deployments return their items without a cursor, in a data array. Widget deployments use a deployments array instead. Assistants, ingestion jobs, API keys and widget deployments accept limit; knowledge sources and collections always return every item. See each endpoint.
Limits
An over-large limit is handled one of two ways, depending on the endpoint:
- Refused with
400: conversations, messages, assistants, API keys and widget deployments.
- Reduced to the maximum of 100: ingestion jobs and documents.
Each endpoint’s page gives its default and maximum. Last modified on September 26, 2026