Dokumentacja dla programistów

Informacje o wydaniach

O API monday.comDokumentacja API
Aktualizacja 2026-10-30

Release candidate. 2027-01 may still change before it becomes the current version on January 15, 2027.


Aktywnie obsługiwane wersje

Ten dokument zawiera listę aktywnie obsługiwanych wersji API w odwrotnej kolejności chronologicznej. Dzięki temu szybko sprawdzisz najnowsze funkcje, poprawki i zmiany.

Wersje wcześniejsze niż 2025-04 są przestarzałe i nie są już obsługiwane. Zebraliśmy je jednak w sekcji Przestarzałe wersje na końcu dokumentu, aby ułatwić migrację i rozwiązywanie problemów.

2026-10

Zmiany powodujące niezgodność

  • Migracja encji User, która rozpoczęła się w wersji 2026-07, zostaje zakończona w wersji 2026-10. Zobacz przewodnik po migracji encji User.
  • Usunięto następujące starsze pola User: photo_original, photo_thumb, photo_thumb_small, photo_tiny, photo_small, is_guest, is_admin, is_view_only, is_pending, enabled, is_verified, join_date, encrypt_api_token i sign_up_product_kind.
  • Usunięto argumenty kind, newest_first i non_active w Query.users. Zamiast nich używaj user_kind, sort i status.
  • WorkForms:
  • Usunięto mutację update_form_tag. Zamiast niej usuń tag i utwórz go ponownie. Zobacz dokumentację referencyjną Form.
  • Usunięto typ wyliczeniowy FormFormat oraz pole format w FormLayout i FormLayoutInput. Przed migracją usuń odwołania do format i FormFormat.
  • Usunięto pole value w FormTag i CreateFormTagInput. Przed migracją usuń zapytania lub dane wejściowe, które używają pola value w tagach formularzy.
  • Usunięto typ wejściowy UpdateFormTagInput (używany wyłącznie przez usuniętą mutację update_form_tag).
  • Usunięto FormQuestion.showIfRules (camelCase). Zamiast niego używaj show_if_rules (snake_case).

