Create New Artist

The canonical recipe used internally by Recoup's chat agent. Follow it step-by-step to bring a brand-new artist account up to "researched + enriched" parity from a sandbox or any external agent.

The chain is 8 sequential API calls. Long deterministic chains executed from prose memory tend to drop steps — the agent reads the doc once, runs a couple of calls, and forgets the rest. Drive the work from the RECOUP.md checklist file scaffolded by the artist-workspace skill: tick each box and persist captured values back to the frontmatter as you go. The file IS the workflow state, and a fresh turn can resume by reading it.

Prerequisites

• $RECOUP_ACCESS_TOKEN — Bearer token for api.recoupable.com
• $RECOUP_ORG_ID — the org the artist should belong to (recommended in sandboxes)
• An artist name to create (e.g. ARTIST_NAME="The Weeknd")
• The artist's RECOUP.md already scaffolded (see artist-workspace skill, Step 0)

The flow has three phases, all driven from the single checklist file:

1. Create + identify — POST /api/artists, then find the canonical Spotify match
2. Enrich — PATCH the artist with image/label/socials, then run structured research (Chartmetric profile/career/playlists) plus a web search for narrative context and additional socials
3. Synthesize + persist — generate a knowledge-base report, save it (RECOUP.md tree or hosted URL), then optionally PATCH the knowledges array