list_collections

List the account's collections — playlists on YouTube, boards on Pinterest — with id, title, visibility and item count. Use an id in metadata.playlistIds (YouTube), metadata.boardId (Pinterest) or add_to_collection. Needs the read permission. Also available as the MCP tool list_collections.

POST

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

View as Markdown

Authorisation

apiKeyHTTPrequired

Request bodyJSONrequired

accountIdstringrequired
mixetape account id (list_accounts)

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

list_collections

curl --request POST \
  --url https://mixetape.com/api/v1/tools/list_collections \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountId": "string"
}
'

const url = 'https://mixetape.com/api/v1/tools/list_collections';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({accountId: 'string'})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://mixetape.com/api/v1/tools/list_collections"

payload = { "accountId": "string" }
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Response example

{
  "result": null
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}