Save continuation tokens
A continuation token is a string value that acts as a bookmark for your query's progress. Since query executions are stateless at the server side, these tokens allow you to resume data retrieval from where you left off. As new logs are continuously generated through system usage, the feed will always have more data available in the future.
Important Considerations
Sometimes queries may return empty pages (no results) even when there are results available on future pages. This can happen due to:
- Multiple network calls being made in the background
- Queries taking longer than expected to retrieve documents
- Data changes occurring between pagination requests
Best Practices
- Store the continuation token from the most recent response
- Use the continuation token to resume fetching new logs in subsequent requests
- Handle empty pages gracefully by continuing to the next page
- Implement retry logic for temporary failures while maintaining the same continuation token
Example Flow
Page 1: Results + Token A
Page 2: No Results + Token A
Page 3: Results + Token B
Page 4: Empty Results + Token B (Save for future use)
