Zespoły to najefektywniejszy sposób zarządzania grupami użytkowników w monday.com. Zespół składa się z jednego lub większej liczby użytkowników. Każdy użytkownik może należeć do wielu zespołów lub do żadnego.

Zapytania

Pobieranie zespołów

• Wymagany zakres uprawnień: teams:read
• Zwraca tablicę z metadanymi jednego lub kilku zespołów.
• Można wysłać zapytanie bezpośrednio do głównego poziomu lub zagnieździć je w zapytaniu users, które zwraca zespoły, do których należy użytkownik.

query {
  teams {
    name
    picture_url
    users {
      created_at
      phone
    }
  }
}

Argumenty

Argument	Typ	Opis
ids	[ID!]	Unikalne identyfikatory konkretnych zespołów do zwrócenia.

Pola

Pole	Typ	Opis
id	ID!	Unikalny identyfikator zespołu.
name	String!	Nazwa zespołu.
owners	[User!]!	Użytkownicy będący właścicielami zespołu.
picture_url	String	Adres URL obrazka zespołu.
users	[User]	Użytkownicy należący do zespołu.

Mutacje

Tworzenie zespołu

Wymagany zakres uprawnień: teams:write

Tworzy zespół. Zwraca Team.

mutation {
  create_team(
    input: {
      name: "New team"
      is_guest_team: false
      subscriber_ids: [
        1234567890
        9876543210
      ]
    }
    options: {
      allow_empty_team: false
    }
  ) {
    id
  }
}

Argumenty

Argument	Typ	Opis
input	CreateTeamAttributesInput!	Atrybuty nowego zespołu.
options	CreateTeamOptionsInput	Opcje tworzenia nowego zespołu.

Dodawanie zespołów do tablicy

Wymagany zakres uprawnień: boards:write

Dodaje zespoły do tablicy. Zwraca [Team].

mutation {
  add_teams_to_board(
    board_id: 1234567890
    kind: owner
    team_ids: [
      654321
      123456
    ]
  ) {
    id
  }
}

Argumenty

Argument	Typ	Opis	Wartości wyliczeniowe
board_id	ID!	Unikalny identyfikator tablicy.
kind	BoardSubscriberKind	Rola zespołu. Jeśli nie użyjesz tego argumentu, zespół zostanie dodany jako obserwujący.	owner subscriber
team_ids	[ID!]!	Unikalne identyfikatory zespołów, które chcesz dodać do tablicy. Możesz przekazać -1, aby zasubskrybować tablicę wszystkim użytkownikom na koncie (więcej informacji tutaj).

Dodawanie użytkowników do zespołu

Wymagany zakres uprawnień: teams:write

Dodaje użytkowników do zespołu. Zwraca ChangeTeamMembershipResult.

mutation {
  add_users_to_team(
    team_id: 7654321 
    user_ids: [
      123456
      654321
      012345
    ]
    ) {
    successful_users {
      name
      email 
    }
    failed_users {
      name
      email
    }
  }
}   

Argumenty

Argument	Typ	Opis
team_id	ID!	Unikalny identyfikator zespołu, do którego dodajesz użytkowników.
user_ids	[ID!]!	Unikalne identyfikatory użytkowników do dodania do zespołu.

Dodawanie zespołów do obszaru roboczego

Wymagany zakres uprawnień: workspaces:write

Dodaje zespoły do obszaru roboczego. Zwraca [Team].

mutation {
  add_teams_to_workspace(
    workspace_id: 1234567
    kind: owner
    team_ids: [
      123456
      654321
      012345
    ]
  ) {
    id
  }
}

Argumenty

Argument	Typ	Opis	Wartości wyliczeniowe
kind	WorkspaceSubscriberKind	Rola zespołu.	owner subscriber
team_ids	[ID!]!	Unikalne identyfikatory zespołów do dodania do obszaru roboczego.
workspace_id	ID!	Unikalny identyfikator obszaru roboczego.

Przypisywanie właścicieli zespołu

Przypisuje właścicieli do zespołu. Zwraca AssignTeamOwnersResut.

mutation {
  assign_team_owners(
    user_ids: [654321, 123456]
    team_id: 24681012
  ) {
    errors {
      message
      code
      user_id
    }
    team {
      owners {
        id
      }
    }
  }
}

Argumenty

Argument	Typ	Opis
team_id	ID!	Unikalny identyfikator zespołu, do którego przypisujesz właścicieli.
user_ids	[ID!]!	Unikalne identyfikatory użytkowników do przypisania. Maksymalnie 200.

Usuwanie właścicieli zespołu

Usuwa właścicieli z zespołu. Zwraca RemoveTeamOwnersResult.

mutation {
  remove_team_owners(
    user_ids: [
      654321
      123456
    ]
    team_id: 9876543210
  ) {
    errors {
      message
      code
      user_id
    }
    team {
      owners {
        id
      }
    }
  }
}

Argumenty

Argument	Typ	Opis
team_id	ID!	Unikalny identyfikator zespołu, z którego usuwasz właścicieli.
user_ids	[ID!]!	Unikalne identyfikatory użytkowników do usunięcia. Maksymalnie 200.

Usuwanie użytkowników z zespołu

Wymagany zakres uprawnień: teams:write

Usuwa użytkowników z zespołu. Zwraca ChangeTeamMembershipResult.

mutation {
  remove_users_from_team(
    team_id: 7654321
    user_ids: [
      123456
      654321
      12345
    ]
  ) {
    successful_users {
      name
      email
    }
    failed_users {
      name
      email
    }
  }
}

Argumenty

Argument	Typ	Opis
team_id	ID!	Unikalny identyfikator zespołu, z którego usuwasz użytkowników.
user_ids	[ID!]!	Unikalne identyfikatory użytkowników do usunięcia z zespołu.

Usuwanie zespołu

Wymagany zakres uprawnień: teams:write

Usuwa zespół. Zwraca Team.

mutation {
  delete_team(team_id: 1234567890) {
    id
  }
}

Argumenty

Argument	Typ	Opis
team_id	ID!	Unikalny identyfikator zespołu do usunięcia.

Usuwanie zespołów z tablicy

Wymagany zakres uprawnień: boards:write

Usuwa zespoły z tablicy. Zwraca Team.

mutation {
  delete_teams_from_board(
    board_id: 1234567890
    team_ids: [
      123456
      654321
      12345
    ]
  ) {
    id
  }
}

Argumenty

Argument	Typ	Opis
board_id	ID!	Unikalny identyfikator tablicy.
team_ids	[ID!]!	Unikalne identyfikatory zespołów do usunięcia z tablicy.

Usuwanie zespołów z obszaru roboczego

Wymagany zakres uprawnień: workspaces:write

Usuwa zespoły z obszaru roboczego. Zwraca Team.

mutation {
  delete_teams_from_workspace(
    workspace_id: 1234567
    team_ids: [
      123456
      654321
      12345
    ]
  ) {
    id
  }
}

Argumenty

Argument	Typ	Opis
team_ids	[ID!]!	Unikalne identyfikatory zespołów do usunięcia z obszaru roboczego.
workspace_id	ID!	Unikalny identyfikator obszaru roboczego.