Runs export: a truncated one counts the selection into X-Total-Count; the SDK and fluksio export warn how many runs were left out

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WgBfkm4rCmtd1T4vHWjEPx
2026-10-14 23:29:48 +02:00
parent 02f43bf7c4
commit 8eec58d1d6
6 changed files with 66 additions and 17 deletions
@@ -143,7 +143,9 @@ row's `created_at` as `before` for stable pagination.
 Exports also accept `ids` and `until`, with `format=csv` or `jsonl`.
 The metrics export is a long table; the runs export is one row per run.
 Use `params` and `metrics` to choose columns, including dotted paths into
-record outputs.
+record outputs. An export covers at most the newest 10 000 runs. When a
+selection matches more, the response carries `X-Truncated` with that cap and
+`X-Total-Count` with the number of runs the selection matched.

 Import takes `{"runs": [...]}`, records completed results without executing
 code, and deduplicates by `external_id`. See