v34

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-09194386949.7 KB

Beta

Agent Data

Aggregate Agent Data

Aggregate agent data with grouping and optional counting/first item retrieval.

post/api/v1/beta/agent-data/:aggregate

Query parameters

project_idstring uuid nullable

organization_idstring uuid nullable

Cookies

sessionstring nullable

Request body

page_sizeinteger nullable

The maximum number of items to return. The service may return fewer than this value. If unspecified, a default page size will be used. The maximum value is typically 1000; values above this will be coerced to the maximum.

page_tokenstring nullable

A page token, received from a previous list call. Provide this to retrieve the subsequent page.

filterobject nullable

A filter object or expression that filters resources listed in the response.

order_bystring nullable

A comma-separated list of fields to order by, sorted in ascending order. Use 'field_name desc' to specify descending order.

deployment_namestring required

The agent deployment's name to aggregate data for

collectionstring

The logical agent data collection to aggregate data for

group_bystring[] nullable

The fields to group by. If empty, the entire dataset is grouped on. e.g. if left out, can be used for simple count operations

countboolean nullable

Whether to count the number of items in each group

firstboolean nullable

Whether to return the first item in each group (Sorted by created_at)

offsetinteger nullable

The offset to start from. If not provided, the first page is returned

Response

Successful Response

next_page_tokenstring nullable

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

total_sizeinteger nullable

The total number of items available. This is only populated when specifically requested. The value may be an estimate and can be used for display purposes only.