Skip to main content
GET
List assets

Authorizations

Authorization
string
header
required

Pass your API key as Authorization: Bearer sk_…. Mint a key from your dashboard's API-keys page.

Query Parameters

project_id
string<uuid> | null

Restrict the listing to one project. Omit to return assets across every project you own.

state
enum<string> | null

Filter by lifecycle state. Omit to return every state.

Available options:
pending_upload,
processing,
pending_payment,
ready,
failed
limit
integer
default:20

Maximum number of assets to return (1-100). Defaults to 20.

Required range: 1 <= x <= 100
cursor
string | null

Opaque continuation token from the previous page's next_cursor. Omit for the first page.

Response

One page of assets, newest first.

One page of assets, newest first (keyset cursor pagination).

items
AssetSummary · object[]
required

One page of items, ordered by this list's sort key descending. See the endpoint description for which key that is.

limit
integer
required

The page-size limit this response was computed with.

next_cursor
string | null

Opaque continuation token. Pass as cursor on the next request to fetch the following page; null means this is the last page.