Działy pozwalają kontom Enterprise grupować użytkowników według lokalizacji, centrum kosztów lub działu organizacyjnego na potrzeby zarządzania licencjami i administracji.

Każdy dział ma własnych członków i właścicieli. Może mieć więcej niż jednego właściciela, ale każdy użytkownik może należeć do najwyżej jednego działu (albo nie należeć do żadnego).

Zapytania

Pobieranie działów

• 🚧 Dostępne tylko w planach Enterprise
• Wymagany zakres: departments:read
• Zwraca tablicę zawierającą metadane działów na koncie.
• Można wysłać zapytanie bezpośrednio w korzeniu albo zagnieździć je w zapytaniu users.

query {
  departments(ids: [12345, 54321]) {
    id
    name
    assigned_seats
    reserved_seats
    members {
      id
      name
    }
    owners {
      id
      name
    }
  }
}

Argumenty

Argument	Typ	Opis
ids	[ID!]	Identyfikatory działów do filtrowania.

Pola

Pole	Typ	Opis
assigned_seats	Int!	Liczba licencji przypisanych do działu.
id	ID!	Unikalny identyfikator działu.
members	[User!]	Członkowie działu. Zwraca pełny obiekt users.
name	String!	Nazwa działu.
owners	[User!]	Właściciele działu.
reserved_seats	Int!	Liczba licencji zarezerwowanych dla działu.

Mutacje

• 🚧 Dostępne tylko w planach Enterprise
• Wymagany zakres: departments:write
• Uprawnienie na poziomie konta: manage_account_users_permission

Tworzenie działu

Tworzy dział. Zwraca Department.

mutation {
  create_department(data: {
    name: "New Department",
    reserved_seats: 3
  }) {
    id
    name
    reserved_seats
  }
}

Argumenty

Argument	Typ	Opis
data	CreateDepartmentDataInput!	Pola wejściowe do utworzenia działu.

Przypisywanie członków do działu

Przypisuje członków do działu. Zwraca AssignDepartmentMembersResult.

mutation {
  assign_department_members(
    department_id: 45678,
    user_ids: [54321, 12345]
  ) {
    successful_users {
      id
      name
    }
    failed_users {
      id
      name
    }
  }
}

Argumenty

Argument	Typ	Opis
department_id	ID!	Unikalny identyfikator działu.
user_ids	[ID!]!	Unikalne identyfikatory użytkowników.

Przypisywanie właściciela działu

Przypisuje właściciela do działu. Zwraca AssignDepartmentOwnerResult.

mutation {
  assign_department_owner(
    department_id: 45678,
    user_id: 12345
  ) {
    owner {
      id
      name
    }
  }
}

Argumenty

Argument	Typ	Opis
department_id	ID!	Unikalny identyfikator działu.
user_id	ID!	Unikalny identyfikator użytkownika.

Aktualizowanie działu

Aktualizuje dział. Zwraca Department.

mutation {
  update_department(
    department_id: 12345,
    data: {
      name: "Engineering",
      reserved_seats: 4
    }
  ) {
    id
    name
    reserved_seats
    assigned_seats
  }
}

Argumenty

Argument	Typ	Opis
data	UpdateDepartmentOptionsInput	Pola wejściowe do aktualizacji działu.
department_id	ID!	Unikalny identyfikator działu.

Usuwanie przypisania działu użytkownikom

Usuwa przypisanie działów użytkownikom. Zwraca ClearUsersDepartmentResult.

mutation {
  clear_users_department(user_ids: [12345, 54321]) {
    cleared_users {
      id
      name
    }
  }
}

Argumenty

Argument	Typ	Opis
user_ids	[ID!]!	Unikalne identyfikatory użytkowników.

Odbieranie właścicielom uprawnień do działu

Odbiera właścicielom uprawnienia do działu. Zwraca UnassignDepartmentOwnerResult.

mutation {
  unassign_department_owners(
    department_id: 45678,
    user_ids: [12345, 54321]
  ) {
    unassigned_users {
      id
      name
    }
  }
}

Argumenty

Argument	Typ	Opis
department_id	ID!	Unikalny identyfikator działu.
user_ids	[ID!]!	Unikalne identyfikatory użytkowników.

Usuwanie działu

Usuwa dział z konta. Zwraca Department.

mutation {
  delete_department(department_id: 12345) {
    id
    name
    members {
      id
      name
    }
  }
}

Argumenty

Argument	Typ	Opis
department_id	ID!	Unikalny identyfikator działu.