Starts building a claimed artist's profiles, sources, Lore and About on the server and returns right away; only one build runs per artist, whether or not anyone keeps the page open. Search-provider failures leave the affected stage unconfirmed and retain partial saved links and sources, so calling again can resume without deleting content; successful searches with no matches can complete. Older runs already marked complete still return started: false and need separate recovery. Follow progress with Onboarding state.
POST/api/onboarding/{artistId}/build
Authorizations
Authorizationstringheaderrequired
Bearer authentication header of the form Bearer <token>. The signed-in user's access token. Copy it at https://musicnerd.net/access after signing in. The user must be the artist's approved claimant or a Music Nerd admin.
X-MusicNerd-Research-Keystringheaderrequired
Server-only MUSICNERD_RESEARCH_API_KEY. Music Nerd's site sends it when an admin approves a claim. Never sent from a browser.
Path Parameters
artistIdstringrequired
The artist's ID (a UUID).
Response
application/json
Whether a build started. started: false means the page is already built.
statusstring · enumrequired
Values: "ok"
startedbooleanrequired
True when a build run was started. False when the page was already built.
runIdstring | nullrequired
The workflow run's ID, for support and logs. null when nothing started.