Skip to content

Update a workflow's graph

PUT
/workflows/{action_id}

Update a workflow. The voice update endpoint takes org_id as a query param and the partial body in JSON, so we forward both. A graph with record steps or a record trigger needs the object scopes they exercise (403 missing_scopes), like create, and a node or trigger config whose snake_case and camelCase keys disagree is refused (422 conflicting_node_keys). On a workflow with record steps or a record trigger, only its owner or a graph8 admin may change what it runs (403 owner_or_admin_required); its name and description stay editable.

use_when follows create: leave the key out to keep the stored line, send a string to set it, or send null or an empty string to clear it.

Translates the public config field to voice’s internal skill_config before forwarding (see module docstring).

Authorizations

Parameters

Path Parameters

action_id
required

Workflow action_id.

string
>= 1 characters

Workflow action_id.

Header Parameters

X-Target-Org-Id
Any of:
string

Request Body required

Partial update payload (voice ActionUpdateRequest).

object
key
additional properties
any

Responses

200

Successful Response

object
key
additional properties
any

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string