Add entities to playlist

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://api-docs.kitsu.cloud/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Kitsu API MCP server": {
    "url": "https://api-docs.kitsu.cloud/mcp"
  }
}
Close
POST /actions/playlists/{playlist_id}/add-entities
Jwt authorization

Atomically add several (entity, preview) couples to the given playlist in a single database write. A playlist entry is the couple, so the same entity may be added several times with different previews; only exact duplicate couples are skipped. When a couple has no preview_file_id, the entity's latest preview (highest revision, restricted to the playlist task type when one is set) is used.

Path parameters

  • playlist_id string(uuid) Required

    Playlist unique identifier

application/json

Body Required

  • entities array[object] Required

    Entity/preview couples to add to the playlist

    Hide entities attributes Show entities attributes object
    • entity_id string(uuid) Required
    • preview_file_id string(uuid) | null

Responses

  • 200 application/json

    Updated playlist
POST /actions/playlists/{playlist_id}/add-entities 
curl \
 --request POST 'http://api.example.com/actions/playlists/{playlist_id}/add-entities' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"entities":[{"entity_id":"string","preview_file_id":"string"}]}'
Request examples 
{
  "entities": [
    {
      "entity_id": "string",
      "preview_file_id": "string"
    }
  ]
}
Response examples (200) 
{}