Move File - Gravix Layer

POST /v1/agents/runtime/{runtime_id}/files/move Moves or renames a path. The guest uses the native rename syscall when the source and destination live on the same filesystem, which is atomic and does not copy any data. Across filesystems it falls back to a copy followed by an unlink.

from gravixlayer import GravixLayer

client = GravixLayer()  # defaults to cloud="aws", region="us-east-1"
sandbox = client.runtime.create()  # defaults to template="base-small"

sandbox.file.write("/workspace/draft.txt", "hello\n")

result = sandbox.file.move("/workspace/draft.txt", "/workspace/final.txt")
print(result.success, result.source, result.destination)

sandbox.kill()

import { GravixLayer } from 'gravixlayer';

const client = new GravixLayer(); // defaults to cloud="aws", region="us-east-1"
const sandbox = await client.runtime.create(); // defaults to template="base-small"

await sandbox.file.write("/workspace/draft.txt", "hello\n");

const result = await sandbox.file.move("/workspace/draft.txt", "/workspace/final.txt");
console.log(result.success, result.source, result.destination);

await sandbox.kill();

gravixlayer runtime files mv "$RT" /workspace/draft.txt /workspace/final.txt

curl -X POST "https://api.gravixlayer.ai/v1/agents/runtime/$RT/files/move" \
  -H "Authorization: Bearer $GRAVIXLAYER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source": "/workspace/draft.txt", "destination": "/workspace/final.txt"}'

Parameters

Parameter	Type	Required	Description
`source`	string	Yes	Existing absolute path
`destination`	string	Yes	New absolute path
`overwrite`	boolean	No	Replace `destination` if it already exists. Defaults to `false`

Without overwrite, moving onto an existing path fails rather than silently destroying it.

Response (`FileMoveResponse`)

Field	Type	Description
`success`	boolean	Whether the move succeeded
`source`	string	The path that was moved
`destination`	string	The path it now occupies
`entry`	object	`FileInfo` for the destination, when the guest reports it