Pagination

Collection endpoints use cursor pagination. Pass limit and the after cursor from the previous page:

GET /v1/workspaces/ws_123/subscribers?limit=50&after=sub_456

{
  "data": [{ "id": "sub_789", "email": "ada@example.com" }],
  "pagination": {
    "has_more": true,
    "next_cursor": "sub_789"
  }
}

The default limit is 20 and the maximum is 100 unless an endpoint documents a different bound. Cursors are opaque and may change format without notice.

Automatic pagination

The SDK exposes async iterators for streaming through all pages:

for await (const subscriber of fluxdigest.subscribers.listAutoPaging({
  workspaceId: "ws_123",
  status: "active",
})) {
  await synchronize(subscriber);
}

For large datasets, persist progress in your own job system and avoid collecting the entire result in memory.