Delete a Library file
delete_mediaDelete one file from the artist's Library for good, with its stored file. Ask the artist first and name the file: it cannot be brought back. Refused while the file is in use (a song's or album's cover, the logo, the profile photo, an Artist page photo, or any Promo post: draft, approved, scheduled or posted); the refusal names each use and post, so the artist can change those first.
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": "delete_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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. | |
| media_asset_id | Yes | From list_media. |