List agents
curl --request GET \
--url https://agents.labs.bandwidth.com/api/v1/workflow/fetch \
--header 'Authorization: Bearer <token>'import requests
url = "https://agents.labs.bandwidth.com/api/v1/workflow/fetch"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://agents.labs.bandwidth.com/api/v1/workflow/fetch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));[
{
"id": 42,
"name": "Receptionist",
"status": "draft",
"created_at": "2026-11-01T12:00:00Z",
"total_runs": 0,
"folder_id": null,
"workflow_uuid": "00000000-0000-4000-8000-000000000042",
"assistant_mode": "single_prompt",
"created_by": "developer@example.com"
}
]Agents
List agents
Retrieve agent summaries in the requested workspace.
GET
/
api
/
v1
/
workflow
/
fetch
List agents
curl --request GET \
--url https://agents.labs.bandwidth.com/api/v1/workflow/fetch \
--header 'Authorization: Bearer <token>'import requests
url = "https://agents.labs.bandwidth.com/api/v1/workflow/fetch"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://agents.labs.bandwidth.com/api/v1/workflow/fetch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));[
{
"id": 42,
"name": "Receptionist",
"status": "draft",
"created_at": "2026-11-01T12:00:00Z",
"total_runs": 0,
"folder_id": null,
"workflow_uuid": "00000000-0000-4000-8000-000000000042",
"assistant_mode": "single_prompt",
"created_by": "developer@example.com"
}
]Returns a JSON array of workspace agents. Each item includes the numeric management
id, name, lifecycle status, agent UUID, folder, and run count. Use Get an agent to retrieve its definition and configuration.
Omit status to list all agents, or supply a single status or comma-separated statuses such as active,archived. This endpoint does not paginate. An empty array is a successful response when no agents match.
With an API key, send X-VOAI-ORGANIZATION-ID for a workspace where the key owner is a current member. The same key can access the owner’s other workspaces by changing that header; its permissions follow the owner’s role in each workspace.Authorizations
LabsAuthLabsApiKey
Headers
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.
Query Parameters
Response
Successful Response