list_items

List the library's content items, newest first, with their files — narrowed by words in the title, caption or description. Returns { items, nextCursor }; pass nextCursor back as cursor for the next page (null on the last). Needs the library permission. Also available as the MCP tool list_items.

POST

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

View as Markdown

Authorisation

apiKeyHTTPrequired

Request bodyJSONrequired

searchoptionalstring
Words in the title, caption or description
limitoptionalnumber
Items per page: default 50, max 200
cursoroptionalstring
nextCursor from the previous page

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/list_items \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "search": "string", "limit": 0, "cursor": "string" } '