Workflow Edges
Delete Edge
deprecated
Remove a transition (edge) between two workflow nodes without affecting the nodes themselves.
DELETE
Delete an edge from a workflow
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.
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
Errors
404 Not Foundis returned when the workflow or edge does not exist, or the edge does not belong to the specified workflow.409 Conflictis returned when deleting the edge would orphan an in-progress lead and the workflow’s safety configuration forbids that. Resolve the orphaned lead first.
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.
Delete an edge from a workflow