Developer docs

Link an artist to their released songs

MCP tool
link_artist
CLI
kinetune artists link
POST/api/v1/artists/{artist_id}/catalog

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

Set the artist’s catalog profile, once: their released songs are then listed to import

Available to Artist and Label workspaces. Send catalog_artist_id from find_artist_in_catalog with catalog_confirmed=true after the user confirms they manage the selected profile. The artist names must match exactly. Also sets their Apple Music link (links.apple_music) unless one is set. Linking again replaces it; unlink with update_artist catalog_artist_id null. Then list_released_songs and import_songs.

headerAuthorizationBearer <token>

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

artist_id*string

The artist id

Length1 <= length <= 120
application/json
  1. body
catalog_artist_id*string

Their catalog profile id (find_artist_in_catalog)

Match^\d{1,15}$
catalog_confirmed?boolean

Set true after the user confirms they manage the selected artist

Response Body

OK

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