music nerd

Artist linksSet or clear an artist link

Artist links

Set or clear an artist link

Writes one platform link straight onto the artist, for the approved claimant or an admin, and returns the platform written. set reads the platform and ID from url: song and album URLs are refused, and an Apple Music or Beatport artist page is saved as an approved Lore source instead (siteName is then applemusic or beatport). clear empties the platform's link. For Spotify or Deezer, disconnect requires expectedValue, the account ID actually displayed to the user (explicit null means an empty slot). The server rechecks the current identity, claim generation and authorization, archives the complete matching mapping provenance privately, removes that active mapping, clears the direct link and cancels pending identity-match jobs atomically. A stale or divergent mapping is refused for review. No exclusion is added, and a later explicit valid replacement still uses normal collision checks. The private archive is not returned.

POST/api/directEditLink
POST/api/directEditLink

Writes one platform link straight onto the artist, for the approved claimant or an admin, and returns the platform written. set reads the platform and ID from url: song and album URLs are refused, and an Apple Music or Beatport artist page is saved as an approved Lore source instead (siteName is then applemusic or beatport). clear empties the platform's link. For Spotify or Deezer, disconnect requires expectedValue, the account ID actually displayed to the user (explicit null means an empty slot). The server rechecks the current identity, claim generation and authorization, archives the complete matching mapping provenance privately, removes that active mapping, clears the direct link and cancels pending identity-match jobs atomically. A stale or divergent mapping is refused for review. No exclusion is added, and a later explicit valid replacement still uses normal collision checks. The private archive is not returned.

Authorization

Authorizationstringrequired

The signed-in user's access token. Copy it at https://musicnerd.net/access after signing in. Link writes need the artist's approved claimant or a Music Nerd admin; removeArtistData accepts any whitelisted user too. Kept in this tab only.

Body
cURL
curl --request POST \
  --url 'https://musicnerd-api.vercel.app/api/directEditLink' \
  --header 'Content-Type: application/json' \
  --data '{
  "artistId": "6cb3d81a-3d02-4c57-a711-bb7902a9af1b",
  "action": "set",
  "url": "https://www.instagram.com/p3t3rango/"
}'

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. Link writes need the artist's approved claimant or a Music Nerd admin; removeArtistData accepts any whitelisted user too.

Body

application/jsonrequired
artistIdstringrequired

format: uuid

actionstring · enumrequired

Values: "set", "clear"

urlstring

The profile URL to save. Required for set.

siteNamestring

The platform column to empty. Required for clear.

expectedValuestring | null

Required for Spotify/Deezer clear. Send the displayed account ID, not a freshly inferred replacement. Explicit null means already disconnected; omission is invalid. Other platforms do not require it.

minLength: 1

Response

application/json

Written. siteName and platformName come back for set; platformName is the urlmap display name and may be null.

statusstring · enumrequired

Values: "ok"

successbooleanrequired
siteNamestring

The column written, or applemusic / beatport for a source-backed link.

platformNamestring | null
changedboolean

For ordinary profile-link set only: whether the stored ID changed. Omitted for clear and source-backed additions.