Send a file from your computer
- MCP tool
create_upload- CLI
kinetune uploads create
/api/v1/uploadsNot 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.
AuthorizationBearer <token>An organization API key (kt_live_…) or an OAuth access token
application/json- body
filename*stringThe file's name, e.g. desk.png (kept on the stored copy)
^[^/\\\u0000-\u001f]+$1 <= length <= 200content_type*stringIts type: audio/mpeg, audio/wav, audio/mp4, image/jpeg, image/png, image/webp, video/mp4, video/quicktime or video/webm
"audio/mpeg""audio/wav""audio/mp4""image/jpeg""image/png""image/webp""video/mp4""video/quicktime""video/webm"size_bytes*integerIts exact size in bytes (the upload must match it)
1 <= value <= 314572800OK
application/json- response
upload_url*stringPUT the file's bytes here, with the headers below, within the hour
method*stringheaders*Send these with the PUT (content-type); content-length must be size_bytes
file_url*stringOnce 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*stringfile_expires_at*stringuploads_per_day*integer-9007199254740991 <= value <= 9007199254740991[key: string]?unknowncurl -X POST 'https://kinetune.com/api/v1/uploads' \
-H 'Content-Type: application/json' \
-d '{
"filename": "string",
"content_type": "audio/mpeg",
"size_bytes": 1
}'{
"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
}