Dokumentacja dla programistów

Inne typy

Aktualizacja 2026-09-06

Interfejs API monday.com portfolio umożliwia tworzenie tablic rozwiązań portfolio.

Każdy z opisanych poniżej typów obiektów reprezentuje określoną część rozwiązania portfolio. Możesz używać tych typów obiektów do przekazywania metadanych w mutacjach lub określania pól zwracanych w zapytaniach.

ConnectProjectResult

Obiekt zawierający wynik połączenia portfolio z tablicą projektu za pomocą interfejsu API.

Field Description
message String Wiadomość opisująca wynik operacji.
portfolio_item_id String Unikalny identyfikator utworzonego elementu portfolio (jeśli operacja się powiodła).
process_id ID Unikalny identyfikator procesu zwracany podczas używania callback_url. Użyj go, aby powiązać odpowiedź zwrotną z procesem. Dostępny od wersji 2026-07.
success Boolean Informacja o tym, czy operacja się powiodła.

ConvertBoardToProjectInput

Obiekt zawierający właściwości tablicy.

Pole Opis Obsługiwane pola podrzędne
board_id ID! Unikalny identyfikator tablicy do konwersji.
callback_url String Adres URL, na który mają być wysyłane wyniki operacji asynchronicznej (opcjonalny, ale zalecany).
column_mappings ColumnsMappingInput! Mapowanie kluczy pól projektu na istniejące identyfikatory kolumn tablicy. project_owner ID!
project_status ID!
project_timeline ID!

ColumnsMappingInput

Obiekt zawierający właściwości mapowania kolumn.

Pole Opis
project_owner ID! Kolumna reprezentująca właściciela projektu.
project_status ID! Kolumna reprezentująca status projektu.
project_timeline ID! Kolumna reprezentująca oś czasu lub daty projektu.

ConvertBoardToProjectResult

Obiekt zawierający wynik konwersji istniejącej tablicy na tablicę projektu za pomocą interfejsu API.

Pole Opis
message String Wiadomość opisująca wynik operacji.
process_id String Unikalny identyfikator wygenerowany dla tego procesu i wysłany w żądaniu zwrotnym.
projectId ID Unikalny identyfikator nowej tablicy projektu.
success Boolean Informacja o tym, czy operacja się powiodła.

CreatePortfolioResult

Obiekt zawierający wynik utworzenia nowej tablicy portfolio za pomocą interfejsu API.

Pole Opis
message String Wiadomość opisująca wynik operacji.
process_id ID Unikalny identyfikator procesu zwracany podczas używania callback_url. Ta sama wartość jest uwzględniana w danych wywołania zwrotnego, aby umożliwić powiązanie początkowego żądania z powiadomieniem o zakończeniu. Zwraca null, jeśli nie podano callback_url. Dostępny od wersji 2026-07.
solution_live_version_id String Unikalny identyfikator szablonu rozwiązania użytego do utworzenia portfolio. To nie jest identyfikator tablicy portfolio - użyj procesu z callback_url, aby pobrać bezpośrednio portfolio_id, albo odpytuj tablice obszaru roboczego.
success Boolean Informacja o tym, czy operacja się powiodła.

CreateProjectInput

Dostępne tylko w wersjach 2026-04 i nowszych

Obiekt zawierający właściwości nowej tablicy projektu.

Pole Opis Akceptowane wartości
board_kind BoardKind! Ustawienie prywatności tablicy. Domyślnie public. private
public
share
callback_url String Adres URL, na który po asynchronicznym utworzeniu projektu zostanie wysłany jego identyfikator.
companions [String!] Lista dodatkowych funkcji do włączenia. Obecnie obsługuje tylko "resource_planner". Nie można używać razem z template_id. "resource_planner"
folder_id String Unikalny identyfikator folderu, z którym ma być powiązany projekt. Jeśli używasz go razem z workspace_id, folder musi znajdować się w podanym obszarze roboczym.
name String! Nazwa tablicy.
template_id ID Unikalny identyfikator szablonu, na podstawie którego ma zostać utworzony projekt. Obecnie obsługiwane są tylko szablony rozwiązań. Nie można używać razem z companions.
workspace_id String Unikalny identyfikator obszaru roboczego, z którym ma być powiązany projekt. Jeśli go nie podasz, projekt zostanie utworzony w domyślnym obszarze roboczym.

CreateProjectResult

Dostępne tylko w wersjach 2026-04 i nowszych

Obiekt zawierający wynik utworzenia tablicy projektu za pomocą interfejsu API.

Pole Opis
error String Komunikat o błędzie zwracany, gdy żądanie się nie powiedzie.
message String Wiadomość zwracana, gdy żądanie się powiedzie.
process_id ID Unikalny identyfikator procesu służący do śledzenia żądania. Zwracany tylko wtedy, gdy podano callback_url. Ten identyfikator zostanie uwzględniony w danych wywołania zwrotnego, aby powiązać początkowe żądanie z powiadomieniem o zakończeniu. Zwraca null, jeśli nie podano callback_url.
success Boolean Informacja o tym, czy operacja się powiodła.