send_file
Sends a file into the chat as an attachment.
Sends a file into the chat as an attachment.
- Tool name
- send_file
- Group
- Files
- Risk
- low
- Needs approval
- never
- Approval rule
- No approval.
- 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. | ||
| filename | string | No | Name to show for the sent file. |
Returns
A confirmation.
Example (made up for this page)
{
"path": "demo"
}Queued vault/notes/a.mdSide effects
- Uploads a file to the chat.
How it can fail
| When | What the agent sees |
|---|---|
| File missing | An error text |
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.