v1

latestOpenAPI 3.1.02026-08-066984441.1 MB

workflows

Deletes a workflow.

If the workflow is linked to projects or project templates they can either be unlinked or migrated to another workflow before the workflow is deleted.

<Check title="Required Permissions" icon="key">The user must be an admin or have project-manage-config:write permissions.</Check>

post/workflows/{workflowId}/delete

Path parameters

workflowIdstring uuid required

Headers

Authorizationstring required

Bearer authentication

Request body

deleteOperationstring nullable

Defines how linked projects and project templates should be handled before deletion. Supported values are 'unlink' and 'migrate'.

newWorkflowIdstring uuid nullable

The workflow to migrate linked projects and project templates to. Required when DeleteOperation is 'migrate'.

keepCustomFieldsboolean nullable

Whether to keep existing non-workflow custom fields when migrating. Default: true.

keepCustomAutomationsboolean nullable

Whether to keep existing non-workflow automations when migrating. Default: true.

Response

No Content

object required