move_file
Move a saved file to another folder, creating it if needed while preserving the file name, extension, and description; canvas-linked files are refused.
Instructions
File an item into a different folder. This is the other half of describe_item: describing makes a pile findable, filing makes it tidy, and both are the slow work somebody drops things into Inbox to avoid doing by hand.
Use list_folders first to see what folders exist. The folder is created if it does not exist yet.
REFUSES for a file that is on a canvas, and the reason is worth knowing rather than working around: canvas elements store the path of the file they show, those elements live inside the app, and only the app can rewrite them. Studiolo's own move updates every canvas as it goes. A move made from out here would leave those canvases pointing at nothing, with no way for either side to notice. Move it in Studiolo instead.
REFUSES ALSO when it cannot find out whether the file is on a canvas. Missing information is not permission.
The filename and its extension are unchanged — use rename_file for the name. Nothing is overwritten: a collision gets a numbered suffix. Any description the file has travels with it.
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>",
"folder": "<folder>"
},
"name": "move_file"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | The item, as search_inspo reports it. | |
| folder | Yes | Folder within the root, e.g. 'packaging' or 'type/specimens'. Use '.' for the root itself. |