Zaloguj się
Nowe zgłoszenie
Dokumentacja dla programistów›Dokumentacja API (rdzeń)›Inne typy
Dokumentacja dla programistów

Inne typy

Dokumentacja API (rdzeń)Dokumentacja API
Aktualizacja 2026-09-06

Interfejsy API monday.com blocks umożliwiają tworzenie, odczytywanie, aktualizowanie i usuwanie bloków dokumentów monday docs.

Poniższe typy są używane przez zapytania i mutacje dotyczące bloków. Nie można ich odpytywać niezależnie.

CreateBlockInput

Obiekt zawierający dane wejściowe bloku, pogrupowane według typu bloku.

Pole Typ Opis
divider_block DividerBlockInput Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków separatora.
image_block ImageBlockInput Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków obrazu.
layout_block LayoutBlockInput Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków układu.
list_block ListBlockInput Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków listy.
notice_box_block NoticeBoxBlockInput Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków pola informacyjnego.
page_break_block PageBreakBlockInput Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków podziału strony.
table_block TableBlockInput Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków tabeli.
text_block TextBlockInput Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków tekstu.
video_block VideoBlockInput Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków wideo.

DividerBlockInput

Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków separatora.

Pole Typ Opis
parent_block_id String Unikalny identyfikator bloku nadrzędnego, pod którym zostanie utworzony nowy blok.

ImageBlockInput

Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków obrazu.

Pole Typ Opis
parent_block_id String Unikalny identyfikator bloku nadrzędnego, pod którym zostanie utworzony nowy blok.
asset_id ID Identyfikator zasobu monday.com przypisanego do obrazu.
public_url String Publiczny adres URL obrazu.
width Int Szerokość obrazu.

LayoutBlockInput

Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków układu.

Pole Typ Opis
column_count Int! Liczba kolumn w układzie.
column_style [ColumnStyleInput!] Konfiguracja stylu kolumn.
parent_block_id String Unikalny identyfikator bloku nadrzędnego, pod którym zostanie utworzony nowy blok.

ColumnStyleInput

Tablica zawierająca konfigurację stylu kolumn.

Pole Typ Opis
width Int! Szerokość kolumny w procentach.

Sposób użycia i działanie

Po utworzeniu układu system automatycznie generuje column_count podrzędnych bloków komórek - po jednym dla każdej kolumny. Sam blok układu pełni funkcję kontenera, a każda komórka ma parentBlockId === <layout-block-id>, dzięki czemu jest bezpośrednim blokiem nadrzędnym dla treści umieszczonej w danej kolumnie. Odpowiedź z operacji tworzenia zawiera też uporządkowaną listę wygenerowanych identyfikatorów komórek w content[0].cells. Jest to jednowymiarowa tablica, w której komórki są ułożone od lewej do prawej.

Zalecany sposób postępowania

  1. Utwórz układ i zapisz jego identyfikator.
  2. Pobierz identyfikatory bloków komórek z content[0].cells w odpowiedzi albo przez wysłanie zapytania o bloki podrzędne układu.
  3. Utwórz zbiorczo bloki podrzędne (np. textBlock, imageBlock), używając parentBlockId = matrix[row][col]. Używaj afterBlockId tylko do ustalania kolejności bloków równorzędnych w tej samej komórce.

ListBlockInput

Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków listy.

Pole Typ Opis Wartości wyliczeniowe
alignment BlockAlignment Wyrównanie bloku listy. CENTER
LEFT
RIGHT
delta_format [OperationInput!]! Tablica operacji określających treść tekstową i atrybuty bloku listy.
direction BlockDirection Kierunek wyświetlania tekstu w bloku listy. LTR
RTL
indentation Int Poziom wcięcia elementu listy.
list_block_type ListBlock Typ bloku listy. Domyślna wartość to BULLETED_LIST. BULLETED_LIST
CHECK_LIST
NUMBERED_LIST
parent_block_id String Unikalny identyfikator bloku nadrzędnego, pod którym zostanie utworzony nowy blok.

NoticeBoxBlockInput

Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków pola informacyjnego. Po utworzeniu zapisz identyfikator bloku pola informacyjnego. Każdy blok, który ma się w nim znaleźć, musi używać tego identyfikatora jako wartości parent_block_id.

Pole Typ Opis Wartości wyliczeniowe
parent_block_id String Unikalny identyfikator bloku nadrzędnego, pod którym zostanie utworzony nowy blok.
theme NoticeBoxTheme! Opcje motywu stosowane w bloku pola informacyjnego. GENERAL
INFO
TIPS
WARNING

