Skip to main content
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.
Your own data tagged with a workspace id (docs, issues, etc.) is not deleted by Sublay — Sublay doesn’t know about it. React to the workspace.deleted webhook to clean up your own workspace-tagged data.

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.

Response

Error Responses