Name: Audora
Author: audora

Returns the account this connection acts in (an artist's, or a label's with its roster), what this connection is allowed to do, where the result is reviewed, and next_steps: what to offer the artist next, worked out from the account. Call this first, and again whenever you are unsure whose catalog you are working in. On a label connection, pass artist to see one roster artist's account.

Parameter	Type	Required	Notes
artist	string	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. Le

Every field Audora needs, with its exact limit in characters or words, the closed list to choose from where there is one, and the accepted file formats and sizes. Call this BEFORE filling anything in. The limits differ per field: some are refused when exceeded and some only flagged. What blocks a release is set by Audora, and it changes.

Parameter	Type	Required	Notes
entity	string	no	Narrow to one kind of thing. Omit for everything.
release_type	string	no	Narrow to the fields this kind of release needs. An album needs more than a single.

Audora can design a logo, cover art, brand colors and typefaces, artist photos, and promotion posts and short videos for the artist. Those are made inside Audora, not through this connection: call this to get the exact page to send the artist to, with a sentence on what they will find there. Use it whenever the artist wants a logo, artwork, a cover, visuals, photos or promo video made.

Parameter	Type	Required	Notes
what	string	yes	—
track_id	string	no	For cover_art on a single.
album_id	string	no	For cover_art on an album or EP.
artist	string	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. Le

Streams, saves and growth per track, which stores and playlists the listening comes from, TikTok use, the audience's age and gender, how the artist's promotion posts performed, and their followers. For the whole catalog, when the artist has connected their own Songstats account, it also gives their numbers across the web (listeners, followers, playlist reach, socials, Shazam, charts), the cities t

Parameter	Type	Required	Notes
track_id	string	no	One track. Leave out both ids for the whole catalog, which also includes posts, followers and audience.
album_id	string	no	Every track on one album or EP.
artist	string	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. Le

The plan, whether distribution is included, credits remaining, and the track, album and storage allowances. Check before uploading or preparing a submission.

Parameter	Type	Required	Notes
artist	string	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. Le

The artist profile as Audora holds it.

Parameter	Type	Required	Notes
artist	string	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. Le

Call this whenever the artist asks for something there is no tool for, or a tool refuses in a way you cannot work around. It files the ask in Audora's support inbox, where a person reads it, and it shows in the artist's Settings › Support. Call it before you tell the artist no. It changes nothing in their catalog, and it is the only way the ask reaches anyone.

Parameter	Type	Required	Notes
asked_for	string	yes	What the artist wanted, in their own words as far as you can keep them.
tool_tried	string	no	The tool you tried or looked for, if there was one.
note	string	no	Anything that would help Audora understand the ask.

Send Audora feedback it will read, as one of these kinds. missing_capability: a change you would need to do what the artist wants. connector_improvement: how this connector could work better for an assistant, such as a confusing tool, a missing field or a result that did not tell you enough. product_improvement: how Audora itself could serve artists better. bug: something that looks broken. other:

Parameter	Type	Required	Notes
kind	string	yes	What this is about.
summary	string	yes	One line someone at Audora can triage from. Up to 120 characters.
details	string	yes	What you or the artist were trying to do, what got in the way and the change that would have helped. Up to 5000 characters. No passwords, tokens or other secrets.
tool	string	no	The tool this is about, if it is about one.
artist_asked	boolean	no	True when the artist asked for this or said it; false or omitted when it is your own observation.

Every track in this account, newest first.

Parameter	Type	Required	Notes
artist	string	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. Le

One track with its billed artists and its song credits.

Parameter	Type	Required	Notes
track_id	string	yes	The track's id, from list_tracks.
artist	string	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. Le

Every album in this account, newest first.

Parameter	Type	Required	Notes
artist	string	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. Le

For one track or one album: everything Audora still needs before that release could be submitted, and anything worth a second look that does not block it. That includes the stores' intake rules, checked against the uploaded master and cover themselves (a stereo WAV, FLAC or Apple Lossless master at a rate the stores take; square RGB JPG 3000–6000 px). Call this after writing, and again before tell

Parameter	Type	Required	Notes
track_id	string	no	Check a single. Give this or album_id, not both.
album_id	string	no	Check an album or EP. Give this or track_id, not both.
artist	string	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. Le

