Move Files
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
}
'Agent Filesystem
Move Files
Move or rename files and directories within an agent’s workspace.
POST
/
v1
/
agent
/
{agentId}
/
filesystem
/
operations
/
move
Move Files
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.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
}
]
}
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 |

