API reference · Schema
SandboxFileList
objectstringrequiredAlways `list`: the type of this object
One of
listpathstringrequiredThe directory listed, relative to the workspace
The items
ShowHide 6 fields of
dataobjectstringrequiredAlways `sandbox_file`: the type of this object
One of
sandbox_filenamestringrequiredIts name
pathstringrequiredRelative to the workspace
typestringrequired`file`, `directory`, `symlink` (a symbolic link) or `other` (for example a socket)
One of
filedirectorysymlinkothersizeintegerrequiredSize in bytes
modified_atstring (date-time)requiredTime modified (ISO 8601, UTC)
next_cursorany JSON | nullrequiredAlways null: a listing is one page, cut short when `truncated` is true
truncatedbooleanrequiredMore than 1000 entries: the rest are left out
Example
{
"object": "list",
"path": "string",
"data": [
{
"object": "sandbox_file",
"name": "string",
"path": "string",
"type": "file",
"size": 1,
"modified_at": "2026-01-01T00:00:00.000Z"
}
],
"next_cursor": {},
"truncated": true
}Used by
- List a directory of the sandbox’s workspace
GET /v1/sandboxes/{sandbox_id}/files