v1

latestOpenAPI 3.0.0Proprietary2026-08-062711471.0 MB
Workflows

Delete workflow edge

Removes an edge from the workflow graph.

delete/public/v1/workflows/{workflowId}/edges

Path parameters

workflowIdnumber nullable
Example:42

Request body

Example request

{
  "edge": {
    "source": "trigger_1",
    "sourceHandle": "default",
    "target": "api_1",
    "targetHandle": "default"
  }
}

Response

Updated graph

idstring
assistantIdstring nullable
accountIdnumber nullable
entityIdnumber required
type'FLOW' | 'AUTOMATION' required
createdAtstring required
updatedAtstring nullable
executedboolean
breakingChangeAtstring nullable
breakingChangeReasonstring nullable

Example response

{
  "id": "example",
  "assistantId": "example",
  "accountId": 1,
  "entityId": 1,
  "type": "FLOW",
  "nodes": [
    {
      "nodeId": "node_550e8400-e29b-41d4-a716-446655440000",
      "alias": "Initial trigger",
      "name": "Initial trigger",
      "position": {
        "positionX": 1,
        "positionY": 1
      },
      "type": "TRIGGER",
      "data": {
        "type": "TRIGGER",
        "triggerType": "CONVERSATION_ENDED",
        "triggeredBy": "BOTH",
        "triggeredByAgentIds": [
          "example"
        ],
        "triggerByWebhookIds": [
          "example"
        ],
        "triggeredByTableId": 1,
        "triggeredByRecordTypeId": 1,
        "connectedAccountTriggerId": "example",
        "triggerToolkit": "example",
        "triggerSlug": "example",
        "connectedAccountId": 1
      },
      "workflowId": "example",
      "handles": [
        {
          "handleId": "example",
          "sourceEdge": {
            "from": "example",
            "fromHandleId": "example",
            "to": "example",
            "toHandleId": "example"
          },
          "text": "example"
        }
      ],
      "targetEdges": [
        {
          "from": "example",
          "fromHandleId": "example",
          "to": "example",
          "toHandleId": "example"
        }
      ],
      "createdAt": "example",
      "updatedAt": "example"
    }
  ],
  "createdAt": "example",
  "updatedAt": "example",
  "breakingChangeAt": "example",
  "breakingChangeReason": "example"
}