Aktualizacje to wątki komunikacji dotyczące elementu lub tablicy, w których zespoły mogą udostępniać notatki, pliki i ważne informacje. Ułatwiają użytkownikom współpracę w różnych organizacjach, pomagają im być na bieżąco i komunikować się asynchronicznie - wszystko w kontekście ich pracy.

W ramach aktualizacji użytkownicy mogą odpowiadać i reagować, załączać pliki, przypinać ważne wiadomości u góry oraz sprawdzać, kto wyświetlił rozmowę. Wiele zespołów korzysta z aktualizacji jako głównego miejsca bieżącej komunikacji w monday.com.

Zapytania

Pobieranie aktualizacji

• Wymagany zakres:updates:read
• Zwraca tablicę zawierającą metadane jednej aktualizacji lub wielu aktualizacji, uporządkowane od najnowszej do najstarszej
• Aktualizacje można pobierać bezpośrednio z poziomu głównego zapytania (zwraca wszystkie aktualizacje na koncie) albo zagnieździć zapytanie w zapytaniu boards lub items (zwraca aktualizacje z określonej tablicy lub elementu)

query {
  updates(
    limit: 50 
    to_date: "2025-06-04" 
    from_date: "2025-01-01"
    ) {
    body
      id
      created_at
      creator {
        name
        id
    }
  }
}

Argumenty

Argument	Typ	Opis
board_updates_only	Boolean	Określa, czy uwzględniać tylko aktualizacje dotyczące tablicy. Można użyć tego argumentu tylko wtedy, gdy zapytanie updates jest zagnieżdżone w zapytaniu boards.
from_date	String	Filtruje aktualizacje utworzone w tym dniu lub później. Akceptuje format ISO 8601 (YYYY-MM-DD lub YYYY-MM-DDTHH:mm). Tego argumentu należy używać razem z argumentem to_date i tylko wtedy, gdy zapytanie updates jest na głównym poziomie (nie jest zagnieżdżone w zapytaniu boards).
ids	[ID!]	Identyfikatory aktualizacji, które mają zostać zwrócone.
limit	Int	Liczba aktualizacji na stronie. Domyślnie 25, maksymalnie 100.
page	Int	Numer strony do pobrania. Numeracja zaczyna się od 1.
to_date	String	Filtruje aktualizacje utworzone w tym dniu lub wcześniej. Akceptuje format ISO 8601 (YYYY-MM-DD lub YYYY-MM-DDTHH:mm). Tego argumentu należy używać razem z argumentem from_date i tylko wtedy, gdy zapytanie updates jest na głównym poziomie (nie jest zagnieżdżone w zapytaniu boards).

Pola

Pole	Typ	Opis
assets	[Asset]	Pliki i zasoby aktualizacji.
body	String!	Treść aktualizacji w formacie HTML.
created_at	Date	Data utworzenia aktualizacji.
creator	User	Autor aktualizacji.
creator_id	String	Unikalny identyfikator autora aktualizacji.
edited_at	Date!	Data ostatniej edycji treści aktualizacji.
id	ID!	Unikalny identyfikator aktualizacji.
item	Item	Element, którego dotyczy aktualizacja.
item_id	String	Identyfikator elementu aktualizacji.
likes	[Like!]!	Polubienia aktualizacji.
pinned_to_top	[UpdatePin!]!	Informacje o przypięciu aktualizacji u góry.
replies	[Reply!]	Odpowiedzi na aktualizację.
text_body	String	Tekstowa treść aktualizacji.
updated_at	Date	Data ostatniej edycji aktualizacji.
viewers	[Watcher!]!	Osoby, które wyświetliły aktualizację.

Mutacje

• Wymagany zakres:updates:write

Tworzenie aktualizacji

Tworzy i dodaje nową aktualizację do elementu. Zwraca Update.

mutation {
  create_update(
    item_id: 9876543210
    body: "This update will mention user 1234567890 on an item"
    mentions_list: [
      {
        id: 1234567890
        type: User
      }
    ]
  ) {
    id
  }
}

Argumenty

Argument	Typ	Opis
body	String!	Tekst aktualizacji.
item_id	ID	Unikalny identyfikator elementu. Nie musisz używać tego argumentu, jeśli odpowiadasz na wpis za pomocą parent_id.
mentions_list	[UpdateMention]	Użytkownik, zespół lub tablica, o których mowa w aktualizacji.
original_creation_date	String	Oryginalna data utworzenia aktualizacji. Wymagany format: DD-MM-YYYY.
parent_id	ID	Unikalny identyfikator nadrzędnej aktualizacji. Możesz go użyć, aby dodać odpowiedź do aktualizacji.

Polubienie aktualizacji

Dodaje polubienie do aktualizacji. Zwraca Update.

mutation {
  like_update(update_id: 1234567890) {
    id
  }
}

Argumenty

Argument	Typ	Opis
update_id	ID	Unikalny identyfikator aktualizacji.

Cofanie polubienia aktualizacji

Usuwa polubienie aktualizacji. Zwraca Update.

mutation {
  unlike_update(update_id: 1234567890) {
    creator_id
    item_id
  }
}

Argumenty

Argument	Typ	Opis
update_id	ID!	Unikalny identyfikator aktualizacji.

Edytowanie aktualizacji

Edytuje aktualizację. Zwraca Update.

mutation {
  edit_update(
    id: 1234567890
    body: "The updated text!"
    ) {
    creator_id
    item_id
  }
}

Argumenty

Argument	Typ	Opis
body	String!	Nowy tekst aktualizacji.
id	ID!	Unikalny identyfikator aktualizacji.

Przypinanie u góry

Przypina aktualizację u góry elementu. Zwraca Update.

mutation {
  pin_to_top(
    id: 1234567890
    item_id: 9876543210
    ) {
    creator_id
    body
  }
}

Argumenty

Argument	Typ	Opis
id	ID!	Unikalny identyfikator aktualizacji.
item_id	ID	Unikalny identyfikator elementu.

Odpinanie od góry

Odpina aktualizację z góry elementu. Zwraca Update.

mutation {
  unpin_from_top(
    id: 1234567890
    item_id: 9876543210
  ) {
    creator_id
    body
  }
}

Argumenty

Argument	Typ	Opis
id	ID!	Unikalny identyfikator aktualizacji.
item_id	ID	Unikalny identyfikator elementu.

Czyszczenie aktualizacji elementu

Usuwa wszystkie aktualizacje dotyczące określonego elementu, w tym odpowiedzi i polubienia. Zwraca Update.

mutation {
  clear_item_updates(item_id: 1234567890) {
    id
  }
}

Argumenty

Argument	Typ	Opis
item_id	ID!	Unikalny identyfikator elementu.

Usuwanie aktualizacji

Usuwa aktualizacje elementu. Zwraca Update.

mutation {
  delete_update(id: 1234567890) {
    id
  }
}

Argumenty

Argument	Typ	Opis
id	ID!	Unikalny identyfikator aktualizacji.