Skip to main content
POST
Create from Template
Bandwidth Agent Builder uses an LLM to generate the initial workflow definition from your description. The result is a fully editable agent — use Update to refine it after creation. This is the fastest way to get a working agent, especially for common use cases like appointment booking, lead qualification, or customer support.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Body

application/json
call_type
enum<string>
required
Available options:
inbound,
outbound
use_case
string
required
activity_description
string
required

Response

Successful Response

id
integer
required
name
string
required
status
string
required
created_at
string<date-time>
required
workflow_definition
Workflow Definition · object
required
current_definition_id
integer | null
required
template_context_variables
Template Context Variables · object | null
call_disposition_codes
CallDispositionCodes · object | null
total_runs
integer | null
workflow_configurations
Workflow Configurations · object | null
version_number
integer | null
version_status
string | null
workflow_uuid
string | null