create_item

Put content in the library without scheduling it: files from storage plus the title, caption and metadata you wrote. The user sees it in the workspace (Library) and can send it to channels or a brand later. Answers the item with its files (kind, size, orientation, duration). Needs the library permission. Also available as the MCP tool create_item.

POST

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

View as Markdown

Authorisation

apiKeyHTTPrequired

Request bodyJSONrequired

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