Get the time spent of a person for a week, by task

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
GET /data/persons/{person_id}/time-spents/week/{year}/{week}
Jwt authorization

Get the time spent of a person for a week, with one entry per task. Give project_id to keep the tasks of one project. An administrator and the person get all the tasks. A manager gets the tasks of the projects they manage. A supervisor gets the tasks of the projects they supervise, for the task types of their departments. A supervisor without department gets all the task types. A manager or a supervisor who gives a project_id of another project gets a 403. Other users cannot read the time spents of other persons. You cannot read the time spents of a bot. The manager and supervisor roles are the roles held on the project team.

Path parameters

  • person_id string(uuid) Required

    Person unique identifier

  • year integer Required

    Year, for example 2026

  • week integer Required

    Week number of the ISO year, from 1 to 53

    Minimum value is 1, maximum value is 52.

Query parameters

  • project_id string(uuid)

    Get only the time spent on this project

Responses

  • 200 application/json

    The time spent of each task for the week

    Hide response attributes Show response attributes object
    • task_id string(uuid)

      Task unique identifier

    • task_type_id string(uuid)

      Task type of the task

    • project_id string(uuid)

      Project of the task

    • project_name string

      Project name

    • entity_name string

      Name of the entity of the task

    • entity_type_name string

      Name of the entity type of the task

    • sequence_name string

      Sequence name, for a shot

    • episode_name string

      Episode name, for a shot

    • duration number(float)

      Time spent on the task in hours
  • 400

    The date is not valid

  • 403

    You cannot read the time spents of this person, or the person is a bot, or you cannot access this project

  • 404

    The person does not exist

GET /data/persons/{person_id}/time-spents/week/{year}/{week} 
curl -X GET "http://api.example.com/data/persons/a24a6ea4-ce75-4665-a070-57453082c25/time-spents/week/2022/35" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
import requests

url = "http://api.example.com/data/persons/a24a6ea4-ce75-4665-a070-57453082c25/time-spents/week/2022/35"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json"
}
params = {}
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) 
[
  {
    "task_id": "string",
    "task_type_id": "string",
    "project_id": "string",
    "project_name": "string",
    "entity_name": "string",
    "entity_type_name": "string",
    "sequence_name": "string",
    "episode_name": "string",
    "duration": 8.5
  }
]