Single objects (for example
GET /v1/creators/{creatorId}) are returned bare, without an envelope.
Parameters
Cursors are opaque. Pass them back exactly as you received them; never build or edit one. Keep every other parameter (filters, sort) identical while you page: a cursor belongs to one query. A malformed cursor returns
400 VALIDATION_ERROR. Cursors are for paging through a result now, not for storing and resuming days later.
Page sizes
Walk every page
Message history pages backwards
Messages are different: a chat is read from the newest end.GET /v1/conversations/{conversationId}/messageswithoutbeforereturns the newest page.- Each page is ordered oldest to newest.
- To get older messages, pass
before= theidof the first (oldest) message on the page you have. hasMore: falsemeans you reached the beginning of the conversation.
Consistency
Lists reflect live data. Items created while you page may appear on a later page or not at all, and an item that changes (for example a conversation that gets a new message while you page conversations sorted byrecent) can move between pages. When you need an exact snapshot, page quickly and de-duplicate by id.