Delete Workspace
Workspace Endpoints
Delete Workspace
Owner-only delete that cascades the subtree
Delete Workspace
Deletes a workspace. Owner-only (the workspace’s own owner, or an ancestor owner via the god path). There is no
delete-workspace capability.
Deletion cascades the entire subtree in one transaction, bottom-up: invitations → members → workspaces. Every workspace actually deleted fires a workspace.deleted webhook (one per workspace).
No per-member webhooks fire on this path. The cascade does not emit
workspace.member.removed for the memberships it tears down — one POST per member across a large subtree would flood a delivery layer with no retry or batching, and workspace.deleted already says the whole roster is gone. Treat each workspace.deleted as removing that node’s entire roster. See Webhooks & lifecycle.Path Parameters
string
required
The workspace UUID.
Body Parameters
string
Service/master keys only — the user to act as (must be own owner or an ancestor owner). Sent in the request body so the act-as-user path works on
DELETE.
