music nerd

Artist bioRead the About

Artist bio

Read the About

The artist's About as the profile shows it: the saved bio for a claimed artist, otherwise the directory's prepared About when it is still current, otherwise the claim prompt. With regenerate=true the caller must be the artist's claimant or an admin; the About is rewritten from the artist's Lore and saved, with the previous text kept in the bio history.

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

The artist's About as the profile shows it: the saved bio for a claimed artist, otherwise the directory's prepared About when it is still current, otherwise the claim prompt. With regenerate=true the caller must be the artist's claimant or an admin; the About is rewritten from the artist's Lore and saved, with the previous text kept in the bio history.

Path

idstringrequired

The artist's ID (a UUID).

Query

regeneratestring

true rewrites the About from the Lore document instead of reading it. Requires the claimant's or an admin's token.

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

Send the request to see the live response here.

Authorizations

None. This endpoint is public.

Path Parameters

idstringrequired

The artist's ID (a UUID).

Query Parameters

regeneratestring · enum

true rewrites the About from the Lore document instead of reading it. Requires the claimant's or an admin's token.

Values: "true"

Response

application/json

The About. A read carries Cache-Control: private, no-store. A regeneration returns the new bio, or the unchanged bio with pinned: true when a version is pinned.

Cache-Controlresponse header

private, no-store on a read.

oneOf · ArtistAbout 1
statusstring · enumrequired

Values: "ok"

biostringrequired

The saved bio for a claimed artist; otherwise the directory About's text, or the claim prompt when there is nothing verified to show.

publicAboutone ofrequired

The directory About for an unclaimed artist, or null.

Properties for publicAbout
oneOf · PublicArtistAbout 1

The directory's prepared About for an unclaimed artist, with the sources it cites. Only returned while the artist's links and sources still match what it was written from.

biostringrequired
kindstring · enumrequired

official when it rests on the artist's own page or account; researched otherwise.

Values: "official", "researched"

sourcesarray<object>required
Item properties for sources
idstringrequired
urlstringrequired
labelstringrequired
oneOf · null 2

null

oneOf · RegeneratedBio 2
statusstring · enumrequired

Values: "ok"

biostring | nullrequired

The About now saved.

pinnedboolean

true when a pinned version blocked the regeneration; bio is the unchanged About.

messagestring