Update File Metadata

curl --request PATCH \
  --url https://api.app.shinzo.ai/v1/agent/{agentId}/filesystem/metadata/{path} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "permissions": "<string>",
  "owner": "<string>",
  "group": "<string>",
  "tags": [
    {}
  ]
}
'

PATCH

agent

{agentId}

filesystem

metadata

{path}

Update File Metadata

curl --request PATCH \
  --url https://api.app.shinzo.ai/v1/agent/{agentId}/filesystem/metadata/{path} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "permissions": "<string>",
  "owner": "<string>",
  "group": "<string>",
  "tags": [
    {}
  ]
}
'

Authentication

Requires JWT token or Platform API key.

string

required

Agent UUID

string

required

File or directory path within the agent workspace (wildcard segment)

string

New file permissions in octal format (e.g., 755)

string

New owner

string

New group

array

Tags to apply to the file

Example Request

curl -X PATCH "https://api.app.shinzo.ai/v1/agent/agt_abc123/filesystem/metadata/workspace/scripts/deploy.sh" \
  -H "Authorization: Bearer <jwt_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "permissions": "755"
  }'

Response

{
  "path": "/workspace/scripts/deploy.sh",
  "type": "file",
  "size": 512,
  "permissions": "755",
  "created_at": "2025-01-15T10:00:00Z",
  "modified_at": "2025-01-20T14:00:00Z"
}

Response Fields

Field	Type	Description
`path`	string	Absolute path of the file or directory
`type`	string	Entry type (`file` or `directory`)
`size`	number	Size in bytes
`permissions`	string	Updated file permissions in octal format
`created_at`	string	Creation timestamp (ISO 8601)
`modified_at`	string	Last modified timestamp (ISO 8601)

Status Codes

Code	Description
`200`	Metadata updated successfully
`400`	Invalid request body
`401`	Invalid authentication
`403`	Access denied
`404`	Agent or path not found

Overview

Authentication

AI Agents

Agent Messaging

Agent Schedules & Triggers

Agent Channels

Agent Filesystem

MCP Servers

Spotlight

Tokens

Provider Keys

Telemetry

Update File Metadata

Authentication

Example Request

Response

Response Fields

Status Codes

​Authentication

​Example Request

​Response

​Response Fields

​Status Codes

Authentication

Example Request

Response

Response Fields

Status Codes