---
title: "Changes to Evaluate one roster metric"
method: POST
path: "/v2/roster/metrics/query"
---

# Changes to Evaluate one roster metric

`POST /v2/roster/metrics/query`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 3 revisions.

- **2026-09-09** `9ec0debedfc6`: 3 breaking, 9 info

## Changes

- **2026-09-09** `9ec0debedfc6`: 3 breaking, 9 info
  - the request property `force` became required
  - the request property `metricId` became required
  - the request property `rosterIds` became required
  - api operation id `dashboardQueryRosterMetric` was added
  - the endpoint scheme security `BotToken` was added to the API
  - the endpoint scheme security `UserToken` was added to the API
  - the endpoint scheme security `ApiKeyAuth` was removed from the API
  - added the required property `cached` to the response with the `200` status
  - added the required property `evaluatedAt` to the response with the `200` status
  - added the required property `metricId` to the response with the `200` status
  - added the required property `parameters` to the response with the `200` status
  - added the required property `rows` to the response with the `200` status

---

[Operation](https://skmtc.dev/clashk/apis/clashking-api/docs/v2/roster/metrics/query/post.md) - [API](https://skmtc.dev/clashk/apis/clashking-api.md) - [Page](https://skmtc.dev/clashk/apis/clashking-api/changes/v2/roster/metrics/query/post)