Get the task dates of the persons

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

{
  "Kitsu API MCP server": {
    "url": "https://api-docs.kitsu.cloud/mcp"
  }
}

GET /data/persons/task-dates

Jwt authorization

For each active person, get the first start date and the last end date of their tasks. The schedule of the team uses it. An administrator gets all the projects. A manager or a supervisor gets the projects of their teams. The other open projects come as busy periods, without the project or the task. Without project_id, the route uses your global role. You must be a supervisor, a manager or an administrator in the studio. With project_id, the route uses your role on this project.

Query parameters

project_id string(uuid)

Get only the tasks of this project

Responses

200 application/json

The first and the last date for each person
Hide response attributes Show response attributes object
- person_id string(uuid)
- min_date string
  
  First task start date for this person within the requested scope
- max_date string
  
  Last task due date for this person within the requested scope
- busy_periods array[object]
  
  Anonymous, merged date intervals covering the person's tasks in open productions outside the caller's scope. No production or task detail is exposed.
  
  Hide busy_periods attributes Show busy_periods attributes object
  
  start_date string
  
  end_date string
400

project_id is not valid
403

You do not have the supervisor role, or you are not in the team of this project

GET /data/persons/task-dates

curl -X GET "http://api.example.com/data/persons/task-dates?project_id=a24a6ea4-ce75-4665-a070-57453082c25" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

import requests

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

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

response.raise_for_status()

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

Response examples (200)

[
  {
    "person_id": "a24a6ea4-ce75-4665-a070-57453082c250",
    "min_date": "2024-01-15 00:00:00",
    "max_date": "2024-03-21 00:00:00",
    "busy_periods": [
      {
        "start_date": "2024-01-15 00:00:00",
        "end_date": "2024-03-21 00:00:00"
      }
    ]
  }
]