manage_collections
ManagementManage 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.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| action | enum(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_id | string | — | Collection ID. |
| name | string | — | Name for create/update. |
| description | string | — | Description for create/update. |
| asset_ids | array | — | Asset IDs for collection add/remove. |
| model_ids | array | — | Model IDs for collection add/remove. |
| limit | number | 20 | Results per page. |
| team_id | string | — | Team ID. Required if user belongs to multiple teams. |
| project_id | string | — | Project ID to scope the operation to. |
| response_format | enum(json | markdown) | json | Output format: 'json' for structured data, 'markdown' for human-readable text. |
Example Request
{
"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
{
"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