Skip to main content
GET
List Runs
Returns all runs for the given workflow, including both test runs and live call runs.

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

Query Parameters

page
integer
default:1
limit
integer
default:50
filters
string | null

JSON-encoded filter criteria

sort_by
string | null

Field to sort by (e.g., 'duration', 'created_at')

sort_order
string | null
default:desc

Sort order ('asc' or 'desc')

Response

Successful Response

limit
integer
required
page
integer
required
runs
WorkflowRunResponseSchema · object[]
required
total_count
integer
required
total_pages
integer
required
applied_filters
Applied Filters · object[] | null