Developer quickstart

Before you begin

Sign in with Labs Auth once to initialize your workspace, then create and test an agent. Create a key for your user through the Labs platform and store it on your server as LABS_AUTH_API_KEY. Set VOAI_ORGANIZATION_ID to the integer ID of a workspace you belong to. Ask your workspace administrator for that ID if needed. See authentication.

List agents

curl --fail-with-body 'https://agents.labs.bandwidth.com/api/v1/workflow/fetch' \
  -H "X-BW-LABS-AGENTS-API-KEY: ${LABS_AUTH_API_KEY}" \
  -H "X-VOAI-ORGANIZATION-ID: ${VOAI_ORGANIZATION_ID}"

Each entry includes an integer id and, where available, workflow_uuid. Save the integer ID for agent management and run lookup. Use the stable UUID for outbound calls by Agent UUID.

Retrieve recent runs

Set WORKFLOW_ID to the returned integer ID:

curl --fail-with-body "https://agents.labs.bandwidth.com/api/v1/workflow/${WORKFLOW_ID}/runs" \
  -H "X-BW-LABS-AGENTS-API-KEY: ${LABS_AUTH_API_KEY}" \
  -H "X-VOAI-ORGANIZATION-ID: ${VOAI_ORGANIZATION_ID}"

Use a returned run’s id as RUN_ID:

curl --fail-with-body "https://agents.labs.bandwidth.com/api/v1/workflow/${WORKFLOW_ID}/runs/${RUN_ID}" \
  -H "X-BW-LABS-AGENTS-API-KEY: ${LABS_AUTH_API_KEY}" \
  -H "X-VOAI-ORGANIZATION-ID: ${VOAI_ORGANIZATION_ID}"

Inspect state, is_completed, and the available transcript, recording, and gathered context. Artifact URLs can be absent until processing finishes.

Choose your next integration

Place an outbound call and supply runtime context.
Receive a webhook when a call finishes.
Create or update a workflow definition.
Connect an MCP client to work with agents through an assistant.

Use the REST API from any language with an HTTPS client. See authentication and error handling before adding write operations.

Build an integration

Connect applications

Before you begin

List agents

Retrieve recent runs

Choose your next integration

​Before you begin

​List agents

​Retrieve recent runs

​Choose your next integration

Before you begin

List agents

Retrieve recent runs

Choose your next integration