Skip to main content
GET
Get Run
Returns the full run record including status, transcript and recording storage keys, gathered context, and usage/cost information. Exchange an artifact storage key through the authenticated GET /api/v1/s3/signed-url endpoint before downloading it. Access is restricted to Labs accounts in the run’s workspace.

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

call_type
enum<string>
required
Available options:
inbound,
outbound
cost_info
Cost Info · object | null
required
created_at
string<date-time>
required
definition_id
integer | null
required
id
integer
required
is_completed
boolean
required
mode
string
required
name
string
required
recording_url
string | null
required
state
string
required
transcript_url
string | null
required
workflow_id
integer
required
annotations
Annotations · object | null
gathered_context
Gathered Context · object | null
initial_context
Initial Context · object | null
logs
Logs · object | null
usage_info
Usage Info · object | null