Utwórz folder (Platform MCP)
Użyj tego narzędzia, aby utworzyć folder w obszarze roboczym. Foldery pomagają porządkować tablice i dokumenty w logiczne grupy. Możesz tworzyć foldery zagnieżdżone, podając parentFolderId, a także dostosować wygląd folderu, wybierając kolor, ikonę i grubość czcionki. Po utworzeniu folderu użyj zwróconego identyfikatora, aby przenieść do niego tablice za pomocą move_object lub utworzyć w nim kolejne foldery.
Parametry
| Parametr | Typ | Wymagane | Opis |
|---|---|---|---|
| workspaceId | string |
Tak | Identyfikator obszaru roboczego, w którym zostanie utworzony folder. |
| name | string |
Tak | Nazwa folderu. |
| color | string |
Nie | 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 | 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 | Ikona wyświetlana na folderze. Jedna z wartości: FOLDER, MOREBELOW, MOREBELOWFILLED, NULL, WORK. |
| parentFolderId | string |
Nie | Identyfikator folderu nadrzędnego, w którym ma zostać umieszczony ten folder. Jeśli go nie podasz, folder zostanie utworzony w katalogu głównym obszaru roboczego. |
Przykład
Utwórz niebieski folder o nazwie „MCP Test Folder” w obszarze roboczym 12406666:
{
"workspaceId": "12406666",
"name": "MCP Test Folder",
"color": "BRIGHT_BLUE"
}
Podczas testu narzędzie zwróciło komunikat: Folder 20393953 successfully created z nazwą MCP Test Folder. Identyfikatora folderu (20393953) można następnie użyć z update_folder lub move_object.
Odpowiednik programowy
Użyj GraphQL API, aby uzyskać ten sam rezultat:
mutation {
create_folder(
workspace_id: 12406666
name: "MCP Test Folder"
color: BRIGHT_BLUE
) {
id
name
color
}
}
Pełną dokumentację znajdziesz w sekcji Foldery.