---
title: "Changes to Get usage metrics"
method: GET
path: "/usage/metrics"
---

# Changes to Get usage metrics

`GET /usage/metrics`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 9 revisions.

- **2026-11-02** `62aa324803a7`: 13 info
- **2026-10-24** `ecca093572e0`: 11 breaking, 3 warning, 9 info
- **2026-08-17** `261c340a3f6d`: 2 warning, 2 info

## Changes

- **2026-11-02** `62aa324803a7`: 13 info
  - added the new enum value `agent` to the `query` request parameter `group_by`
  - added the new enum value `api_key` to the `query` request parameter `group_by`
  - added the new enum value `device_class` to the `query` request parameter `group_by`
  - added the new enum value `model` to the `query` request parameter `group_by`
  - added the new enum value `schedule` to the `query` request parameter `group_by`
  - added the optional property `points/items/agent` to the response with the `200` status
  - added the optional property `points/items/api_key` to the response with the `200` status
  - added the optional property `points/items/device_class` to the response with the `200` status
  - added the optional property `points/items/model` to the response with the `200` status
  - added the optional property `points/items/schedule` to the response with the `200` status
  - added the required property `points/items/input_tokens` to the response with the `200` status
  - added the required property `points/items/output_tokens` to the response with the `200` status
  - added the required property `points/items/session_seconds` to the response with the `200` status
- **2026-10-24** `ecca093572e0`: 11 breaking, 3 warning, 9 info
  - for the `query` request parameter `granularity`, default value was changed from `daily` to `day`
  - removed the enum value `daily` from the `query` request parameter `granularity`
  - removed the enum value `hourly` from the `query` request parameter `granularity`
  - removed the required property `compute_minutes` from the response with the `200` status
  - removed the required property `cost_by_product` from the response with the `200` status
  - removed the required property `granularity` from the response with the `200` status
  - removed the required property `inference_chart_data` from the response with the `200` status
  - removed the required property `infra_costs` from the response with the `200` status
  - removed the required property `period_end` from the response with the `200` status
  - removed the required property `period_start` from the response with the `200` status
  - removed the required property `session_chart_data` from the response with the `200` status
  - deleted the `query` request parameter `end_date`
  - deleted the `query` request parameter `start_date`
  - deleted the `query` request parameter `timezone`
  - added the new optional `query` request parameter `group_by`
  - added the new optional `query` request parameter `period_end_at`
  - added the new optional `query` request parameter `period_start_at`
  - added the new optional `query` request parameter `time_zone`
  - added the new enum value `day` to the `query` request parameter `granularity`
  - added the new enum value `hour` to the `query` request parameter `granularity`
  - added the non-success response with the status `422`
  - added the non-success response with the status `500`
  - added the required property `points` to the response with the `200` status
- **2026-08-17** `261c340a3f6d`: 2 warning, 2 info
  - added the new `daily` enum value to the `granularity` response property for the response status `200`
  - added the new `hourly` enum value to the `granularity` response property for the response status `200`
  - the endpoint scheme security `apiKeyAuth` was added to the API
  - the endpoint scheme security `bearerAuth` was removed from the API

---

[Operation](https://skmtc.dev/axilioai/apis/axilio-api-2/docs/usage/metrics/get.md) - [API](https://skmtc.dev/axilioai/apis/axilio-api-2.md) - [Page](https://skmtc.dev/axilioai/apis/axilio-api-2/changes/usage/metrics/get)