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
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.