Utwórz kolumnę (Platform MCP)
Użyj tego narzędzia, aby dodać nową kolumnę do istniejącej tablicy. Podaj typ kolumny (np. status, date, numbers, people) i jej tytuł. W przypadku typów kolumn, które wymagają konfiguracji - takich jak status (definicje etykiet) lub dropdown (lista opcji) - przekaż ciąg JSON w parametrze columnSettings.
Najlepsza praktyka: Przed przekazaniem columnSettings wywołaj get_column_type_info z fetchMode: "schema" dla wybranego typu kolumny. Otrzymasz dokładny schemat JSON ustawień tego typu, który pozwoli przygotować prawidłową konfigurację.
Parametry
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| boardId | number |
Tak | Identyfikator tablicy, do której chcesz dodać kolumnę. |
| columnType | string |
Tak | Typ tworzonej kolumny. Obsługiwane typy to między innymi: auto_number, board_relation, checkbox, date, dependency, dropdown, email, file, formula, hour, link, location, long_text, numbers, people, phone, rating, status, tags, team, text, time_tracking, timeline, vote, week, world_clock i inne. |
| columnTitle | string |
Tak | Tytuł wyświetlany dla nowej kolumny. |
| columnDescription | string |
Nie | Opcjonalny opis wyświetlany w podpowiedzi w nagłówku kolumny. |
| columnSettings | string |
Nie | Konfiguracja właściwa dla kolumny, przekazana jako ciąg JSON. Aby pobrać prawidłową strukturę dla danego typu, użyj get_column_type_info z fetchMode: "schema". |
Przykład
Utwórz kolumnę Status na tablicy 18412502536:
{
"boardId": 18412502536,
"columnType": "status",
"columnTitle": "Status"
}
Narzędzie zwróciło identyfikator nowej kolumny (color_mm37gbqg) i jej tytuł (Status).
Odpowiednik programistyczny
Aby uzyskać ten sam rezultat, użyj GraphQL API:
mutation {
create_column(
board_id: 18412502536
title: "Status"
column_type: status
) {
id
title
type
}
}
Pełną dokumentację znajdziesz na stronie Kolumny.