rename_file
Renames a file on disk without changing the item's displayed name or extension; refuses canvas files to prevent broken references.
Instructions
Rename the file on disk. This changes the filename, not the item's name — use describe_item for that. Most of the time describe_item is what you want: the name is what the app displays, and a camera filename is only worth changing when it is actively misleading.
REFUSES for a file that is on a canvas. Renaming one would leave every canvas element pointing at nothing; the app's own rename fixes those up as it goes, and only the app can, so do it there.
The extension is kept and cannot be changed — it describes the bytes, not the name.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>",
"name": "<name>"
},
"name": "rename_file"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The new filename, without an extension. | |
| path | Yes | The item, as search_inspo reports it. |