Runs Audora's own lookup of what the artist has already published (streaming profiles, releases, their site and social profiles), or reads where one is and what it found. Use it only when you cannot search the web yourself: otherwise look the artist up with your own search, check with them that you found the right artist, and fill their page with update_profile. With action "start" it begins one,

Parameter	Type	Required	Notes
action	string	no	"start" a new lookup, or read its "status". Default: status.
link	string	no	For start: one page the artist is on (Apple Music, Deezer, SoundCloud, YouTube, Bandcamp, their site, Instagram), as a full https:// address. It is the best starting point. A Spotify link is kept as t
not_me	array	no	For start: names of earlier matches the artist said are not them.
dry_run	boolean	no	For start: true to read what the lookup costs without starting it.
confirm_cost_credits	number	no	For start: the price a dry run quoted and you told the artist. Needed for a lookup that is not free.
run_id	string	no	For status: a particular lookup. Default: the newest.
artist	string	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. Le

Puts a finished find_online lookup in front of the artist in Audora and returns the link to it. The artist confirms it is them and keeps what is right there. This call writes nothing to their profile, and you should not copy the findings into update_profile yourself. Their Home says their assistant found something to look at.

Parameter	Type	Required	Notes
run_id	string	no	The lookup to propose. Default: the newest.
artist	string	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. Le

Set artist details: name, country, genre, tone, description, main markets, Promo's post language, the three bios and links. Send only the fields you are changing. Call get_requirements first for the exact limits. An over-long value is refused with the number it got.

Parameter	Type	Required	Notes
fields	object	yes	The fields to set, by the name get_requirements gives each one.
dry_run	boolean	no	True to see what would change, and what it would replace, without writing anything. Use it before overwriting words the artist wrote.
artist	string	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. Le

Create a track from its metadata. The audio and the cover art are uploaded separately. Pass idempotency_key if you might retry, so a timeout does not leave two tracks.

Parameter	Type	Required	Notes
dry_run	boolean	no	True to check the call and see what it would replace, without writing anything.
fields	object	yes	The fields to set, by the name get_requirements gives each one.
idempotency_key	string	no	Send the same key if you retry, and the create happens once.
artist	string	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. Le

Amend a track's metadata. Refused once its release has been submitted: a submitted release carries a frozen copy, and changing the catalog underneath it is the artist's own decision, because it costs credits.

Parameter	Type	Required	Notes
track_id	string	yes	—
fields	object	yes	The fields to set, by the name get_requirements gives each one.
dry_run	boolean	no	True to see what would change, and what it would replace, without writing anything. Use it before overwriting words the artist wrote.
artist	string	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. Le

Replace a track's song credits with this list. Every track needs at least one songwriter, one performer and one producer before its release can be submitted. These are real people: ask the artist, and never invent a name to satisfy the requirement.

Parameter	Type	Required	Notes
dry_run	boolean	no	True to check the call and see what it would replace, without writing anything.
track_id	string	yes	—
credits	array	yes	Each entry: name, role (songwriter \| performer \| producer). A performer also takes performer_type (primary \| featured \| non_featured, default primary) and instrument, which is REQUIRED for a performer
artist	string	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. Le

Replace the OTHER artists a track is billed to: the "Artist & Guest feat. Guest" line on every store. The account's own artist is always billed first and cannot be removed. Do not send it (a name equal to it is dropped, never printed twice). Send the others in billing order. primary and with join the main credit after the account's artist; featured and remixer become the "feat." part. Anot

Parameter	Type	Required	Notes
dry_run	boolean	no	True to check the call and see what it would replace, without writing anything.
track_id	string	yes	—
rights_confirmed	boolean	no	Required as true when the list has a primary artist besides the account's own. Ask the artist first, in these words: "I have all the rights needed for this collaboration". Send true only when they c
artists	array	yes	The artists besides the account's own, in billing order. An empty list clears the billing back to the artist's own name.
artist	string	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. Le

Create an album or EP. Put tracks on it afterward with set_album_tracks.

Parameter	Type	Required	Notes
dry_run	boolean	no	True to check the call and see what it would replace, without writing anything.
fields	object	yes	The fields to set, by the name get_requirements gives each one.
idempotency_key	string	no	Send the same key if you retry, and the create happens once.
artist	string	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. Le

Amend an album's details. Refused once its release has been submitted.

