BrandLife

List the assets sitting directly in one collection, most recently updated first. Assets in its sub collections are not included: to see those, call this again for each child collection from list_collections. The assets are shown to the user as a thumbnail grid automatically, so do not try to fetch or describe their images.

list_collection_assets

List every collection in a brand as a flat list, each with its parent_id so you can rebuild the tree yourself. Only collections this user may see are returned. Call it once per brand and reuse the result: collection ids from here are what list_collection_assets and the collection_ids filter of search_assets take.

list_collections

List the assets most recently opened or most recently added in a brand. Use it for questions like "what did I look at last week" or "what is new in this brand". Downloads are not tracked, so there is no download activity to ask for. The assets are shown to the user as a thumbnail grid automatically, so do not try to fetch or describe their images.

list_recent_assets

List what has been deleted in a brand: the deleted assets, and the deleted collections alongside them. Only items this user may see are returned. The assets are shown to the user as a thumbnail grid automatically, so do not try to fetch or describe their images.

list_trash

Move assets into a collection. An asset lives in exactly one collection, so this takes them out of wherever they are now: it does not add them to a second place. To copy instead, use clone_assets.

move_assets

Move a collection under a different parent collection, or to the top level of the brand. Everything inside it, sub collections and assets alike, moves with it. The collection is placed last among its new siblings.

move_collection

Rename a single asset. Nothing else about it changes: its files, tags, labels, status and collection are left alone.

rename_asset

Rename a collection, and optionally replace its description. Only the fields you pass are changed. To move a collection somewhere else use move_collection instead.

rename_collection

Restore one asset from the trash. If the collection it used to live in is gone, it comes back in the brand default collection.

restore_asset

Restore a collection from the trash, along with the assets and sub collections that were trashed with it. Collection ids in the trash come from list_trash.

restore_collection

Search the assets of a brand. `query` is free text matched against asset names, tags and descriptions; the optional filters narrow the result to given asset types, channels, tags, labels, collections, statuses, file extensions or starred assets only, and combine with each other. Every filter takes ids from list_brand_vocabulary or list_collections, never names. Results are the most recently updated matches first. `similar_assets` are what the AI search found close to the query without matching it outright, and are worth pointing out when the exact matches are few or empty. Both are shown to the user as a thumbnail grid automatically, so do not try to fetch or describe their images.

search_assets