Create Directory
curl --request POST \
--url https://api.app.shinzo.ai/v1/agent/{agentId}/filesystem/directories/{path} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"recursive": true
}
'Agent Filesystem
Create Directory
Create a new directory in an agent’s workspace.
POST
/
v1
/
agent
/
{agentId}
/
filesystem
/
directories
/
{path}
Create Directory
curl --request POST \
--url https://api.app.shinzo.ai/v1/agent/{agentId}/filesystem/directories/{path} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"recursive": true
}
'Authentication
Requires JWT token or Platform API key.string
required
Agent UUID
string
required
Directory path within the agent workspace (wildcard segment)
boolean
Create parent directories if they don’t exist
Example Request
curl -X POST "https://api.app.shinzo.ai/v1/agent/agt_abc123/filesystem/directories/workspace/data/exports" \
-H "Authorization: Bearer <jwt_token>" \
-H "Content-Type: application/json" \
-d '{
"permissions": "755",
"recursive": true
}'
Response
{
"path": "/workspace/data/exports",
"created_at": "2025-01-20T10:00:00Z"
}
Response Fields
| Field | Type | Description |
|---|---|---|
path | string | Absolute path of the created directory |
created_at | string | Creation timestamp (ISO 8601) |
Status Codes
| Code | Description |
|---|---|
201 | Directory created successfully |
400 | Invalid request body |
401 | Invalid authentication |
403 | Access denied |
404 | Agent not found |
409 | Directory already exists |