Create a share link for a 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 /data/playlists/{playlist_id}/share
Jwt authorization

Create a link that lets guests review the playlist without an account. The link can expire, forbid comments and require a password. Requires the manager role on the production.

Path parameters

  • playlist_id string(uuid) Required
application/json

Body

  • expiration_date string(date-time)

    Date after which the link stops working

  • can_comment boolean

    Whether guests may comment and annotate

    Default value is true.

  • password string

    Password guests must give to open the link

Responses

  • 201 application/json

    Share link created, with its token

    Hide response attributes Show response attributes object
    • id string(uuid)
    • token string
    • playlist_id string(uuid)
    • expiration_date string(date-time) | null
    • is_active boolean
    • can_comment boolean
    • has_password boolean
  • 400

    Invalid body

  • 403

    Not a manager of the production

  • 404

    Playlist not found

POST /data/playlists/{playlist_id}/share 
curl \
 --request POST 'http://api.example.com/data/playlists/a24a6ea4-ce75-4665-a070-57453082c250/share' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "expiration_date": "2026-12-31",
  "can_comment": true,
  "password": "string"
}'
Request examples 
{
  "expiration_date": "2026-12-31",
  "can_comment": true,
  "password": "string"
}
Response examples (201) 
{
  "id": "string",
  "token": "string",
  "playlist_id": "string",
  "expiration_date": "2026-05-04T09:42:00Z",
  "is_active": true,
  "can_comment": true,
  "has_password": true
}