Interfejsy API monday.com dla tablic umożliwiają tworzenie, odczytywanie, aktualizowanie i usuwanie tablic.

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

ItemNicknameInput

Obiekt zawierający nazwę elementu.

Field	Type	Description
plural	String	Liczba mnoga nazwy elementu
preset_type	String	Typ predefiniowany nazwy elementu.
singular	String	Liczba pojedyncza nazwy elementu.

---

item_nickname

Wartość wyliczeniowa board_attribute w mutacji update_board, która umożliwia zmianę nazwy elementu na tablicy.

mutation {
  update_board(
    board_id: 1234567890
    board_attribute: item_nickname
    new_value: "{\"preset_type\":\"other\",\"singular\":\"Task\",\"plural\":\"Tasks\"}"
  )
}

Field	Type	Description
plural	String	Liczba mnoga nazwy elementu
preset_type	String	Typ predefiniowany nazwy elementu.
singular	String	Liczba pojedyncza nazwy elementu.

---

SetBoardPermissionResponse

Obiekt zawierający wynik ustawiania uprawnień do tablicy za pomocą API.

Field	Type	Description	Enum Values
edit_permissions	BoardEditPermissions!	Określa, która grupa użytkowników może edytować zawartość tablicy. To ustawienie odzwierciedla techniczne uprawnienia do edycji tablicy.	assignee collaborators everyone owners
failed_actions	[String!]	Działania, które nie powiodły się podczas aktualizowania uprawnień.

---

UpdateTeamsBoardRoleResponse

Obiekt zawierający wynik mutacji update_teams_board_role.

Dostępne tylko w wersjach API 2026-10 i nowszych

Field	Type	Description	Enum Values
successful_team_ids	[ID!]!	Identyfikatory zespołów, których rola na tablicy została zaktualizowana.
failed_teams	[FailedTeamBoardRoleUpdate!]!	Zespoły, których roli na tablicy nie udało się zaktualizować, wraz z przyczyną każdego niepowodzenia.

---

FailedTeamBoardRoleUpdate

Reprezentuje pojedynczy zespół, którego roli na tablicy nie udało się zaktualizować za pomocą mutacji update_teams_board_role.

Field	Type	Description	Enum Values
team_id	ID!	Identyfikator zespołu, którego nie udało się zaktualizować.
error	String!	Przyczyna niepowodzenia aktualizacji tego zespołu (np. zespół nie subskrybuje tablicy).

---

UpdateBoardHierarchyAttributesInput

Obiekt zawierający atrybuty tablicy do zaktualizowania.

Field	Type	Description
account_product_id	ID	Zaktualizowany identyfikator produktu konta dla tablicy. Musisz też podać odpowiednią wartość workspace_id w zaktualizowanym produkcie.
folder_id	ID	Zaktualizowany identyfikator folderu tablicy.
position	DynamicPosition	Zaktualizowana pozycja tablicy w menu po lewej stronie.
workspace_id	ID	Zaktualizowany identyfikator obszaru roboczego tablicy.

Dynamic position

Obiekt zawierający zaktualizowaną pozycję tablicy w menu platformy po lewej stronie.

Field	Type	Description	Enum Values
is_after	Boolean	Określa położenie docelowej tablicy względem obiektu referencyjnego: Ustaw true, aby umieścić tablicę za obiektem referencyjnym. Ustaw false, aby umieścić tablicę przed obiektem referencyjnym.
object_id	String!	Unikatowy identyfikator obiektu referencyjnego, względem którego ma zostać umieszczona docelowa tablica.
object_type	ObjectType!	Typ obiektu referencyjnego.	Board Folder Overview

---

UpdateBoardHierarchyResult

Obiekt zawierający wynik aktualizowania pozycji tablicy, produktu lub obszaru roboczego.

Field	Type	Description
board	Board	Zaktualizowana tablica.
message	String	Komunikat o wyniku operacji.
success	Boolean!	Informacja, czy operacja się powiodła.

---

BoardInferredMetadata

Opcjonalne metadane wywnioskowane dla tablicy (na przykład informacje o tym, jak w danym kontekście nazywane są elementy).

Field	Type	Description
item_type	String	Niestandardowa nazwa elementów na tej tablicy, jeśli została ustawiona.

---

BoardManualMetadata

Opcjonalne metadane podane bezpośrednio dla tablicy.

