Skip to main content
GET
List uploads

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

project_reference
string
required

Project slug, UUID, or domain that identifies the project.

Query Parameters

path
string

Project-relative path to select direct-child files (for example, "assets/"). Omit to list all project files.

cursor
string

Opaque continuation; copy unchanged with the same project/path/sort. A removed anchor requires restarting; live changes affect traversal. Legacy ISO timestamps retain the creation cutoff and cannot recover ties.

Required string length: 1 - 4096
limit
number
default:20

Maximum number of entries to return. Defaults to 20 and is capped at 100.

Required range: 1 <= x <= 100
sort_by
enum<string>
default:created_at

Sort field. Defaults to "created_at". "size" is accepted as another spelling of "size_bytes".

Available options:
created_at,
name,
size_bytes,
size
sort_order
enum<string>
default:desc

Sort order. Defaults to "desc".

Available options:
asc,
desc
recursive
boolean
default:true

When true, returns all nested folders under the given path (or all folders if no path). Default: true.

Response

One page of uploads with the visible folders in folders. data also repeats the folders as type: "folder" items before the uploads (type: "file").

data
object[]
required

Upload item, either a folder (type: "folder") or a file (type: "file")

folders
object[]
required

Visible folders, separate from the upload cursor and page size. The data items with type: "folder" repeat them.

page_info
object
required