List Assets

List assets with pagination and optional filtering.

This endpoint returns a paginated list of assets belonging to your organization. You can optionally filter by a specific list of asset IDs, by the agent that produced them, and/or by the specific run that produced them.

Primary Use Cases:

• Browse all your assets with pagination
• Retrieve specific assets using their IDs
• Fetch every asset produced by a given agent across all its runs
• Fetch every asset produced by a specific run
• Verify the provenance of a known asset list (combine asset_ids with agent_id or run_id)

Pagination Parameters:

• limit: Maximum number of items to return (default: 20, max: 100)
• cursor: Cursor for pagination (optional)

Filtering Parameters:

• asset_ids: Optional list of UUIDs to filter specific assets.
• agent_id: Optional agent UUID. Returns all assets produced by that agent across every run.
• run_id: Optional run UUID. Returns all assets produced by that single run.
• All three filters compose as an AND. For example, ?asset_ids=<id>&agent_id=<agent> returns the asset only if it was produced by that agent; otherwise the response is empty.
• agent_id and run_id only match assets that were produced by an agent run, so uploaded assets are excluded when either filter is set.

Response: Returns a CursorPaginatedResponse object containing:

• data: List of AssetSummary objects. Each asset includes agent_id and run_id so you can correlate it back to the agent / run that produced it.
• has_more: Indicates if there are more results available
• next_cursor: Cursor for the next page

Access Control:

• Only assets belonging to your organization are returned
• Assets not found or not accessible are silently excluded