v4

latestOpenAPI 3.1.02026-07-3163216290.7 KB

Workflow nodes

Delete workflow nodes recursively

Delete a node and its downstream subtree. If contacts are queued at any node that would be deleted, Loops returns with "status": "queuedContactsFound" instead of deleting. Retry with queuedContactPolicy: "discard" to delete the nodes and discard those queued contacts.

delete/v1/workflows/{workflowId}/nodes/{nodeId}/recursive

Request body

expectedRevisionIdstring nullable required

The workflow revision token returned by the latest workflow read or mutation. Older workflows may return null before their first revision-aware mutation; pass null back as expectedRevisionId in that case. If the token is stale, the API returns a 409 Conflict error.

dryRunboolean

If true, the request will be validated but the workflow will not be modified.

queuedContactPolicy'fail' | 'discard'

fail returns queued-contact impact instead of mutating. discard confirms that matching queued contacts should be discarded. Defaults to fail when omitted.

Response

Delete dry run, queued-contact warning, or deletion result.