Skip to main content
GET
List agent versions
Use the integer agent ID to retrieve saved versions. Inspect version status before comparing a draft with published behavior. See test and publish.

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

limit
integer | null
Required range: 1 <= x <= 100
offset
integer
default:0
Required range: x >= 0

Response

Successful Response

created_at
string<date-time>
required
id
integer
required
status
string
required
version_number
integer
required
workflow_json
Workflow Json · object
required
published_at
string<date-time> | null
template_context_variables
Template Context Variables · object | null
workflow_configurations
Workflow Configurations · object | null