Field	Type	Description
board_md	String	Treść w formacie Markdown opisująca tablicę.

---

BoardActivityLogsPage

Zwracane przez pole activity_log typu Board. Pola nie są jeszcze tutaj opisane.

---

ExportAsyncJob

Zwracane przez create_board_export. Odpytuj export_job_status, używając wartości job_id zadania, aż jego status zmieni się na COMPLETED, FAILED lub CANCELLED. fetch_export_job_status to przestarzały alias, dostępny tylko w środowisku dev. Pola nie są jeszcze tutaj opisane.

---

ExportFile

Zakończony eksport tablicy, gotowy do pobrania. Zwracany jako jedna z gałęzi typu ExportResult, jeśli eksport zakończył się w ramach okna synchronicznego.

Field	Type	Description
download_url	String	Podpisany adres URL do pobrania wyeksportowanego pliku. Traktuj go jako poufny - każda osoba, która go ma, może pobrać plik, dopóki adres nie wygaśnie.
expires_at	String	Czas, po którym download_url przestanie działać, zapisany jako znacznik czasu ISO 8601. Nie można odświeżyć adresu URL. Wykonaj mutację ponownie, aby uzyskać nowy adres.

---

CreateBoardExportOptionsInput

Opcjonalna konfiguracja eksportu przekazywana do create_board_export. Wszystkie pola są opcjonalne. Jeśli pominiesz cały obiekt, tablica zostanie wyeksportowana z poniższymi wartościami domyślnymi.

Field	Type	Default	Description
include_subitems	Boolean	false	Uwzględnij podelementy w eksporcie.
include_item_identifiers	Boolean	false	Dodaj item_id - a także parent_item_id, jeśli include_subitems ma wartość true - jako ostatnie kolumny. Ułatwia dopasowanie wyeksportowanych wierszy do elementów.
header_row	HeaderFormat	COLUMN_ID	Określa, czy wiersz nagłówka zawiera tytuły kolumn, czy ich identyfikatory. Jeśli nie podasz wartości, domyślnie używane jest COLUMN_ID.
people_column_format	PeopleColumnFormat	-	Format wartości w kolumnie osób. Pomiń to pole, aby zachować surowe wartości identyfikatorów.
connected_item_column_format	ConnectedItemColumnFormat	NAME	Określa, czy połączone elementy (Connect boards) są wyświetlane jako nazwy, czy identyfikatory.
columns_order	[String!]	-	Identyfikatory kolumn w kolejności, w jakiej mają się pojawić w pliku. To pole także filtruje kolumny - zobacz uwagę poniżej. Pomiń je, aby wyeksportować wszystkie kolumny w kolejności z tablicy.
include_project_board_link	Boolean	-	Uwzględnij w eksporcie link do tablicy projektu. Dostępne tylko w wersjach 2027-01 i nowszych.

---

ExportResult

Typ union zwracany przez create_board_export. Zawiera albo zakończony eksport, który można od razu pobrać, albo odwołanie do trwającego zadania.

union ExportResult = ExportAsyncJob | ExportFile

Serwer wybiera zwracany typ na podstawie rozmiaru tablicy i bieżącego obciążenia. Zwracana gałąź nie jest gwarantowana i może się zmienić bez uprzedzenia, dlatego zapytanie musi obsługiwać obie możliwości. Wybierz obie gałęzie za pomocą fragmentów inline:

mutation {
  create_board_export(board_id: 1234567890) {
    ... on ExportFile {
      download_url
      expires_at
    }
    ... on ExportAsyncJob {
      job_id
    }
  }
}

Member	Meaning
ExportFile	Eksport został zakończony. Od razu użyj download_url.
ExportAsyncJob	Eksport nadal trwa. Odpytuj export_job_status, używając job_id, aż zadanie osiągnie stan końcowy.

Nie ma gałęzi oznaczającej błąd. Problemy są zwracane jako błąd GraphQL (jeśli żądanie zostanie odrzucone przed rozpoczęciem eksportu) albo jako status FAILED pola export_job_status (jeśli eksport nie powiedzie się po rozpoczęciu).

---

HeaderFormat

Format wiersza nagłówka w wyeksportowanym pliku. Używany przez pole CreateBoardExportOptionsInput.header_row.

