List files in a sandbox directory (/api/v1/sandbox/{id}/files/list)

Returns a listing of files and directories at the specified path within the sandbox Served by the live controller (answers 401 unauthenticated) but absent from…

GET /api/v1/sandbox/{id}/files/list

cURL

curl --request GET \
  --url 'https://api.sandbox.stateset.app/api/v1/sandbox/{id}/files/list' \
  --header "Authorization: Bearer $STATESET_SANDBOX_API_KEY"

200

{
  "files": [
    {
      "name": "Two-Person Tent",
      "path": "string",
      "type": "file",
      "size": 1,
      "modified_at": "2026-08-31T14:22:05Z"
    }
  ]
}

Returns a listing of files and directories at the specified path within the sandbox

Served by the live controller (answers 401 unauthenticated) but absent from its published /openapi.json — verified 2026-08-31.

Path parameters

id · string (uuid) · required

Unique sandbox identifier

Query parameters

path · string

Directory path to list (relative to sandbox root)

recursive · boolean

Whether to list files recursively

Response

FileListResponse

files · FileListEntry[]

Show FileListEntry

name · string

File or directory name

path · string

Full path within the sandbox

type · string

Whether this entry is a file or directory

size · integer

File size in bytes (0 for directories)

modified_at · string (date-time)

Last modification timestamp

Status codes

Code	Meaning
200	File listing
400	—
401	—
404	—

cURL

curl --request GET \
  --url 'https://api.sandbox.stateset.app/api/v1/sandbox/{id}/files/list' \
  --header "Authorization: Bearer $STATESET_SANDBOX_API_KEY"

200

{
  "files": [
    {
      "name": "Two-Person Tent",
      "path": "string",
      "type": "file",
      "size": 1,
      "modified_at": "2026-08-31T14:22:05Z"
    }
  ]
}