---
title: "Changes to List Insights"
method: GET
path: "/data/v1/metrics/{METRIC_ID}/insights"
---

# Changes to List Insights

`GET /data/v1/metrics/{METRIC_ID}/insights`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 54 revisions.

- **2026-09-30** `99c1d509dcbb`: 3 warning, 3 info
- **2026-01-07** `83dc80cce4d6`: 3 info
- **2025-08-05** `ba7ebfd893a1`: 1 info
- **2025-07-02** `d4d7fca3b738`: 1 info
- **2024-11-15** `59cc6a0736ea`: 2 breaking
- **2024-11-15** `5bc9dec57cc4`: 1 info

## Changes

- **2026-09-30** `99c1d509dcbb`: 3 warning, 3 info
  - deleted the `query` request parameter `filters[]`
  - deleted the `query` request parameter `metric_filters[]`
  - deleted the `query` request parameter `timeframe[]`
  - added the new optional `query` request parameter `filters`
  - added the new optional `query` request parameter `metric_filters`
  - added the new optional `query` request parameter `timeframe`
- **2026-01-07** `83dc80cce4d6`: 3 info
  - added the new enum value `rendition_change_count` to the `path` request parameter `METRIC_ID`
  - added the new enum value `rendition_downshift_count` to the `path` request parameter `METRIC_ID`
  - added the new enum value `rendition_upshift_count` to the `path` request parameter `METRIC_ID`
- **2025-08-05** `ba7ebfd893a1`: 1 info
  - the endpoint scheme security `authorizationToken` was added to the API
- **2025-07-02** `d4d7fca3b738`: 1 info
  - the endpoint scheme security `accessToken` was added to the API
- **2024-11-15** `59cc6a0736ea`: 2 breaking
  - removed the enum value `ad_watch_time` from the `path` request parameter `METRIC_ID`
  - removed the enum value `view_content_watch_time` from the `path` request parameter `METRIC_ID`
- **2024-11-15** `5bc9dec57cc4`: 1 info
  - added the new enum value `view_dropped_percentage` to the `path` request parameter `METRIC_ID`

---

[Operation](https://skmtc.dev/muxinc/apis/mux-api/docs/data/v1/metrics/:METRIC_ID/insights/get.md) - [API](https://skmtc.dev/muxinc/apis/mux-api.md) - [Page](https://skmtc.dev/muxinc/apis/mux-api/changes/data/v1/metrics/:METRIC_ID/insights/get)