music nerd

Artist imagesSet the header position

Artist images

Set the header position

Saves how far down the artist's header image is framed, as a percentage, together with the image it applies to. Choosing a different provider photo later clears it.

PATCH/api/artist/header-position
PATCH/api/artist/header-position

Saves how far down the artist's header image is framed, as a percentage, together with the image it applies to. Choosing a different provider photo later clears it.

Authorization

Authorizationstringrequired

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. Kept in this tab only.

Body
cURL
curl --request PATCH \
  --url 'https://musicnerd-api.vercel.app/api/artist/header-position' \
  --header 'Content-Type: application/json' \
  --data '{
  "artistId": "aab92f80-f9e1-4299-aa33-7dd85c8de5d3",
  "imageUrl": "https://e-cdns-images.dzcdn.net/images/artist/0a1b2c3d4e5f/1000x1000-000000-80-0-0.jpg",
  "y": 35
}'

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. The user must be the artist's approved claimant or a Music Nerd admin.

Body

application/jsonrequired
artistIdstringrequired

The artist's ID.

format: uuid

imageUrlstringrequired

The header image the position applies to: a site-relative path starting with one /, or an https URL without credentials.

maxLength: 4096

yintegerrequired

How far down the image is framed, as a percentage.

minimum: 0 · maximum: 100

Response

application/json

The position was saved.

statusstring · enumrequired

Values: "ok"

successboolean · enumrequired

Values: true