v36

latestOpenAPI 3.0.3GNU General Public License v3.0raw.githubusercontent.com2026-08-017758212.6 KB
file

List user assets

Retrieves a paginated list of assets belonging to the authenticated user. Supports filtering by tags, name, metadata, and sorting options.

get/api/assets

Query parameters

include_tagsstring[]

Filter assets that have ALL of these tags

exclude_tagsstring[]

Exclude assets that have ANY of these tags

name_containsstring

Filter assets where name contains this substring (case-insensitive)

metadata_filterstring

JSON object for filtering by metadata fields

limitinteger

Maximum number of assets to return (1-500)

offsetinteger

Number of assets to skip for pagination

sort'name' | 'created_at' | 'updated_at' | 'size' | 'last_access_time'

Field to sort by

order'asc' | 'desc'

Sort order

include_publicboolean

Whether to include public/shared assets in results

hashstring

Filter assets by content hash, in the canonical blake3:<hex> form. Matches regardless of which of this asset store's two internal hash storage formats the matching row was written under (the canonical form used by from-hash-created references, or the raw <hex>.<ext>/bare <hex> storage key used by direct uploads) — both represent the same content hash.

afterstring

Opaque cursor for keyset pagination. Pass the next_cursor value from the previous response to fetch the next page. When provided, offset is ignored. Cursor pagination is only supported with sort values created_at, updated_at, name, or size; requests combining after with other sort fields return 400. The cursor must have been minted under the same sort value used in the follow-up request.

Response

Success - Assets returned

has_moreboolean required

Whether more assets are available beyond this page

next_cursorstring

Opaque cursor to pass as the after query parameter to fetch the next page. Omitted from the response when there are no more results.

totalinteger required

Total number of assets matching the filters

All 77 operations