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
}
'

POST

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

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

List Directory Delete Directory

Documentation Index

​Authentication

​Example Request

​Response

​Response Fields

​Status Codes

Authentication

Example Request

Response

Response Fields

Status Codes