Import released songs
import_songsBring 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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"artist_id": "<artist_id>",
"track_ids": "<track_ids>"
},
"name": "import_songs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| artist_id | Yes | The artist id | |
| track_ids | Yes | The released songs’ ids (list_released_songs) | |
| distinct_track_ids | No | Selected releases the user confirmed are distinct from possible duplicates |