---
title: "Changes to List ACLs"
method: GET
path: "/clusters/{cluster_id}/acls"
---

# Changes to List ACLs

`GET /clusters/{cluster_id}/acls`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 69 revisions.

- **2023-08-08** (v3) `25e5259d1722`: 1 breaking, 2 info
- **2023-08-08** (v3) `1be42847ed21`: 3 info
- **2023-03-10** (v3) `bb1cdf42f052`: 1 breaking, 2 info
- **2022-03-22** (v3) `7500cc59fcff`: 22 breaking, 28 info
- **2022-03-22** (v3) `0b87d328c664`: 3 breaking, 22 warning, 28 info
- **2022-01-18** (v3) `242a6e383b71`: 22 breaking, 28 info
- **2022-01-18** (v3) `fbdd72178c66`: 3 breaking, 22 warning, 28 info
- **2021-09-08** (v3) `2d4f120a2079`: 3 info
- **2021-09-01** (v3) `fc95920a3a26`: 22 breaking, 25 info
- **2020-12-11** (v3) `14895b1532ce`: 1 info

## Changes

- **2023-08-08** (v3) `25e5259d1722`: 1 breaking, 2 info
  - removed the media type `text/plain` for the response with the status `400`
  - api operation id `getKafkaV3Acls` removed and replaced with `getKafkaAcls`
  - added the non-success response with the status `403`
- **2023-08-08** (v3) `1be42847ed21`: 3 info
  - api operation id `getKafkaAcls` removed and replaced with `getKafkaV3Acls`
  - added the media type `text/plain` for the response with the status `400`
  - removed the non-success response with the status `403`
- **2023-03-10** (v3) `bb1cdf42f052`: 1 breaking, 2 info
  - removed the media type `text/plain` for the response with the status `400`
  - api operation id `getKafkaV3Acls` removed and replaced with `getKafkaAcls`
  - added the non-success response with the status `403`
- **2022-03-22** (v3) `7500cc59fcff`: 22 breaking, 28 info
  - removed the enum value `ALL` from the `query` request parameter `operation`
  - removed the enum value `ALLOW` from the `query` request parameter `permission`
  - removed the enum value `ALTER` from the `query` request parameter `operation`
  - removed the enum value `ALTER_CONFIGS` from the `query` request parameter `operation`
  - removed the enum value `ANY` from the `query` request parameter `operation`
  - removed the enum value `ANY` from the `query` request parameter `pattern_type`
  - removed the enum value `ANY` from the `query` request parameter `permission`
  - removed the enum value `CLUSTER_ACTION` from the `query` request parameter `operation`
  - removed the enum value `CREATE` from the `query` request parameter `operation`
  - removed the enum value `DELETE` from the `query` request parameter `operation`
  - removed the enum value `DENY` from the `query` request parameter `permission`
  - removed the enum value `DESCRIBE` from the `query` request parameter `operation`
  - removed the enum value `DESCRIBE_CONFIGS` from the `query` request parameter `operation`
  - removed the enum value `IDEMPOTENT_WRITE` from the `query` request parameter `operation`
  - removed the enum value `LITERAL` from the `query` request parameter `pattern_type`
  - removed the enum value `MATCH` from the `query` request parameter `pattern_type`
  - removed the enum value `PREFIXED` from the `query` request parameter `pattern_type`
  - removed the enum value `READ` from the `query` request parameter `operation`
  - removed the enum value `UNKNOWN` from the `query` request parameter `operation`
  - removed the enum value `UNKNOWN` from the `query` request parameter `pattern_type`
  - removed the enum value `UNKNOWN` from the `query` request parameter `permission`
  - removed the enum value `WRITE` from the `query` request parameter `operation`
  - api operation id `getKafkaV3Acls` was added
  - api tag `ACL (v3)` added
  - api tag `ACL` removed
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `429`
  - removed the `ALL` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `ALLOW` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - removed the `ALTER` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `ALTER_CONFIGS` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `ANY` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `ANY` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/pattern_type` response property for the response status `200`
  - removed the `ANY` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - removed the `CLUSTER_ACTION` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `CREATE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `DELETE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `DENY` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - removed the `DESCRIBE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - …10 more
