List Directory

GET

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

string

required

The ID of the instance.

Query Parameters

string

default:"."

The directory path to list, relative to the instance root.

Response

string

The directory path that was listed.

array

Show Entry object

string

The file or directory name.

string

The full path relative to the instance root.

boolean

Whether this entry is a directory.

integer

File size in bytes. 0 for directories.

string

Last modification timestamp (ISO 8601).

string

Unix-style permission string (e.g. "-rw-r--r--").

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--"
    }
  ]
}

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--"
    }
  ]
}

Overview

Organization

Instances

Channels

Skills

Files

API Keys

Subscription

Authentication

Path Parameters

Query Parameters

Response

​Authentication

​Path Parameters

​Query Parameters

​Response

Authentication

Path Parameters

Query Parameters

Response