Skip to main content
POST/api/public/v1/devices/{id}/storage/move

devices.storage.move

Move every profile folder of the machine to another absolute folder (worker 0.9.5+): refused while a browser runs; copied or renamed, verified file by file, then switched; progress and outcome appear in devices.list `storage.move`.

Capability: device.manageCommand (idempotent)MCP tool: devices_storage_move
View as Markdown

Parameters

NameTypeRequiredDescription
idpathstring (uuid)YesDevice id
command_idbodystring (uuid)YesClient-generated UUID for this command. Send the same id (and body) again to get the stored receipt instead of a second change; a different body under the same id is CONFLICT.
tobodystringYesAbsolute folder on the machine, e.g. D:\Browlix\profiles or /srv/browlix/profiles; empty or new; never a network share (min length 2, max length 400)

Examples

curl -X POST "https://browlix.com/api/public/v1/devices/<id>/storage/move" \
  -H "Authorization: Bearer $BROWLIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"command_id":"<uuid>","to":"<to>"}'

Response

201 with { data, replayed: false, correlation_id } the first time; 200 with replayed: true when the same command_id and body come again.

The field list of this reply is not published yet; read data as JSON.

Errors

CodeHTTPRetryable
UNAUTHENTICATED401No
FORBIDDEN403No
RATE_LIMITED429Yes
VALIDATION_FAILED422No
NOT_FOUND404No
CONFLICT409No
OUTCOME_UNKNOWN202Yes
DEPENDENCY_UNAVAILABLE503Yes
UNKNOWN500No

Every error code and when to retry

All operations