Create tasks for entities of a type

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}/task-types/{task_type_id}/create-tasks/{entity_type}
Jwt authorization

Create a task of the task type for each entity of the list. If the body is empty, the route uses all the entities of this type in the project, or of the episode episode_id. The entity type name is not case sensitive. A task that exists is skipped. For an asset type, an asset whose workflow does not have the task type is skipped. You must be a manager of the project.

Path parameters

  • project_id string(uuid) Required

    Unique identifier of the project

  • entity_type string Required

    Name of the entity type, for example Asset or Sequence

  • task_type_id string(uuid) Required

    Unique identifier of the task type

Query parameters

  • episode_id string(uuid)

    Use only the entities of this episode, when the body is empty

application/json

Body

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

List of entity IDs to create tasks for

Responses

  • 201 application/json

    The new tasks

    Hide response attributes Show response attributes object
    • id string(uuid)
    • name string
    • task_type_id string(uuid)
    • task_status_id string(uuid)
    • entity_id string(uuid)
    • project_id string(uuid)
  • 400

    The body is not a list of valid identifiers

  • 404

    The project, the task type or the entity type does not exist

  • 403

    You are not a manager of the project

POST /actions/projects/{project_id}/task-types/{task_type_id}/create-tasks/{entity_type} 
curl -X POST "http://api.example.com/actions/projects/a24a6ea4-ce75-4665-a070-57453082c25/task-types/a24a6ea4-ce75-4665-a070-57453082c25/create-tasks/Asset/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '[
  ""
]'
import requests

url = "http://api.example.com/actions/projects/a24a6ea4-ce75-4665-a070-57453082c25/task-types/a24a6ea4-ce75-4665-a070-57453082c25/create-tasks/Asset/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
}
params = {}
payload = [
    ""
]

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

response.raise_for_status()

if response.content:
    print(response.json())
Request example 
[
  "b24a6ea4-ce75-4665-a070-57453082c250"
]
Response examples (201) 
[
  {
    "id": "a24a6ea4-ce75-4665-a070-57453082c250",
    "name": "Entity Task Name",
    "task_type_id": "b24a6ea4-ce75-4665-a070-57453082c250",
    "task_status_id": "c24a6ea4-ce75-4665-a070-57453082c250",
    "entity_id": "d24a6ea4-ce75-4665-a070-57453082c250",
    "project_id": "e24a6ea4-ce75-4665-a070-57453082c250"
  }
]