Import task estimations from a CSV file

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 /import/csv/projects/{project_id}/task-types/{task_type_id}/estimations

Set the estimations, the dates and the other values of the tasks of a task type from a CSV file. Each line gives one entity. The columns are Parent, Entity, Estimation, Drawings, Start date, Due date, Difficulty and the names of the task metadata descriptors of the task type. For an asset task type, Parent is the asset type and Entity is the asset. For a shot task type, Parent is the sequence and Entity is the shot. For a sequence or an edit task type, Parent is the name of its episode, or empty to match any episode, and Entity is the sequence or the edit. For an episode task type, Entity is the episode and the route ignores Parent. When several entities match a line, the ones with the exact name win, then the ones that are not canceled. If a line still matches several entities, the route refuses it. The route does not support concept task types. The Estimation column is in hours when the organisation shows durations in hours, in days otherwise. Dates use the YYYY-MM-DD format. If Due date is empty and Start date and Estimation are set, the route computes the due date from them. Send the CSV file in a multipart form. The route finds the separator of the file. Each line is imported in order. If a line is not valid, the import stops. You must be an administrator, a manager of the project, or a supervisor of the project. A supervisor must have no department, or the department of the task type must be one of their departments.

Path parameters

  • project_id string(uuid) Required

    Unique identifier of the project

  • task_type_id string(uuid) Required

    Unique identifier of the task type

multipart/form-data

Body Required

  • file string(binary) Required

    CSV file with task estimation data

Responses

  • 201 application/json

    One null value per imported line

  • 400 application/json

    A line of the file is not valid. The lines before this line are imported.

    Hide response attributes Show response attributes object
    • error boolean
    • message string
    • line_number integer

      Number of the line that is not valid

    • imported_rows integer

      Number of lines that are imported

  • 403

    You cannot change the tasks of this task type

  • 404

    The project or the task type does not exist

POST /import/csv/projects/{project_id}/task-types/{task_type_id}/estimations
curl -X POST "http://api.example.com/import/csv/projects/a24a6ea4-ce75-4665-a070-57453082c25/task-types/b24a6ea4-ce75-4665-a070-57453082c25/estimations" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
import requests

url = "http://api.example.com/import/csv/projects/a24a6ea4-ce75-4665-a070-57453082c25/task-types/b24a6ea4-ce75-4665-a070-57453082c25/estimations"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json"
}
params = {}
payload = None

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

response.raise_for_status()

if response.content:
    print(response.json())
Response examples (201)
[
  {}
]
Response examples (400)
{
  "error": true,
  "message": "string",
  "line_number": 42,
  "imported_rows": 42
}