Copy Files
curl --request POST \
--url https://api.app.shinzo.ai/v1/agent/{agentId}/filesystem/operations/copy \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source": "<string>",
"destination": "<string>",
"overwrite": true
}
'Agent Filesystem
Copy Files
Copy files or directories within an agent’s workspace.
POST
/
v1
/
agent
/
{agentId}
/
filesystem
/
operations
/
copy
Copy Files
curl --request POST \
--url https://api.app.shinzo.ai/v1/agent/{agentId}/filesystem/operations/copy \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source": "<string>",
"destination": "<string>",
"overwrite": true
}
'Authentication
Requires JWT token or Platform API key.string
required
Agent UUID
string
required
Source path in the workspace
string
required
Destination path in the workspace
boolean
Overwrite if the destination already exists
Example Request
curl -X POST "https://api.app.shinzo.ai/v1/agent/agt_abc123/filesystem/operations/copy" \
-H "Authorization: Bearer <jwt_token>" \
-H "Content-Type: application/json" \
-d '{
"operations": [
{
"source": "/workspace/config.json",
"destination": "/workspace/config.backup.json",
"overwrite": false
},
{
"source": "/workspace/src",
"destination": "/workspace/src-backup"
}
]
}'
Response
{
"results": [
{
"source": "/workspace/config.json",
"destination": "/workspace/config.backup.json",
"success": true
},
{
"source": "/workspace/src",
"destination": "/workspace/src-backup",
"success": true
}
]
}
error field describes the reason:
{
"results": [
{
"source": "/workspace/missing.txt",
"destination": "/workspace/copy.txt",
"success": false,
"error": "Source file not found"
}
]
}
Response Fields
| Field | Type | Description |
|---|---|---|
results | array | Results for each copy 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 | Copy operations completed (check individual results for per-operation status) |
400 | Invalid request body |
401 | Invalid authentication |
403 | Access denied |
404 | Agent not found |