Files

Edit file

Edit a text file using a sequence of precise edit operations.

Parameters#

target_filestringrequired

The absolute path to the file to edit.

operationsobject[]required

A list of operations to apply to the file: replace_block, insert_after, insert_before, delete_block, append_line.

devicestringdefault: ""

Optional fleet device name or id. When set, edits the file inside that running device's container instead of the host. The device must be started first. Requires the 'devices:manage' scope.

zappstringdefault: ""

Optional Zo App slug or id. When set, edits the file inside that Zo App's sandbox instead of the host (the app server is /zo-app/server.ts; private/user data goes under /user-data so the app stays cleanly shareable). Mutually exclusive with 'device'. Requires the 'apps:shell' scope.