Użyj tego narzędzia, aby odczytać dokumenty z konta monday.com. Narzędzie obsługuje dwa tryby, które kontroluje parametr mode: content (domyślny) pobiera dokumenty z pełną treścią w formacie Markdown oraz, opcjonalnie, strukturą bloków i komentarzami; version_history pobiera historię edycji jednego dokumentu w postaci listy punktów przywracania.

Zazwyczaj użyj read_docs w trybie content przed wywołaniem update_doc. Dzięki temu poznasz identyfikatory bloków potrzebne do wskazania konkretnych bloków. Ustaw include_blocks: true, aby w odpowiedzi uwzględnić identyfikatory, typy, pozycje i treść bloków.

Parametry

Parametr	Typ	Wymagany	Opis
mode	string	Nie	Tryb działania. content (domyślny) pobiera dokumenty z treścią w formacie Markdown. version_history pobiera historię edycji jednego dokumentu.
type	string	Tak (tryb content)	Typ zapytania w trybie content. Jedna z wartości: ids (identyfikatory dokumentów), object_ids (identyfikatory obiektów z adresu URL) lub workspace_ids (identyfikatory obszarów roboczych). Wymagany w trybie content.
ids	array	Tak	Tablica identyfikatorów zgodnych z wybranym type. W trybie version_history podaj tutaj pojedynczy object_id dokumentu (np. ["18412502542"]).
limit	number	Nie	Liczba dokumentów na stronę (domyślnie: 25). Tylko w trybie content.
page	number	Nie	Numer strony do zwrócenia, począwszy od 1. Tylko w trybie content.
order_by	string	Nie	Kolejność sortowania wyników. Jedna z wartości: created_at lub used_at. Tylko w trybie content.
include_blocks	boolean	Nie	Jeśli wartość to true, odpowiedź zawiera identyfikatory, typy, pozycje i treść bloków. Ustaw ten parametr przed wywołaniem update_doc. Domyślnie ma wartość false. Tylko w trybie content.
blocks_limit	number	Nie	Maksymalna liczba bloków zwracanych dla każdego dokumentu (domyślnie: 25). Użyj razem z blocks_page, aby stronicować długie dokumenty. Tylko w trybie content.
blocks_page	number	Nie	Numer strony bloków, począwszy od 1. Tylko w trybie content.
include_comments	boolean	Nie	Jeśli wartość to true, pobiera wszystkie komentarze i odpowiedzi w dokumencie. Domyślnie ma wartość false. Tylko w trybie content.
comments_limit	number	Nie	Maksymalna liczba komentarzy pobieranych dla każdego dokumentu, gdy include_comments ma wartość true. Domyślnie: 50. Tylko w trybie content.
version_history_limit	number	Nie	Maksymalna liczba zwracanych punktów przywracania. Tylko w trybie historii wersji.
since	string	Nie	Data w formacie ISO 8601, od której ma być filtrowana historia wersji (np. "2026-03-15T00:00:00Z"). Tylko w trybie historii wersji.
until	string	Nie	Data w formacie ISO 8601, do której ma być filtrowana historia wersji. Domyślnie bieżąca data i godzina. Tylko w trybie historii wersji.
include_diff	boolean	Nie	Jeśli wartość to true, pobiera różnice w treści między kolejnymi punktami przywracania. Może to potrwać dłużej. Tylko w trybie historii wersji.

Przykłady

Wyświetlanie wszystkich dokumentów w obszarze roboczym

Pobierz wszystkie dokumenty z obszaru roboczego 12406666:

{
  "mode": "content",
  "type": "workspace_ids",
  "ids": ["12406666"],
  "limit": 25
}

Narzędzie zwróciło 3 dokumenty z obszaru roboczego, wraz z ich nazwami, identyfikatorami, identyfikatorami obiektów, datami utworzenia i pełną treścią w formacie Markdown. Odpowiedź zawiera też has_more_pages: false, co oznacza, że nie ma kolejnych stron.

Odczytywanie konkretnego dokumentu wraz z blokami

Pobierz pojedynczy dokument, używając jego doc_id, i uwzględnij metadane wszystkich bloków (wymagane przed wywołaniem update_doc):

{
  "mode": "content",
  "type": "ids",
  "ids": ["41622523"],
  "include_blocks": true
}

Odpowiedź zawiera tablicę blocks. Każdy jej element ma pola id, type (np. "large title", "normal text", "bulleted list"), parent_block_id, position i content w formacie delta.

Wskazówka: Jeśli zapytanie z użyciem ids nie zwróci wyników, narzędzie automatycznie ponowi próbę, używając object_ids. Możesz też wysłać zapytanie bezpośrednio z użyciem object_ids i identyfikatora z adresu URL dokumentu.

Pobieranie historii wersji

Pobierz 3 ostatnie migawki edycji dokumentu, używając jego object_id:

{
  "mode": "version_history",
  "ids": ["18412502542"],
  "version_history_limit": 3,
  "include_diff": true
}

Odpowiedź zawiera punkty przywracania posortowane od najnowszego do najstarszego. Różnice pokazują, jaka treść zmieniła się między wersjami.

---

Odpowiednik programistyczny

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

query {
  docs(workspace_ids: [12406666], limit: 25) {
    id
    object_id
    name
    doc_kind
    created_at
    url
    blocks {
      id
      type
      position
      content
    }
  }
}

Pełną dokumentację znajdziesz w sekcji Dokumentacja.