Dokumentacja dla programistów›O API monday.com›Informacje o obszarze roboczym (Platform MCP)
Dokumentacja dla programistów

Informacje o obszarze roboczym (Platform MCP)

O API monday.comDokumentacja API
Aktualizacja 2026-09-06

Użyj tego narzędzia, aby uzyskać ogólny obraz zawartości obszaru roboczego. Zwraca maksymalnie 100 tablic, 100 dokumentów i 100 folderów, uporządkowanych według folderów, w których się znajdują. Elementy na najwyższym poziomie, które nie należą do żadnego folderu, są zwracane osobno w root_items. Przydaje się to do sprawdzenia układu obszaru roboczego przed przenoszeniem obiektów, tworzeniem folderów lub wyszukiwaniem konkretnych tablic.

Jeśli dla dowolnego typu obiektu (tablic, dokumentów lub folderów) zostanie zwróconych dokładnie 100 wyników, załóż, że istnieją dodatkowe elementy tego typu, których nie ma w odpowiedzi. Użyj bezpośrednio interfejsu GraphQL API, aby pobrać pełną listę stronicami.

Parametry

Parametr Typ Wymagane Opis
workspace_id number Tak Identyfikator obszaru roboczego, którego informacje chcesz pobrać. Użyj list_workspaces, aby znaleźć identyfikatory obszarów roboczych.

Przykład

Pobierz pełną strukturę obszaru roboczego 12406666:

{
  "workspace_id": 12406666
}

Odpowiedź zawiera metadane obszaru roboczego, tablicę folders (każdy folder zawiera swoje zagnieżdżone tablice i dokumenty) oraz obiekt root_items z tablicami i dokumentami, które nie znajdują się w żadnym folderze. Na przykład:

{
  "workspace": {
    "id": "12406666",
    "name": "MCP TEST WORKSPACE",
    "kind": "open",
    "state": "active"
  },
  "folders": [
    {
      "id": "19028717",
      "name": "Real estate agency management",
      "boards": [
        { "id": "18392419211", "name": "Agent task management Board" }
      ],
      "docs": []
    }
  ],
  "root_items": {
    "boards": [
      { "id": "18394522211", "name": "Final Asset Library" }
    ],
    "docs": [
      { "id": "35809248", "name": "test doc" }
    ]
  }
}

Odpowiednik programistyczny

Aby uzyskać ten sam wynik, użyj GraphQL API:

query {
  workspaces(ids: [12406666]) {
    id
    name
    kind
    state
    boards {
      id
      name
      folder_id
    }
    folders {
      id
      name
      children {
        id
        name
      }
    }
  }
}

Pełną dokumentację znajdziesz w sekcji Workspaces.