music.audora/audora

Tools

• add_post

  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 draft until it is scheduled.

  shallow
• answer_release_question

  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.

  shallow
• cancel_event

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

  shallow
• catalog_import_status

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

  shallow
• check_readiness

  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 (WAV 16/24-bit 44.1 kHz stereo; square RGB JPG 3000–6000 px). Call this after writing, and again before telling the artist something is ready.

  shallow
• close_todo

  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.

  shallow
• confirm_my_music

  "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.

  shallow
• create_album

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

  shallow
• create_track

  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.

  shallow
• design_in_audora

  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.

  shallow
• finalize_upload

  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 WAV 16/24-bit 44.1 kHz stereo master and a square RGB JPG cover of 3000–6000 px, which check_readiness reports on.

  shallow
• find_my_music

  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.

  shallow
• find_online

  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, which takes 1–2 minutes; the artist gets a few a day, shared with Soundcheck in Audora. The account's first lookup is free and each later one costs credits and needs the artist's spend permission: start with dry_run: true to read the price, tell the artist, then start with confirm_cost_credits. With action "status" (the default) it reads the newest lookup, or the one named by run_id. Every fact comes with the pages it was read on. It never changes the artist's profile: when it is done, call propose_profile so the artist keeps what is theirs in Audora.

  shallow
• get_campaign

  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.

  shallow
• get_limits

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

  shallow
• get_profile

  The artist profile as Audora holds it.

  shallow
• get_release_questions

  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.

  shallow
• get_requirements

  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.

  shallow
• get_stats

  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 they are listened to in now, the playlists carrying them and dated events. The same numbers the artist sees in Audora. Use it to answer "how is my release doing", to write a pitch or bio from real numbers, or to suggest where to focus next. When a figure is missing, say "not reported yet", never zero.

  shallow
• get_track

  One track with its billed artists and its song credits.

  shallow
• import_catalog

  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.

  shallow
• keep_post

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

  shallow
• list_albums

  Every album in this account, newest first.

  shallow
• list_campaigns

  Every Promo campaign in this account (one per release, plus the posts between releases), 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. Also lists upcoming releases that have no campaign yet, and campaigns being planned right now.

  shallow
• list_events

  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.

  shallow
• list_media

  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.

  shallow
• list_release_todos

  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).

  shallow
• list_releases

  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.

  shallow
• list_todos

  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.

  shallow
• list_tracks

  Every track in this account, newest first.

  shallow
• preview_catalog_import

  Every record of the confirmed artist with its codes, date and type, matched against the catalog: new, already in the catalog, or in conflict with another account. Also the plan's room for songs and albums.

  shallow
• promo_results

  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.

  shallow
• promo_this_week

  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.

  shallow
• propose_profile

  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.

  shallow
• report_gap

  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.

  shallow
• request_upload

  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.

  shallow
• save_event

  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.

  shallow
• save_release_draft

  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 track or album usually needs some of it.

  shallow
• send_feedback

  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: anything else. It goes into Audora's support inbox and shows in the artist's Settings › Support, so write it for a person: what you were trying to do, what got in the way and what would have helped. Use it when you notice something worth fixing. You do not need the artist's permission, but set artist_asked to true when the artist asked for it. For a plain "there is no tool for that", report_gap is enough.

  shallow
• set_album_tracks

  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.

  shallow
• set_first_listen

  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.

  shallow
• set_todo_done

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

  shallow
• set_track_artists

  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. Another `primary` artist is a collaboration: ask the artist whether they have all the rights needed for it, and send rights_confirmed: true only when they say yes. Without it the call is refused and nothing is written. `featured`, `with` and `remixer` need no confirmation. Optional: a track with none is billed to the artist profile's own name. The songwriter, performer and producer credits are a different list, set with set_track_credits.

  shallow
• set_track_credits

  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.

  shallow
• skip_post

  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.

  shallow
• start_campaign

  Start a campaign for an upcoming or released release, or the posts between releases. Audora plans it (every post's day, time, words and lane) for free; fill each post from the artist's Library with update_post, or, with the artist's spend permission, have Audora make the pictures and videos (make: true, priced first). Each post costs 1 credit when it goes out, set aside when it is scheduled. The answers about the song (the_story, key_lyrics, key_moments, what_works, sonic_references, note) are the Start panel's: optional, filled from what Audora knows when left out, and they turn on posts that use them. Use dry_run first to see the posts, the price and those answers (quote.answers), and tell the artist.

  shallow
• update_album

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

  shallow
• update_post

  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 here.

  shallow
• update_profile

  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.

  shallow
• update_track

  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.

  shallow
• whoami

  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.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/2f08e3f9-a3d2-4d88-997c-213a623ab961/badge.svg)](https://vouch.tools/servers/2f08e3f9-a3d2-4d88-997c-213a623ab961)