Organize a Library file
update_mediaRename a file in the artist's Library, give it a short description, set the artist's own tags, or link it to one song or album, as the file's Edit in the Library does. Only what you pass changes; tags replaces the whole set. It overwrites what was there (the answer says what it was), so tell the artist what you change. Limits: name 120 characters, description 500, up to 20 tags of 40 characters, stored lowercase.
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": {
"media_asset_id": "<media_asset_id>"
},
"name": "update_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | The file's name; null goes back to its own name. | |
| tags | No | The artist's own tags, the whole set; [] clears them. | |
| artist | No | Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection. | |
| unlink | No | true: take it off its song or album. | |
| album_id | No | Link it to this album (from list_albums). Clears a song link. | |
| track_id | No | Link it to this song (from list_tracks). Clears an album link. | |
| description | No | A few words about it; null clears it. | |
| media_asset_id | Yes | From list_media. | |
| idempotency_key | No | Send the same key if you retry, and the change happens once. |