Skip to main content
POST
Duplicate an agent
Requires Editor, Admin, or Owner. Copies the latest draft when present, otherwise the published definition, together with configuration and triggers. Audio-library recordings remain shared workspace resources. Trigger identifiers are regenerated so the copy has its own trigger URLs; retrieve the returned definition before building an integration around them. The response describes the new agent. Retrying a successful duplication creates another copy. Review its connections and routing before use. A missing source agent, including one outside the workspace, returns 404.

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.

Path Parameters

workflow_id
integer
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