Zmiany niewymagające dostosowania

  • Nowe pole search.users w SearchNamespace - umożliwia wyszukiwanie użytkowników według imienia i nazwiska lub adresu e-mail. Zwraca SearchUserResults z danymi z indeksu i opcjonalnym pobieraniem aktualnych danych.
  • Nowe pole search.updates w SearchNamespace - umożliwia wyszukiwanie aktualizacji według treści, tablicy, twórcy i zakresu dat. Zwraca SearchUpdateResults z danymi z indeksu i opcjonalnym pobieraniem aktualnych danych.
  • Nowe pole search.timeline_items w SearchNamespace - umożliwia wyszukiwanie elementów osi czasu w sekcji Emails & Activities według tytułu, podsumowania i treści. Wyniki można filtrować według tablicy, obszaru roboczego, elementu, TimelineItemKind, TimelineItemProductKind i zakresu dat. Zwraca SearchTimelineItemResults z danymi z indeksu i opcjonalnym pobieraniem aktualnych danych.
  • Nowa mutacja promote_app umożliwia asynchroniczne opublikowanie wersji roboczej aplikacji.
  • Nowy typ DeveloperAppVersion i typ wyliczeniowy AppVersionStatus umożliwiają śledzenie statusu publikowania wersji aplikacji.
  • Nowe pole versions w App - zwraca [DeveloperAppVersion!] i umożliwia sprawdzanie statusu publikowania wersji.
  • Nowe pole show_if_rules (snake_case) w FormQuestion zastępuje usunięty alias showIfRules (camelCase).
  • Nowe zapytanie template_installation_status umożliwia sprawdzanie statusu asynchronicznej instalacji szablonu za pomocą process_id i zwraca utworzone identyfikatory tablic. Zwraca TemplateInstallationStatusResult.
  • Nowa mutacja use_template instaluje szablon w tle i zwraca process_id, którego można użyć do sprawdzenia statusu za pomocą template_installation_status (zobacz dokumentację referencyjną Templates).
  • Nowa mutacja run_prompt uruchamia pojedynczy prompt w modelu AI hostowanym przez monday.com i zwraca wygenerowany tekst. Przyjmuje opcjonalny typ RunPromptConfigInput (model, prompt systemowy, temperatura, maksymalna liczba tokenów) i zwraca RunPromptResult. Wymaga uprawnienia do dostępu do bramy External AI (oraz zakresu AI:Consume w przypadku aplikacji). To prostsza alternatywa dla Models API. Zobacz dokumentację referencyjną AI.
  • Nowa mutacja change_board_kind zmienia typ prywatności tablicy (publiczna, prywatna lub udostępniana).
  • Nowa mutacja update_teams_board_role aktualizuje rolę tablicy dla co najmniej jednego zespołu, który już subskrybuje tablicę. Zwraca UpdateTeamsBoardRoleResponse.
  • Nowe mutacje duplicate_view i restore_view dla widoków tablicy.
  • Nowe argumenty use_mls_template i use_dataset_template w create_board - umożliwiają utworzenie tablicy na podstawie szablonu MLS (tablica wielopoziomowa) lub szablonu zestawu danych.
  • Nowa mutacja create_board_export eksportuje elementy tablicy do pliku CSV. Zwraca ExportResult, czyli unię ExportFile (eksport zakończył się podczas żądania, więc adres URL pobierania jest już dostępny) i ExportAsyncJob (eksport nadal trwa, więc trzeba sprawdzić jego status). Serwer wybiera wariant na podstawie rozmiaru tablicy i bieżącego obciążenia. Wybierz oba warianty i użyj __typename do określenia, który z nich zwrócono. Mutacja przyjmuje time_zone, który służy do formatowania wartości dat, oraz opcjonalny typ CreateBoardExportOptionsInput, obejmujący podelementy, format nagłówka, formatowanie wartości według typu kolumny oraz columns_order, które pozwala wybrać i ustawić kolejność eksportowanych kolumn. Wymaga zakresu boards:read i jest dostępna tylko w planach Enterprise.
  • Nowe zapytanie export_job_status umożliwia sprawdzanie statusu asynchronicznego eksportu tablicy za pomocą job_id. Zwraca ExportJobStatusInfo ze statusem ExportJobStatus, adresem URL pobierania po zakończeniu eksportu oraz ExportFailureReason, jeśli eksport się nie powiedzie. Wymaga zakresu boards:read i jest dostępne tylko w planach Enterprise.
  • Nowe Availability APIs umożliwiają zarządzanie harmonogramami pracy, dniami wolnymi firmy, przydziałami zasobów i dniami wolnymi użytkowników (PTO). Obejmują zapytania work_schedules, time_offs, resources_availability, account_availability_defaults i user_pto, a także odpowiadające im mutacje create, update, delete, assign i unassign. Zobacz dokumentację referencyjną Availability.

2026-07

Zmiany powodujące niezgodność

Jeśli integracja nie zostanie zaktualizowana, te zmiany zwykle powodują błędy walidacji lub wykonania GraphQL (nieprawidłowe argumenty lub dane wejściowe albo przekroczenie limitu).

  • Typ User i Query.users zostały gruntownie przebudowane w wersji 2026-07. Dodano nowe pola, typy, typy wyliczeniowe i argumenty zapytania oraz wprowadzono obowiązkową paginację. Szczegółowe informacje i przykłady kodu znajdziesz w przewodniku po migracji encji User.
  • Argument emails w Query.users: typ elementów to teraz typ non-null ([String!]). Żądania, które zawierają null w tablicy emails, nie przejdą walidacji.
  • limit w Query.users: wartości powyżej 1000 są odrzucane z błędem (maksymalna wartość limit to 1000).
  • Zapytanie connection_board_ids: argument zmienił nazwę z connectionId na connection_id (snake_case) i jest teraz wymagany (ID!). Zmieniono też typ zwracany z [Int!] na [ID!]!. Przed migracją zaktualizuj wywołania, aby używały connection_id. Zobacz sekcję kolumna Connect Boards.
  • Board.columns: argument capabilities nie ma już wartości domyślnej. Jeśli wcześniej polegano na niej, teraz trzeba jawnie przekazać ten argument.

