Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.patchline.ai/llms.txt

Use this file to discover all available pages before exploring further.

Your roster is the set of artists Patchline tracks intelligence for — yours, your label’s, your roster as a manager, or artists you’re scouting. Each roster artist gets a full intelligence profile built from licensed music and audience data, then refreshed automatically.   Connected-artist limits: Free 1 · Starter 1 · Pro 5 · Scale 20 · Enterprise unlimited.

​
Why platform URL only

You cannot add an artist by name alone. Many artists share names — “Tessa,” “Mira,” “Cloud” — and name-only matching produces wrong artists ~30% of the time at scale. So Patchline requires a platform URL that uniquely identifies the artist. Supported URL types:
  • Spotify: https://open.spotify.com/artist/...
  • Apple Music: https://music.apple.com/.../artist/.../...
  • YouTube: https://youtube.com/@channelname or channel URL
  • SoundCloud: https://soundcloud.com/username
  • TikTok: https://tiktok.com/@username
  • Instagram: https://instagram.com/username
Spotify is most common and most informative. Use Spotify if you have it.

​
How to add an artist

​
Via the UI

Sidebar → Artists → + Add artist → paste platform URL → Add.

​
Via Aria

​
Via MCP

Programmatic adds work the same — URL required, name-only rejected.

​
What happens after you add

  1. Immediate: artist row appears in /dashboard/artists with the platform-supplied basics (name, profile pic, URL).
  2. Background (10–60 seconds): artist intelligence refreshes. Streaming stats, social audience, genre tags, and top tracks populate when available.
  3. Background (1–5 minutes): AI bio generation — get_bio populates the bio cache for fast lookups later (no live LLM call needed for future bio queries).
  4. Background (~daily): ongoing intelligence refresh keeps the profile current.
You can use the artist (search, link to releases, query intel) before the background enrichment completes. The profile just gets richer over time.

​
Removing an artist

Roster row → ⋯ → Remove. Or via Aria: Removal frees a slot against your roster cap. Historical intelligence stays in Patchline (you can re-add and pick up where you left off).

​
Tier limits

TierConnected artists
1
1
5
20
Unlimited
If you hit the cap, add_artist returns 403 with the upgrade-path message.

​
Best practices

  • Add your own artist first if you’re an artist (your roster cap starts at 1 on Free/Starter).
  • For managers / labels, add the artists in priority order — enrichment runs sequentially, so the first-added artist is fully intel-rich fastest.
  • Re-add an artist if their URL changed (rare — labels sometimes re-launch profiles).

​
FAQ

Many artists share names. Even unique-sounding names (“Mira”, “Tessa”) can map to many artists across platforms. Platform URL is the only safe identifier.
Enrichment returns partial data — name, profile pic from the platform, no streaming stats. The artist still appears in the roster and can be referenced in releases, just with limited intel.
Initial enrichment uses current provider-backed data when available. Background refresh runs daily.
Yes — each workspace has its own roster. Cross-workspace artists are tracked separately by workspace.
No — that’s a separate flow (catalog import). add_artist adds intelligence; analyze_url + import adds catalog. You can do both for the same artist.