vault_delete
Delete a file from an Obsidian vault and commit the removal to git history, keeping every deletion recoverable. Supports idempotent retries for already-removed files.
Instructions
Delete a single file from the vault (destructive; recoverable via git).
Removes one file and, by default, commits the deletion so it stays
recoverable from git history (git revert / git show). Files
only — directories are rejected. A non-existent path is an error,
unless idempotency_key is set (then a retry against an already-gone
file is a no-op success).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Relative path to the file within the project. | |
| commit | No | Must be True (the default). Unlike ``vault_write``, this tool has no deferred mode: it neither uses the commit queue (a delete and a recreate inside one tick would collapse to a single state) nor leaves the removal uncommitted, which is the indefinite deferral ADR-018 §4 removed. ``commit=False`` is rejected with an explanation rather than silently upgraded — see the ADR's 2026-08-09 amendment. | |
| project | Yes | Project slug or '_meta' for cross-project content. | |
| idempotency_key | No | Optional at-most-once token. If set, a retry with the same key is a no-op after the first delete (ADR-013), which also makes deleting an already-removed file succeed. Empty (default) disables idempotency. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |