Utwórz grupę (Platform MCP)
Użyj tego narzędzia, aby dodać nową grupę do istniejącej tablicy. Grupy dzielą elementy na etapy przepływu pracy, kategorie lub sprinty (np. „Planowanie”, „W trakcie” i „Gotowe”). Możesz przypisać grupie jeden z predefiniowanych kolorów i określić jej położenie względem istniejącej grupy.
Uwaga: Nowe elementy są zawsze tworzone w pierwszej grupie na tablicy. Jeśli chcesz, aby nowe elementy trafiały do tworzonej grupy, użyj move_object, aby po jej utworzeniu przenieść ją na górę, albo odpowiednio zaplanuj kolejność grup.
Parametry
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| boardId | string |
Tak | Identyfikator tablicy, na której ma zostać utworzona grupa. |
| groupName | string |
Tak | Nazwa wyświetlana nowej grupy. Maksymalnie 255 znaków. |
| groupColor | string |
Nie | Kolor nagłówka grupy w formacie szesnastkowym. Musi być jednym z 19 predefiniowanych kolorów grup w monday.com: #037f4c, #00c875, #9cd326, #cab641, #ffcb00, #784bd1, #9d50dd, #007eb5, #579bfc, #66ccff, #bb3354, #df2f4a, #ff007f, #ff5ac4, #ff642e, #fdab3d, #7f5347, #c4c4c4, #757575. |
| relativeTo | string |
Nie | Identyfikator istniejącej grupy, względem której ma zostać ustawiona nowa grupa. Użyj get_board_info, aby znaleźć identyfikatory grup. |
| positionRelativeMethod | string |
Nie | Określa, czy nowa grupa ma zostać umieszczona przed (before_at), czy po (after_at) grupie wskazanej w relativeTo. |
Przykład
Utwórz grupę „Sprint 1” w niebieskim kolorze na tablicy 18412502536:
{
"boardId": "18412502536",
"groupName": "Sprint 1",
"groupColor": "#579bfc"
}
Narzędzie zwróciło identyfikator nowej grupy (group_mm37rev), jej nazwę („Sprint 1”) oraz identyfikator tablicy, do której została dodana.
Odpowiednik programistyczny
Użyj GraphQL API, aby uzyskać ten sam rezultat:
mutation {
create_group(
board_id: 18412502536
group_name: "Sprint 1"
group_color: "#579bfc"
) {
id
title
color
}
}
Pełną dokumentację znajdziesz w sekcji Grupy.