pve_agent_file_write
Write a file to a Proxmox VM guest via the QEMU agent. Dry-run returns a plan; confirm executes the write, overwriting the target irreversibly.
Instructions
MUTATION: write a file inside the guest via the qemu-agent.
Requires PROXIMO_ENABLE_AGENT=1, the VMID in PROXIMO_AGENT_ALLOWLIST, and a running guest agent inside the VM. Dry-run by default (returns a PLAN); confirm=True executes and returns {"status": "ok", "result": None}. File path must be absolute; content is UNCONDITIONALLY redacted from the ledger (fingerprint only). Overwrites the target file whole — irreversible, no undo primitive on this plane. To read a file instead use pve_agent_file_read; text content round-trips byte-identical, binary/encoded content is unconfirmed.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | Yes | Absolute path of the file to write inside the guest. | |
| node | No | Proxmox node name hosting the guest; auto-detected if omitted. | |
| vmid | Yes | Numeric VM ID of the guest to write to via the qemu-agent. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the write. | |
| content | Yes | File content to write; unconditionally redacted from the ledger (fingerprint only). | |
| proximo_target | No | Which configured Proxmox target to run this call against — a target name from your multi-target config (a specific PVE/PBS/PMG/PDM box). Omit to use the single/default target from the environment; the selection applies only to this call. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |