Developer docs

Send a file from your computer

MCP tool
create_upload
CLI
kinetune uploads create
POST/api/v1/uploads

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

A signed upload URL for a local file, and the file_url to use it

For an agent that has a file on the person's computer but can only pass URLs (the CLI sends files itself): returns upload_url, where you PUT the file's bytes within an hour with the headers given, e.g. curl -X PUT -H "content-type: image/png" --upload-file desk.png "<upload_url>"; then pass file_url in any *_url field within a day: create_song (audio_url, cover_art_url), add_kit_piece (file_url), start_character (photo_urls), upload_background (file_url), set_artist_image (image_url). That field checks the file like an upload (format, size, rights) and keeps its own copy; this one is deleted after a day. size_bytes must be the file's exact size (up to 300 MB), content_type its type. Up to 100 files a day; without a plan, only a free song's audio and cover.

headerAuthorizationBearer <token>

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

application/json
  1. body
filename*string

The file's name, e.g. desk.png (kept on the stored copy)

Match^[^/\\\u0000-\u001f]+$
Length1 <= length <= 200
content_type*string

Its type: audio/mpeg, audio/wav, audio/mp4, image/jpeg, image/png, image/webp, video/mp4, video/quicktime or video/webm

Value in"audio/mpeg""audio/wav""audio/mp4""image/jpeg""image/png""image/webp""video/mp4""video/quicktime""video/webm"
size_bytes*integer

Its exact size in bytes (the upload must match it)

Range1 <= value <= 314572800

Response Body

OK

application/json
  1. response
upload_url*string

PUT the file's bytes here, with the headers below, within the hour

method*string
headers*

Send these with the PUT (content-type); content-length must be size_bytes

file_url*string

Once the file is sent: pass it in the *_url field (audio_url, cover_art_url, file_url, photo_urls, image_url) within a day

upload_expires_at*string
file_expires_at*string
uploads_per_day*integer
Range-9007199254740991 <= value <= 9007199254740991
[key: string]?unknown
Example Request
curl -X POST 'https://kinetune.com/api/v1/uploads' \
  -H 'Content-Type: application/json' \
  -d '{
  "filename": "string",
  "content_type": "audio/mpeg",
  "size_bytes": 1
}'
Example Response
{
  "upload_url": "string",
  "method": "PUT",
  "headers": {
    "property1": "string",
    "property2": "string"
  },
  "file_url": "string",
  "upload_expires_at": "string",
  "file_expires_at": "string",
  "uploads_per_day": -9007199254740991,
  "property1": null,
  "property2": null
}