create_upload

Upload a local file (up to 5 GB) to mixetape storage. Returns uploadUrl, a presigned URL valid for 6 hours: send the whole file in one PUT with exactly the returned Content-Type header — the returned curl command does it (replace ). No API key is needed for the PUT. Then use url (r2://…) as mediaUrl in create_post; publicUrl (media.mixetape.com) is the same file for services outside mixetape. For a file already on the web use import_file. Needs the storage permission. Also available as the MCP tool create_upload.

POST

https://mixetape.com/api/v1/tools/create_upload

View as Markdown

Authorisation

apiKeyHTTPrequired

Request bodyJSONrequired

fileNamestringrequired
contentTypeoptionalstring
e.g. "video/mp4", "image/jpeg"
sizeoptionalnumber
Size in bytes, to refuse files over 5 GB early

Returns

200

The tool's result.

JSON

resultunknownrequired
What the tool returns

400

The request is invalid; error says why.

JSON

errorstringrequired
What went wrong, in plain words

401

No valid API key.

JSON

errorstringrequired
What went wrong, in plain words

403

The key lacks the permission this needs.

JSON

errorstringrequired
What went wrong, in plain words

404

Not found, or not yours.

JSON

errorstringrequired
What went wrong, in plain words

curl --request POST \ --url https://mixetape.com/api/v1/tools/create_upload \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "fileName": "string", "contentType": "string", "size": 0 } '