music nerd

Artist bioSuggest a Lore source

Artist bio

Suggest a Lore source

Adds a public web page to the artist's vault as a suggested Lore source, for any signed-in user. An admin's or whitelisted contributor's source is approved at once and a Lore refresh is queued; anyone else's waits for review, with sourceStatus pending. A URL already in the vault, with or without its fragment, is refused.

POST/api/artist/{id}/lore-suggestions
POST/api/artist/aab92f80-f9e1-4299-aa33-7dd85c8de5d3/lore-suggestions

Adds a public web page to the artist's vault as a suggested Lore source, for any signed-in user. An admin's or whitelisted contributor's source is approved at once and a Lore refresh is queued; anyone else's waits for review, with sourceStatus pending. A URL already in the vault, with or without its fragment, is refused.

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 POST \
  --url 'https://musicnerd-api.vercel.app/api/artist/aab92f80-f9e1-4299-aa33-7dd85c8de5d3/lore-suggestions' \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "https://www.styleweekly.com/bio-ritmo-at-30/"
}'

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
urlstringrequired

A public http(s) page. A bare domain gets https://; the fragment is dropped. IP addresses and private or local hosts are refused.

maxLength: 2048

Response

application/json

The source was saved. sourceStatus is approved for a trusted contributor (a Lore refresh is queued) or pending for review. warning is present when the source was approved but the Lore refresh could not be queued.

statusstring · enumrequired

Values: "ok"

successboolean · enumrequired

Values: true

sourceStatusstring · enumrequired

approved for an admin's or whitelisted contributor's source; pending for review.

Values: "approved", "pending"

warningstring

Present when the source was approved but the Lore refresh could not be queued.