Skip to main content
POST
Create from a catalog template
Send a catalog key such as inbound-receptionist. Catalog keys are strings; they are different from the numeric IDs returned by List saved templates. The MCP list_workflow_templates tool lists catalog keys and their call types. Creation returns a new agent. Review its configuration, supply required connections, validate it, and publish when ready. Repeating the request creates another agent. An outbound catalog template additionally requires a Labs super_user bearer token. A workspace Editor role or API key alone cannot select one. Unknown keys return 404; invalid definitions or configurations return 422.

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.

Body

application/json
template_key
string
required

Response

Successful Response

created_at
string<date-time>
required
current_definition_id
integer | null
required

Current definition record ID; distinct from version_number.

id
integer
required
name
string
required
status
string
required
workflow_definition
Workflow Definition · object
required

Node and edge graph for this version.

call_disposition_codes
CallDispositionCodes · object | null
template_context_variables
Template Context Variables · object | null
total_runs
integer | null
version_number
integer | null

Human-readable sequence number. Use the version record ID for rollback.

version_status
string | null
workflow_configurations
Workflow Configurations · object | null
workflow_uuid
string | null