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.

get/v1/agents/{id}/traces/export

Request

  • Base URL
    https://api.runbear.io
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

The ID of the agent to retrieve

Example:0fade940-133f-49e6-bf4b-8f662186479b

Query parameters

fromTimestampstring date-time

Export traces from this timestamp (ISO 8601). Defaults to, and is clamped at, 90 days ago.

Example:2026-05-01T00:00:00.000Z
toTimestampstring date-time

Export traces up to this timestamp (ISO 8601, exclusive). Defaults to now. Ignored once cursor is supplied.

Example:2026-08-01T00:00:00.000Z
cursorstring

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.