Dokumentacja dla programistów

Inne typy

Aktualizacja 2026-09-06

Interfejsy API pulpitów i widżetów monday.com umożliwiają tworzenie, aktualizowanie i usuwanie pulpitów oraz widżetów.

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

Dashboard

Obiekt zawierający wynik utworzenia nowego pulpitu za pomocą API.

Pole Typ Opis Wartości wyliczeniowe
board_folder_id Int Unikalny identyfikator folderu, w którym znajduje się pulpit.
id ID Unikalny identyfikator pulpitu.
kind DashboardKind Widoczność pulpitu. PRIVATE
PUBLIC
name String Nazwa pulpitu.
workspace_id Int Unikalny identyfikator obszaru roboczego, w którym znajduje się pulpit.

ExternalWidget

Obsługiwane wartości wyliczeniowe ExternalWidget.

Wartość wyliczeniowa Opis
APP_FEATURE Widżety funkcji aplikacji służące do osadzania niestandardowych funkcji aplikacji na pulpitach. (w wersji 2026-04 i nowszych)
BATTERY Widżet baterii służy do śledzenia postępów i wizualizacji stanu realizacji.
CHART Widżet wykresu służy do wizualizacji danych (np. na wykresach kołowych, słupkowych i kolumnowych).
LISTVIEW Elementy z wielu tablic wyświetlane w formie tabeli z filtrowaniem i sortowaniem. (w wersji 2026-04 i nowszych)
NUMBER Widżet liczbowy wyświetla dane liczbowe (np. sumy, średnie, liczbę elementów i wartości łączne).

UpdateOverviewHierarchy

Obiekt zawierający wynik zaktualizowania hierarchii pulpitu za pomocą API.

Pole Typ Opis Obsługiwane pola
message String! Komunikat dotyczący wyniku operacji.
overview Overview Metadane zaktualizowanego pulpitu. created_at ISO8601DateTime
creator User!
folder_id ID
id ID!
kind String
name String!
state String!
updated_at ISO8601DateTime
workspace_id ID
success Boolean! Informacja, czy operacja zakończyła się powodzeniem.

Overview

Obiekt zawierający metadane zaktualizowanego pulpitu.

Pole Typ Opis
created_at ISO8601DateTime Data utworzenia pulpitu.
creator User! Unikalny identyfikator osoby, która utworzyła pulpit.
folder_id ID Unikalny identyfikator folderu, w którym znajduje się pulpit.
id ID! Unikalny identyfikator pulpitu.
kind String Typ pulpitu (prywatny lub publiczny).
name String! Nazwa pulpitu.
state String! Stan pulpitu.
updated_at ISO8601DateTime Data ostatniej aktualizacji pulpitu.
workspace_id ID Unikalny identyfikator obszaru roboczego, w którym znajduje się pulpit.

UpdateOverviewHierarchyAttributes

Obiekt zawierający zaktualizowane atrybuty hierarchii pulpitu.

Pole Typ Opis
account_product_id ID Unikalny identyfikator konta, do którego należy przenieść pulpit.
folder_id ID Unikalny identyfikator folderu, do którego należy przenieść pulpit.
position DynamicPosition Pozycja pulpitu w lewym panelu.
workspace_id ID Unikalny identyfikator obszaru roboczego, do którego należy przenieść pulpit.

DynamicPosition

Obiekt zawierający atrybuty elementu referencyjnego w lewym panelu, względem którego pozycjonowany jest zaktualizowany pulpit.

Pole Typ Opis Wartości wyliczeniowe
is_after Boolean Informacja, czy docelowy pulpit zostanie umieszczony za obiektem referencyjnym.
object_id String! Unikalny identyfikator obiektu, względem którego zostanie umieszczony docelowy pulpit (np. identyfikator tablicy, pulpitu lub folderu).
object_type ObjectType! Typ obiektu, który wskazuje, względem czego należy umieścić docelowy pulpit. Board
Folder
Overview

WidgetModel

Obiekt zawierający wynik utworzenia nowego widżetu za pomocą API.

Pole Typ Opis
id Int Unikalny identyfikator nowego widżetu.
kind ExternalWidget Typ nowego widżetu.
name String Nazwa nowego widżetu.
parent WidgetParentOutput Obiekt zawierający metadane kontenera nadrzędnego widżetu.

WidgetParentOutput

Obiekt zawierający właściwości elementu nadrzędnego widżetu.

Pole Typ Opis Wartości wyliczeniowe
id Int Unikalny identyfikator nadrzędnego pulpitu lub widoku tablicy.
kind WidgetParentKind Typ kontenera nadrzędnego. BOARD_VIEW
DASHBOARD

WidgetParentKind

Obsługiwane wartości wyliczeniowe WidgetParentKind.

Wartość wyliczeniowa Opis
BATTERY Widżet baterii służy do śledzenia postępów i wizualizacji stanu realizacji.
CHART Widżet wykresu służy do wizualizacji danych (np. na wykresach kołowych, słupkowych i kolumnowych).
NUMBER Widżet liczbowy wyświetla dane liczbowe (np. sumy, średnie, liczbę elementów i wartości łączne).

WidgetParentInput

Obiekt zawierający właściwości elementu nadrzędnego widżetu.

Pole Typ Opis Wartości wyliczeniowe
id Int! Unikalny identyfikator nadrzędnego pulpitu lub widoku tablicy.
kind WidgetParentKind! Typ kontenera nadrzędnego. BOARD_VIEW
DASHBOARD