v1

latestOpenAPI 3.0.0Proprietary2026-08-062711471.0 MB
Flows

Delete flow edge

Removes an edge from the flow graph.

delete/public/v1/agents/{agentId}/flows/{flowId}/edges

Path parameters

agentIdstring required
Example:uuid-xxxx-xxxx
flowIdnumber nullable
Example:101

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": "Start",
      "name": "Start",
      "position": {
        "positionX": 1,
        "positionY": 1
      },
      "type": "START",
      "data": {
        "type": "TRIGGER_INTENT",
        "agenticRouting": "example",
        "intentIds": [
          1
        ],
        "intents": [
          {
            "id": 1,
            "name": "example",
            "description": "example",
            "createdAt": "example",
            "updatedAt": "example",
            "status": "ACTIVE",
            "assistantId": "example",
            "phrases": [
              {
                "id": 1,
                "phrase": "example"
              }
            ],
            "flowId": 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"
}