← API reference
Mutation / workflows

deleteWorkflowVersion

Delete one version from a workflow's authoring history. Fails when the workflow is active and this is the version it runs — deactivate it or activate another version first. Requires workflow:delete permission.

Arguments

TypeID of the workflow version to delete.

Returns DeletePayload!

Scalar fields at a glance

successBoolean!
↗ View the complete DeletePayload type

Explore in a view

Workflow Authoring
View exact SDL
"""
Delete one version from a workflow's authoring history. Fails when the workflow is active and this is the version it runs — deactivate it or activate another version first. Requires workflow:delete permission.
"""
deleteWorkflowVersion(
  """TypeID of the workflow version to delete."""
  id: WorkflowVersionID!
): DeletePayload! @topic(names: ["workflows"])

Schema reference describes the API contract. Actual access is checked by the platform for every operation.