Update File Tool
update_fileRename, re-label, or remove a project file or link by ID, or rename/archive a project document by title; actions require permission and confirmation.
Instructions
Renames, re-labels or removes a file or link (by its id, from read_document, project_brief or a task) or a project document (by its title): title renames it, role sets a file's or link's role on the project (brief, contract, design...), remove: true deletes a file or link for good, or archives a document (its versions stay). Only whoever added it, the project lead or an admin removes or re-labels; a task's file only whoever added it, and only while the task is open (on a closed task the files stay as reference). Only when the person asks, after confirming.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "update_file"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | The file's or link's id (from read_document, project_brief, start_task or search). | |
| repo | No | For a document: the git remotes of the working directory. | |
| role | No | A project file's or link's role ("none" clears it). | |
| title | No | The new name. | |
| remove | No | true deletes the file or link (for good), or archives the document. | |
| project | No | For a document: the project (slug or name), when it is not this session's. | |
| session | No | This session's id, from the cemainou line at the start of the session. The session's project wins over the repo. | |
| document | No | Or a project document's title. |