vault_delete
Delete a file from the vault and commit the deletion to git history for recoverability. Supports idempotent retries to prevent errors on retries.
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 |
|---|---|---|---|
| project | Yes | Project slug or '_meta' for cross-project content. | |
| path | Yes | Relative path to the file within the project. | |
| commit | No | If True (default), stage + commit the deletion. If False, unlink on disk but leave the removal staged for a later ``vault_commit`` (or obsidian-git). Same durability contract as ``vault_write``. | |
| 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 |