- **2022-03-22** (v3) `0b87d328c664`: 3 breaking, 22 warning, 28 info
  - the `query` request parameter `operation` was restricted to a list of enum values
  - the `query` request parameter `pattern_type` was restricted to a list of enum values
  - the `query` request parameter `permission` was restricted to a list of enum values
  - added the new `ALL` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `ALLOW` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - added the new `ALTER` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `ALTER_CONFIGS` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `ANY` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `ANY` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/pattern_type` response property for the response status `200`
  - added the new `ANY` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - added the new `CLUSTER_ACTION` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `CREATE` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `DELETE` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `DENY` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - added the new `DESCRIBE` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `DESCRIBE_CONFIGS` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `IDEMPOTENT_WRITE` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `LITERAL` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/pattern_type` response property for the response status `200`
  - added the new `MATCH` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/pattern_type` response property for the response status `200`
  - added the new `PREFIXED` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/pattern_type` response property for the response status `200`
  - added the new `READ` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `UNKNOWN` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `UNKNOWN` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/pattern_type` response property for the response status `200`
  - added the new `UNKNOWN` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - added the new `WRITE` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - api operation id `getKafkaV3Acls` removed and replaced with ``
  - api tag `ACL` added
  - api tag `ACL (v3)` removed
  - added the new enum value `ALL` to the `query` request parameter `operation`
  - added the new enum value `ALLOW` to the `query` request parameter `permission`
  - added the new enum value `ALTER` to the `query` request parameter `operation`
  - added the new enum value `ALTER_CONFIGS` to the `query` request parameter `operation`
  - added the new enum value `ANY` to the `query` request parameter `operation`
  - added the new enum value `ANY` to the `query` request parameter `pattern_type`
  - added the new enum value `ANY` to the `query` request parameter `permission`
  - added the new enum value `CLUSTER_ACTION` to the `query` request parameter `operation`
  - added the new enum value `CREATE` to the `query` request parameter `operation`
  - added the new enum value `DELETE` to the `query` request parameter `operation`
  - added the new enum value `DENY` to the `query` request parameter `permission`
  - added the new enum value `DESCRIBE` to the `query` request parameter `operation`
  - …13 more
- **2022-01-18** (v3) `242a6e383b71`: 22 breaking, 28 info
  - removed the enum value `ALL` from the `query` request parameter `operation`
  - removed the enum value `ALLOW` from the `query` request parameter `permission`
  - removed the enum value `ALTER` from the `query` request parameter `operation`
  - removed the enum value `ALTER_CONFIGS` from the `query` request parameter `operation`
  - removed the enum value `ANY` from the `query` request parameter `operation`
  - removed the enum value `ANY` from the `query` request parameter `pattern_type`
  - removed the enum value `ANY` from the `query` request parameter `permission`
  - removed the enum value `CLUSTER_ACTION` from the `query` request parameter `operation`
  - removed the enum value `CREATE` from the `query` request parameter `operation`
  - removed the enum value `DELETE` from the `query` request parameter `operation`
  - removed the enum value `DENY` from the `query` request parameter `permission`
  - removed the enum value `DESCRIBE` from the `query` request parameter `operation`
  - removed the enum value `DESCRIBE_CONFIGS` from the `query` request parameter `operation`
  - removed the enum value `IDEMPOTENT_WRITE` from the `query` request parameter `operation`
  - removed the enum value `LITERAL` from the `query` request parameter `pattern_type`
  - removed the enum value `MATCH` from the `query` request parameter `pattern_type`
  - removed the enum value `PREFIXED` from the `query` request parameter `pattern_type`
  - removed the enum value `READ` from the `query` request parameter `operation`
  - removed the enum value `UNKNOWN` from the `query` request parameter `operation`
  - removed the enum value `UNKNOWN` from the `query` request parameter `pattern_type`
  - removed the enum value `UNKNOWN` from the `query` request parameter `permission`
  - removed the enum value `WRITE` from the `query` request parameter `operation`
  - api operation id `getKafkaV3Acls` was added
  - api tag `ACL (v3)` added
  - api tag `ACL` removed
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `429`
  - removed the `ALL` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `ALLOW` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - removed the `ALTER` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `ALTER_CONFIGS` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `ANY` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `ANY` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/pattern_type` response property for the response status `200`
  - removed the `ANY` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - removed the `CLUSTER_ACTION` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `CREATE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `DELETE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `DENY` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - removed the `DESCRIBE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - …10 more
- **2022-01-18** (v3) `fbdd72178c66`: 3 breaking, 22 warning, 28 info
  - the `query` request parameter `operation` was restricted to a list of enum values
  - the `query` request parameter `pattern_type` was restricted to a list of enum values
  - the `query` request parameter `permission` was restricted to a list of enum values
  - added the new `ALL` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `ALLOW` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - added the new `ALTER` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `ALTER_CONFIGS` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `ANY` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `ANY` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/pattern_type` response property for the response status `200`
  - added the new `ANY` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - added the new `CLUSTER_ACTION` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `CREATE` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `DELETE` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `DENY` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - added the new `DESCRIBE` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `DESCRIBE_CONFIGS` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `IDEMPOTENT_WRITE` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `LITERAL` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/pattern_type` response property for the response status `200`
  - added the new `MATCH` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/pattern_type` response property for the response status `200`
  - added the new `PREFIXED` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/pattern_type` response property for the response status `200`
  - added the new `READ` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `UNKNOWN` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - added the new `UNKNOWN` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/pattern_type` response property for the response status `200`
  - added the new `UNKNOWN` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - added the new `WRITE` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - api operation id `getKafkaV3Acls` removed and replaced with ``
  - api tag `ACL` added
  - api tag `ACL (v3)` removed
  - added the new enum value `ALL` to the `query` request parameter `operation`
  - added the new enum value `ALLOW` to the `query` request parameter `permission`
  - added the new enum value `ALTER` to the `query` request parameter `operation`
  - added the new enum value `ALTER_CONFIGS` to the `query` request parameter `operation`
  - added the new enum value `ANY` to the `query` request parameter `operation`
  - added the new enum value `ANY` to the `query` request parameter `pattern_type`
  - added the new enum value `ANY` to the `query` request parameter `permission`
  - added the new enum value `CLUSTER_ACTION` to the `query` request parameter `operation`
  - added the new enum value `CREATE` to the `query` request parameter `operation`
  - added the new enum value `DELETE` to the `query` request parameter `operation`
  - added the new enum value `DENY` to the `query` request parameter `permission`
  - added the new enum value `DESCRIBE` to the `query` request parameter `operation`
  - …13 more
