upload_caption

Upload a subtitle track to a post on the platform: public https SRT or WebVTT on YouTube (400–450 quota units), SRT on Facebook. A track with the same language (and name) is replaced. Needs the manage permission. Also available as the MCP tool upload_caption.

POST

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

View as Markdown

Authorisation

apiKeyHTTPrequired

Request bodyJSONrequired

idstringrequired
mixetape post id (list_posts)
languagestringrequired
BCP-47, e.g. "en", "id"
urlstringrequired
nameoptionalstring
Track name; empty is the default track
isDraftoptionalboolean
Upload without publishing the track

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/upload_caption \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "id": "string", "language": "string", "name": "string", "url": "string", "isDraft": true } '