Update Workflow

PUT /v1/workflows/{workflow_ref}

Updates a workflow draft. Every field is optional, but when updating nodes, edges, or global_edges, send a complete internally consistent graph rather than a partial graph fragment.

workflow_ref

string

required

Workflow UUID or reference.

Request fields

Field	Type	Description
`name`	string	New workflow name
`description`	string	New description
`nodes`	array	Complete node collection to replace the draft nodes
`edges`	array	Complete local edge collection to replace draft edges
`global_edges`	array	Complete global conditional edge collection
`variables_schema`	object	Declared variable types and metadata
`ui_state`	object	Dashboard canvas state
`compliance_plan`	object	Consent, retention, text/audio redaction, and recording configuration
`analysis_enabled`	boolean	Enable post-call analysis for this workflow
`analysis_profile_id`	integer or null	Organization analysis profile

Replace a graph

Use the same graph payload described in Create Workflow, with only the fields you want to replace.

curl -X PUT https://api.vonative.com/v1/workflows/WORKFLOW_UUID \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "nodes": [/* complete node collection */],
    "edges": [/* complete local edge collection */],
    "global_edges": [],
    "variables_schema": {
      "language": {"type": "string", "source_node": "language", "required": true, "pii": false}
    },
    "ui_state": {"viewport": {"x": 0, "y": 0, "zoom": 1}}
  }'

The API validates node types, edge references, and condition schemas, and validates compliance_plan the same way as Create Workflow (e.g. recording_consent.max_attempts must be 1–3). Test and publish apply additional runtime graph and resource-readiness validation.

Errors

Status	Description
`404`	Workflow not found in the organization
`422`	Invalid node type, edge reference, or condition schema
`409`	Workflow name conflict within the organization

Get Workflow Publish Workflow

Authentication

Introduction

Assistants

Phone Numbers

Workflows

Calls

Meets

Files

Tools

Server Credentials

Sessions

Call Logs

Webhooks

Campaigns

Update Workflow

Update Workflow

Request fields

Replace a graph

Errors

​Update Workflow

​Request fields

​Replace a graph

​Errors

Update Workflow

Request fields

Replace a graph

Errors