Parameter	Type	Required	Notes
album_id	string	yes	—
fields	object	yes	The fields to set, by the name get_requirements gives each one.
dry_run	boolean	no	True to see what would change, and what it would replace, without writing anything. Use it before overwriting words the artist wrote.
artist	string	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. Le

Put these tracks on this album, in this order. Replaces whatever was on it. A track left out is taken off the album, not deleted.

Parameter	Type	Required	Notes
dry_run	boolean	no	True to check the call and see what it would replace, without writing anything.
album_id	string	yes	—
track_ids	array	yes	In running order.
artist	string	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. Le

Ask for a one-time address to upload a master, cover art, a logo or an artist photo to. You need the file's NAME, nothing else. Never ask the artist how big a file is. PUT the file to the address you get back, then call finalize_upload, which reads the file itself and checks the size, the format and the account's storage against it.

Parameter	Type	Required	Notes
kind	string	yes	—
filename	string	yes	The file's own name, with its extension. Audio is .wav, .flac or .m4a (Apple Lossless); images are .png, .jpg or .webp. A release going out through Audora needs a stereo master and a .jpg cover (squar
bytes	number	no	Optional. The size in bytes, IF you already know it: it saves a doomed upload. Never ask anyone for it. The server measures the file when it arrives.
mime_type	string	no	—
track_id	string	no	Required for audio; for cover art, give this or album_id.
album_id	string	no	—
artist	string	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. Le

Audora reads the file you uploaded (the file itself, not its name) and attaches it only if it meets the upload spec. A master that is secretly an MP3, or a cover that is not square or is under 3000 pixels, is refused here and the file is removed. Passing here is not the same as being releasable: a release also needs a stereo master and a square RGB JPG cover of 3000–6000 px, which check_readiness

Parameter	Type	Required	Notes
upload_id	string	yes	—
name	string	no	A short name, for an artist image.
artist	string	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. Le

Write the release details for a track or album as a DRAFT. A draft costs nothing, can be changed and goes nowhere until the artist says so. Returns a draft_hash identifying exactly what you prepared, and release_rules: everything the track or album still needs to meet the stores' rules (master format, cover, sub-genre, languages, countries, performer roles) before it can be submitted. An older tra