- **2021-09-08** (v3) `2d4f120a2079`: 3 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `429`
- **2021-09-01** (v3) `fc95920a3a26`: 22 breaking, 25 info
  - removed the enum value `ALL` from the `query` request parameter `operation`
  - removed the enum value `ALLOW` from the `query` request parameter `permission`
  - removed the enum value `ALTER` from the `query` request parameter `operation`
  - removed the enum value `ALTER_CONFIGS` from the `query` request parameter `operation`
  - removed the enum value `ANY` from the `query` request parameter `operation`
  - removed the enum value `ANY` from the `query` request parameter `pattern_type`
  - removed the enum value `ANY` from the `query` request parameter `permission`
  - removed the enum value `CLUSTER_ACTION` from the `query` request parameter `operation`
  - removed the enum value `CREATE` from the `query` request parameter `operation`
  - removed the enum value `DELETE` from the `query` request parameter `operation`
  - removed the enum value `DENY` from the `query` request parameter `permission`
  - removed the enum value `DESCRIBE` from the `query` request parameter `operation`
  - removed the enum value `DESCRIBE_CONFIGS` from the `query` request parameter `operation`
  - removed the enum value `IDEMPOTENT_WRITE` from the `query` request parameter `operation`
  - removed the enum value `LITERAL` from the `query` request parameter `pattern_type`
  - removed the enum value `MATCH` from the `query` request parameter `pattern_type`
  - removed the enum value `PREFIXED` from the `query` request parameter `pattern_type`
  - removed the enum value `READ` from the `query` request parameter `operation`
  - removed the enum value `UNKNOWN` from the `query` request parameter `operation`
  - removed the enum value `UNKNOWN` from the `query` request parameter `pattern_type`
  - removed the enum value `UNKNOWN` from the `query` request parameter `permission`
  - removed the enum value `WRITE` from the `query` request parameter `operation`
  - api operation id `getKafkaV3Acls` was added
  - api tag `ACL (v3)` added
  - api tag `ACL` removed
  - removed the `ALL` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `ALLOW` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - removed the `ALTER` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `ALTER_CONFIGS` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `ANY` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `ANY` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/pattern_type` response property for the response status `200`
  - removed the `ANY` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - removed the `CLUSTER_ACTION` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `CREATE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `DELETE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `DENY` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/permission` response property for the response status `200`
  - removed the `DESCRIBE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `DESCRIBE_CONFIGS` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `IDEMPOTENT_WRITE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/operation` response property for the response status `200`
  - removed the `LITERAL` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/pattern_type` response property for the response status `200`
  - …7 more
- **2020-12-11** (v3) `14895b1532ce`: 1 info
  - added the required property `allOf[subschema #2]/data/items/allOf[subschema #2]/resource_name` to the response with the `200` status

---

[Operation](https://skmtc.dev/confluentinc/apis/rest-admin-api/docs/clusters/:cluster_id/acls/get.md) - [API](https://skmtc.dev/confluentinc/apis/rest-admin-api.md) - [Page](https://skmtc.dev/confluentinc/apis/rest-admin-api/changes/clusters/:cluster_id/acls/get)