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

da017caf56f1

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[]

Deprecated alias for tags_all, kept permanently for existing callers. Filter assets that have ALL of these tags. Combining it with tags_all, or exceeding 100 tags (counted after removing empty values and duplicates), returns 400 INVALID_TAG_FILTER.

exclude_tagsstring[]

Deprecated alias for tags_none, kept permanently for existing callers. Exclude assets that have ANY of these tags. Combining it with tags_none, or exceeding 100 tags (counted after removing empty values and duplicates), returns 400 INVALID_TAG_FILTER.

tags_allstring[]

Filter assets that have ALL of these tags. Tag values are opaque byte-strings compared exactly and case-sensitively; unknown tags are not an error — they simply match nothing. Replaces the deprecated include_tags. Sending both spellings, listing the same tag here and in tags_none, or exceeding 100 tags per list (counted after removing empty values and duplicates) returns 400 INVALID_TAG_FILTER.

tags_anystring[]

Filter assets that have AT LEAST ONE of these tags. Combines with tags_all/tags_none by intersection (tags_none always wins; overlap with tags_none is allowed and leaves a dead term). Supplying a positive tag filter (tags_any, tags_all, or include_tags) replaces the default category filter that is otherwise applied. Lists over 100 tags (counted after removing empty values and duplicates) return 400 INVALID_TAG_FILTER.

tags_nonestring[]

Exclude assets that have ANY of these tags. Replaces the deprecated exclude_tags. Sending both spellings, or exceeding 100 tags per list (counted after removing empty values and duplicates), returns 400 INVALID_TAG_FILTER.

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