da017caf56f1
List user assets
Retrieves a paginated list of assets belonging to the authenticated user. Supports filtering by tags, name, metadata, and sorting options.
Query parameters
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.
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.
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.
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.
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.
Filter assets where name contains this substring (case-insensitive)
JSON object for filtering by metadata fields
Maximum number of assets to return (1-500)
Number of assets to skip for pagination
Field to sort by
Sort order
Whether to include public/shared assets in results
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.
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