List Assets
sirv_list_assetsList or search Studio library assets to locate asset IDs and URLs for AI tools; use filters in list mode and ranked search when supplying a query.
Instructions
List or search the assets in the Studio library. Two modes:
Without
q: list assets, filtered bysearch(file name),folderId,tags,productIdandfavorite, and sorted bysortBy. Each row has the asset URL.With
q: ranked search over file names, tags, linked products, alt text and metadata, filtered bymimeType,sourceToolandfavorite. Rows have no URL: get it with sirv_get_asset.
Use it to find an asset id or URL for the AI tools. These are Studio library assets: for files in the connected Sirv account, use sirv_cdn_search_files. For images that look alike, use sirv_find_similar_assets.
Read-only. Returns asset ids, file names and types, and the total, with the offset for the next page.
Credits: free.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "sirv_list_assets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Words to search for. Switches to ranked search over file names, tags, linked products, alt text and metadata. Leave it out to list assets | |
| tags | No | List mode only: comma-separated tag ids. Shows assets with these tags | |
| limit | No | Assets per page, 1 to 100. Default: 20 | |
| orgId | No | Workspace id from sirv_list_organizations. Default: the workspace you signed in to | |
| offset | No | Number of assets to skip, for the next page. Default: 0 | |
| search | No | List mode only: show assets whose file name contains this text | |
| sortBy | No | List mode only: sort field. Default: created_at. Search results are ranked by match | |
| favorite | No | true: only favourite assets. Works in both modes | |
| folderId | No | List mode only: folder id, or 'root' for the top level | |
| mimeType | No | Search mode only (with q): MIME type, such as image/png | |
| productId | No | List mode only: show assets linked to this product id | |
| sortOrder | No | List mode only: sort direction. Default: desc | |
| sourceTool | No | Search mode only (with q): the AI tool that made the asset, such as upscale |