List agent traces

List traces for a specific agent. Returns trace summaries including input/output content.

Rate limit: 30 requests per minute per organization. Every response carries the standard RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset (seconds until the window resets) headers; a 429 response additionally carries Retry-After. The limit is enforced per API replica, so the effective budget scales with the number of replicas — treat the headers as a pacing signal rather than an exact global counter. For large exports, page with a small limit, back off on 429, and stay within the 90-day retention window.

get/v1/agents/{id}/traces

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

pageinteger

Page number, starts at 1

limitinteger

Number of items per page (max 100)

sessionIdstring

Filter traces by session ID (channel thread ID)

fromTimestampstring date-time

Filter traces from this timestamp (ISO 8601). Defaults to 90 days ago.

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

Filter traces up to this timestamp (ISO 8601). Defaults to now.

Example:2026-03-08T00:00:00.000Z

Response

Default Response

Changes

No recorded changes to this operation across all 1 revision of this API.