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

Query Parameters

path
string

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

cursor
string

Cursor for pagination (ISO timestamp)

limit
number
default:20
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

Pagination cursor values for traversing the result set.