Developer docs

Import released songs

MCP tool
import_songs
CLI
kinetune songs import
POST/api/v1/song-imports

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

Bring in released songs of a linked artist by their track ids, without uploading

Each track (list_released_songs: id) becomes an import: Kinetune fetches the song’s audio (about half a minute each), then the song is made with the release’s title and cover and analyzed like an upload; poll get_song_import or list_song_imports (status queued, fetching, done with song_id, or failed with why). A song we can’t fetch fails, and the user adds the file to it instead (add_song_import_audio). Songs already in the workspace or being imported are skipped (skipped: track_id and reason). Up to 50 at once, and a daily number per workspace (429 daily_limit). Only the user’s own songs: confirm they own or have the rights to them. 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). Without a plan, the user’s free song covers one import.

headerAuthorizationBearer <token>

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

application/json
  1. body
artist_id*string

The artist id

Length1 <= length <= 120
track_ids*array<>

The released songs’ ids (list_released_songs)

Items1 <= items <= 50
distinct_track_ids?array<string>

Selected releases the user confirmed are distinct from possible duplicates

Itemsitems <= 50

Response Body

OK

Example Request
curl -X POST 'https://kinetune.com/api/v1/song-imports' \
  -H 'Content-Type: application/json' \
  -d '{
  "artist_id": "string",
  "track_ids": [
    "string"
  ]
}'
Example Response
Empty