Skip to main content
DELETE
Delete a node from 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.
Deletes a single node from a workflow. Every edge connected to the node, both incoming transitions from earlier steps and outgoing transitions to later steps, is automatically deleted in the same operation. Leads currently waiting at this node are not moved; they remain attached to the (now removed) node and will not advance further until you either remove them with Remove Workflow Lead or re-route them by adding new edges.

When to use this

Node deletion is a structural change to the workflow graph. Use it when you are intentionally refactoring the sequence, not to pause work or to skip a step. Common cases:
  • Removing an obsolete step when the business process no longer needs it.
  • Consolidating branches so two parallel nodes collapse into a single canonical step.
  • Replacing a node with a different action; delete the old one, then Create Node to add the replacement and reconnect the edges.
If you only want to stop a node from running for a while, deactivate or detach its inbound edge instead. Deleting and re-adding the node is destructive, leads waiting on it lose their position in the workflow.

Behavior

  • All edges where this node is the source or destination are deleted along with the node.
  • Leads waiting on this node are left in a stranded state until you intervene.
  • Historical call logs from previous executions of this node remain visible in Call Logs.

Path parameters

Errors

  • 404 Not Found is returned when the workflow or node does not exist.
  • 409 Conflict is returned when deleting the node would leave the workflow without a valid entry point and the workflow’s safety configuration forbids that.

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 deleted successfully