Get File Metadata
curl --request GET \
--url https://api.app.shinzo.ai/v1/agent/{agentId}/filesystem/metadata/{path} \
--header 'Authorization: Bearer <token>'Agent Filesystem
Get File Metadata
Get metadata about a file or directory in an agent’s workspace.
GET
/
v1
/
agent
/
{agentId}
/
filesystem
/
metadata
/
{path}
Get File Metadata
curl --request GET \
--url https://api.app.shinzo.ai/v1/agent/{agentId}/filesystem/metadata/{path} \
--header 'Authorization: Bearer <token>'Authentication
Requires JWT token or Platform API key.string
required
Agent UUID
string
required
File or directory path within the agent workspace (wildcard segment)
Example Request
curl -X GET "https://api.app.shinzo.ai/v1/agent/agt_abc123/filesystem/metadata/workspace/src/index.js" \
-H "Authorization: Bearer <jwt_token>"
Response
{
"path": "/workspace/src/index.js",
"type": "file",
"size": 1024,
"permissions": "644",
"created_at": "2025-01-15T10:00:00Z",
"modified_at": "2025-01-20T12:30: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 | 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 returned successfully |
401 | Invalid authentication |
403 | Access denied |
404 | Agent or path not found |