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

Folder path prefix to list (for example, "assets/"). Omit for root.

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".

Available options:
created_at,
name,
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

Paginated list of folders and files. Each item has type: "folder" or type: "file".

data
object[]
required

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

page_info
object
required