Pagination
Traverse stable result sets with opaque, signed keyset pagination tokens.
Pagination contract
| Property | Behaviour |
|---|---|
| Page size | Fixed at 50 resources |
| This page | meta.resultCount is 0–50 |
| Next page | meta.nextToken |
| Previous page | meta.previousToken; null on the first page |
| Request token | paginationToken |
| Lifetime | 24 hours |
| Filter changes | Rejected explicitly |
| Page-size changes | Not supported |
| Tampering | Rejected explicitly |
Pagination loop
- Send the initial filters. Page size is fixed at 50.
- Read
meta.nextTokenandmeta.previousToken. - Send the same filters with
paginationTokenset to that token. - Stop when
meta.nextTokenis null.
Official SDK iterators enforce the same loop and stop on a repeated token.
Treat pagination tokens as opaque
Do not decode, persist beyond their lifetime, modify or reuse them with another operation or channel.