Workspace API
Delete Workspace
Delete a workspace.
DELETE
Delete Workspace
Authentication and permissions
Token requirements: User-based token (OAuth) or Organization-scoped API key. Send a bearer access token for one of these identities. The permissions and resource restrictions below also apply.
Permissions joined by + are all required; or separates alternatives. Full-access keys still cannot call endpoints marked unsupported. Workspace keys must allow every workspace checked by the request. OAuth access depends on the user’s roles and resource access.
- Non-branch workspace: The target workspace is not a branch. User OAuth requires an organization admin. Existing workspace deletion restrictions still apply.
- Branch workspace: User OAuth requires an organization admin who originally created the branch. Branches with unavailable creator provenance cannot be deleted.

