Common patterns
Pagination and filters
Resources use either offset pagination or an opaque cursor based on their access and ordering model.
Offset pagination
Workspaces, teams, members, invitations, roles, and export histories use offset and limit, with totals in page.total.
- The first page starts with
offset=0. - Request the next page with the previous
offset + limit. - Concurrent changes may produce duplicates or gaps between pages.
Record cursor
Pass a returned next_token unchanged to the next records or shared-records request. A null value marks the last page.
Using filters
- Send dates in ISO 8601 format.
- Repeat the same key for array query parameters, for example
team_ids=7&team_ids=8. - Use IDs returned by
GET /labelsin recordlabel_idsfilters.