PageBreakBlockInput

Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków podziału strony.

Pole Typ Opis
parent_block_id String Unikalny identyfikator bloku nadrzędnego, pod którym zostanie utworzony nowy blok.

TableBlockInput

Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków tabeli.

Aby łatwiej tworzyć tabele, użyj add_content_to_doc_from_markdown i przekaż tabele w formacie Markdown zamiast tworzyć bloki tabeli ręcznie.

Pole Typ Opis
column_count Int! Liczba kolumn w tabeli.
column_style [ColumnStyleInput!] Konfiguracja stylu kolumn.
parent_block_id String Unikalny identyfikator bloku nadrzędnego, pod którym zostanie utworzony nowy blok.
row_count Int! Liczba wierszy w tabeli.
width Int Szerokość tabeli.

Sposób użycia i działanie

Po utworzeniu tabeli system automatycznie generuje siatkę podrzędnych bloków komórek o wymiarach row_count × column_count - po jednym bloku dla każdej komórki. Każda komórka ma parentBlockId === <table-block-id> i pełni funkcję bezpośredniego bloku nadrzędnego dla swojej zawartości. Aby odwołać się do komórek, zawsze używaj macierzy dwuwymiarowej zwracanej w content[0].cells.

Macierz jest uporządkowana wierszami (matrix[rowIndex][columnIndex]). Nie należy polegać na kolejności zwracanej przez docs { blocks { ... } }, ponieważ zależy ona od implementacji.

Zalecany sposób postępowania

  1. Utwórz tabelę i zapisz jej identyfikator.
  2. Pobierz content[0].cells, aby uzyskać macierz identyfikatorów komórek.
  3. Utwórz zbiorczo bloki podrzędne (np. textBlock, imageBlock), używając parentBlockId = matrix[row][col]. Używaj afterBlockId tylko do ustalania kolejności bloków równorzędnych w tej samej komórce.

TextBlockInput

Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków tekstu.

Pole Typ Opis Wartości wyliczeniowe
alignment BlockAlignment Wyrównanie bloku tekstu. CENTER
LEFT
RIGHT
delta_format [OperationInput!]! Tablica operacji określających treść tekstową i atrybuty bloku tekstu.
direction BlockDirection Kierunek wyświetlania tekstu w bloku. LTR
RTL
parent_block_id String Unikalny identyfikator bloku nadrzędnego, pod którym zostanie utworzony nowy blok.
text_block_type TextBlock Typ bloku tekstu. Domyślna wartość to NORMAL_TEXT. CODE
LARGE_TITLE (H1)
MEDIUM_TITLE (H2)
NORMAL_TEXT (H3)
QUOTE
SMALL_TITLE

VideoBlockInput

Obiekt zawierający dane wejściowe potrzebne do utworzenia bloków wideo.

Pole Typ Opis
parent_block_id String Unikalny identyfikator bloku nadrzędnego, pod którym zostanie utworzony nowy blok.
raw_url String! Surowy adres URL filmu.
width Int Szerokość filmu.

DocumentBlockV2

Obiekt zawierający uporządkowaną treść, hierarchiczne relacje i powiązane metadane bloku treści.

Pole Typ Opis Możliwe typy
content [BlockContent]! Uporządkowana tablica zawartości bloku. DividerContent
ImageContent
LayoutContent
ListBlockContent
NoticeBoxContent
PageBreakContent
TableContent
TextBlockContent
VideoContent
created_at String Data utworzenia bloku.
created_by User Osoba, która utworzyła blok.
doc_id ID Unikalny identyfikator dokumentu, do którego należy blok.
id ID! Unikalny identyfikator bloku.
parent_block_id String Unikalny identyfikator bloku nadrzędnego. W przypadku bloków najwyższego poziomu wartość wynosi null.
position Float Pozycja bloku w dokumencie. Wyższe wartości oznaczają położenie bliżej końca dokumentu.
type String Typ zawartości bloku.
updated_at String Data ostatniej aktualizacji bloku.

BlockContent

Abstrakcyjny typ unii reprezentujący różne typy zawartości bloków. Wszystkie typy BlockContent implementują interfejs DocBaseBlockContent. Oznacza to, że mają wspólne pola alignment i direction, o które można wysyłać zapytania za pośrednictwem interfejsu.

