List files in a sandbox directory

List files in a sandbox directory

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

cURL

curl --request GET \
  --url 'https://api.sandbox.stateset.app/api/v1/sandbox/{id}/files' \
  --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"
    }
  ]
}

Path parameters

id · string (uuid) · required

Sandbox identifier

Query parameters

path · string

Directory path (default /workspace)

recursive · string

Recurse into subdirectories (true/false)

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

cURL

curl --request GET \
  --url 'https://api.sandbox.stateset.app/api/v1/sandbox/{id}/files' \
  --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"
    }
  ]
}