---
title: "Changes to Create an ACL"
method: POST
path: "/clusters/{cluster_id}/acls"
---

# Changes to Create an ACL

`POST /clusters/{cluster_id}/acls`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 12 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, 6 info
- **2022-03-22** (v3) `0b87d328c664`: 3 breaking, 28 info
- **2022-01-18** (v3) `242a6e383b71`: 22 breaking, 6 info
- **2022-01-18** (v3) `fbdd72178c66`: 3 breaking, 28 info
- **2021-09-08** (v3) `2d4f120a2079`: 3 info
- **2021-09-01** (v3) `fc95920a3a26`: 22 breaking, 3 info
- **2020-12-11** (v3) `42127473fd30`: 1 breaking
- **2020-12-11** (v3) `14895b1532ce`: 1 warning
- **2020-12-01** (v3) `5c941d4568ae`: 1 breaking

## 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 `createKafkaV3Acls` removed and replaced with `createKafkaAcls`
  - added the non-success response with the status `403`
- **2023-08-08** (v3) `1be42847ed21`: 3 info
  - api operation id `createKafkaAcls` removed and replaced with `createKafkaV3Acls`
  - 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 `createKafkaV3Acls` removed and replaced with `createKafkaAcls`
  - added the non-success response with the status `403`
- **2022-03-22** (v3) `7500cc59fcff`: 22 breaking, 6 info
  - removed the enum value `ALL` of the request property `operation`
  - removed the enum value `ALLOW` of the request property `permission`
  - removed the enum value `ALTER` of the request property `operation`
  - removed the enum value `ALTER_CONFIGS` of the request property `operation`
  - removed the enum value `ANY` of the request property `operation`
  - removed the enum value `ANY` of the request property `pattern_type`
  - removed the enum value `ANY` of the request property `permission`
  - removed the enum value `CLUSTER_ACTION` of the request property `operation`
  - removed the enum value `CREATE` of the request property `operation`
  - removed the enum value `DELETE` of the request property `operation`
  - removed the enum value `DENY` of the request property `permission`
  - removed the enum value `DESCRIBE` of the request property `operation`
  - removed the enum value `DESCRIBE_CONFIGS` of the request property `operation`
  - removed the enum value `IDEMPOTENT_WRITE` of the request property `operation`
  - removed the enum value `LITERAL` of the request property `pattern_type`
  - removed the enum value `MATCH` of the request property `pattern_type`
  - removed the enum value `PREFIXED` of the request property `pattern_type`
  - removed the enum value `READ` of the request property `operation`
  - removed the enum value `UNKNOWN` of the request property `operation`
  - removed the enum value `UNKNOWN` of the request property `pattern_type`
  - removed the enum value `UNKNOWN` of the request property `permission`
  - removed the enum value `WRITE` of the request property `operation`
  - api operation id `createKafkaV3Acls` 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`
- **2022-03-22** (v3) `0b87d328c664`: 3 breaking, 28 info
  - request property `operation` was restricted to a list of enum values
  - request property `pattern_type` was restricted to a list of enum values
  - request property `permission` was restricted to a list of enum values
  - api operation id `createKafkaV3Acls` removed and replaced with ``
  - api tag `ACL` added
  - api tag `ACL (v3)` removed
  - added the new `ALL` enum value to the request property `operation`
  - added the new `ALLOW` enum value to the request property `permission`
  - added the new `ALTER` enum value to the request property `operation`
  - added the new `ALTER_CONFIGS` enum value to the request property `operation`
  - added the new `ANY` enum value to the request property `operation`
  - added the new `ANY` enum value to the request property `pattern_type`
  - added the new `ANY` enum value to the request property `permission`
  - added the new `CLUSTER_ACTION` enum value to the request property `operation`
  - added the new `CREATE` enum value to the request property `operation`
  - added the new `DELETE` enum value to the request property `operation`
  - added the new `DENY` enum value to the request property `permission`
  - added the new `DESCRIBE` enum value to the request property `operation`
  - added the new `DESCRIBE_CONFIGS` enum value to the request property `operation`
  - added the new `IDEMPOTENT_WRITE` enum value to the request property `operation`
  - added the new `LITERAL` enum value to the request property `pattern_type`
  - added the new `MATCH` enum value to the request property `pattern_type`
  - added the new `PREFIXED` enum value to the request property `pattern_type`
  - added the new `READ` enum value to the request property `operation`
  - added the new `UNKNOWN` enum value to the request property `operation`
  - added the new `UNKNOWN` enum value to the request property `pattern_type`
  - added the new `UNKNOWN` enum value to the request property `permission`
  - added the new `WRITE` enum value to the request property `operation`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `429`
- **2022-01-18** (v3) `242a6e383b71`: 22 breaking, 6 info
  - removed the enum value `ALL` of the request property `operation`
  - removed the enum value `ALLOW` of the request property `permission`
  - removed the enum value `ALTER` of the request property `operation`
  - removed the enum value `ALTER_CONFIGS` of the request property `operation`
  - removed the enum value `ANY` of the request property `operation`
  - removed the enum value `ANY` of the request property `pattern_type`
  - removed the enum value `ANY` of the request property `permission`
  - removed the enum value `CLUSTER_ACTION` of the request property `operation`
  - removed the enum value `CREATE` of the request property `operation`
  - removed the enum value `DELETE` of the request property `operation`
  - removed the enum value `DENY` of the request property `permission`
  - removed the enum value `DESCRIBE` of the request property `operation`
  - removed the enum value `DESCRIBE_CONFIGS` of the request property `operation`
  - removed the enum value `IDEMPOTENT_WRITE` of the request property `operation`
  - removed the enum value `LITERAL` of the request property `pattern_type`
  - removed the enum value `MATCH` of the request property `pattern_type`
  - removed the enum value `PREFIXED` of the request property `pattern_type`
  - removed the enum value `READ` of the request property `operation`
  - removed the enum value `UNKNOWN` of the request property `operation`
  - removed the enum value `UNKNOWN` of the request property `pattern_type`
  - removed the enum value `UNKNOWN` of the request property `permission`
  - removed the enum value `WRITE` of the request property `operation`
  - api operation id `createKafkaV3Acls` 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`
