Find files matching a glob pattern

Matching files

POST /api/v1/sandbox/{id}/files/glob

cURL

curl --request POST \
  --url 'https://api.sandbox.stateset.app/api/v1/sandbox/{id}/files/glob' \
  --header "Authorization: Bearer $STATESET_SANDBOX_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{}'

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

Request body

JSON body of type GlobQueryRequest.

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	Matching files
404	Sandbox not found

cURL

curl --request POST \
  --url 'https://api.sandbox.stateset.app/api/v1/sandbox/{id}/files/glob' \
  --header "Authorization: Bearer $STATESET_SANDBOX_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{}'

200

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