Move Files

Move or rename files and directories within an agent’s workspace.

POST /v1/agent/{agentId}/filesystem/operations/move

Move Files

cURL

curl --request POST \
  --url https://api.app.shinzo.ai/v1/agent/{agentId}/filesystem/operations/move \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source": "<string>",
  "destination": "<string>",
  "overwrite": true
}
'

Authentication

Requires JWT token or Platform API key.

agentId · string · required

Agent UUID

source · string · required

Source path in the workspace

destination · string · required

Destination path in the workspace

overwrite · boolean

Overwrite if the destination already exists

Example Request

curl -X POST "https://api.app.shinzo.ai/v1/agent/agt_abc123/filesystem/operations/move" \
  -H "Authorization: Bearer <jwt_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "operations": [
      {
        "source": "/workspace/old-name.txt",
        "destination": "/workspace/new-name.txt"
      },
      {
        "source": "/workspace/temp/data.json",
        "destination": "/workspace/data/data.json",
        "overwrite": true
      }
    ]
  }'

Response

{
  "results": [
    {
      "source": "/workspace/old-name.txt",
      "destination": "/workspace/new-name.txt",
      "success": true
    },
    {
      "source": "/workspace/temp/data.json",
      "destination": "/workspace/data/data.json",
      "success": true
    }
  ]
}

When an operation fails, the error field describes the reason:

{
  "results": [
    {
      "source": "/workspace/missing.txt",
      "destination": "/workspace/moved.txt",
      "success": false,
      "error": "Source file not found"
    }
  ]
}

Response Fields

Field	Type	Description
results	array	Results for each move operation
results[].source	string	Source path
results[].destination	string	Destination path
results[].success	boolean	Whether the operation succeeded
results[].error	string	Error message (present only on failure)

Status Codes

Code	Description
200	Move operations completed (check individual results for per-operation status)
400	Invalid request body
401	Invalid authentication
403	Access denied
404	Agent not found