list_files

List the files in your mixetape storage, newest first, with url (r2://…) and size — narrow by words in the file name. Returns { files, nextCursor }; pass nextCursor back as cursor for the next page (null on the last). Needs the storage permission. Also available as the MCP tool list_files.

POST

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

View as Markdown

Authorisation

apiKeyHTTPrequired

Request bodyJSONrequired

searchoptionalstring
Words in the file name (case-insensitive)
limitoptionalnumber
Files per page: default 50, max 1000
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_files \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "search": "string", "limit": 0, "cursor": "string" } '