The provider photos an artist can pick as their profile photo: one option each for Deezer and Spotify, from the IDs linked on the artist. expectedCustomImage is the current photo; pass it to Choose a provider photo so a stale choice is refused.
GET/api/artist/photo-choice
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. The user must be the artist's approved claimant or a Music Nerd admin.
Query Parameters
artistIdstringrequired
The artist's ID (a UUID).
Response
application/json
The two provider options. Cache-Control: no-store.
statusstring · enumrequired
Values: "ok"
expectedCustomImagestring | nullrequired
The artist's current customImage. Send it back as expectedCustomImage when choosing.
optionsarray<object>required
One entry per provider, Deezer first, whether or not the artist has that provider linked.
Item properties for options
sourcestring · enumrequired
Which provider the photo comes from.
Values: "deezer", "spotify"
providerIdstring | nullrequired
The provider ID linked on the artist, trimmed; null when none is linked.
imageUrlstring | nullrequired
The provider's photo for that ID (https only); null when there is no ID, no photo, or the provider could not be reached.