- **2022-01-18** (v3) `fbdd72178c66`: 3 breaking, 28 info
  - request property `operation` was restricted to a list of enum values
  - request property `pattern_type` was restricted to a list of enum values
  - request property `permission` was restricted to a list of enum values
  - api operation id `createKafkaV3Acls` removed and replaced with ``
  - api tag `ACL` added
  - api tag `ACL (v3)` removed
  - added the new `ALL` enum value to the request property `operation`
  - added the new `ALLOW` enum value to the request property `permission`
  - added the new `ALTER` enum value to the request property `operation`
  - added the new `ALTER_CONFIGS` enum value to the request property `operation`
  - added the new `ANY` enum value to the request property `operation`
  - added the new `ANY` enum value to the request property `pattern_type`
  - added the new `ANY` enum value to the request property `permission`
  - added the new `CLUSTER_ACTION` enum value to the request property `operation`
  - added the new `CREATE` enum value to the request property `operation`
  - added the new `DELETE` enum value to the request property `operation`
  - added the new `DENY` enum value to the request property `permission`
  - added the new `DESCRIBE` enum value to the request property `operation`
  - added the new `DESCRIBE_CONFIGS` enum value to the request property `operation`
  - added the new `IDEMPOTENT_WRITE` enum value to the request property `operation`
  - added the new `LITERAL` enum value to the request property `pattern_type`
  - added the new `MATCH` enum value to the request property `pattern_type`
  - added the new `PREFIXED` enum value to the request property `pattern_type`
  - added the new `READ` enum value to the request property `operation`
  - added the new `UNKNOWN` enum value to the request property `operation`
  - added the new `UNKNOWN` enum value to the request property `pattern_type`
  - added the new `UNKNOWN` enum value to the request property `permission`
  - added the new `WRITE` enum value to the request property `operation`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `429`
- **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, 3 info
  - removed the enum value `ALL` of the request property `operation`
  - removed the enum value `ALLOW` of the request property `permission`
  - removed the enum value `ALTER` of the request property `operation`
  - removed the enum value `ALTER_CONFIGS` of the request property `operation`
  - removed the enum value `ANY` of the request property `operation`
  - removed the enum value `ANY` of the request property `pattern_type`
  - removed the enum value `ANY` of the request property `permission`
  - removed the enum value `CLUSTER_ACTION` of the request property `operation`
  - removed the enum value `CREATE` of the request property `operation`
  - removed the enum value `DELETE` of the request property `operation`
  - removed the enum value `DENY` of the request property `permission`
  - removed the enum value `DESCRIBE` of the request property `operation`
  - removed the enum value `DESCRIBE_CONFIGS` of the request property `operation`
  - removed the enum value `IDEMPOTENT_WRITE` of the request property `operation`
  - removed the enum value `LITERAL` of the request property `pattern_type`
  - removed the enum value `MATCH` of the request property `pattern_type`
  - removed the enum value `PREFIXED` of the request property `pattern_type`
  - removed the enum value `READ` of the request property `operation`
  - removed the enum value `UNKNOWN` of the request property `operation`
  - removed the enum value `UNKNOWN` of the request property `pattern_type`
  - removed the enum value `UNKNOWN` of the request property `permission`
  - removed the enum value `WRITE` of the request property `operation`
  - api operation id `createKafkaV3Acls` was added
  - api tag `ACL (v3)` added
  - api tag `ACL` removed
- **2020-12-11** (v3) `42127473fd30`: 1 breaking
  - added the new required request property `resource_name`
- **2020-12-11** (v3) `14895b1532ce`: 1 warning
  - removed the request property `resource_name`
- **2020-12-01** (v3) `5c941d4568ae`: 1 breaking
  - added the new required request property `resource_name`

---

[Operation](https://skmtc.dev/confluentinc/apis/rest-admin-api/docs/clusters/:cluster_id/acls/post.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/post)