Zmiany niewymagające dostosowania

  • Nowe pole search.workspaces w SearchNamespace - umożliwia wyszukiwanie obszarów roboczych według nazwy, typu i opisu. Zwraca SearchWorkspaceResults z danymi z indeksu i opcjonalnym pobieraniem aktualnych danych.
  • Nowe zapytanie job_status umożliwia sprawdzanie statusu asynchronicznego zadania ogólnego przeznaczenia według zewnętrznego identyfikatora. Zwraca AsyncJobStatus.
  • Nowy argument cross_product_collaborative w mutacji set_board_permission - ustawienie go na true włącza uprawnienia do współpracy między produktami.
  • Narzędzia dla deweloperów:
  • Nowy interfejs wiersza poleceń GraphQL mcli - jednoplikowe narzędzie wiersza poleceń dla GraphQL API monday.com. Obsługuje dane wyjściowe JSON, semantyczne operacje warstwy biznesowej, webhooki i projektowanie z myślą o LLM. Zobacz przewodnik po CLI mcli.
  • Portfolio:
  • Nowy argument callback_url w mutacji create_portfolio - przekaż adres URL HTTPS, aby asynchronicznie otrzymać nowe portfolio_id. Mutacja natychmiast zwraca process_id, a po utworzeniu tablicy portfolio monday.com wysyła metodą POST do podanego adresu { is_success, process_id, portfolio_id }.
  • Nowe pole process_id w typie CreatePortfolioResult - zwracane przy użyciu callback_url; służy do powiązania operacji asynchronicznych z powiadomieniami o ich zakończeniu.
  • WorkForms:
  • Nowe wartości HOUR, DISPLAY_TEXT i PAGE_BLOCK w typie wyliczeniowym FormQuestionType.
  • Nowe opcjonalne pola w CreateQuestionInput: show_if_rules, existing_column_id, insert_after_question_id, page_block_id.
  • Nowe pola: ai_translate w FormFeaturesInput, allow_create_item w FormMondayInput, type w FormLayoutInput, is_anonymous w UpdateFormSettingsInput, label_limit_count_enabled i default_answer w FormQuestionSettingsInput, value i visible w QuestionOptionInput, show_if_rules i options w UpdateQuestionInput oraz page_block_id w QuestionOrderInput.
  • Nowe pole show_if_rules w FormQuestion (alias camelCase showIfRules zostanie usunięty w wersji 2026-10).
  • Nowe mutacje create_validation_rule, update_validation_rule i delete_validation_rule do zarządzania regułami walidacji tablicy (zobacz przewodnik po regułach walidacji).
  • Nowa mutacja create_doc_blocks z ustrukturyzowanym typem CreateBlockInput do tworzenia rozbudowanych bloków dokumentu (zobacz Document blocks V2).
  • Nowe pola inferred_metadata i manual_metadata w typie Board.
  • Typ User i Query.users zyskały nowe pola, typy, typy wyliczeniowe, typy wejściowe i argumenty. Kilka starszych pól i argumentów zostało oznaczonych jako przestarzałe i ma zostać usuniętych w wersji 2026-10. Zmieniono też działanie kilku typów skalarnych, bez dodatkowego komunikatu. Szczegółowe informacje i przykłady kodu znajdziesz w przewodniku po migracji encji User.
  • Nowe pole activity_logs w typie User umożliwia pobieranie zdarzeń dziennika aktywności użytkownika z paginacją opartą na kursorach.
  • Nowe pola w typie User: account_id, status, invitation_method, serial_number, is_deleted, photo_url, became_active_at, bb_visitor_id, is_email_confirmed i user_config.
  • Nowe zapytanie user_configs pobiera konfigurację użytkowników dla konta, zależnie od ich typu.
  • Nowe typy PhotoUrl i UserConfig w User.
  • Nowe typy wyliczeniowe UserStatus, InvitationMethod, UserKindFilter, UsersSortField i UsersSortDirection.
  • Nowe typy wejściowe UserKindFilterInput i UsersSortInput.
  • Nowe argumenty user_kind, sort, status i visibility w Query.users.
  • Argumenty kind, newest_first i non_active w Query.users zostały oznaczone jako przestarzałe i mają zostać usunięte w wersji 2026-10. Zamiast nich używaj user_kind, sort i status.
  • Następujące pola User zostały oznaczone jako przestarzałe i mają zostać usunięte w wersji 2026-10: photo_original, photo_thumb, photo_thumb_small, photo_tiny, photo_small, is_guest, is_admin, is_view_only, is_pending, enabled, is_verified, join_date, encrypt_api_token i sign_up_product_kind.
  • Ważna zmiana: zapytanie Query.users bez limit zwraca teraz domyślnie tylko 200 użytkowników (wcześniej nie było limitu). Zadania, które polegały na pobraniu pełnej listy użytkowników konta w jednym wywołaniu, pobiorą po cichu zbyt mało danych. Używaj jawnie limit i page.
  • Ważna zmiana: skalarny typ User.created_at zmienił się z Date na ISO8601DateTime! (zawiera godzinę i jest wymagany w schemacie). Klienci, którzy traktują tę wartość wyłącznie jako datę, mogą nieprawidłowo ją interpretować lub utracić część informacji.
  • Ważna zmiana: typ User.birthday zmienił się z Date na String (nie jest już dedykowanym typem skalarnym Date).
  • Ważna zmiana: typ User.utc_hours_diff zmienił się z Int na Float (różnica może obejmować ułamki godzin). Logika zakładająca liczbę całkowitą może dawać nieprawidłowe wyniki, mimo że zapytanie zakończy się powodzeniem.

