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: used for create (required) or update. (Note: there is no `description` field on /collections — the API doesn't accept it.)
- thumbnail: optional asset_id for the collection thumbnail (update only)
- asset_ids: required for add_assets and remove_assets
- model_ids: required for add_models and remove_models
- limit, page_token: pagination for list (default limit=20)
- 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
| 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. |
| thumbnail | string | — | Asset ID to use as the collection thumbnail (update only). |
| asset_ids | array | — | Asset IDs for collection add/remove. |
| model_ids | array | — | Model IDs for collection add/remove. |
| limit | number | 20 | Results per page. |
| page_token | string | — | Pagination token. |
| 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
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