Skip to main content
POST
https://api.app.shinzo.ai
/
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.
agentId
string
required
Agent UUID
path
string
required
Directory path within the agent workspace (wildcard segment)
recursive
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

FieldTypeDescription
pathstringAbsolute path of the created directory
created_atstringCreation timestamp (ISO 8601)

Status Codes

CodeDescription
201Directory created successfully
400Invalid request body
401Invalid authentication
403Access denied
404Agent not found
409Directory already exists