List files in the workspace sandbox (live)

GET

/workspaces/{id}/sandbox/files

curl --request GET \
  --url https://your-org.evershell.ai/v1/workspaces/example/sandbox/files \
  --header 'Authorization: Bearer <token>'

• Hosted tenant

Permissions: workspace:read or workspace:read:own (creator-match on :own).

Proxied through to the agent service. Requires the workspace to be running. For files in a stopped workspace, use /snapshot/files.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string

Responses

200

OK

Media type application/json

object

entries

required

Array<object>

A single entry in the workspace sandbox or snapshot tree. Shape matches the agent’s FileEntry so the same renderer works on both live (/sandbox/files) and stopped (/snapshot/files) sources.

object

path

required

string

size

required

integer format: int64

is_dir

required

boolean

mtime

required

Unix-epoch seconds with fractional milliseconds.

number

readonly

required

boolean

mime_type

string

Example ^generated

{
  "entries": [
    {
      "path": "example",
      "size": 1,
      "is_dir": true,
      "mtime": 1,
      "readonly": true,
      "mime_type": "example"
    }
  ]
}

409

Workspace is not running.

502

Agent service unreachable.