Add a track to a collection
add_to_collectionAdd a track returned by search to one of your editable collections. A collection has at most 500 tracks. A CC BY-NC track cannot be added to a commercial collection; use another track or mark the collection not commercial.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"collection_id": "<collection_id>",
"track_id": "<track_id>"
},
"name": "add_to_collection"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| revision | No | Current collection revision when coordinating concurrent edits. | |
| track_id | Yes | ||
| collection_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| kind | Yes | ||
| name | Yes | ||
| items | Yes | ||
| created | Yes | ||
| updated | Yes | ||
| revision | Yes | ||
| read_only | Yes | true when a lapsed Pro plan has made this collection view-and-export only. | |
| commercial | Yes | ||
| archived_at | Yes | When the collection was archived, or null. | |
| description | Yes | One line of plain text, or null. | |
| credits_heading | Yes | The credits block heading, or null for the default. |