music nerd

Artist bioSave or regenerate the About

Artist bio

Save or regenerate the About

Saves the About the artist wrote, or with regenerate: true rewrites it from the artist's Lore, for the approved claimant or an admin. Both the old and the new text are kept in the bio history, and a pinned bio is never replaced.

PUT/api/artistBio/{id}
PUT/api/artistBio/aab92f80-f9e1-4299-aa33-7dd85c8de5d3

Saves the About the artist wrote, or with regenerate: true rewrites it from the artist's Lore, for the approved claimant or an admin. Both the old and the new text are kept in the bio history, and a pinned bio is never replaced.

Authorization

Authorizationstringrequired

The signed-in user's access token. Copy it at https://musicnerd.net/access after signing in. Each operation says who may call it: any signed-in user, or the artist's approved claimant or a Music Nerd admin. Kept in this tab only.

Path

idstringrequired

The artist's ID (a UUID).

Body
cURL
curl --request PUT \
  --url 'https://musicnerd-api.vercel.app/api/artistBio/aab92f80-f9e1-4299-aa33-7dd85c8de5d3' \
  --header 'Content-Type: application/json' \
  --data '{
  "bio": "Bio Ritmo is a 10-piece salsa band from Richmond, Virginia."
}'

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. Each operation says who may call it: any signed-in user, or the artist's approved claimant or a Music Nerd admin.

Path Parameters

idstringrequired

The artist's ID (a UUID).

Body

application/jsonrequired
biostring

The About to save. Required unless regenerate is true; at most 10,000 characters.

maxLength: 10000

regenerateboolean

Rewrite the About from the Lore document instead of saving bio.

Default: false

Response

application/json

Saved, or regenerated. A regeneration returns the About that is now saved and a message saying whether it changed.

statusstring · enumrequired

Values: "ok"

messagestringrequired
biostring

After a regeneration: the About now saved.