Delete entities batch

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/projects/{project_id}/delete-entities

Delete assets, shots, edits and concepts given by id list in a single request. Each entity follows the same rules as its single deletion route. Without force, entities with tasks are marked as canceled on first deletion, then removed for real when already canceled; concepts are always removed. Only entity creators or project managers can delete entities.

Path parameters

  • project_id string(uuid) Required

    Unique identifier of the project

Query parameters

  • force boolean

    Remove the entities and their tasks for real, instead of only canceling the ones that have tasks

application/json

Body Required

array[string(uuid)] array[string(uuid)]

Entity unique identifiers to delete

Responses

  • 200 application/json

    Ids of the entities that were deleted. Entities that do not belong to the project or are not an asset, a shot, an edit or a concept are skipped.

POST /actions/projects/{project_id}/delete-entities
curl \
 --request POST 'http://api.example.com/actions/projects/a24a6ea4-ce75-4665-a070-57453082c25/delete-entities' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '["string"]'
Request examples
[
  "string"
]
Response examples (200)
[
  "string"
]