v1
latestOpenAPI 3.1.02026-07-267154122.0 KBWorkspace
Delete a workspace (two-step; ?confirm=true)
Permanently deletes a workspace and its entire entity tree (tables, rows, cells, sequences, chat history, documents). Follows the v2 deletes convention — deliberately two-step so it can't fire on a single ambiguous instruction:
- Call without ?confirm=true → no deletion. Returns HTTP 200 with the impact preview { workspaceId, name, confirmationRequired: true, willDelete: { tables, rows } }. The caller is expected to check with the user before proceeding.
- After the user agrees, retry with ?confirm=true → performs the cascade soft-delete and returns { workspaceId, name, deleted: true }.
A missing / cross-org / already-deleted workspace returns 404 WORKSPACE_NOT_FOUND.
delete/workspaces/{workspaceId}
Query parameters
confirmboolean
Must be true to actually delete. Omit for the impact preview.
Response
The impact preview (unconfirmed) or the delete receipt (confirmed).