Bulk-export agent traces
Export an agent's full interaction history — input, output, and tool calls for every turn — over a large time window, in cursor-paginated pages.
Use this instead of listAgentTraces for high-volume extraction: analytics pipelines, warehouse loads, and multi-month pulls. It reads a higher-throughput upstream API and carries a separate, larger rate-limit budget.
Paging: follow meta.cursor until it is null, passing it back as the cursor query parameter. Do not pass fromTimestamp/toTimestamp changes mid-export. Every page contains whole traces — a trace is never split across pages nor returned twice — so pages vary in size.
Rate limit: 20 requests per minute per organization, enforced per API replica. Responses carry RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset; a 429 additionally carries Retry-After.
Retention: traces older than 90 days are not retained and cannot be exported; fromTimestamp is silently clamped to that window.
Freshness: a trace becomes exportable a few minutes after it completes (measured at ~2-3 minutes). An export whose toTimestamp reaches the present may therefore omit the most recent interactions; they appear on a later run. For a reproducible extract, set toTimestamp at least 15 minutes in the past.
Request
- Base URLhttps://api.runbear.io
- AuthHTTP bearer
Path parameters
The ID of the agent to retrieve
Query parameters
Export traces from this timestamp (ISO 8601). Defaults to, and is clamped at, 90 days ago.
Export traces up to this timestamp (ISO 8601, exclusive). Defaults to now. Ignored once cursor is supplied.
Continuation token from the previous page's meta.cursor. Pass it back verbatim; treat it as opaque.
Response
Default Response
Changes
No recorded changes to this operation across all 1 revision of this API.