Skip to content

delete_active_file

Delete the note currently open in the live Obsidian session (delete_note, aimed at the active note): to the vault’s .trash mirror, or permanently. Destructive: requires human confirmation bound to the resolved note, so a confirmation raised while one note was active cannot be redeemed once another is. restore_note reads its undo from a snapshot when snapshots are enabled. Refuses a non-markdown active file.

Domain workspace
Scopes delete:notes
Access destructive
Tags writes, destructive, hitl, domain:workspace, plugin-bridge
Profile full only
Annotation Value
Read-only no
Destructive yes
Idempotent no
Accepts an idempotency key no

Idempotent is the advisory MCP idempotentHint. Destructive is also yes for a tool that asks for confirmation only on some calls.

A single-use elicit_token (or a transport-verified confirmation) is required on every call.

  • The confirmation binds to the vault paths the call names, which are also checked against the folder ACL.
Parameter Type Required Default Description
vault string — Vault id. May be omitted when only one vault is available. length 1–64; pattern ^[a-z0-9_-]+$
permanent boolean false —
prev_hash string — —
Field Type Always present Description
vault string yes —
path string yes —
deleted boolean yes —
permanent boolean yes —
trashed_to string | null yes —
prev_hash string yes —

Other tools in the workspace domain: add_bookmark, append_active_file, append_to_periodic_note, create_periodic_note, find_or_create_periodic_note, get_active_file, get_periodic_note, list_bookmarks, list_periodic_notes, list_workspaces, open_workspace, patch_active_file, remove_bookmark, resolve_daily_note, save_workspace, update_active_file.

Back to the tool catalog.