Home / Projects / NiPlex-Harness / Tools / Files tools / delete_file

Pictures

delete_file

Deletes a non-core file.

Since 2 Sept 2026

Core code, data files and root files are refused.

Tool name: delete_file
Group: Files
Risk: medium
Needs approval: never
Approval rule: No approval. Hard blocks apply.
Allowed in scheduled jobs: No
Default: on

Parameters

Name	Type	Required	Default	Meaning	Limits
path	string	Yes		Path relative to the project, such as vault/note.md.

Returns

A confirmation.

Example (made up for this page)

Call

{
  "path": "demo"
}

Result

Deleted vault/notes/a.md

Side effects

Removes a file.

How it can fail

When	What the agent sees
File not found	File not found: path
Protected path	HARD BLOCK

See also:Files tools

Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.