Retrieve agent trace

Retrieve detailed trace data for a specific agent trace, including messages and generation output.

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

Request

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

Path parameters

idstring uuid required

The ID of the agent

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

The ID of the trace

Example:12b7beea-1234-5678-9abc-def012345678

Response

Default Response

traceIdstring required

Trace ID

timestampstring required

ISO 8601 timestamp

threadIdstring nullable required

Thread ID (UUID)

latencynumber nullable required

Latency in seconds

metadataobject required

Trace metadata (sensitive fields excluded)

modelstring nullable required

LLM model used in the last generation

inputunknown
outputunknown
userContextobject

User context metadata passed via SDK

Example response

{
  "sessionStartHook": {
    "fetchedAt": "2026-07-22T19:03:58.412Z"
  }
}

Changes

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