Możliwe typy Opis
DividerContent Obiekt zawierający metadane dotyczące zawartości bloku separatora.
ImageContent Obiekt zawierający metadane dotyczące zawartości bloku obrazu.
LayoutContent Obiekt zawierający metadane dotyczące zawartości bloku układu.
ListBlockContent Obiekt zawierający metadane dotyczące zawartości bloku listy.
NoticeBoxContent Obiekt zawierający metadane dotyczące zawartości bloku pola informacyjnego.
PageBreakContent Obiekt zawierający metadane dotyczące zawartości bloku podziału strony.
TableContent Obiekt zawierający metadane dotyczące zawartości bloku tabeli.
TextBlockContent Obiekt zawierający metadane dotyczące zawartości bloku tekstu.
VideoContent Obiekt zawierający metadane dotyczące zawartości bloku wideo.

DividerContent

Obiekt zawierający metadane dotyczące zawartości bloku separatora.

Pole Typ Opis Wartości wyliczeniowe
alignment BlockAlignment Wyrównanie zawartości bloku. CENTER
LEFT
RIGHT
direction BlockDirection Kierunek tekstu w zawartości bloku. LTR
RTL

ImageContent

Obiekt zawierający metadane dotyczące zawartości bloku obrazu.

Pole Typ Opis Wartości wyliczeniowe
alignment BlockAlignment Wyrównanie zawartości bloku. CENTER
LEFT
RIGHT
direction BlockDirection Kierunek tekstu w zawartości bloku. LTR
RTL
public_url String! Publiczny adres URL obrazu.
width Int Szerokość obrazu.

LayoutContent

Obiekt zawierający metadane dotyczące zawartości bloku układu.

Pole Typ Opis Wartości wyliczeniowe
alignment BlockAlignment Wyrównanie zawartości bloku. CENTER
LEFT
RIGHT
cells [Cell!] Jednowymiarowa tablica komórek.
column_style [ColumnStyle!] Konfiguracja stylu kolumn.
direction BlockDirection Kierunek tekstu w zawartości bloku. LTR
RTL

Cell

Obiekt zawierający metadane komórki w bloku układu lub tabeli.

Pole Typ Opis
block_id String! Unikalny identyfikator bloku reprezentującego komórkę (bloku nadrzędnego dla wszystkich bloków zawartości w komórce).

ColumnStyle

Obiekt zawierający konfigurację stylu kolumn.

Pole Typ Opis
width Int! Szerokość kolumny w procentach.

ListBlockContent

Obiekt zawierający metadane dotyczące zawartości bloku listy.

Pole Typ Opis Wartości wyliczeniowe
alignment BlockAlignment Wyrównanie zawartości bloku. CENTER
LEFT
RIGHT
delta_format [Operation!]! Tablica zawierająca treść tekstową bloku w formacie delta.
direction BlockDirection Kierunek tekstu w zawartości bloku. LTR
RTL
indentation Int Poziom wcięcia elementu listy.

NoticeBoxContent

Obiekt zawierający metadane dotyczące zawartości bloku pola informacyjnego.

Pole Typ Opis Wartości wyliczeniowe
alignment BlockAlignment Wyrównanie zawartości bloku. CENTER
LEFT
RIGHT
direction BlockDirection Kierunek tekstu w zawartości bloku. LTR
RTL
theme NoticeBoxTheme! Motyw bloku pola informacyjnego. GENERAL
INFO
TIPS
WARNING

PageBreakContent

Obiekt zawierający metadane dotyczące zawartości bloku podziału strony.

Pole Typ Opis Wartości wyliczeniowe
alignment BlockAlignment Wyrównanie zawartości bloku. CENTER
LEFT
RIGHT
direction BlockDirection Kierunek tekstu w zawartości bloku. LTR
RTL

TableContent

Obiekt zawierający metadane dotyczące zawartości bloku tabeli.

Pole Typ Opis Wartości wyliczeniowe
alignment BlockAlignment Wyrównanie zawartości bloku. CENTER
LEFT
RIGHT
cells [TableRow!] Dwuwymiarowa tablica komórek (wiersze i kolumny).
column_style [ColumnStyle!] Konfiguracja stylu kolumn.
direction BlockDirection Kierunek tekstu w zawartości bloku. LTR
RTL
width Int Szerokość tabeli.

ColumnStyle

Obiekt zawierający konfigurację stylu kolumn.

Pole Typ Opis
width Int! Szerokość kolumny w procentach.

TableRow

Obiekt zawierający konfigurację wiersza tabeli.

Pole Typ Opis
row_cells [Cell!]! Komórki wiersza.

TextBlockContent

Obiekt zawierający metadane dotyczące zawartości bloku tekstu.

