collection_add_assets
ManagementAdd 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
| Name | Type | Required | Description |
|---|---|---|---|
| collection_id | string | ✓ | Collection ID. |
| asset_ids | array | ✓ | Asset IDs to add. |
| 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
{
"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