Value	Description
TITLE	Użyj tytułów kolumn jako nagłówków. Są czytelne dla użytkowników, ale nie są unikatowe i można je zmienić w dowolnym momencie.
COLUMN_ID	Użyj identyfikatorów kolumn jako nagłówków. Są to stabilne identyfikatory - wybierz tę opcję, gdy plik będzie ponownie importowany lub przetwarzany przez skrypt.

---

ConnectedItemColumnFormat

Format wyjściowy wartości w kolumnie połączonych elementów (Connect boards). Używany przez pole CreateBoardExportOptionsInput.connected_item_column_format.

Value	Description
NAME	Użyj wyświetlanych nazw połączonych elementów (np. Task A, Task B). To wartość domyślna.
ID	Użyj identyfikatorów połączonych elementów (np. 111, 222). Wybierz tę opcję, jeśli trzeba dopasować wyeksportowane dane do elementów.

---

PeopleColumnFormat

Format wyjściowy wartości w kolumnie osób. Używany przez pole CreateBoardExportOptionsInput.people_column_format.

Value	Description
NAME	Użyj wyświetlanych nazw (np. Jordan Lee, Marketing Team) zamiast surowych identyfikatorów (np. user:123).

Pomiń tę opcję, aby zachować surowe wartości identyfikatorów. Wybierz tę opcję, jeśli wartości mają być dopasowane do konkretnych użytkowników lub zespołów.

---

ExportJobStatusInfo

Bieżący stan asynchronicznego zadania eksportu tablicy. Zwracany przez export_job_status.

Field	Type	Description
status	ExportJobStatus	Bieżący status zadania. COMPLETED, FAILED i CANCELLED to stany końcowe - zakończ odpytywanie po otrzymaniu jednego z nich.
download_url	String	Podpisany adres URL do pobrania. Jest wypełniany tylko wtedy, gdy status ma wartość COMPLETED i adres URL nie wygasł. Potem przyjmuje wartość null. Ponownie uruchom eksport, aby uzyskać nowy adres.
failure_reason	ExportFailureReason	Ustrukturyzowana przyczyna niepowodzenia zadania. Jest wypełniana tylko wtedy, gdy status ma wartość FAILED. Sprawdzaj to pole zamiast failure_message.
failure_message	String	Czytelny dla użytkownika szczegółowy opis błędu, jeśli można bezpiecznie wyświetlić tekst. Jest wypełniany tylko wtedy, gdy status ma wartość FAILED, i nawet wtedy może przyjmować wartość null.

Pamiętaj, że zadanie ze statusem COMPLETED może nadal zwracać null w polu download_url, jeśli odpytasz je po wygaśnięciu adresu. Przed użyciem sprawdź, czy pole nie ma wartości null.

---

ExportJobStatus

Status cyklu życia asynchronicznego zadania eksportu tablicy. Używany przez pole ExportJobStatusInfo.status.

Value	Terminal	Description
RUNNING	No	Eksport nadal trwa. Kontynuuj odpytywanie.
COMPLETED	Yes	Eksport zakończył się pomyślnie. Odczytaj download_url.
FAILED	Yes	Eksport nie powiódł się. Odczytaj failure_reason oraz failure_message, jeśli jest dostępne.
CANCELLED	Yes	Eksport został anulowany.

Każdą nierozpoznaną wartość traktuj jako stan końcowy. Dzięki temu nowe wartości dodane w przyszłości nie sprawią, że klient będzie odpytywać serwer bez końca.

---

ExportFailureReason

Ustrukturyzowana przyczyna niepowodzenia asynchronicznego zadania eksportu tablicy. Używana przez pole ExportJobStatusInfo.failure_reason.

Value	Retryable	Description
BOARD_UNAVAILABLE	No	Tablica została usunięta lub zarchiwizowana.
BOARD_INACCESSIBLE	No	Wywołujący utracił uprawnienia do odczytu tablicy.
ITEM_LIMIT_EXCEEDED	No	Tablica zawiera więcej elementów, niż pozwala limit eksportu.
INVALID_REQUEST	No	Żądanie zostało odrzucone podczas walidacji - na przykład z powodu nieobsługiwanej kombinacji opcji eksportu. Popraw żądanie przed ponowną próbą.
NOT_FOUND	No	Nie można znaleźć tablicy lub obiektu, do którego się odwołuje.
INTERNAL_ERROR	Yes	Wystąpił nieoczekiwany błąd wewnętrzny. Warto ponownie wykonać mutację.