2026-04

Zmiany powodujące niezgodność

Zmiany niewymagające dostosowania

2026-01

Zmiany niewymagające dostosowania

2025-10

Zmiany powodujące niezgodność

Zmiany niewymagające dostosowania


2025-07

Poprawki

  • 28 kwietnia 2025 r.: W przypadku błędów wyjątku wartości kolumny właściwość column_type nie zwraca już słowa „Column” dopisanego do typu kolumny. Więcej informacji tutaj.
  • 19 maja 2025 r.: Wszystkie odpowiedzi API zawierają teraz unikalny identyfikator żądania. Więcej informacji tutaj.

Zmiany powodujące niezgodność

Zmiany niewymagające dostosowania


2025-04

Poprawki

  • 18 lutego 2025 r.: Zmieniono format błędu informującego o wyczerpaniu budżetu złożoności. Więcej informacji tutaj.
  • 24 lutego 2025 r.: Mutacja create_webhook zwraca teraz szczegółowe informacje o błędach. Więcej informacji tutaj.
  • 24 lutego 2025 r.: Pole renewal_date nie jest już wymagane podczas pobierania szczegółów subskrypcji aplikacji. Więcej informacji tutaj.
  • 27 lutego 2025 r.: Zmieniliśmy zapytanie subitems, aby poprawić wydajność i zapewnić spójne wyniki. Więcej informacji tutaj.
  • 28 kwietnia 2025 r.: W przypadku błędów wyjątku wartości kolumny właściwość column_type nie zwraca już słowa „Column” dopisanego do typu kolumny. Więcej informacji tutaj.
  • 19 maja 2025 r.: Wszystkie odpowiedzi API zawierają teraz unikalny identyfikator żądania. Więcej informacji tutaj.

Zmiany powodujące niezgodność

  • Oznaczono jako przestarzałe wysyłanie zmiennych jako ciągu JSON.
  • Pole value zwraca teraz wartość null w kolumnach Connect Boards, zależności i podelementów.

Zmiany niewymagające dostosowania


Przestarzałe wersje

Ta sekcja zawiera wersje API, które są przestarzałe i nie są już obsługiwane. Zamieszczono je tu wyłącznie do celów historycznych i jako pomoc przy migracji. Sprawdź zasady wersjonowania API, aby poznać przyszłe terminy wycofania wersji.

