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 guests can use to review the playlist without an account. The link can expire, block comments and ask for a password. You must be an administrator or a manager of the project. The role held on the project team applies.

Path parameters

  • playlist_id string(uuid) Required

    Unique identifier of the playlist

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.

  • can_download boolean

    Whether guests may download the playlist as a ZIP file

    Default value is false.

  • password string

    Password guests must give to open the link

Responses

  • 201 application/json

    The new share link, 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
    • can_download boolean
    • has_password boolean
  • 400

    The body is not valid

  • 403

    You are not an administrator or a manager of the project

  • 404

    The playlist does not exist

POST /data/playlists/{playlist_id}/share 
curl \
 --request POST '/api/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,
  "can_download": false,
  "password": "string"
}'
Request examples 
{
  "expiration_date": "2026-12-31",
  "can_comment": true,
  "can_download": false,
  "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,
  "can_download": true,
  "has_password": true
}