update_item

Change a library item: the given fields only (null clears one); fileIds, when given, replaces the files and their order; metadata is merged. Needs the library permission. Also available as the MCP tool update_item.

POST

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

View as Markdown

Authorisation

apiKeyHTTPrequired

Request bodyJSONrequired

idstringrequired
Content item id (list_items)
titleoptionalstring
Title where the platform has one (YouTube, Pinterest)
captionoptionalstring
The post text; defaults for every platform
descriptionoptionalstring
Longer description where the platform has one
fileIdsoptionalarray ofstring
Files from storage (list_files ids), in order — one video, or several images for a carousel. Each must be ready (finish_upload done).
metadataoptionalobject
Fields every platform shares (tags, thumbnailUrl, firstComment, …) and platforms: { youtube: { … }, facebook: { … } } with each platform's overrides (same fields as create_post's metadata for that platform). On update it is merged; null clears a field or a platform.

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/update_item \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "id": "string", "title": "string", "caption": "string", "description": "string", "fileIds": [ "string" ], "metadata": {} } '