Skip to main content
GET
List user files

Authorizations

Authorization
string
header
required

JWT authentication token

Query Parameters

page_size
integer
default:50
Required range: 1 <= x <= 10000
cursor
string

Pagination cursor from previous response

directory
string

Filter by directory within workspace

Search files by filename

keys
string

Comma-separated file keys to retrieve

types
string

Comma-separated file extensions to filter

include_url
boolean
default:false

Include signed URLs in response

chat_id
string

Filter by associated chat ID

include_total
boolean
default:false

Include total count in response

sort_by
enum<string>
default:last_modified
Available options:
last_modified,
base_name,
size,
key
order
enum<string>
default:desc
Available options:
asc,
desc
project_id
string<uuid>

Optional project ID for project-scoped sandbox files

sandbox
string

Route file operations to a specific sandbox (cloud or a self-hosted display name / hostname). When omitted, the Neo-managed cloud sandbox is used. Self-hosted sandboxes require an explicit selection.

Response

File list

error
string
items
object[]
next_cursor
string
total
integer