collection_add_assets

Management

Add Assets to Collection

Add assets to a collection. Args: - collection_id: required - asset_ids: required — array of asset IDs to add - team_id, project_id: required for OAuth callers Returns: the mutation result from the API. Example: "Add these assets to a collection" -> collection_id="collection_xxx", asset_ids=["asset_1", "asset_2"]
open-world

Parameters

NameTypeRequiredDescription
collection_idstringCollection ID.
asset_idsarrayAsset IDs to add.
team_idstringTeam ID. Required if user belongs to multiple teams.
project_idstringProject ID to scope the operation to.
response_formatenum(json | markdown)jsonOutput 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