Delete Edge

Remove a transition (edge) between two workflow nodes without affecting the nodes themselves.

DELETE /workflows/{id}/edges/{edgeId}

Delete a workflow edge

cURL

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

200

{
  "message": "Edge deleted."
}

Removes a single edge between two workflow nodes. The source and destination nodes remain in place; only the directed transition between them is deleted. Leads that have already advanced past this edge keep moving through the rest of the graph normally, the deletion only affects future evaluations.

When to use this

Edges encode “what happens next” decisions in a workflow. Delete an edge when:

• A branch is no longer needed, for example after consolidating two outcome paths into one.
• You want to remove a fallback transition after introducing a more specific condition through Create Edge.
• A workflow is being refactored and you are rewiring transitions one at a time so you can validate the diff.

If you want to remove an entire node and everything connected to it, use Delete Node instead, that endpoint cleans up incoming and outgoing edges automatically.

Behavior

• Deleting an edge does not delete the source or destination node.
• Leads that have already been routed by this edge stay on their current node.
• Leads currently arriving at the source node will no longer be eligible to follow this transition. If no other outgoing edge applies, they remain on the source node until you add a replacement edge or end the workflow.

Path parameters

Parameter	Description
id	The workflow ID, for example wfl_m3v7zb9rk2px.
edgeId	The edge ID, for example edge_h4q8zn2vr6bx.

Errors

• 404 Not Found is returned when the workflow or edge does not exist, or the edge does not belong to the specified workflow.
• 409 Conflict is returned when deleting the edge would orphan an in-progress lead and the workflow’s safety configuration forbids that. Resolve the orphaned lead first.

Request

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

Response

{ "message": "success" }

Related endpoints

• Create Edge: add a new transition between nodes.
• List Edges: view all current transitions for a workflow.
• Delete Node: remove a node and all its connected edges.

Authorizations

Authorization · string · header · required

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

Path Parameters

id · string · required

edgeId · string · required

Response

200 - application/json

Success.

message · string

Example:

"Edge deleted."