Developer docs

Set the artist picture

MCP tool
set_artist_picture
CLI
kinetune artists picture
POST/api/v1/artists/{artist_id}/picture

Not sent from the docs: it changes your workspace. Run it with curl, the CLI or its MCP tool.

Choose which photo is the artist’s picture, and how it is cropped to a square

The picture (image_url on the artist, a 512 px square) is cut from one of the artist’s photos; the photo itself is unchanged. The first photo becomes the picture automatically, centered. crop is in fractions of the photo (its url): x/y the top-left corner, size the side relative to the photo’s short side; leave it out to center.

Authorization

headerAuthorizationBearer <token>

An organization API key (kt_live_…) or an OAuth access token

Path Parameters

artist_id*string

The artist id

Length1 <= length <= 120

Request Body

application/json
  1. body
photo_id*string

One of the artist’s photos (list_artist_photos)

Length1 <= length <= 120
crop?

The square to keep, in fractions of the photo; centered when omitted

Response Body

OK

Example Request
curl -X POST 'https://kinetune.com/api/v1/artists/string/picture' \
  -H 'Content-Type: application/json' \
  -d '{
  "photo_id": "string"
}'
Example Response
Empty