Pole Typ Opis Wartości wyliczeniowe
alignment BlockAlignment Wyrównanie zawartości bloku. CENTER
LEFT
RIGHT
delta_format [Operation!]! Tablica zawierająca treść tekstową bloku w formacie delta.
direction BlockDirection Kierunek tekstu w zawartości bloku. LTR
RTL

VideoContent

Obiekt zawierający metadane dotyczące zawartości bloku wideo.

Pole Typ Opis Wartości wyliczeniowe
alignment BlockAlignment Wyrównanie zawartości bloku. CENTER
LEFT
RIGHT
direction BlockDirection Kierunek tekstu w zawartości bloku. LTR
RTL
url String! Surowy adres URL filmu.
width Int Szerokość filmu.

Operation

Tablica operacji określających treść tekstową i atrybuty bloku.

Pole Typ Opis
attributes Attributes Obiekt zawierający opcjonalne opcje formatowania tekstu.
insert InsertOps Obiekt zawierający treść do wstawienia.

Attributes

Obiekt zawierający opcjonalne opcje formatowania tekstu.

Pole Typ Opis
background String Kolor tła (HEX, RGB lub nazwa koloru).
bold Boolean Określa, czy tekst ma być pogrubiony.
code Boolean Określa, czy do tekstu ma być zastosowane formatowanie kodu.
color String Kolor tekstu (HEX, RGB lub nazwa koloru).
italic Boolean Określa, czy tekst ma być zapisany kursywą.
link String Adres URL, do którego ma prowadzić hiperłącze.
strike Boolean Określa, czy tekst ma być przekreślony.
underline Boolean Określa, czy tekst ma być podkreślony.

InsertOps

Obiekt zawierający treść do wstawienia.

Pole Typ Opis Możliwe typy
blot BlotContent Uporządkowane dane w bloku tekstu. DocsColumnValue
Mention
text String Zwykła treść tekstowa.

DocsColumnValue

Obiekt zawierający odwołanie do wartości kolumny wyświetlającej dane z kolumny elementu tablicy.

Pole Typ Opis
column_id String Unikalny identyfikator kolumny.
item_id Int Unikalny identyfikator elementu.

Mention

Obiekt zawierający metadane wzmianki o użytkowniku lub dokumencie.

Pole Typ Opis Wartości wyliczeniowe
id Int Unikalny identyfikator wspomnianego użytkownika lub dokumentu.
type DocsMention Typ wzmianki. BOARD
DOC
USER

OperationInput

Tablica operacji określających treść tekstową i atrybuty bloku.

Pole Typ Opis
attributes AttributesInput Obiekt zawierający opcjonalne opcje formatowania tekstu.
insert InsertOpsInput! Obiekt zawierający treść do wstawienia.

AttributesInput

Obiekt zawierający opcjonalne opcje formatowania tekstu.

Pole Typ Opis
background String Kolor tła (HEX, RGB lub nazwa koloru).
bold Boolean Określa, czy tekst ma być pogrubiony.
code Boolean Określa, czy do tekstu ma być zastosowane formatowanie kodu.
color String Kolor tekstu (HEX, RGB lub nazwa koloru).
italic Boolean Określa, czy tekst ma być zapisany kursywą.
link String Adres URL, do którego ma prowadzić hiperłącze.
strike Boolean Określa, czy tekst ma być przekreślony.
underline Boolean Określa, czy tekst ma być podkreślony.

InsertOpsInput

Obiekt zawierający treść do wstawienia.

Pole Typ Opis
blot BlotInput Uporządkowane dane w bloku tekstu.
text String Zwykła treść tekstowa.

BlotInput

Obiekt zawierający uporządkowane dane w bloku tekstu.

Pole Typ Opis
column_value DocsColumnValueInput Odwołanie do wartości kolumny wyświetlającej dane z kolumny elementu tablicy.
mention MentionInput Metadane wzmianki o użytkowniku lub dokumencie.

DocsColumnValueInput

Obiekt zawierający odwołanie do wartości kolumny wyświetlającej dane z kolumny elementu tablicy.

Pole Typ Opis
column_id String! Unikalny identyfikator kolumny.
item_id Int! Unikalny identyfikator elementu.

MentionInput

Obiekt zawierający metadane wzmianki o użytkowniku lub dokumencie.

Pole Typ Opis Wartości wyliczeniowe
id Int! Unikalny identyfikator wspomnianego użytkownika lub dokumentu.
type DocsMention! Typ wzmianki. BOARD
DOC
USER
Mam problem z tym tematem Źródło: developer.monday.com