music nerd

OnboardingStart the claim build

Onboarding

Start the claim build

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
POST/api/onboarding/aab92f80-f9e1-4299-aa33-7dd85c8de5d3/build

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.

Authorization

Authorizationstringrequired

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. Kept in this tab only.

Path

artistIdstringrequired

The artist's ID (a UUID).

cURL
curl --request POST \
  --url 'https://musicnerd-api.vercel.app/api/onboarding/aab92f80-f9e1-4299-aa33-7dd85c8de5d3/build'

Send the request to see the live response here.

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.