This example shows you how to export only runbooks completed since your last successful export, so you don't need to retrieve the same runbooks every time your export runs.
1. Record your last successful export
Your application should store the date and time of the last successful export. For example:
2026-07-01T14:45:00Z
We'll use this value as the watermark for the next export.
2. Retrieve runbooks completed since the watermark
Make an authenticated call to the List Runbooks endpoint and provide the timestamp using actual_completion_after:
GET /core/runbooks?workspace_id=123&actual_completion_after=2026-07-01T14:45:00Z
This returns runbooks completed after your previous successful export.
3. Export the returned runbooks
For each runbook returned, retrieve its tasks, streams, and teams and store the results in your repository.
4. Update your watermark
Once the export has completed successfully, update your stored timestamp.
If the export fails, don't update the watermark. The same runbooks will then be included in the next export attempt.
This approach allows you to run your export on a regular schedule without repeatedly retrieving runbooks that have already been exported.
Note: actual_completion_after applies to completed runbooks. If you also need to export planned or in-progress runbooks, use the appropriate stage filter instead.
