Delete a workspace (two-step confirmation)
Workspace
Delete a workspace (two-step confirmation)
Permanently deletes a workspace and its entire entity tree (tables, rows, cells, sequences, chat history, documents). Deliberately a two-step operation so it can’t fire on a single ambiguous instruction:
- Call with
confirmomitted/false → no deletion. Returns409 CONFIRMATION_REQUIREDwhosedetailscarry the workspace name and an impact preview (willDelete: { tables, rows }). The caller is expected to check with the user before proceeding. - After the user agrees, retry with
{ "confirm": true }→ performs the delete and returns{ workspaceId, name, deleted: true }.
A missing / cross-org / already-deleted workspace returns
404 WORKSPACE_NOT_FOUND.
POST
Delete a workspace (two-step confirmation)
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
application/json
Must be true to actually delete. Omit/false to get the confirmation preview.
Response
{ workspaceId, name, deleted: true } — workspace deleted.