Developer docs

Add artist photos

MCP tool
add_artist_photos
CLI
kinetune artists photos add
POST/api/v1/artists/{artist_id}/photos

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

Upload one or more photos of the artist (JPEG, PNG or WebP)

As many as your plan's storage holds (up to 20 an upload), at least 512 px on the short side, up to 15 MB each. hidden keeps them off the artist's photos, for photos meant for one music video only (pass their ids in its cast). Only with the rights to use them (rights_confirmed). They are identity references only: never shown publicly or used as they are. Each is kept upright at up to 1536 px, with a small thumbnail; the uploaded file itself is not kept. Needs an active plan (402 plan_required without one; get_account: plan.active) and room in its storage (402 storage_full when it would not fit; get_account: storage).

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

  1. body
photo_urls?array<>

Public https URLs of the photos (or upload files with the CLI)

Items1 <= items <= 20
rights_confirmed*boolean

You have the rights to use these photos of the artist

hidden?boolean

true: only for a music video, kept off the artist's photos (default false)

Response Body

OK

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