---
title: "Changes to PUT /v1/orchestrator/metrics/{metric.id}"
method: PUT
path: "/v1/orchestrator/metrics/{metric.id}"
---

# Changes to PUT /v1/orchestrator/metrics/{metric.id}

`PUT /v1/orchestrator/metrics/{metric.id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 50 revisions.

- **2026-03-04** `97c4541f02f0` — 1 breaking, 1 info
- **2025-07-21** `48f235df8ac6` — 4 breaking, 7 warning, 5 info
- **2025-01-08** `2b79660c20a0` — 4 breaking, 4 info
- **2024-04-16** `7ea70d31170c` — 1 breaking, 1 info
- **2024-02-16** `b58167cced1e` — 8 breaking, 14 warning, 2 info
- **2023-11-29** `dc83c7b45e88` — 2 info
- **2022-11-07** `9aea46cc4c8a` — 7 breaking, 6 warning, 19 info

## Changes

- **2026-03-04** `97c4541f02f0` — 1 breaking, 1 info
  - added the new required request property `name`
  - added the required property `name` to the response with the `200` status
- **2025-07-21** `48f235df8ac6` — 4 breaking, 7 warning, 5 info
  - added the new required request property `version`
  - the request property `category` became required
  - the request property `description` became required
  - removed the required property `name` from the response with the `200` status
  - removed the request property `interval`
  - removed the request property `name`
  - removed the request property `range`
  - removed the request property `scale`
  - removed the optional property `interval` from the response with the `200` status
  - removed the optional property `range` from the response with the `200` status
  - removed the optional property `scale` from the response with the `200` status
  - added the new optional request property `comments`
  - added the optional property `comments` to the response with the `200` status
  - the response property `category` became required for the status `200`
  - the response property `description` became required for the status `200`
  - added the required property `version` to the response with the `200` status
- **2025-01-08** `2b79660c20a0` — 4 breaking, 4 info
  - the request property `id` became required
  - the request property `implementation/allOf[#/components/schemas/MetricImplementation]/code` became required
  - the request property `implementation/allOf[#/components/schemas/MetricImplementation]/metricId` became required
  - the request property `name` became required
  - the response property `id` became required for the status `200`
  - the response property `implementation/allOf[#/components/schemas/MetricImplementation]/code` became required for the status `200`
  - the response property `implementation/allOf[#/components/schemas/MetricImplementation]/metricId` became required for the status `200`
  - the response property `name` became required for the status `200`
- **2024-04-16** `7ea70d31170c` — 1 breaking, 1 info
  - added the pattern `^-?(?:0|[1-9][0-9]{0,11})(?:\.[0-9]{1,9})?s$` to the request property `interval`
  - the `interval` response's property pattern `^-?(?:0|[1-9][0-9]{0,11})(?:\.[0-9]{1,9})?s$` was added for the status `200`
- **2024-02-16** `b58167cced1e` — 8 breaking, 14 warning, 2 info
  - added `#/components/schemas/MetricImplementation` to the `implementation` request property `allOf` list
  - added `#/components/schemas/Range` to the `range` request property `allOf` list
  - the `implementation` request property type changed from `object` to no type
  - the `interval` request property type changed from `integer` to `string`, and format from `int64` to no format
  - the `range` request property type changed from `object` to no type
  - the `implementation` response's property type changed from `object` to no type for status `200`
  - the `interval` response's property type changed from `integer` to `string`, and format from `int64` to no format for status `200`
  - the `range` response's property type changed from `object` to no type for status `200`
  - removed the request property `implementation/code`
  - removed the request property `implementation/lang`
  - removed the request property `implementation/metricId`
  - removed the request property `implementation/updatedAt`
  - removed the request property `range/allowedValues`
  - removed the request property `range/minMax`
  - removed the request property `range/order`
  - removed the optional property `implementation/code` from the response with the `200` status
  - removed the optional property `implementation/lang` from the response with the `200` status
  - removed the optional property `implementation/metricId` from the response with the `200` status
  - removed the optional property `implementation/updatedAt` from the response with the `200` status
  - removed the optional property `range/allowedValues` from the response with the `200` status
  - removed the optional property `range/minMax` from the response with the `200` status
  - removed the optional property `range/order` from the response with the `200` status
  - added `#/components/schemas/MetricImplementation` to the `implementation` response property `allOf` list for the response status `200`
  - added `#/components/schemas/Range` to the `range` response property `allOf` list for the response status `200`
- **2023-11-29** `dc83c7b45e88` — 2 info
  - added the new optional request property `deprecatedSince`
  - added the optional property `deprecatedSince` to the response with the `200` status
- **2022-11-07** `9aea46cc4c8a` — 7 breaking, 6 warning, 19 info
  - the `implementation` request property type changed from no type to `object`
  - the response property `category` became optional for the status `200`
  - the response property `description` became optional for the status `200`
  - the response property `id` became optional for the status `200`
  - the response property `name` became optional for the status `200`
  - the `implementation` response's property type changed from no type to `object` for status `200`
  - removed the required property `version` from the response with the `200` status
  - removed `#/components/schemas/MetricImplementation` from the `implementation` request property `allOf` list
  - removed the request property `comments`
  - removed the request property `deprecatedSince`
  - removed the request property `version`
  - removed the optional property `comments` from the response with the `200` status
  - removed the optional property `deprecatedSince` from the response with the `200` status
  - added the new optional request property `implementation/code`
  - added the new optional request property `implementation/lang`
  - added the new optional request property `implementation/metricId`
  - added the new optional request property `implementation/updatedAt`
  - added the new optional request property `interval`
  - added the new optional request property `range`
  - added the new optional request property `scale`
  - the request property `category` became optional
  - the request property `description` became optional
  - the request property `id` became optional
  - the request property `name` became optional
  - added the optional property `implementation/code` to the response with the `200` status
  - added the optional property `implementation/lang` to the response with the `200` status
  - added the optional property `implementation/metricId` to the response with the `200` status
  - added the optional property `implementation/updatedAt` to the response with the `200` status
  - added the optional property `interval` to the response with the `200` status
  - added the optional property `range` to the response with the `200` status
  - added the optional property `scale` to the response with the `200` status
  - removed `#/components/schemas/MetricImplementation` from the `implementation` response property `allOf` list for the response status `200`

---

[Operation](https://skmtc.dev/clouditor/apis/orchestrator-api/docs/v1/orchestrator/metrics/:metric.id/put.md) · [API](https://skmtc.dev/clouditor/apis/orchestrator-api.md) · [Page](https://skmtc.dev/clouditor/apis/orchestrator-api/changes/v1/orchestrator/metrics/:metric.id/put)
