Delete Node

Remove a node from a workflow, along with every incoming and outgoing edge connected to it.

DELETE /workflows/{id}/nodes/{nodeId}

Delete a workflow node

cURL

curl --request DELETE \
  --url https://api.dialnexa.com/v1/workflows/{id}/nodes/{nodeId} \
  --header 'Authorization: Bearer <token>'

200

{
  "message": "Node deleted."
}

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

Parameter	Description
id	The workflow ID, for example wfl_m3v7zb9rk2px.
nodeId	The node ID, for example node_v8p3kz1mq7ry.

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.

Request

curl -X DELETE "https://api.dialnexa.com/v1/workflows/wfl_m3v7zb9rk2px/nodes/node_v8p3kz1mq7ry" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{ "message": "success" }

Related endpoints

• Create Node: add a replacement node.
• List Nodes: confirm the node is gone.
• Delete Edge: remove a single transition without removing its nodes.

Authorizations

Authorization · string · header · required

Pass your API key as a Bearer token in the Authorization header.

Path Parameters

id · string · required

nodeId · string · required

Response

200

application/json

Success.

message · string

Example:

"Node deleted."