← API reference
Mutation / surfaces

deleteWorkspaceVersion

Delete one version from a workspace's authoring history. Fails when the version is the one the workspace is currently published at — delete the workspace itself to remove that. Owner for PERSONAL, else workspace:write.

Arguments

TypeID of the workspace version to delete (prefix wsv).

Returns DeletePayload!

Scalar fields at a glance

successBoolean!
↗ View the complete DeletePayload type

Explore in a view

Journeys and Workspaces
View exact SDL
"""
Delete one version from a workspace's authoring history. Fails when the version is the one the workspace is currently published at — delete the workspace itself to remove that. Owner for PERSONAL, else workspace:write.
"""
deleteWorkspaceVersion(
  """TypeID of the workspace version to delete (prefix `wsv`)."""
  id: WorkspaceVersionID!
): DeletePayload! @topic(names: ["surfaces"])

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