manage_collections

Management

Manage Collections

Manage collections and their membership. Actions: list, get, create, update, delete, add_assets, remove_assets, add_models, remove_models. Args: - action: required operation (see above) - collection_id: required for get, update, delete, and membership changes - name, description: used for create or update - asset_ids: required for add_assets and remove_assets - model_ids: required for add_models and remove_models - response_format: 'json' (default) or 'markdown' - team_id, project_id: required for OAuth callers Returns: collection metadata (JSON or markdown). list returns collection summaries; membership actions return the updated collection state or mutation result. Examples: - "List my collections" -> action="list" - "Create a collection for hero assets" -> action="create", name="Hero Assets" - "Add these assets to a collection" -> action="add_assets", collection_id="collection_xxx", asset_ids=["asset_1", "asset_2"] - "Remove these models from a collection" -> action="remove_models", collection_id="collection_xxx", model_ids=["model_1"] Don't use when: You need tag management. Prefer manage_assets or manage_models instead.

destructiveopen-world

Parameters

NameTypeRequiredDescription
actionenum(list | get | create | update | delete | add_assets | remove_assets | add_models | remove_models)Collection action: list, get, create, update, delete, add_assets, remove_assets, add_models, remove_models.
collection_idstringCollection ID.
namestringName for create/update.
descriptionstringDescription for create/update.
asset_idsarrayAsset IDs for collection add/remove.
model_idsarrayModel IDs for collection add/remove.
limitnumber20Results per page.
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
{
  "action": "create",
  "name": "Dragon Concept Art",
  "description": "All dragon-themed assets for the fantasy RPG project",
  "team_id": "team_abc123",
  "project_id": "proj_xyz789"
}

Example Response

JSON
{
  "collection": {
    "id": "col_dragons",
    "name": "Dragon Concept Art",
    "description": "All dragon-themed assets for the fantasy RPG project"
  }
}

Common Use Cases

  • Group related assets into a collection for a specific milestone or sprint
  • Add or remove tags from assets to improve search and filtering
  • Save a set of model parameters as a named preset for reuse
  • List all tags across a project to audit naming conventions