Skip to content

Team Management

Team management covers users, departments, and roles across one or more projects.

Overview

Team management in Kitsu revolves around three core data models:

  • Studios – For multi-studio (or multi-site) productions.
  • Departments – Organizational units that group users by role or function (e.g. Animation, Lighting, Production).
  • Users – Individuals who collaborate on projects and tasks.

Managing Multi-Studio Contributions

Create a studio

python
gazu.studio.new_studio("Paris", "#0000CC")

Creating and Managing Departments

Create a new department

python
gazu.person.new_department(name, color='', archived=False)

Retrieve existing departments

python
gazu.person.all_departments()

Update department details as the production evolves

python
gazu.person.update_department(department)

Remove or archive departments that are no longer in use

python
gazu.person.remove_department(department, force=False)

Inviting and Managing Users

Create a new user

python
person = gazu.person.new_person(first_name, last_name, email, phone='', role='user', desktop_login='', departments=[], password=None, active=True, contract_type='open-ended')

Invite a user

python
gazu.person.invite_person(person)

Assign the user to one or more departments

python
gazu.person.add_person_to_department(person, department)

Assign the user to a studio

python
studio = gazu.studio.get_studio_by_name("Paris")
person["studio_id"] = studio["id"]
gazu.person.update_person(person)

Retrieve all persons listed in the database

python
persons = gazu.person.all_persons()

Get a person by full name or login used on his desktop machine

python
person = gazu.person.get_person_by_full_name("John Doe")
person = gazu.person.get_person_by_desktop_login("john.doe")

Managing Project Teams

Get team for a project

python
team = gazu.project.get_team(project)

Add a person to the project team

python
gazu.project.add_person_to_team(project, person)

Remove a person from the project team

python
gazu.project.remove_person_from_team(project, person)

Next Steps