v5

OpenAPI 3.1.02026-07-31129337684.6 KB

Super Nodes

Unpublish Super Node

Unpublish a workflow version as a super node.

If version_number is omitted, resolves to the workflow's active_version_number. Sets is_active=False on the SuperNodesModel document for that (workflow, version) pair. The workflow itself is not modified. Also warns about any workflows in this team that currently embed this super node — those will fail at execution time once the interface snapshot they hold diverges or becomes stale.

When dry_run=true, the SuperNodesModel document is left untouched and only the list of referencing workflows is returned. This lets the dashboard show a confirmation prompt before performing the destructive call.

delete/workflows/v1/workflows/{workflow_id}/super-node-interface

Path parameters

workflow_idstring required

Example:5eb7cf5a86d9755df3a6c593

Query parameters

version_numberinteger nullable

dry_runboolean

When true, do not actually unpublish — only return the list of workflows that currently reference this super node. Used by the UI to surface a confirmation dialog.

Response

Successful Response

workflow_idstring required

workflow_version_numberinteger nullable

Version number that was unpublished

messagestring required

dry_runboolean

When true, the super node was NOT actually unpublished; the response only previews which workflows reference it. Used by the UI to show a confirmation dialog before a real DELETE.

workflows_referencingstring[]

IDs of other workflows that currently embed this super node. They will break at execution time. May be truncated — see workflows_referencing_total and workflows_referencing_truncated.

workflows_referencing_totalinteger

Total number of dependent workflows, regardless of truncation.

workflows_referencing_truncatedboolean

True when workflows_referencing was capped and additional dependents exist beyond the returned list. Use the dedicated dependents endpoint to page through them.