Inne typy
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. |
privatepublicshare |
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. |