ORorigami
Workspace

Delete a workspace (two-step; ?confirm=true)

Changed on

Permanently deletes a workspace and its entire entity tree (tables, rows, cells, sequences, chat history, documents). For a session container the cascade covers the session, agents created in it, and its exclusively-linked workspace-less tables; tables also linked to other chats survive, and in-app chat sessions are rejected with 403 WORKSPACE_NOT_DELETABLE. Follows the v2 deletes convention, deliberately two-step so it can't fire on a single ambiguous instruction:

  1. 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.
  2. 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}

Request

  • Base URL
    https://origami.chat/api/v2
  • URL
    https://origami.chat/api/v2/workspaces/{workspaceId}
  • Auth
    HTTP bearer

Query parameters

confirmboolean

Must be true to actually delete. Omit for the impact preview.

Response

The impact preview (unconfirmed) or the delete receipt (confirmed).

OR

Changes