mv

Move or rename file or directory

Move or rename a file or directory to a new Viking URI.

Python SDK

from openviking import OpenViking

client = OpenViking()

# Rename a directory
client.mv(
    "viking://resources/old-name/",
    "viking://resources/new-name/"
)

# Move a file to a different directory
client.mv(
    "viking://resources/docs/temp.md",
    "viking://resources/archive/temp.md"
)

HTTP API

cURL

curl -X POST http://localhost:1933/api/v1/fs/mv \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{
    "from_uri": "viking://resources/old-name/",
    "to_uri": "viking://resources/new-name/"
  }'

POST /api/v1/fs/mv

{
  "from_uri": "viking://resources/old-name/",
  "to_uri": "viking://resources/new-name/"
}

Parameters

from_uri · string · required

Source Viking URI (file or directory to move)

to_uri · string · required

Destination Viking URI (new location and/or name)

Response

status · string

Operation status (ok on success)

result · object

Result object containing source and destination URIs

Show properties

from · string

Source Viking URI

to · string

Destination Viking URI

time · number

Execution time in seconds

{
  "status": "ok",
  "result": {
    "from": "viking://resources/old-name/",
    "to": "viking://resources/new-name/"
  },
  "time": 0.1
}

CLI

openviking mv viking://resources/old-name/ viking://resources/new-name/

Notes

• Both files and directories can be moved
• The operation is atomic
• If the destination already exists, it will be overwritten
• All metadata and relations are preserved
• Parent directories of the destination are created automatically if needed