Skip to main content
GET
/
v1
/
instances
/
{instance_id}
/
files
curl -X GET "https://api.chowder.dev/v1/instances/ins_abc123/files?path=skills" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "path": "skills",
  "entries": [
    {
      "name": "web-search",
      "path": "skills/web-search",
      "is_dir": true,
      "size": 0,
      "mod_time": "2026-01-15T10:30:00Z",
      "permissions": "drwxr-xr-x"
    },
    {
      "name": "openclaw.json",
      "path": "skills/openclaw.json",
      "is_dir": false,
      "size": 1024,
      "mod_time": "2026-01-15T09:00:00Z",
      "permissions": "-rw-r--r--"
    }
  ]
}
Lists the files and subdirectories at a given path on the instance. Defaults to the root directory (.) if no path is specified.

​
Authentication

Requires an org-level API key or a scoped token with the appropriate permission.

​
Path Parameters

​
instance_id
string
required
The ID of the instance.

​
Query Parameters

​
path
string
default:"."
The directory path to list, relative to the instance root.

​
Response

​
path
string
The directory path that was listed.
​
entries
array
curl -X GET "https://api.chowder.dev/v1/instances/ins_abc123/files?path=skills" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "path": "skills",
  "entries": [
    {
      "name": "web-search",
      "path": "skills/web-search",
      "is_dir": true,
      "size": 0,
      "mod_time": "2026-01-15T10:30:00Z",
      "permissions": "drwxr-xr-x"
    },
    {
      "name": "openclaw.json",
      "path": "skills/openclaw.json",
      "is_dir": false,
      "size": 1024,
      "mod_time": "2026-01-15T09:00:00Z",
      "permissions": "-rw-r--r--"
    }
  ]
}