Parameter	Type	Required	Notes
type	string	yes	—
item_id	string	yes	The track's or album's id.
release	object	no	The release fields, by the names get_requirements(entity: "release") gives them, for example { "release_type": "single", "scheduled_date": "2026-11-20", "description": "...", "pitching_directly": "...
artist	string	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. Le

Questions Audora's reviewers asked about the artist's releases (for example, whether the rights to a remix are cleared), with the whole conversation. A release with an unanswered question does not go out until the artist answers. Omit release_id for every open question.

Parameter	Type	Required	Notes
release_id	string	no	One release, including a closed conversation. Omit for all open questions.
artist	string	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. Le

Send the ARTIST'S answer to a question Audora asked about their release (see get_release_questions). Ask the artist and relay what they say. Never answer for them and never guess: an answer can be a statement about rights or ownership that Audora relies on. Audora is told it came through their assistant. The release status does not change; Audora reads the answer and moves the release on.

Parameter	Type	Required	Notes
dry_run	boolean	no	True to check the question is open, without sending anything.
release_id	string	yes	—
answer	string	yes	The artist's answer, in their words. Up to 4000 characters.
idempotency_key	string	no	Send the same key if you retry, and the answer is sent once.
artist	string	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. Le

Every release in this account with where it has reached (status_label: Draft, Submitted, Changes asked, Going to the stores, Live, Rejected, Takedown asked, Taken down, Released elsewhere), including anything Audora asked about.

Parameter	Type	Required	Notes
artist	string	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. Le

Every Promo campaign in this account, with its window, whether it is ahead, running or over, and how many posts are to look at, scheduled, posted or did not go out. A release's campaign is kind release; between releases, a campaign is always on (kind always_on, always_on_id): it runs a month at a time on the billing period and plans its next month when the credits arrive, each month its own campai

Parameter	Type	Required	Notes
artist	string	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. Le

One campaign as Promo's calendar: every post by day and lane, with its words, hashtags, picture or video, status, and schedule_check: exactly what Audora's Schedule would decide about it now, and in the artist's words what it still needs.

Parameter	Type	Required	Notes
campaign_id	string	yes	From list_campaigns.
artist	string	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. Le

What goes out in the next days across every campaign, what in that time is not scheduled yet (and so will not go out unless it is), and what did not go out lately and needs the artist.

Parameter	Type	Required	Notes
days	number	no	How many days ahead, 1–14. Default 7.
artist	string	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. Le

The posts that went out, best first, with their latest reach, likes, comments, shares, saves and views, the totals over the window, and the followers on each connected account. A missing number is not reported yet, never zero. what_works: per platform, the angles and posting hours that have beaten the artist's usual most often, from their own posts only, with how many posts each rests on.

Parameter	Type	Required	Notes
days	number	no	How far back, 1–365 days. Default 90.
limit	number	no	How many posts to list, 1–50. Default 10.
artist	string	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. Le

Start a campaign for an upcoming release, or an always-on campaign between releases (between_releases: true): it runs from tomorrow to the day before the credits next arrive with its share of the size, then plans the whole size every month when the credits arrive, until set_always_on stops it; up to 3 run at once, and up to 5 release campaigns (CAMPAIGN_LIMIT otherwise). A release already out gets

Parameter	Type	Required	Notes
release_id	string	no	The release (from list_releases or list_campaigns' can_start). Or use between_releases.
between_releases	boolean	no	True for a new always-on campaign between releases instead of a release's.
lanes	array	yes	Where the posts go. Only lanes with a connected account are planned.
size	string	yes	light (4 moments), steady (12) or loud (18). A release campaign runs 5 weeks before release day and 2 after, its moments climbing toward release day; between releases that many every month, its first
note	string	no	Optional, ≤ 200 characters: "Anything we should know?", anything else the planner should know, in the artist's words. Left out: the last campaign's for this release, if any.
post_language	string	no	Optional: the language every post in this campaign is written in, with the text on its pictures and videos. Left out: the artist's Post language, else the language the release's songs are sung in, els
the_story	string	no	Optional, ≤ 5000 characters: "The story behind it", in the artist's own words. Where it was written, what happened, who it is for. Posts tell it in your words. Never write it for them.
key_lyrics	array	no	Optional, up to 2: "A line that matters", word for word from the song's lyrics (get_track has them). A line not in the lyrics is refused; a song with no lyrics takes a line the artist types; an instru
key_lyrics_track_id	string	no	The song the lines are from: one of the release's songs, or between releases any of the artist's. Left out: the release's songs are tried; between releases, the artist's newest songs with lyrics.
key_moments	array	no	Optional, up to 6: "Something coming up". A show, a video, a date that matters. Posts lead up to it. Left out: Scene's public shows and parties inside the campaign's days.
what_works	string	no	Optional, ≤ 2000 characters: "What worked before", in the artist's words. A post, a format or a time that did well for you. Posts can take the same shape again.
sonic_references	array	no	Optional, up to 5 names: "Artists you sound like". Left out: the Artist page's reference artists.
about	string	no	Between releases only: what the campaign is about. "song" (with about_track_id, one of the artist's songs) or "artist" (posts about who they are, their sound and their artist page; no line is kept). L
about_track_id	string	no	With about: "song", the song the campaign is about (list_tracks).
picture_fallback	string	no	Optional: what fills the posts the artist's own photos and cover do not cover, when Audora makes them. stock: free Pixabay stock photos, always made into the artist's cards (people and brands left out
lyric_video	boolean	no	Optional, with make: the campaign's first video shows the song's words in time with the song. Audora times the lyrics when the campaign starts (free), so that video comes about 10 minutes later. false
make	boolean	no	Have Audora fill every post's picture or video too: from the artist's Library first (their photos and cover as cards, and their own videos posted as they are, free to make), then made (credits; needs
dry_run	boolean	no	True to check the call and see what it would do, without writing anything.
confirm_cost_credits	number	no	The price a dry run quoted (charged_at_start) and you told the artist. Required with make, or when the plan itself has a price.
idempotency_key	string	no	Send the same key if you retry, and the change happens once.

Stop an always-on campaign between releases after its month (renew: false), or keep it on every month again (renew: true), as Promo's campaign menu does. A stopped campaign's posts this month still go out; nothing more is planned. Up to 3 are on at once.

Parameter	Type	Required	Notes
always_on_id	string	yes	From list_campaigns (always_on).
renew	boolean	yes	false: stop after this month. true: keep it on every month.
dry_run	boolean	no	True to check the call and see what it would do, without writing anything.
idempotency_key	string	no	Send the same key if you retry, and the change happens once.
artist	string	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. Le

Change a post's words, hashtags, link, day, time, its picture or video (from the Library), or the angle its words take. Send only what changes. Returns the post with schedule_check: what Schedule would decide now. A post already scheduled can be changed only with the schedule permission; one already handed to its platform's own schedule (Facebook, YouTube) or one that went out cannot be changed he

Parameter	Type	Required	Notes
post_id	string	yes	The post's id (post_id from get_campaign or promo_this_week).
caption	string	no	The words of the post, as they will be published. The lane's limit and Audora's text rules apply (no placeholders, nothing that points back at another post).
hashtags	array	no	Up to 12 hashtags, with or without #. Replaces the list.
link_url	string/null	no	A web address the post links to, or null to remove it.
date	string	no	The day it goes out, YYYY-MM-DD, inside the campaign's window and not in the past.
time	string	no	The time it goes out, HH:MM 24-hour, in the artist's own time zone.
media_asset_id	string	no	A picture (for a picture post) or a video (for a video post) already in the artist's Library, by its media asset id. Audora does not make pictures or videos through this connection.
angle	string	no	Which of Audora's post angles the words take (the key names it: listener_pov is the listener's side of the song, tail_section a part of the track no other post used, hook_object an object the song nam
dry_run	boolean	no	True to check the call and see what it would do, without writing anything.
idempotency_key	string	no	Send the same key if you retry, and the change happens once.
artist	string	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. Le

Bring a skipped post, or one that did not go out, back as a draft to schedule. A draft is already kept.

Parameter	Type	Required	Notes
post_id	string	yes	The post's id (post_id from get_campaign or promo_this_week).
idempotency_key	string	no	Send the same key if you retry, and the change happens once.
artist	string	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. Le

Skip a post so it does not go out. It stays on the campaign and keep_post brings it back. Skipping a post that is already scheduled takes it out of the queue and returns its posting credit, and needs the schedule permission.

Parameter	Type	Required	Notes
post_id	string	yes	The post's id (post_id from get_campaign or promo_this_week).
idempotency_key	string	no	Send the same key if you retry, and the change happens once.
artist	string	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. Le

Add a post to a campaign on one lane and day, as Promo's + does, with its words, the angle they take and a picture or video from the Library if you have them. It is a post on its own, not part of a moment, and a draft until it is scheduled.

Parameter	Type	Required	Notes
campaign_id	string	yes	From list_campaigns.
lane	string	yes	Where it goes.
caption	string	no	The words of the post, as they will be published. The lane's limit and Audora's text rules apply (no placeholders, nothing that points back at another post).
hashtags	array	no	Up to 12 hashtags, with or without #. Replaces the list.
link_url	string/null	no	A web address the post links to, or null to remove it.
date	string	yes	The day it goes out, YYYY-MM-DD, inside the campaign's window and not in the past.
time	string	no	The time it goes out, HH:MM 24-hour, in the artist's own time zone.
media_asset_id	string	no	A picture (for a picture post) or a video (for a video post) already in the artist's Library, by its media asset id. Audora does not make pictures or videos through this connection.
angle	string	no	Which of Audora's post angles the words take (the key names it: listener_pov is the listener's side of the song, tail_section a part of the track no other post used, hook_object an object the song nam
dry_run	boolean	no	True to check the call and see what it would do, without writing anything.
idempotency_key	string	no	Send the same key if you retry, and the change happens once.
artist	string	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. Le

Every open to-do the artist sees on their pages, most urgent first: what it is, how urgent, where it is fixed and the tool that fixes it from here. Each has a key; closable says whether close_todo can close it.

Parameter	Type	Required	Notes
artist	string	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. Le

Close one to-do the artist does not want to see, exactly as closing it in Audora does: it comes back by itself when what it is about changes. A track's or album's missing details are not closed: they are fixed.

Parameter	Type	Required	Notes
key	string	yes	The to-do's key, from list_todos.
idempotency_key	string	no	Send the same key if you retry, and the change happens once.
artist	string	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. Le

With release_id: the release's "Around the release" checklist (pitch, pre-save, Canvas, lyrics, release day and the weeks after), each with when it is due, why, where it is done and whether it is done. Without: the artist's "Set up once" list (Instagram ready to post, photos and clips for the posts, claiming the store profiles, the bio link).

Parameter	Type	Required	Notes
release_id	string	no	The release (list_releases). Leave out for "Set up once".
artist	string	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. Le

Mark one checklist item done, or not done again: the tick in Audora.

Parameter	Type	Required	Notes
todo_id	string	yes	From list_release_todos.
done	boolean	yes	—
idempotency_key	string	no	Send the same key if you retry, and the change happens once.
artist	string	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. Le

The artist's pictures or videos in Audora's Library, newest first, searchable by name and filterable by category (Brand kit, Logo, Cover art, Promo, a platform, Generated, Uploaded, Stock footage). Each has a media_asset_id (what update_post takes) and a preview link valid for an hour.

Parameter	Type	Required	Notes
kind	string	no	Pictures (default) or videos.
search	string	no	Words in the item's name, or the artist, track or album it belongs to.
categories	array	no	Only items in every one of these.
offset	integer	no	—
limit	integer	no	—
artist	string	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. Le

Switch a release on or off the list other artists on Audora see on release day, to give it a first listen. Refused for a release out more than four weeks ago or released elsewhere.

Parameter	Type	Required	Notes
release_id	string	yes	From list_releases.
on	boolean	yes	—
idempotency_key	string	no	Send the same key if you retry, and it happens once.
artist	string	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. Le

The shows, release parties and listening parties the artist has posted, with who is invited and who is coming. Artist connections only: Scene is between artists.

Parameter	Type	Required	Notes
artist	string	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. Le

Post the artist's own show, release party or listening party, or change one (pass event_id). Where: a city and a country, and/or an online link. Inviting artists or Audora stays the artist's to do in Audora; an edit keeps what they chose. Artist connections only.

Parameter	Type	Required	Notes
event_id	string	no	To change one; leave out to post a new one.
event	object	yes	—
idempotency_key	string	no	Send the same key if you retry, and the change happens once.
artist	string	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. Le

Cancel one of the artist's events. Everyone invited or coming is told. Artist connections only.

Parameter	Type	Required	Notes
event_id	string	yes	—
idempotency_key	string	no	Send the same key if you retry, and the change happens once.
artist	string	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. Le

Find which artist on Deezer (and Apple Music) is this artist, to bring their released records in: the confirmed one, or candidates to show the artist. A link to their music (Deezer, Spotify or Apple, artist or record) searches from that instead of the name.

Parameter	Type	Required	Notes
link	string	no	Optional: a link to the artist's music.
artist	string	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. Le

"That's me": record the candidates the ARTIST said are theirs (a catalog can be split across pages). Only ids find_my_music offered. Ask the artist. Never confirm on a guess.

Parameter	Type	Required	Notes
deezer_ids	array	yes	The candidates' ids the artist picked.
idempotency_key	string	no	Send the same key if you retry, and it happens once.
artist	string	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. Le

The records of the confirmed artist, newest first and 50 a page, with their codes, date and type, matched against the catalog: new, already in the catalog, or in conflict with another account. total says how many there are in all. Also the plan's room for songs and albums.

Parameter	Type	Required	Notes
deezer_album_ids	array	no	Optional: only these records.
page	integer	no	Optional: which page, 0 the newest (the default).
artist	string	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. Le

Start bringing the chosen records into the catalog, within the plan's room. Covers come in only when the artist said they are theirs to use (rights_confirmed: true, their own words, recorded as their consent); otherwise every record comes in with its codes and the cover is left to upload.

Parameter	Type	Required	Notes
items	array	yes	—
rights_confirmed	boolean	no	Only true when the artist said the covers are theirs to use.
idempotency_key	string	no	Send the same key if you retry, and it happens once.
artist	string	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. Le

The latest import (or the one named): how many records are in, and each record's outcome.

Parameter	Type	Required	Notes
job_id	string	no	—
artist	string	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. Le

Where are you running it?

Tool surface

Release history

Audora MCP

What it does

Quickstart

Where are you running it?

Tool surface

What counts against your monthly calls

Release history

See also