Pobieranie aktualizacji (Platform MCP)
Użyj tego narzędzia, aby odczytać historię aktualizacji elementu lub tablicy. W przypadku zapytań dotyczących elementu odpowiedź zawiera tekst każdej aktualizacji, jej autora i znaczniki czasu. W przypadku zapytań dotyczących tablicy domyślnie zwracana jest tylko dyskusja na poziomie tablicy. Ustaw includeItemUpdates na true, aby uwzględnić także aktualizacje opublikowane w poszczególnych elementach tablicy.
Filtrowanie według zakresu dat (fromDate / toDate) jest obsługiwane tylko w przypadku zapytań dotyczących tablicy. Oba parametry muszą być użyte razem. Wyniki są stronicowane. Użyj page i limit, aby przeglądać długą historię aktualizacji.
Parametry
| Parametr | Typ | Wymagane | Opis |
|---|---|---|---|
| objectId | string |
Tak | ID elementu lub tablicy, z których mają zostać pobrane aktualizacje. |
| objectType | string |
Tak | Typ obiektu: "Item" lub "Board". |
| limit | number |
Nie | Liczba aktualizacji zwracanych na stronę. Domyślnie: 25. Maksymalnie: 100. |
| page | number |
Nie | Numer strony wyników. Domyślnie: 1. |
| includeReplies | boolean |
Nie | Ustaw na true, aby uwzględnić odpowiedzi w wątkach dotyczących każdej aktualizacji. Domyślnie: false. |
| includeAssets | boolean |
Nie | Ustaw na true, aby uwzględnić załączniki w odpowiedzi. Domyślnie: false. |
| fromDate | string |
Nie | Początek zakresu dat w formacie ISO 8601 (np. "2025-01-01" lub "2025-01-01T00:00:00Z"). Tylko zapytania dotyczące tablicy. Należy użyć razem z toDate. |
| toDate | string |
Nie | Koniec zakresu dat w formacie ISO 8601. Tylko zapytania dotyczące tablicy. Należy użyć razem z fromDate. |
| includeItemUpdates | boolean |
Nie | Gdy objectType ma wartość "Board", ustaw na true, aby uwzględnić aktualizacje poszczególnych elementów. Domyślnie: false (tylko dyskusja na poziomie tablicy). |
Przykład
Pobierz aktualizacje elementu 11971936030 wraz z odpowiedziami:
{
"objectId": "11971936030",
"objectType": "Item",
"includeReplies": true
}
Narzędzie zwróciło 1 aktualizację (ID 5179486006) z tekstem "Testing the MCP create_update tool for documentation purposes.", autorem Daniel Hai i pustą tablicą odpowiedzi. Informacje o stronicowaniu wskazywały: page: 1, limit: 25, count: 1.
Pobierz wszystkie aktualizacje na tablicy z wybranego zakresu dat:
{
"objectId": "18412502536",
"objectType": "Board",
"fromDate": "2026-01-01",
"toDate": "2026-05-10",
"includeItemUpdates": true
}
Odpowiednik programistyczny
Aby uzyskać ten sam wynik, użyj GraphQL API:
query {
items(ids: [11971936030]) {
updates(limit: 25, page: 1) {
id
body
text_body
created_at
updated_at
creator {
id
name
}
replies {
id
body
creator {
id
name
}
}
}
}
}
Pełną dokumentację znajdziesz w sekcji Updates.