Skip to main content
GET
Browse files by directory

Authorizations

Authorization
string
header
required

JWT authentication token

Query Parameters

page_size
integer
default:100
Required range: 1 <= x <= 1000
cursor
string
directory
string

Directory to browse within workspace

type
enum<string>

Filter by type

Available options:
directory,
file
project_id
string<uuid>

Optional project ID for project-scoped sandbox files

task_id
string<uuid>

Optional isolated task ID for task-scoped sandbox files

sandbox
string

Route file operations to a specific sandbox: cloud, a self-hosted sandbox UUID from the sandbox list, or an unambiguous display name / hostname. UUID values are always interpreted as IDs, never names. Prefer IDs because names can change. When omitted, the Neo-managed cloud sandbox is used. An unavailable or ambiguous selection returns an error and never selects another host.

Response

Directory listing

error
string
files
object[]
next_cursor
string