Example prompts

These are prompts we use ourselves. Each one is a whole workflow the assistant carries out by chaining tools, so you do not need to name the tools.

Find music for a brief

A sync supervisor needs a warm, mid-tempo indie-folk instrumental for a coffee ad, 60–90 seconds, no vocals. Shortlist five and build a playlist I can send them.

Uses search_tracks (with hasVocals: false and a duration window), create_playlist, then returns the public link from get_playlist.

Clean up tags across a batch

Tag everything I uploaded this week, then show me the suggestions you're least sure about before applying anything.

Uses list_tracks (sorted by -created_at), batch_auto_tag, wait_for_auto_tag, get_suggested_tags, and apply_suggested_tags only after you confirm.

Fix metadata in bulk

Every track whose artist is "koens" should be "Koen Schuite", and add the record label "Postal Records" where it's empty.

Uses list_tracks and update_track_details per track.

Replace a track's audio

Here is the final master for "Alpha": https://cdn.example.com/alpha_master.wav. Swap it in, label it "master", and keep the old mix in the history.

Uses list_tracks to find the track, upload_track_version (active by default, so playlists and share links pick up the new file), then list_track_versions to confirm which version is active.

Weekly report

Give me a short weekly update: uploads, listens, downloads, and my three most-played tracks this month.

Uses get_dashboard and get_top_tracks with a since date.

Find duplicates before a delivery

I'm delivering the catalogue to a distributor next week. Are there any duplicate files I should merge first?

Uses find_duplicate_tracks. Tracks without a content hash are listed under missingCid; ask the assistant to trigger analysis for those.

Keep composer records in sync

Here's a CSV of our writers with PRO and IPI numbers. Make sure every one of them exists as a composer in Postal, and update the ones that changed.

Uses list_composers, create_composer and update_composer.

Trace a pitch

Where has "Night Drive (v3)" been submitted, and did any of those briefs close?

Uses list_tracks to resolve the id, then get_track_submissions.

Tips

• Say what must be true. BPM windows, "instrumental only", a key or a language are hard filters on search_tracks. Put them in the prompt as constraints and the assistant will pass them as parameters instead of hoping the ranking gets it right.
• Ask for the taxonomy first when setting tags by hand. Invalid tag names are rejected.
• Search costs credits. One credit per search_tracks call by default. Listing and filtering by name or tag is free.