2025-01

Poprawki

  • 18 lutego 2025 r.: Zmieniono format błędu informującego o wyczerpaniu budżetu złożoności. Więcej informacji tutaj.
  • 24 lutego 2025 r.: Mutacja create_webhook zwraca teraz szczegółowe informacje o błędach. Więcej informacji tutaj.
  • 24 lutego 2025 r.: Pole renewal_date nie jest już wymagane podczas pobierania szczegółów subskrypcji aplikacji. Więcej informacji tutaj.
  • 27 lutego 2025 r.: Zmieniliśmy zapytanie subitems, aby poprawić wydajność i zapewnić spójne wyniki. Więcej informacji tutaj.
  • 28 kwietnia 2025 r.: W przypadku błędów wyjątku wartości kolumny właściwość column_type nie zwraca już słowa „Column” dopisanego do typu kolumny. Więcej informacji tutaj.
  • 19 maja 2025 r.: Wszystkie odpowiedzi API zawierają teraz unikalny identyfikator żądania. Więcej informacji tutaj.

Zmiany powodujące niezgodność

Zmiany niewymagające dostosowania


2024-10

Poprawki

  • 22 października 2024 r.: Argument item_id w mutacjach pin_to_top i unpin_from_top zmienił typ z Int na ID i nie jest już wymagany. Więcej informacji tutaj.
  • 6 listopada 2024 r.: Dostosowaliśmy wersję 2024-10, aby była zgodna wstecz i rozwiązywała błędy parsowania. Więcej informacji tutaj.
  • 19 listopada 2024 r.: Aktualizacje powinny być zwracane w odwrotnej kolejności chronologicznej, a nie chronologicznej. Więcej informacji tutaj.
  • 24 lutego 2025 r.: Mutacja create_webhook zwraca teraz szczegółowe informacje o błędach. Więcej informacji tutaj.
  • 27 lutego 2025 r.: Zmieniliśmy zapytanie subitems, aby poprawić wydajność i zapewnić spójne wyniki. Więcej informacji tutaj.
  • 28 kwietnia 2025 r.: W przypadku błędów wyjątku wartości kolumny właściwość column_type nie zwraca już słowa „Column” dopisanego do typu kolumny. Więcej informacji tutaj.
  • 19 maja 2025 r.: Wszystkie odpowiedzi API zawierają teraz unikalny identyfikator żądania. Więcej informacji tutaj.

Zmiany niewymagające dostosowania


2024-07

Poprawki

  • 1 kwietnia 2024 r.: Możesz teraz filtrować kolumnę daty według wielu dokładnych dat. Pełne ogłoszenie znajdziesz tutaj.
  • 1 maja 2024 r.: Przywróciliśmy poprzednią strukturę błędu ComplexityException i poprzedni kod błędu. Więcej informacji tutaj.
  • 9 maja 2024 r.: Dodawanie obiektu data do kodów błędów zostało wycofane do wersji 2025-01. Więcej informacji tutaj.
  • 14 maja 2024 r.: Przywróciliśmy poprzedni komunikat błędu ComplexityException. Więcej informacji tutaj.
  • 19 czerwca 2024 r.: Dodano szczegółowy błąd parsowania JSON we wszystkich wersjach API. Więcej informacji tutaj.
  • 20 czerwca 2024 r.: Możesz teraz użyć mutacji add_teams_to_board, aby zasubskrybować tablicę dla wszystkich użytkowników konta. Pełne ogłoszenie znajdziesz tutaj.

Zmiany niewymagające dostosowania

2024-04

