Interfejs API monday.com aggregate umożliwia odczytywanie danych z tablic przy użyciu grupowania i funkcji agregujących.

Poniższe typy są używane przez zapytanie aggregate i nie można ich odpytywać niezależnie.

AggregateQueryInput

Obiekt zawierający zapytanie agregujące do wykonania.

Field	Type	Description
from	AggregateFromTableInput!	Źródło danych dla agregacji.
group_by	[AggregateGroupByElementInput!]	Pola, według których mają być grupowane wyniki. Domyślny limit na grupę wynosi 1,000.
limit	Int	Maksymalna liczba zwracanych grup wyników. Ma zastosowanie tylko przy użyciu group_by.
query	ItemsQuery	Filtry dotyczące agregowanych elementów. Jeśli ich nie podasz, uwzględnione zostaną wszystkie elementy.
select	[AggregateSelectElementInput!]!	Pola lub funkcje do zwrócenia.

AggregateFromTableInput

Obiekt zawierający tabelę źródłową i jej identyfikator dla zapytania agregującego.

Field	Type	Description	Enum Values
id	ID!	Unikalny identyfikator źródła (np. identyfikator tablicy).
type	AggregateFromElementType!	Typ źródła.	TABLE

AggregateGroupByElementInput

Obiekt zawierający limit elementów i kolumnę, według której mają być grupowane wyniki.

Field	Type	Description
column_id	String!	Unikalny identyfikator kolumny, według której mają być grupowane wyniki. Może to być także alias funkcji transformującej.
limit	Int	Liczba grup do zwrócenia. Domyślnie 1,000.

AggregateSelectElementInput

Obiekt zawierający pola lub funkcje do zwrócenia.

Field	Type	Description	Enum Values
as	String!	Alias pola w zbiorze wyników. W przypadku kolumn użytych w group_by alias musi odpowiadać wartości column_id w tablicy group_by.
column	AggregateSelectColumnInput	Kolumna wybierana ze źródła. Wymagana, gdy typ to COLUMN.
function	AggregateSelectFunctionInput	Funkcja stosowana do określonych pól. Wymagana, gdy typ to FUNCTION.
type	AggregateSelectElementType!	Określa, czy ten element jest odwołaniem do kolumny, czy wywołaniem funkcji.	COLUMN FUNCTION

AggregateSelectColumnInput

Obiekt zawierający kolumnę wybieraną ze źródła.

Field	Type	Description
column_id	String!	Unikalny identyfikator kolumny.

AggregateSelectFunctionInput

Obiekt zawierający funkcję stosowaną do określonych pól.

Field	Type	Description	Enum Values
function	AggregateSelectFunctionName!	Nazwa funkcji.	AVERAGE BETWEEN CASE COLOR COUNT COUNT_DISTINCT COUNT_ITEMS COUNT_KEYS COUNT_SUBITEMS DATE DATE_TRUNC_DAY DATE_TRUNC_MONTH DATE_TRUNC_QUARTER DATE_TRUNC_WEEK DATE_TRUNC_YEAR DURATION_RUNNING END_DATE EQUALS FIRST FLATTEN HOUR ID IS_DONE LABEL LEFT LENGTH LOWER MAX MEDIAN MIN MIN_MAX NONE ORDER PERSON PHONE_COUNTRY_SHORT_NAME RAW START_DATE SUM TRIM UPPER
params	[AggregateSelectElementInput!]	Argumenty przekazywane do funkcji. W przypadku funkcji operujących na kolumnach (np. SUM, AVERAGE) przekaż element typu COLUMN z docelową wartością column_id. Nie jest to wymagane w przypadku funkcji działających na poziomie elementu, takich jak COUNT_ITEMS.

AggregateResultSet

Obiekt zawierający wynik zapytania aggregate. Przy użyciu group_by każdy AggregateResultSet reprezentuje jedną grupę.

Field	Type	Description
entries	[AggregateResultEntry!]	Lista wyników, z których każdy reprezentuje klucz grupowania lub zagregowaną wartość.

AggregateResultEntry

Obiekt zawierający nazwę i wartość pola.

Field	Type	Description	Possible Types
alias	String	Nazwa pola zdefiniowana za pomocą pola as. Służy do mapowania wyniku na odpowiadające mu wyrażenie.
value	AggregateResult	Wartość zwrócona dla danego aliasu. Może reprezentować klucz grupowania lub zagregowaną miarę.	AggregateBasicAggregationResult AggregateGroupByResult

AggregateBasicAggregationResult

Obiekt zawierający wynik funkcji agregującej.

Field	Type	Description
result	Float	Wynik liczbowy funkcji agregującej. Zwraca null, gdy wszystkie wartości w grupie są równe null lub kolumna jest pusta.

AggregateGroupByResult

Obiekt zawierający wartość grupowania. Pole value zwraca wartość JSON, której typ zależy od kolumny źródłowej.

Field	Type	Description
value	JSON	Wartość grupowania. Typ zależy od danych: ciągi znaków dla tekstu/statusu (kody szesnastkowe), wartości logiczne dla pól wyboru, liczby dla dat (milisekundy epoki).

API Version	Available Fields	Notes
Przed 2026-04	value_string, value_int, value_float, value_boolean	Oddzielne pola typowane
2026-04 i nowsze	value (JSON)	Ujednolicone pole - obsłuż konwersję typów po stronie klienta