Save a file
add_fileSaves a file on the project from this AI tool, under this person's name: a PDF, a picture, a Word file, slides, a spreadsheet, a ZIP, or text over 1 MB. Takes the file's path on the project, plus one of two things: its size and SHA-256, which returns a command that sends the file, or the whole of a file up to 750 KB in base64, which saves it at once. With only the path, it returns how to send the file and the project's Files link. With replace, the file becomes a new version of the one at that path.
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": "add_file"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| did | No | What the person did themselves in this work, in a few words they agree with: what they chose or decided, what they corrected, rewrote or wrote, what they checked and against what. Start with the verb, in the past tense, in their language: "Chose the three-step plan; fixed the March totals; rewrote the opening". Say nothing of what you did, what they did not do, how long it took, or a share of the work. Pass no did when their part was the request and the yes. Everyone who sees the change reads it, people outside the team included. At most 300 characters. | |
| for | No | Who this is for. "team" when any of it is for the team only: pay, rates or costs, a line the client should not read, personal data. Alcoven then keeps it from people who see only some folders until the person answers in Alcoven. "everyone" when all of it is fine for everyone who sees the folder. | |
| path | Yes | Where it goes, with its name: reports/q3.pdf. | |
| read | No | The § addresses you read for this work, kept with asked. Alcoven adds what it saw you read on this project since you last wrote on it, going back two hours at most. | |
| size | No | The file's size in bytes. | |
| asked | No | What the person asked for, in their own words, as they said it: their request only, never the rest of the conversation, and left out when they do not want it shared. It goes on the project with the change, so everyone who sees the change, and their AIs, see why it was made. | |
| title | No | A title, when its name says too little. | |
| sha256 | No | The file's SHA-256, in hex. | |
| for_why | No | With "team": a few words saying what in it is for the team, like "our day rate for the bank". The person and the project's managers read them. | |
| project | No | The project's slug, from open_project, like acme. Not needed when a § address names the project, or when the person is on one project. | |
| replace | No | True to keep this as a new version of the file at that path. | |
| asked_from | No | Where the request came from, when the person says so, in a few words: "Tuesday's call with the bank", "Ines's email". | |
| content_base64 | No | The whole file in base64, up to 750 KB. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| files | No | ||
| address | No | ||
| applied | Yes | ||
| command | No |