Developer docs

Add the file to a song import

MCP tool
add_song_import_audio
CLI
kinetune songs import-audio
POST/api/v1/song-imports/{import_id}/audio

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

Give the audio of a released song Kinetune couldn’t fetch

The song is made from the file with the release’s title and cover (MP3, WAV or M4A up to 250 MB), and analyzed. For a failed import (or one still queued).

headerAuthorizationBearer <token>

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

import_id*string

The import id (import_…)

Length1 <= length <= 120
  1. body
audio_url?string

A public https URL of the song’s audio (a file on your computer: create_upload, then its file_url)

Formaturi
Lengthlength <= 2000

Response Body

OK

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