Skip to main content
POST
Query insight activity by dimension and measure

Authorizations

Authorization
string
header
required

Organization API key (sl_…).

Headers

x-tenant-id
string
required

The organization ID the request is scoped to.

Body

application/json

An aggregate query over the activity on insights.

Each activity record is one change to one insight field: a view, or an edit to its status, assignee, effort or savings estimate. A view is recorded when it changes who last viewed the insight, so a repeat view by its last viewer adds no record. Group with dimensions, aggregate with measures, narrow rows with filters or filter_expression, and narrow aggregates with measure_filters. The action_* and actor dimensions describe the change; every other dimension describes the insight it was made to. Rows are already limited to the insights the caller may see.

measures
(SemiStructuredMeasure[InsightActivityDimensionName] · object | enum<string>)[]
dimensions
(SemiStructuredDimension[InsightActivityDimensionName] · object | enum<string>)[]
filters
(InFilter[Union[SemiStructuredDimension[InsightActivityDimensionName], InsightActivityDimensionName]] · object | ArrayContainsFilter[Union[SemiStructuredDimension[InsightActivityDimensionName], InsightActivityDimensionName]] · object | IsFilter[Union[SemiStructuredDimension[InsightActivityDimensionName], InsightActivityDimensionName]] · object | LikeFilter[Union[SemiStructuredDimension[InsightActivityDimensionName], InsightActivityDimensionName]] · object | MultiLikeFilter[Union[SemiStructuredDimension[InsightActivityDimensionName], InsightActivityDimensionName]] · object | EqFilter[Union[SemiStructuredDimension[InsightActivityDimensionName], InsightActivityDimensionName]] · object | FilterExpression[Union[SemiStructuredDimension[InsightActivityDimensionName], InsightActivityDimensionName]] · object | InRelativeDateRangeFilter[Union[SemiStructuredDimension[InsightActivityDimensionName], InsightActivityDimensionName]] · object)[]
filter_expression
FilterExpression[Union[SemiStructuredDimension[InsightActivityDimensionName], InsightActivityDimensionName]] · object | null
measure_filters
(InFilter[InsightActivityMeasureName] · object | ArrayContainsFilter[InsightActivityMeasureName] · object | IsFilter[InsightActivityMeasureName] · object | LikeFilter[InsightActivityMeasureName] · object | MultiLikeFilter[InsightActivityMeasureName] · object | EqFilter[InsightActivityMeasureName] · object | FilterExpression[InsightActivityMeasureName] · object | InRelativeDateRangeFilter[InsightActivityMeasureName] · object)[]
sort
Sort[InsightActivityMeasureName, InsightActivityDimensionName] · object[]
limit
integer
default:10000

Maximum rows to return, at most 10000. An aggregation that produces more rows than this is silently cut short at the limit, so narrow the filters or group by fewer dimensions rather than raising it to see everything.

Required range: 1 <= x <= 10000

Response

Successful Response

items
Items · object[]
required
page_token
string | null

Opaque cursor for the next page; empty/absent on the last page.

row_count
integer | null

Best-effort total for the filtered result set; may be null when expensive.