Skip to main content
PATCH
Update a node in a workflow
Legacy endpoint - deprecated. Unversioned endpoints are scheduled for removal on July 31, 2026. A public v1 replacement is not currently listed in the v1 reference. This endpoint remains available for existing integrations until then.
Updates editable fields on a workflow node: the human-readable label, the per-node-type config object (for example which agent a VOICE_CALL node uses or how long a TIME node waits), and the node’s position_x / position_y coordinates in the visual editor. The node_type is immutable after creation, to change the kind of step a node represents, delete the existing node with Delete Node and create a replacement.

When to use this

  • Renaming a step so the workflow’s dashboard view stays accurate as the business process evolves.
  • Swapping the agent or voice on a voice-call step without rebuilding the rest of the workflow graph.
  • Adjusting a TIME node’s delay as you learn the right cadence between outreach attempts.
  • Reflowing the visual layout after adding or removing nodes.
If the node is currently routing leads, changes take effect on the next scheduling tick. In-flight steps already running under the previous configuration complete with the old configuration.

Path parameters

Errors

  • 404 Not Found is returned when the workflow or node does not exist.
  • 400 Bad Request is returned when the config object fails validation for the node’s type, or when an attempt is made to change node_type.
  • List Nodes: see every node and its current configuration.
  • Create Node: add a new step.
  • Delete Node: remove a step, including replacing one of a different type.

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required
nodeId
string
required

Response

200

Node updated successfully