Files

The files endpoints let you read, write, and list paths in a VM's filesystem without opening a shell. They go through the in-VM agent over the same channel exec uses, so they work whether the VM has SSH configured or not.

A running VM is required — start one via VMs.

Endpoints

• GET /v1/instances/:id/files — read a file's contents
• POST /v1/instances/:id/files — write a file
• POST /v1/instances/:id/files/edit — apply a structured edit (insert/replace/delete by line range)
• GET /v1/instances/:id/files/list — list a directory

Related

• Exec — run shell tools (cat, ls, find) when you'd rather use the filesystem indirectly
• SSH — for full interactive shell access