The artist's Library
list_mediaThe artist's pictures or videos in Audora's Library, newest first. Search by name, description and the artist's own tags; filter by category (Brand kit, Logo, Cover art, Promo, a platform, Made by Audora, Uploaded, Found online, Stock footage), by the song, album or release a file belongs to, by the artist's own tags, or to files no Promo post uses. Each has a media_asset_id (what update_post takes), its description, tags and links, and a preview link valid for an hour.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Pictures (default) or videos. | |
| tags | No | The artist's own tags: only files that carry every one. | |
| limit | No | ||
| 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. | |
| offset | No | ||
| search | No | Words in the file's name, description or the artist's own tags, or the title of the song or album it belongs to. | |
| album_id | No | Only files linked to this album (from list_albums). | |
| track_id | No | Only files linked to this song (from list_tracks). | |
| categories | No | Only files in every one of these. | |
| release_id | No | Only files linked to this release or to its song or album (from list_releases). | |
| not_in_posts | No | true: only files no Promo post uses, whatever the post's status. |