v4

latestOpenAPI 3.0.32026-08-0161180264.4 KB

monitoring

integrations

getMonitoringTimeSeries

Get time-series aggregated event counts for monitoring charts. Returns pre-bucketed counts at configurable intervals for both inbound and outbound events. Maximum of 200 buckets per request. Returns 400 if the time range and interval would exceed this limit.

post/v1/integrations/{integrationId}/monitoring/timeseries

Path parameters

integrationIdstring uuid required

The integration ID

Request body

from_datestring date-time required

Start date for the time series (inclusive)

to_datestring date-time

End date for the time series (inclusive). Defaults to current time if not specified.

interval'5m' | '10m' | '30m' | '1h' | '3h' | '1d' required

The time bucket interval for aggregation

direction'inbound' | 'outbound' | 'both'

Filter by event direction. Defaults to both.

Example request

{
  "from_date": "2025-01-01T00:00:00Z",
  "to_date": "2025-01-31T23:59:59Z",
  "interval": "1h",
  "direction": "both"
}

Response

Time-series aggregated event counts retrieved successfully

interval'5m' | '10m' | '30m' | '1h' | '3h' | '1d' required

The time bucket interval used for aggregation

from_datestring date-time required

Start date of the time series

to_datestring date-time required

End date of the time series