Create Archive
curl --request POST \
--url https://api.app.shinzo.ai/v1/agent/{agentId}/filesystem/archives \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"paths": [
{}
],
"outputPath": "<string>",
"format": "<string>",
"compressionLevel": 123
}
'Agent Filesystem
Create Archive
Create a compressed archive from files in an agent’s workspace.
POST
/
v1
/
agent
/
{agentId}
/
filesystem
/
archives
Create Archive
curl --request POST \
--url https://api.app.shinzo.ai/v1/agent/{agentId}/filesystem/archives \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"paths": [
{}
],
"outputPath": "<string>",
"format": "<string>",
"compressionLevel": 123
}
'Authentication
Requires JWT token or Platform API key.Example Request
curl -X POST "https://api.app.shinzo.ai/v1/agent/agt_abc123/filesystem/archives" \
-H "Authorization: Bearer <jwt_token>" \
-H "Content-Type: application/json" \
-d '{
"paths": [
"/workspace/src",
"/workspace/config.json"
],
"output_path": "/workspace/backup.tar.gz",
"format": "tar.gz",
"compression_level": 6
}'
Response
{
"path": "/workspace/backup.tar.gz",
"size": 4096,
"format": "tar.gz"
}
Response Fields
| Field | Type | Description |
|---|---|---|
path | string | Absolute path of the created archive |
size | number | Archive size in bytes |
format | string | Archive format used |
Status Codes
| Code | Description |
|---|---|
201 | Archive created successfully |
400 | Invalid request body or paths |
401 | Invalid authentication |
403 | Access denied |
404 | Agent or source paths not found |

