---
title: "Changes to GET /v1/orchestrator/controls"
method: GET
path: "/v1/orchestrator/controls"
---

# Changes to GET /v1/orchestrator/controls

`GET /v1/orchestrator/controls`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 52 revisions.

- **2026-03-04** `97c4541f02f0`: 1 info
- **2025-07-21** `48f235df8ac6`: 1 breaking, 3 warning, 4 info
- **2025-01-08** `2b79660c20a0`: 4 info
- **2024-09-17** `c04ff2fe305c`: 6 info
- **2024-04-16** `7ea70d31170c`: 1 info
- **2024-02-16** `b58167cced1e`: 3 breaking, 7 warning, 2 info
- **2023-11-29** `dc83c7b45e88`: 1 info
- **2023-10-10** `7962a7c42c95`: 1 info
- **2023-02-17** `11f63b609b07`: 1 info
- **2022-12-09** `4061cf3eaf37`: 1 warning, 1 info
- **2022-11-07** `9aea46cc4c8a`: 12 breaking, 4 warning, 8 info

## Changes

- **2026-03-04** `97c4541f02f0`: 1 info
  - added the required property `controls/items/metrics/items/name` to the response with the `200` status
- **2025-07-21** `48f235df8ac6`: 1 breaking, 3 warning, 4 info
  - removed the required property `controls/items/metrics/items/name` from the response with the `200` status
  - removed the optional property `controls/items/metrics/items/interval` from the response with the `200` status
  - removed the optional property `controls/items/metrics/items/range` from the response with the `200` status
  - removed the optional property `controls/items/metrics/items/scale` from the response with the `200` status
  - added the optional property `controls/items/metrics/items/comments` to the response with the `200` status
  - the response property `controls/items/metrics/items/category` became required for the status `200`
  - the response property `controls/items/metrics/items/description` became required for the status `200`
  - added the required property `controls/items/metrics/items/version` to the response with the `200` status
- **2025-01-08** `2b79660c20a0`: 4 info
  - the response property `controls/items/metrics/items/id` became required for the status `200`
  - the response property `controls/items/metrics/items/implementation/allOf[#/components/schemas/MetricImplementation]/code` became required for the status `200`
  - the response property `controls/items/metrics/items/implementation/allOf[#/components/schemas/MetricImplementation]/metricId` became required for the status `200`
  - the response property `controls/items/metrics/items/name` became required for the status `200`
- **2024-09-17** `c04ff2fe305c`: 6 info
  - the response property `controls/items/categoryCatalogId` became required for the status `200`
  - the response property `controls/items/categoryName` became required for the status `200`
  - the response property `controls/items/controls` became required for the status `200`
  - the response property `controls/items/id` became required for the status `200`
  - the response property `controls/items/metrics` became required for the status `200`
  - the response property `controls/items/name` became required for the status `200`
- **2024-04-16** `7ea70d31170c`: 1 info
  - the `controls/items/metrics/items/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`: 3 breaking, 7 warning, 2 info
  - the `controls/items/metrics/items/implementation` response's property type changed from `object` to no type for status `200`
  - the `controls/items/metrics/items/interval` response's property type changed from `integer` to `string`, and format from `int64` to no format for status `200`
  - the `controls/items/metrics/items/range` response's property type changed from `object` to no type for status `200`
  - removed the optional property `controls/items/metrics/items/implementation/code` from the response with the `200` status
  - removed the optional property `controls/items/metrics/items/implementation/lang` from the response with the `200` status
  - removed the optional property `controls/items/metrics/items/implementation/metricId` from the response with the `200` status
  - removed the optional property `controls/items/metrics/items/implementation/updatedAt` from the response with the `200` status
  - removed the optional property `controls/items/metrics/items/range/allowedValues` from the response with the `200` status
  - removed the optional property `controls/items/metrics/items/range/minMax` from the response with the `200` status
  - removed the optional property `controls/items/metrics/items/range/order` from the response with the `200` status
  - added `#/components/schemas/MetricImplementation` to the `controls/items/metrics/items/implementation` response property `allOf` list for the response status `200`
  - added `#/components/schemas/Range` to the `controls/items/metrics/items/range` response property `allOf` list for the response status `200`
- **2023-11-29** `dc83c7b45e88`: 1 info
  - added the optional property `controls/items/metrics/items/deprecatedSince` to the response with the `200` status
- **2023-10-10** `7962a7c42c95`: 1 info
  - added the new optional `query` request parameter `filter.assuranceLevels`
- **2023-02-17** `11f63b609b07`: 1 info
  - added the optional property `controls/items/assuranceLevel` to the response with the `200` status
- **2022-12-09** `4061cf3eaf37`: 1 warning, 1 info
  - added the new `LANGUAGE_REGO` enum value to the `controls/items/metrics/items/implementation/lang` response property for the response status `200`
  - removed the `REGO` enum value from the `controls/items/metrics/items/implementation/lang` response property for the response status `200`
- **2022-11-07** `9aea46cc4c8a`: 12 breaking, 4 warning, 8 info
  - the response property `controls/items/categoryCatalogId` became optional for the status `200`
  - the response property `controls/items/categoryName` became optional for the status `200`
  - the response property `controls/items/controls` became optional for the status `200`
  - the response property `controls/items/id` became optional for the status `200`
  - the response property `controls/items/metrics` became optional for the status `200`
  - the response property `controls/items/metrics/items/category` became optional for the status `200`
  - the response property `controls/items/metrics/items/description` became optional for the status `200`
  - the response property `controls/items/metrics/items/id` became optional for the status `200`
  - the response property `controls/items/metrics/items/name` became optional for the status `200`
  - the response property `controls/items/name` became optional for the status `200`
  - the `controls/items/metrics/items/implementation` response's property type changed from no type to `object` for status `200`
  - removed the required property `controls/items/metrics/items/version` from the response with the `200` status
  - deleted the `query` request parameter `filter.assuranceLevels`
  - removed the optional property `controls/items/assuranceLevel` from the response with the `200` status
  - removed the optional property `controls/items/metrics/items/comments` from the response with the `200` status
  - removed the optional property `controls/items/metrics/items/deprecatedSince` from the response with the `200` status
  - added the optional property `controls/items/metrics/items/implementation/code` to the response with the `200` status
  - added the optional property `controls/items/metrics/items/implementation/lang` to the response with the `200` status
  - added the optional property `controls/items/metrics/items/implementation/metricId` to the response with the `200` status
  - added the optional property `controls/items/metrics/items/implementation/updatedAt` to the response with the `200` status
  - added the optional property `controls/items/metrics/items/interval` to the response with the `200` status
  - added the optional property `controls/items/metrics/items/range` to the response with the `200` status
  - added the optional property `controls/items/metrics/items/scale` to the response with the `200` status
  - removed `#/components/schemas/MetricImplementation` from the `controls/items/metrics/items/implementation` response property `allOf` list for the response status `200`

---

[Operation](https://skmtc.dev/clouditor/apis/orchestrator-api/docs/v1/orchestrator/controls/get.md) - [API](https://skmtc.dev/clouditor/apis/orchestrator-api.md) - [Page](https://skmtc.dev/clouditor/apis/orchestrator-api/changes/v1/orchestrator/controls/get)
