Skip to navigation
API referenceAssets

List the caller's Assets

The caller’s readable assets (not expired, not deleted), newest first: (created_at, id) descending, a total order. Each item is exactly the Asset GET /v1/assets/{asset_id} answers; a list never carries an href. Pages are chained with next_cursor, which is opaque and bound to this query’s filters and to the caller: send it back with the same filters (any limit), or the answer is 400 INVALID_CURSOR. An unknown or repeated parameter, or a value out of range, is 400 INVALID_REQUEST naming the parameter. Served only where list endpoints are enabled for your environment. Requires no product scope.

Authentication

X-API-Keystring

API key for one environment of your account. Keep server-side; never expose in browser clients.

Query parameters

limitstring or nullOptional

Page size, an integer 1-100 (default 20).

cursorstring or nullOptional

next_cursor of the previous page.

purposestring or nullOptional

input or result.

created_gtestring or nullOptional
Created at or after this RFC 3339 instant.
created_ltstring or nullOptional
Created before this RFC 3339 instant.
job_idstring or nullOptional
Only the result assets of this job.

Response

A page of the caller's assets, newest first
datalist of objects
has_moreboolean
next_cursorstring or null

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error
503
Service Unavailable Error