Aktualizuj folder (Platform MCP)
To narzędzie służy do modyfikowania właściwości istniejącego folderu. Możesz zmienić jego nazwę i wygląd (kolor, ikonę, grubość czcionki), ustawić go względem innego obiektu albo przenieść do innego folderu nadrzędnego lub obszaru roboczego. Wymagany jest tylko parametr folderId. Pozostałe parametry są opcjonalne - zostaną zaktualizowane tylko te, które podasz.
Uwaga: Parametry pozycjonowania (position_object_id, position_object_type, position_is_after) muszą być podane razem. Jeśli podasz position_object_id, musisz podać także position_object_type i odwrotnie.
Parametry
| Parametr | Typ | Wymagane | Opis |
|---|---|---|---|
| folderId | string |
Tak | Identyfikator folderu do zaktualizowania. |
| name | string |
Nie | Nowa nazwa folderu. |
| color | string |
Nie | Nowy kolor folderu. Jedna z wartości: AQUAMARINE, BRIGHT_BLUE, BRIGHT_GREEN, CHILI_BLUE, DARK_ORANGE, DARK_PURPLE, DARK_RED, DONE_GREEN, INDIGO, LIPSTICK, NULL, PURPLE, SOFIA_PINK, STUCK_RED, SUNSET, WORKING_ORANGE. |
| fontWeight | string |
Nie | Nowa grubość czcionki etykiety folderu. Jedna z wartości: FONT_WEIGHT_BOLD, FONT_WEIGHT_LIGHT, FONT_WEIGHT_NORMAL, FONT_WEIGHT_VERY_LIGHT, NULL. |
| customIcon | string |
Nie | Nowa ikona folderu. Jedna z wartości: FOLDER, MOREBELOW, MOREBELOWFILLED, NULL, WORK. |
| parentFolderId | string |
Nie | Identyfikator nowego folderu nadrzędnego, w którym ma się znaleźć ten folder. |
| workspaceId | string |
Nie | Identyfikator obszaru roboczego zawierającego folder. Wymagany, jeśli przenosisz folder do innego obszaru roboczego. |
| accountProductId | string |
Nie | Identyfikator produktu konta, który ma zostać powiązany z folderem. |
| position_object_id | string |
Nie | Identyfikator obiektu, względem którego ma zostać ustawiony folder. Należy podać go razem z position_object_type. |
| position_object_type | string |
Nie | Typ obiektu używanego jako punkt odniesienia przy ustawianiu pozycji. Jedna z wartości: Board, Folder, Overview. Należy podać go razem z position_object_id. |
| position_is_after | boolean |
Nie | Jeśli wartość to true, folder zostanie ustawiony za obiektem odniesienia. Jeśli wartość to false, zostanie ustawiony przed nim. |
Przykład
Zmień nazwę folderu 20393953 i ustaw jego kolor na fioletowy:
{
"folderId": "20393953",
"name": "MCP Test Folder (Updated)",
"color": "PURPLE"
}
Podczas testu zwrócony wynik brzmiał: Folder 20393953 updated, a nowa nazwa folderu to MCP Test Folder (Updated). Zmiana koloru została zastosowana od razu, a wszystkie niepodane pola pozostały bez zmian.
Odpowiednik programistyczny
Aby uzyskać ten sam efekt, użyj GraphQL API:
mutation {
update_folder(
folder_id: 20393953
name: "MCP Test Folder (Updated)"
color: PURPLE
) {
id
name
color
}
}
Pełną dokumentację znajdziesz w sekcji Folders.