Poprawki

  • 26 marca 2024 r.: Mutacje z argumentem column_values przyjmują teraz identyfikatory zapisane jako ciągi znaków i liczby całkowite. Pełne ogłoszenie znajdziesz tutaj.
  • 1 kwietnia 2024 r.: Możesz teraz filtrować kolumnę daty według wielu dokładnych dat. Pełne ogłoszenie znajdziesz tutaj.
  • 1 maja 2024 r.: Przywróciliśmy poprzednią strukturę błędu ComplexityException, kod błędu i komunikat o błędzie. Więcej informacji tutaj.
  • 14 maja 2024 r.: Przywróciliśmy poprzedni komunikat błędu ComplexityException. Więcej informacji tutaj.
  • 19 czerwca 2024 r.: Dodano szczegółowy błąd parsowania JSON we wszystkich wersjach API. Więcej informacji tutaj.
  • 20 czerwca 2024 r.: Możesz teraz użyć mutacji add_teams_to_board, aby zasubskrybować tablicę dla wszystkich użytkowników konta. Pełne ogłoszenie znajdziesz tutaj.

Zmiany powodujące niezgodność

  • Zapytania version i versions akceptują nowe wartości typu wyliczeniowego w polu kind.
  • Zaktualizowano typy pól w zapytaniach app_installs.

Zmiany niewymagające dostosowania

2024-01

Poprawki

  • 26 marca 2024 r.: Mutacje z argumentem column_values przyjmują teraz identyfikatory zapisane jako ciągi znaków i liczby całkowite. Pełne ogłoszenie znajdziesz tutaj.
  • 1 maja 2024 r.: Przywróciliśmy poprzednią strukturę błędu ComplexityException, kod błędu i komunikat o błędzie. Więcej informacji tutaj.
  • 14 maja 2024 r.: Przywróciliśmy poprzedni komunikat błędu ComplexityException. Więcej informacji tutaj.
  • 19 czerwca 2024 r.: Dodano szczegółowy błąd parsowania JSON we wszystkich wersjach API. Więcej informacji tutaj.
  • 20 czerwca 2024 r.: Możesz teraz użyć mutacji add_teams_to_board, aby zasubskrybować tablicę dla wszystkich użytkowników konta. Pełne ogłoszenie znajdziesz tutaj.

Zmiany powodujące niezgodność

Zmiany niewymagające dostosowania

2023-10

Poprawki

  • 3 grudnia 2023 r.: Dostosowaliśmy wyniki pustych wartości pola text pobieranych za pomocą column_values V2 do zachowania z wersji 2023-07. Pełne ogłoszenie znajdziesz tutaj.
  • 26 marca 2024 r.: Mutacje z argumentem column_values przyjmują teraz identyfikatory zapisane jako ciągi znaków i liczby całkowite. Pełne ogłoszenie znajdziesz tutaj.
  • 19 czerwca 2024 r.: Dodano szczegółowy błąd parsowania JSON we wszystkich wersjach API. Więcej informacji tutaj.
  • 20 czerwca 2024 r.: Możesz teraz użyć mutacji add_teams_to_board, aby zasubskrybować tablicę dla wszystkich użytkowników konta. Pełne ogłoszenie znajdziesz tutaj.

Zmiany powodujące niezgodność

  • Usunięto przestarzałe pole items w zapytaniach boards i zastąpiono je polem items_page.

  • Usunięto przestarzałe pole items w zapytaniach groups i zastąpiono je polem items_page.

  • Dodano nowe pola wartości kolumn i typowane wartości kolumn.

  • Usunięto przestarzałe obiekty items_by_column_values i items_by_multiple_column_values i zastąpiono je obiektem items_page_by_column_values.

  • Pole column_type w mutacji create_column jest teraz wymagane.

  • Puste nawiasy nie są już obsługiwane.

  • Cudzysłowy wokół ciągów znaków są teraz wymagane.

  • Usunięto przestarzałe pola pos w zapytaniach dotyczących tablic i kolumn.

  • Zmieniono ciągi znaków określające typ kolumny. Pole type w zapytaniach columns zmieniło typ z String! na ColumnType!.

  • Oznaczono argument newest_first w zapytaniach boards jako przestarzały.

  • Wiele argumentów i pól ID zmieniło typ z Int na ID.

  • Pole Text zwraca puste wyniki dla kolumn lustrzanych, zależności i Connect Boards podczas pobierania za pomocą column_values lub typów MirrorValue, DependencyValue i BoardRelationValue. Zamiast niego używaj pola display_value.

Zmiany niewymagające dostosowania