v1

latestOpenAPI 3.0.0Proprietary2026-08-062711471.0 MB
Workflows

Update workflow node

Updates a node and returns the updated workflow graph.

put/public/v1/workflows/{workflowId}/nodes/{nodeId}

Path parameters

workflowIdnumber nullable
Example:42
nodeIdstring required
Example:api_1

Request body

Example request

{
  "node": {
    "alias": "Fetch CRM contact",
    "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
    }
  }
}

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"
}