Skip to main content
GET
List Media Assets
Returns every ready asset in the project, newest first. Uploads still waiting on confirm are excluded.

Filtering by folder

Pass folder (a path) or folderId (a UUID) to scope the listing to one folder. Add recursive=true to include everything nested beneath it.
Just this folder
This folder and all subfolders
An unknown folder path returns 400 rather than an empty list, so a typo doesn’t look like an empty folder. See Folders & Paths. Each asset comes back with its folder path already resolved, so you don’t need a second call to turn folderId into something readable.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page
integer
default:1
limit
integer
default:20
folder
string

Only list assets in this folder path (relative to the project root). The path must already exist. Mutually exclusive with folderId.

Example:

"avatars/2024"

folderId
string<uuid>

UUID of the folder to list. Mutually exclusive with folder.

recursive
enum<string>
default:false

With folder or folderId, also include assets in every subfolder beneath it. Ignored when no folder filter is given.

Available options:
true,
false

Response

A page of media assets

assets
object[]
pagination
object