Skip to main content
GET
List agent names
Use this compact list to populate an agent selector. Use List agents when you also need status, UUID, folder, or run counts. The optional status filter accepts one lifecycle status. The response is an array and can be empty; this operation does not paginate.

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.

Query Parameters

status
string | null

Filter by status (e.g. 'active' or 'archived'). Omit to return all.

Response

Successful Response

id
integer
required
name
string
required