music nerd

OnboardingReset the claim build

Onboarding

Reset the claim build

Removes everything the claim build wrote and returns the removed values as the backup. Afterwards the state endpoint reports currentStep: "profiles", and visiting the artist page starts a fresh build. The artist's own edits, uploads and interview answers stay. Spotify and Deezer identities and their mappings are preserved. Use the authenticated profile editor to disconnect a catalog identity; build reset is not identity removal.

POST/api/onboarding/{artistId}/reset
POST/api/onboarding/aab92f80-f9e1-4299-aa33-7dd85c8de5d3/reset

Removes everything the claim build wrote and returns the removed values as the backup. Afterwards the state endpoint reports currentStep: "profiles", and visiting the artist page starts a fresh build. The artist's own edits, uploads and interview answers stay. Spotify and Deezer identities and their mappings are preserved. Use the authenticated profile editor to disconnect a catalog identity; build reset is not identity removal.

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/reset'

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.

Path Parameters

artistIdstringrequired

The artist's ID (a UUID).

Response

application/json

The removed values, as a backup.

statusstring · enumrequired

Values: "ok"

removedobjectrequired
Properties for removed
stepsarray<string>required

The step names that were confirmed, now deleted.

Item properties for steps

string

linksobjectrequired

The link columns that had values, now null. Keys are column names; values are the old handles or IDs.

biostring | nullrequired

The bio text that was removed, or null if there was none.

docbooleanrequired

Whether a Lore document was deleted.

sourcesintegerrequired

How many research vault sources were deleted.

jobsintegerrequired

How many pending or running research jobs were deleted.