Dokumentacja dla programistów

Kolumny

Dokumentacja API (rdzeń)Dokumentacja API

Aktualizacja 2026-09-06

Tablice monday.com mają postać tabeli z kolumnami i wierszami elementów. Każda kolumna ma określone funkcje i przechowuje tylko odpowiednie dane. Na przykład kolumna liczb przechowuje wartości liczbowe, kolumna tekstowa - tekst, a kolumna śledzenia czasu - tylko dane o czasie pochodzące z rejestrowanych zdarzeń.

Zapytania

Pobieranie kolumn

Wymagany zakres uprawnień: boards:read
Zwraca tablicę zawierającą metadane jednej lub wielu kolumn
Można jej używać tylko wewnątrz innego zapytania (np. boards); nie można jej wywołać bezpośrednio na poziomie głównym

query {
  boards(ids: [1234567890]) {
    columns {
      id
      title
    }
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `query ($board: [ID!]) {boards (ids: $board) { columns { id title }}}`
const variables = {
  board: 1234567
}
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument Typ Opis Wartości wyliczeniowe

capabilities

Argument	Typ	Opis	Wartości wyliczeniowe
capabilities	`[ColumnCapability]`	Lista możliwości kolumn, według których można filtrować. Zwraca kolumny mające dowolną z określonych możliwości. Użyj `null` w tablicy, aby pobrać kolumny bez żadnych możliwości (np. `[null]` zwróci tylko kolumny bez możliwości, a `[null, CALCULATED]` - kolumny bez możliwości lub z możliwością obliczania).	`CALCULATED` (obliczana wartość kolumny) `VISIBILITY` (ukryte kolumny)
ids	`[String]`	Konkretne kolumny do zwrócenia. Podając ten identyfikator jako ciąg znaków, użyj cudzysłowów.
types	`[ColumnType!]`	Typy kolumn do zwrócenia.

[ColumnCapability]

Lista możliwości kolumn, według których można filtrować. Zwraca kolumny mające dowolną z określonych możliwości.

Użyj null w tablicy, aby pobrać kolumny bez żadnych możliwości (np. [null] zwróci tylko kolumny bez możliwości, a [null, CALCULATED] - kolumny bez możliwości lub z możliwością obliczania).

CALCULATED (obliczana wartość kolumny) VISIBILITY (ukryte kolumny)

ids [String] Konkretne kolumny do zwrócenia. Podając ten identyfikator jako ciąg znaków, użyj cudzysłowów.

types [ColumnType!] Typy kolumn do zwrócenia.

Pola

Pole	Typ	Opis
archived	`Boolean!`	Zwraca `true`, jeśli kolumna jest zarchiwizowana.
capabilities	`ColumnCapabilities!`	Oblicza i pobiera zagregowaną wartość kolumny.
description	`String`	Opis kolumny.
id	`ID!`	Unikalny identyfikator kolumny.
revision	`String!`	Bieżąca rewizja kolumny. Służy do optymistycznej kontroli współbieżności.
settings	`JSON`	Dynamiczne ustawienia kolumny w formacie JSON. W przypadku tablic wielopoziomowych użyj tego pola, aby pobrać etykiety i mapowania kolorów dla kolumn zbiorczych statusu.
title	`String!`	Tytuł kolumny.
type	`ColumnType!`	Typ kolumny.
width	`Int`	Szerokość kolumny.

Mutacje

Wymagany zakres uprawnień: boards:write

Tworzenie kolumny

Tworzy kolumnę. Zwraca Column.

mutation {
  create_column(
    board_id: 1234567890
    title:"Work Status"
    description: "This is my work status column"
    column_type:status
  ) {
    id
    title
    description
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `mutation ($board: ID!, $title: String!, $desc: String!) { create_column(board_id: $board, title: $title, description: $desc, column_type:status){ id title description}}`
const variables = {
  board: 1234567,
  title: "Work status",
  desc: "Current status of the task"
}
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument	Typ	Opis
after_column_id	`ID`	Unikalny identyfikator kolumny, za którą zostanie utworzona nowa kolumna.
board_id	`ID!`	Unikalny identyfikator tablicy, na której ma zostać utworzona nowa kolumna.
capabilities	`ColumnCapabilitiesInput`	Konfiguracja możliwości nowej kolumny. Jeśli jej nie podasz, zostaną użyte wartości domyślne: na tablicach wielopoziomowych kolumny liczb, dat, osi czasu i statusu są tworzone z włączoną możliwością obliczania; w pozostałych przypadkach nie są stosowane żadne możliwości. Aby zmienić to ustawienie domyślne na tablicach wielopoziomowych, przekaż pusty argument - kolumna zostanie utworzona bez możliwości.
column_type	`ColumnType!`	Typ kolumny do utworzenia. Określa, które właściwości są prawidłowe w argumencie `defaults`.
defaults	`JSON`	Wartości domyślne nowej kolumny. Akceptuje obiekt lub ciąg JSON. Wartości są sprawdzane względem schematu typu kolumny. Aby zobaczyć dostępne właściwości, wywołaj zapytanie `get_column_type_schema`.
description	`String`	Opis nowej kolumny.
id	`String`	Unikalny identyfikator kolumny określony przez użytkownika. Jeśli go nie podasz, zostanie automatycznie wygenerowany nowy identyfikator. Podany identyfikator musi spełniać następujące wymagania: Długość od 1 do 20 znaków włącznie Wyłącznie małe litery (a-z) i znaki podkreślenia (_) Musi być unikalny (żadna inna kolumna na tablicy nie może mieć tego samego identyfikatora) Nie można ponownie użyć identyfikatorów kolumn, nawet jeśli kolumna została usunięta z tablicy Nie może mieć wartości null, być pusty ani być pustym ciągiem znaków
title	`String!`	Tytuł nowej kolumny.

Zmiana wartości kolumny

Zmienia wartość kolumny w formacie JSON. Zwraca Column.

Na tablicach wielopoziomowych zmiana kolumn zbiorczych jest zablokowana, jeśli element ma co najmniej jeden podelement.

mutation {
  change_column_value(
    board_id: 1234567890
    item_id: 9876543210
    column_id: "email9",
    value: "{\"text\":\"test@gmail.com\",\"email\":\"test@gmail.com\"}"
  ) {
    id
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `mutation ($board_id: ID!, $item_id: ID!, $column_id: String!, $column_value: JSON!) { change_column_value (board_id: $board_id, item_id: $item_id, column_id: $column_id, value: $column_value) {id}}`;
const variables = {
  board_id: 9571351437,
  item_id: 9571351485,
  column_id: "email_mksr9hcd", // email column
  column_value: JSON.stringify({
    text: "Dabba Baz",
    email: "dabba@tuesday.biz",
  })
};
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument	Typ	Opis
board_id	`ID!`	Unikalny identyfikator tablicy.
column_id	`String!`	Unikalny identyfikator kolumny.
create_labels_if_missing	`Boolean`	Tworzy etykiety statusu lub listy rozwijanej, jeśli ich brakuje. Wymaga uprawnień do zmiany struktury tablicy.
item_id	`ID`	Unikalny identyfikator elementu.
value	`JSON!`	Nowa wartość kolumny w formacie JSON. Informacje o typach kolumn i ich formatach znajdziesz w dokumentacji typów kolumn.

Zmiana prostej wartości kolumny

Zmienia wartość kolumny w formie ciągu znaków. Zwraca Column.

mutation {
  change_simple_column_value(
    board_id: 1234567890
    item_id: 9876543210
    column_id: "status"
    value: "Working on it"
  ) {
    id
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `mutation ($board_id: ID!, $item_id: ID!, $column_id: String!, $column_value: String!) { change_simple_column_value (board_id: $board_id, item_id: $item_id, column_id: $column_id, value: $column_value) {id}}`;
const variables = {
  board_id: 9571351437,
  item_id: 9571351485,
  column_id: "email_mksr9hcd",
  // Each column type has a different value structure
  // Check "Column types reference" section for different values
  column_value: "dabba@monday.com dabba@monday.com"
};
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument	Typ	Opis
board_id	`ID!`	Unikalny identyfikator tablicy.
column_id	`String!`	Unikalny identyfikator kolumny.
create_labels_if_missing	`Boolean`	Tworzy etykiety statusu lub listy rozwijanej, jeśli ich brakuje. Wymaga uprawnień do zmiany struktury tablicy.
item_id	`ID`	Unikalny identyfikator elementu.
value	`String`	Nowa prosta wartość kolumny.

Zmiana wartości wielu kolumn

Zmienia wartości wielu kolumn w formacie JSON. Zwraca Column.

Każda kolumna ma swój typ, a różne typy kolumn wymagają różnych zestawów parametrów do zmiany ich wartości. Wysyłając dane w argumencie column_values, użyj ciągu znaków i utwórz go na podstawie tego przykładu: {\"text\": \"New text\", \"status\": {\"label\": \"Done\"}}

W tej mutacji możesz też używać wartości prostych (String) razem ze zwykłymi wartościami (JSON) albo samych wartości prostych. Oto przykład ustawienia statusu za pomocą prostej wartości: {\"text\": \"New text\", \"status\": \"Done\"}

mutation {
  change_multiple_column_values(
    item_id: 1234567890
    board_id: 9876543210
    column_values: "{\"status\":{\"index\":1},\"date4\":{\"date\":\"2021-01-01\"},\"person\":{\"personsAndTeams\":[{\"id\":9603417,\"kind\":\"person\"}]}}"
  ) {
    id
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `mutation ($board_id: ID!, $item_id: ID!,  $column_value: JSON!) {change_multiple_column_values (item_id: $item_id, board_id: $board_id, column_values: $column_value) {id}}`;
const variables = {
  board_id: 9571351437,
  item_id: 9571351485,
  column_id: "email_mksr9hcd",
  // Each column type has a different value structure
  // Check "Column types reference" section for different values
  column_value: JSON.stringify({
    color_mksreyj6: "In progress",
    date_mksr13fh: "2025-08-27",
    multiple_person_mksr4ka7: "dabba.baz@gmail.com",
  })
};
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument	Typ	Definicja
board_id	`ID!`	Unikalny identyfikator tablicy zawierającej kolumny do zmiany.
column_values	`JSON!`	Zaktualizowane wartości kolumn.
create_labels_if_missing	`Boolean`	Tworzy etykiety statusu lub listy rozwijanej, jeśli ich brakuje. Wymaga uprawnień do zmiany struktury tablicy.
item_id	`ID`	Unikalny identyfikator elementu do zmiany.

Zmiana tytułu kolumny

Zmienia tytuł istniejącej kolumny. Zwraca Column.

mutation {
  change_column_title(
    board_id: 1234567890
    column_id: "status"
    title: "new_status"
  ) {
    id
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `mutation ($board_id: ID!, $column_id: String!, $title: String!) {change_column_title (board_id: $board_id, column_id: $column_id, title: $title) {id}}`;
const variables = {
  board_id: 9571351437,
  column_id: "status",
  title: "New title"
};
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument	Typ	Definicja
board_id	`ID!`	Unikalny identyfikator tablicy zawierającej kolumnę do zmiany.
column_id	`String!`	Unikalny identyfikator kolumny.
title	`String!`	Nowy tytuł kolumny.

Aktualizacja kolumny

Aktualizuje kolumnę. Zwraca Column.

Dane wejściowe są sprawdzane względem schematu typu kolumny przed zastosowaniem zmian.

mutation {
  update_column(
    board_id: 1234567890
    id: "status"
    title: "Work Status"
    description: "This is my updated work status column"
    column_type: status
    width: 200
    revision: "a73d19e54f82c0b7d1e348f5ac92b6de"
  ) {
    id
    title
    description
  }
}

Argumenty

Argument	Typ	Opis
board_id	`ID!`	Unikalny identyfikator tablicy, na której znajduje się aktualizowana kolumna.
capabilities	`ColumnCapabilitiesInput`	Konfiguracja możliwości nowej kolumny. Jeśli jej nie podasz, zostaną użyte wartości domyślne: na tablicach wielopoziomowych kolumny liczb, dat, osi czasu i statusu są tworzone z włączoną możliwością obliczania; w pozostałych przypadkach nie są stosowane żadne możliwości. Aby zmienić to ustawienie domyślne na tablicach wielopoziomowych, przekaż pusty argument - kolumna zostanie utworzona bez możliwości.
column_type	`ColumnType!`	Typ aktualizowanej kolumny. Określa, które właściwości są prawidłowe w argumencie `defaults`.
description	`String`	Opis aktualizowanej kolumny.
id	`String!`	Unikalny identyfikator aktualizowanej kolumny określony przez użytkownika. Jeśli go nie podasz, zostanie automatycznie wygenerowany nowy identyfikator. Podany identyfikator musi spełniać następujące wymagania: Długość od 1 do 20 znaków włącznie Wyłącznie małe litery (a-z) i znaki podkreślenia (_) Musi być unikalny (żadna inna kolumna na tablicy nie może mieć tego samego identyfikatora) Nie można ponownie użyć identyfikatorów kolumn, nawet jeśli kolumna została usunięta z tablicy Nie może mieć wartości null, być pusty ani być pustym ciągiem znaków
revision	`String!`	Bieżąca rewizja kolumny. Służy do optymistycznej kontroli współbieżności.
settings	`JSON`	Ustawienia kolumny zależne od jej typu, zapisane w formacie JSON. Aby zobaczyć dostępne właściwości, wywołaj zapytanie `get_column_type_schema`.
title	`String`	Tytuł aktualizowanej kolumny.
width	`Int`	Zaktualizowana szerokość kolumny w pikselach.

Zmiana metadanych kolumny

Aktualizuje tytuł lub opis istniejącej kolumny. Zwraca Column.

mutation {
  change_column_metadata(
    board_id: 1234567890
    column_id: "date4"
    column_property: description
    value: "This is my awesome date column"
  ) {
    id
    title
    description
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `mutation ($board_id: ID!, $column_id: String!, $desc: String!) {change_column_metadata (board_id: $board_id, column_id: $column_id, column_property: description, value: $desc) {id}}`;
const variables = {
  board_id: 9571351437,
  column_id: "status",
  desc: "New title"
};
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument	Typ	Definicja	Wartości wyliczeniowe
board_id	`ID!`	Unikalny identyfikator tablicy zawierającej kolumnę do zmiany.
column_id	`String!`	Unikalny identyfikator kolumny.
column_property	`ColumnProperty`	Właściwość, którą chcesz zmienić.	`description` `title`
value	`String`	Nowa wartość tej właściwości.

Usuwanie kolumny

Usuwa jedną kolumnę z tablicy. Zwraca Column.

mutation {
  delete_column(
    board_id: 1234567890
    column_id: "status"
  ) {
    id
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `mutation ($board_id: ID!, $column_id: String!) { delete_column(board_id: $board_id, column_id: $column_id) { id }}`;
const variables = {
  board_id: 9571351437,
  column_id: "status",
};
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument	Typ	Opis
board_id	`ID!`	Unikalny identyfikator tablicy zawierającej kolumnę do usunięcia.
column_id	`String!`	Unikalny identyfikator kolumny.

Mam problem z tym tematem Źródło: developer.monday.com