capsid_delete_doc
Delete a document, on Capsid. Needs the write grant.
What it does
Delete one document. Its body is snapshotted to document_versions and its edges are recorded first. Needs the write grant.
Delete a document. Snapshots it first and writes an audit log entry. Refused on a canon document for a caller that is not the seat or the admin (see capsid_write_doc). Needs confirmation: the server elicits it when the client supports elicitation, otherwise pass confirm: true. Needs the write grant.
What a client is told
The MCP hints it carries, so a client can ask before it acts (src/tool-annotations.ts).
- Writes: some action changes state.
- Can overwrite or remove what exists.
- Repeating a call changes nothing further.
- Stays inside Capsid.
Arguments
| Argument | Type | Needed | What it is |
|---|---|---|---|
namespace | string | always | |
path | string | always | |
confirm | boolean | no | |
allow_improve_paths | boolean | no |