Delete an episode

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
DELETE /data/episodes/{episode_id}
Jwt authorization

Delete an episode. The creator of the episode can delete it if the creator is in the project team. Other users must be managers of the project. Without force, the episode is deleted only if nothing is linked to it. If sequences, assets or tasks are still linked, the route returns 400. With force=true, the sequences, the shots, the assets and the tasks of the episode are deleted too. Only a manager of the project can use force=true.

Path parameters

  • episode_id string(uuid) Required

    Unique identifier of the episode

Query parameters

  • force boolean

    Delete the episode and all its related data

Responses

  • 204

    The episode is deleted

  • 400

    Some data are still linked to this episode

  • 403

    You cannot delete this episode

  • 404

    The episode does not exist

DELETE /data/episodes/{episode_id} 
curl -X DELETE "http://api.example.com/data/episodes/a24a6ea4-ce75-4665-a070-57453082c25" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
import requests

url = "http://api.example.com/data/episodes/a24a6ea4-ce75-4665-a070-57453082c25"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json"
}
params = {}
payload = None

response = requests.delete(
    url,
    headers=headers,
    params=params,
    json=payload
)

response.raise_for_status()

if response.content:
    print(response.json())