Skip to main content
GET
List cuts

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

asset_id
string<uuid> | null

Restrict to one asset's cuts (1:N, newest first).

project_id
string<uuid> | null

Restrict to one project.

state
enum<string> | null

Filter by lifecycle state. Cut states reachable on the public API surface: a cut computes pendingprocessing and lands completed, or failed.

Available options:
pending,
processing,
completed,
failed
limit
integer
default:20

Maximum cuts to return (1-100). Default 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 your cuts, newest first.

One page of the caller's cuts, newest first (keyset cursor pagination).

items
CutResponse · 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.