mcp

Delete (archive) a saved document.

Soft-archive a saved document — it leaves the Files view but is recoverable server-side. Presence-aware: if the document is currently open in ANOTHER session and force is not set, the request FAILS honestly with HTTP 409 (code:"document_in_use" + open_in_sessions:N + suggested_action) so callers can confirm "open in N other session(s) — delete anyway?" and re-call with force=true. On force=true it archives, unlinks every session, and notifies the other sessions (which then prompt the user to keep editing or honor the deletion).

A no-op never wears a success status: if nothing was archived you get the 409 above, so a 2xx always means the archive actually happened.

delete/v1/documents/{document_id}

Request

Base URL: https://api.superdocs.app
URL: https://api.superdocs.app/v1/documents/{document_id}
Auth: HTTP bearer

Path parameters

document_idstring required

Query parameters

forceboolean

Confirm deletion of a doc that is open in another session. Without it, deleting an in-use doc fails with HTTP 409 (code document_in_use, open_in_sessions:N) instead of tombstoning — nothing is archived until you re-call with force=true.

from_sessionstring nullable

The caller's own session id (so it is excluded from the in-use check). Omit for a pure Files-view delete.

Headers

authorizationstring nullable

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.