Skip to main content
DELETE
Delete an edge 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.
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

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.
  • 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

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

Path Parameters

id
string
required
edgeId
string
required

Response

200

Edge deleted successfully