collection_add_assets

Managementcatalog

Add Assets to Collection

Not in the default tool list

This tool lives in the tool catalog. Discover it with scenario_tools_search (or enumerate everything with scenario_tools_list) and run it via scenario_tool_execute_write. To list every tool directly, connect with ?toolsets=full.

Add assets to a collection. Safe to retry: assets already in the collection are skipped, not an error, and lists longer than 49 are sent in batches. Args: - collection_id: required - asset_ids: required — array of asset IDs to add - team_id, project_id: required for OAuth callers Returns: { collection, added_asset_ids, already_present_asset_ids }. If a later batch fails, the error says how many were already added; a retry adds the rest. Example: "Add these assets to a collection" -> collection_id="collection_xxx", asset_ids=["asset_1", "asset_2"]

open-world

Parameters

Name	Type	Required	Description
collection_id	string	✓	Collection ID.
asset_ids	array	✓	Asset IDs to add. Any number; sent in batches of 49.
team_id	string	—	Team ID. Required with project_id for OAuth callers; an API key is scoped by the key.
project_id	string	—	Project ID. Required with team_id for OAuth callers; an API key is scoped by the key.
response_format	enum(json \| markdown)	json	Output format: 'json' for structured data, 'markdown' for human-readable text.

Example Request

JSON

{
  "collection_id": "col_dragons",
  "asset_ids": [
    "asset_img001",
    "asset_img002"
  ],
  "team_id": "team_abc123",
  "project_id": "proj_xyz789"
}

Example Response

JSON

{
  "collection": {
    "id": "col_dragons",
    "name": "Dragon Concept Art"
  }
}

Common Use Cases

Add generated assets to a collection for organization