Mutacja create_portfolio tworzy nową tablicę portfolio. Od wersji 2026-07 przyjmuje opcjonalny argument callback_url: podaj adres HTTPS, a monday.com wyśle na niego żądanie POST z nowym portfolio_id po utworzeniu tablicy. Jeśli nie możesz odbierać wywołań zwrotnych, skorzystaj z opisanej niżej metody odpytywania.

Zalecane - utwórz portfolio z adresem URL wywołania zwrotnego (2026-07 i nowsze)

🚧 Dostępne od wersji API 2026-07

Argument callback_url i pole process_id w odpowiedzi wymagają wersji 2026-07 lub nowszej.

Podaj adres HTTPS jako callback_url. Mutacja natychmiast zwróci process_id i success: true. Po utworzeniu tablicy portfolio portfolio_id zostanie wysłany żądaniem POST na podany adres URL.

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

Natychmiastowa odpowiedź wygląda tak:

{
  "data": {
    "create_portfolio": {
      "success": true,
      "message": "Creation initiated. The portfolio_id will be sent to your callback URL when available.",
      "process_id": "9c1f2a8b-7d3e-4c12-9b2f-7a0e1d4c8b6e"
    }
  }
}

solution_live_version_id nie jest identyfikatorem tablicy portfolio - w trybie asynchronicznym zignoruj tę wartość i poczekaj na wywołanie zwrotne.

Dane wywołania zwrotnego

Po utworzeniu tablicy portfolio monday.com wyśle żądanie POST na adres callback_url z treścią JSON:

Pole	Typ	Opis
is_success	Boolean	true, jeśli tablica portfolio została utworzona, lub false, jeśli operacja się nie powiodła.
process_id	String	Ten sam process_id, który zwróciła mutacja. Użyj go, aby powiązać odpowiedź z operacją.
portfolio_id	Number	Identyfikator nowej tablicy portfolio. Pole występuje tylko wtedy, gdy is_success ma wartość true.

Przykładowa odpowiedź po pomyślnym utworzeniu:

{
  "is_success": true,
  "process_id": "9c1f2a8b-7d3e-4c12-9b2f-7a0e1d4c8b6e",
  "portfolio_id": 1234567890
}

Przykładowa odpowiedź po niepowodzeniu:

{
  "is_success": false,
  "process_id": "9c1f2a8b-7d3e-4c12-9b2f-7a0e1d4c8b6e"
}

Metoda zapasowa - odpytuj o tablice w obszarze roboczym

Jeśli nie możesz udostępnić punktu końcowego do odbierania wywołań zwrotnych, możesz znaleźć nową tablicę portfolio, odpytując obszar roboczy.

Krok 1 - Zapisz znacznik czasu i utwórz portfolio

Bezpośrednio przed wywołaniem mutacji zapisz bieżący znacznik czasu UTC, a następnie utwórz portfolio:

mutation {
  create_portfolio(
    boardName: "My Portfolio"
    boardPrivacy: "public"
    destinationWorkspaceId: 12345
  ) {
    success
    message
  }
}

Argument boardPrivacy przyjmuje wartość "public" lub "private".

Krok 2 - Odpytuj o tablicę portfolio

Odczekaj około 20 sekund, a następnie pobierz tablice utworzone po zapisanym znaczniku czasu:

{
  boards(workspace_ids: [WORKSPACE_ID], limit: 20, order_by: created_at) {
    id
    name
    board_kind
    created_at
    groups { title }
  }
}

Przefiltruj wyniki po stronie klienta, aby znaleźć nową tablicę portfolio:

• Wartość created_at jest późniejsza niż zapisany znacznik czasu.
• Tablica ma jedną grupę o nazwie Projects.
• Wartość name odpowiada podanej nazwie portfolio.

To połączenie kryteriów pozwala wiarygodnie znaleźć nowo utworzoną tablicę portfolio.

Kiedy używać wywołań zwrotnych

Wybierz przepływ asynchroniczny (callback_url), gdy:

• Tworzysz wiele portfolio jednocześnie i chcesz uniknąć opóźnień związanych z odpytywaniem.
• Działasz w środowisku, w którym odpytywanie jest niewygodne, na przykład w procesach roboczych kolejki lub funkcjach bezserwerowych.
• Chcesz trwale zapisać wynik operacji bez konieczności utrzymywania pierwotnego połączenia HTTP lub przeszukiwania tablic w obszarze roboczym.

Metody zapasowej z odpytywaniem używaj tylko wtedy, gdy nie możesz odbierać przychodzących wywołań zwrotnych HTTPS.

Ważne informacje

• Wersja mutacji: sama mutacja create_portfolio jest dostępna od wersji 2025-10. Tylko argument callback_url i pole process_id w odpowiedzi wymagają wersji 2026-07.
• solution_live_version_id nie jest identyfikatorem tablicy - wskazuje szablon użyty do utworzenia portfolio i nie można go użyć do wyszukania tablicy. W trybie asynchronicznym poczekaj na wywołanie zwrotne z wartością portfolio_id.
• Bezpieczeństwo wywołań zwrotnych: traktuj punkt końcowy jako niezaufany z punktu widzenia sieci. Zanim podejmiesz działanie na podstawie otrzymanych danych, sprawdź, czy process_id odpowiada operacji, którą zainicjowałeś.
• Uprawnienia: wymagany jest zakres boards:write. Rozwiązania portfolio są dostępne tylko w planach Enterprise.