Skip to main content
GET
Get a run trace
Use the numeric agent and run IDs. Both must match a run in the requested workspace; otherwise the operation returns 404. The response contains a turn and span waterfall. Empty turns or spans can mean the run predates trace collection or is still in progress; an empty trace is not proof that the run failed. This operation does not start or replay the run.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Path Parameters

workflow_id
integer
required
run_id
integer
required

Response

Successful Response

other_spans
RunTraceSpanSchema · object[]
required
run_id
integer
required
summary
RunTraceSummarySchema · object
required
total_duration_ms
number
required
turns
RunTraceTurnSchema · object[]
required
started_at
string<date-time> | null
trace_id
string | null