Import released songs
- MCP tool
import_songs- CLI
kinetune songs import
/api/v1/song-importsNot 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.
AuthorizationBearer <token>An organization API key (kt_live_…) or an OAuth access token
application/json- body
artist_id*stringThe artist id
1 <= length <= 120track_ids*array<>The released songs’ ids (list_released_songs)
1 <= items <= 50distinct_track_ids?array<string>Selected releases the user confirmed are distinct from possible duplicates
items <= 50curl -X POST 'https://kinetune.com/api/v1/song-imports' \
-H 'Content-Type: application/json' \
-d '{
"artist_id": "string",
"track_ids": [
"string"
]
}'