Update a collection
update_collectionRename a collection, set whether it is commercial, set its description (plain text, up to 200 characters) or credits heading (up to 120 characters; the saved heading replaces the default in exported credits), or archive or unarchive it. An empty description or credits_heading clears it. A rename, commercial, description or credits heading change needs its current revision; archived alone does not and is safe to repeat. Archived collections are hidden from list_collections and search_collections unless you ask for them. A collection containing CC BY-NC tracks cannot be made 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>"
},
"name": "update_collection"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| archived | No | true archives, false unarchives. Needs no revision when sent alone. | |
| revision | No | ||
| commercial | No | ||
| description | No | One line of plain text, up to 200 characters. An empty string clears it. | |
| collection_id | Yes | ||
| credits_heading | No | The heading of the credits block, up to 120 characters. An empty string goes back to the default. |
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. |