Dokumentacja dla programistów

Portfolio

Aktualizacja 2026-09-06

Rozwiązanie portfolio monday.com zapewnia strukturę do zarządzania projektami zarówno z szerokiej, jak i szczegółowej perspektywy. Składa się z dwóch typów tablic:

  • Tablica portfolio: Łączy wiele tablic projektów, zapewniając zbiorczy, interaktywny przegląd wszystkich projektów.
  • Tablica projektu: Służy do zarządzania szczegółami poszczególnych projektów. Aktualizacje są automatycznie synchronizowane z tablicą portfolio.

:construction: Rozwiązania portfolio są dostępne tylko w planach Enterprise.

Tworzysz rozwiązania z agentami AI?

Zapoznaj się z przewodnikiem Portfolio Agent Skills, w którym znajdziesz wieloetapowe przepływy pracy i wzorce implementacji.

Mutacje

  • 🚧 Dostępne tylko w planach Enterprise
  • Wymagany zakres:boards:write

Utwórz tablicę portfolio

Tworzy nową tablicę portfolio. Zwraca CreatePortfolioResult.

mutation {
  create_portfolio(
    boardName: "New Portfolio Board"
    boardPrivacy: "private"
    destinationWorkspaceId: 12345
    callback_url: "https://your-domain.com/webhook/portfolio-created"
  ) {
    success
    message
    process_id
  }
}

Argumenty

Argument Typ Opis Akceptowane wartości
boardName String! Nazwa nowej tablicy portfolio.
boardPrivacy String! Ustawienia prywatności nowej tablicy portfolio. "private"
"share"
callback_url String Adres URL HTTPS, pod który asynchronicznie zostanie wysłany nowy portfolio_id. Jeśli go podasz, mutacja natychmiast zwróci process_id. Po utworzeniu tablicy portfolio w wywołaniu zwrotnym zostaną przesłane wartości { is_success, process_id, portfolio_id }. Dostępne od wersji 2026-07.
destinationWorkspaceId Int Unikalny identyfikator obszaru roboczego, w którym zostanie utworzona tablica portfolio.

Utwórz tablicę projektu

Dostępne tylko w wersjach 2026-04 i nowszych

Tworzy nową tablicę projektu. Zwraca CreateProjectResult.

mutation {
  create_project(
    input: {
      name: "Q1 2026 Marketing Campaign"
      board_kind: public
      workspace_id: "123456"
      folder_id: "9876543210"
      companions: ["resource_planner"]
      callback_url: "https://your-domain.com/webhook/project-created"
    }
  ) {
    success
    message
    process_id
    error
  }
}

Argumenty

Argument Typ Opis
input CreateProjectInput! Obiekt zawierający właściwości nowej tablicy projektu.

Przekształć tablicę w projekt

Przekształca istniejącą tablicę w tablicę projektu. Zwraca ConvertBoardToProjectResult.

mutation {
  convert_board_to_project(
    input: {
      board_id: 1234567890
      column_mappings: {
        project_status: "status_column_id"
        project_owner: "person_column_id"
        project_timeline: "date_column_id"
      }
      callback_url: "https://your-callback-url.com"
    }
  )  {
    success
    message
    process_id
    projectId
  } 
}

Argumenty

Argument Typ Opis
input ConvertBoardToProjectInput! Unikalny identyfikator tablicy portfolio, z którą ma zostać połączona tablica.

Połącz projekt z portfolio

Łączy istniejącą tablicę projektu z tablicą portfolio, tworząc połączony element w portfolio. Zwraca ConnectProjectResult.

Ta mutacja ma dodatkowy limit: 40 mutacji na minutę.

mutation {
  connect_project_to_portfolio(
    projectBoardId: 1234567890
    portfolioBoardId: 9876543210
  ) {
    portfolio_item_id
    process_id
    message
    success
  }
}

Argumenty

Argument Typ Opis
portfolioBoardId ID! Unikalny identyfikator tablicy portfolio, z którą ma zostać połączony projekt.
projectBoardId ID! Unikalny identyfikator tablicy projektu, która ma zostać połączona.
callback_url String Adres URL HTTPS, pod który asynchronicznie zostanie wysłany wynik operacji. Jeśli go podasz, mutacja natychmiast zwróci process_id. Po zakończeniu operacji w wywołaniu zwrotnym zostaną przesłane wartości { is_success, process_id, portfolio_item_id }. Dostępne od wersji 2026-07.