---
title: "Changes to Create a Acme plugin"
method: POST
path: "/v2/control-planes/{controlPlaneId}/core-entities/plugins#Acme"
---

# Changes to Create a Acme plugin

`POST /v2/control-planes/{controlPlaneId}/core-entities/plugins#Acme`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 17 of 52 revisions.

- **2026-06-26** `4a39c7f85509` — 2 breaking, 2 info
- **2026-06-11** `62c54f1094bb` — 1 breaking, 1 info
- **2026-04-24** `7d6a643707d9` — 2 info
- **2026-01-13** `ad02b4e24eb2` — 2 info
- **2025-11-11** `28774c89f2cb` — 1 breaking, 1 info
- **2025-10-29** `19e869275e28` — 3 breaking, 2 info
- **2025-09-16** `f03059016622` — 5 breaking
- **2025-08-22** `96118a9cd7f4` — 33 breaking, 79 info
- **2025-07-22** `2c77aeaee5fb` — 3 breaking, 3 info
- **2025-06-17** `c308b7426a7c` — 2 breaking
- **2025-05-21** `69704304ad5f` — 2 info
- **2025-04-15** `fc6abbc537f3` — 2 breaking, 6 info
- **2025-02-10** `d833d4dbb1fa` — 1 breaking, 1 warning, 4 info
- **2024-12-13** `8aedc289a938` — 1 breaking
- **2024-12-06** `426663331655` — 1 breaking
- **2024-11-11** `08ead66e9ebb` — 4 breaking, 1 warning, 25 info
- **2024-09-11** `be7c36317ba6` — 1 info

## Changes

- **2026-06-26** `4a39c7f85509` — 2 breaking, 2 info
  - the `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/redis/port` request property type changed from `integer` to `string`
  - the `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/redis/port` response's property type changed from `integer` to `string` for status `201`
  - the `port` request property default value changed from `6379` to `6379`
  - the `port` response's property default value changed from `6379` to `6379` for the status `201`
- **2026-06-11** `62c54f1094bb` — 1 breaking, 1 info
  - the request property `allOf[#/components/schemas/PluginBase]/partials/items/path` became required
  - the response property `allOf[#/components/schemas/PluginBase]/partials/items/path` became required for the status `201`
- **2026-04-24** `7d6a643707d9` — 2 info
  - added the new optional request property `allOf[#/components/schemas/PluginBase]/condition`
  - added the optional property `allOf[#/components/schemas/PluginBase]/condition` to the response with the `201` status
- **2026-01-13** `ad02b4e24eb2` — 2 info
  - added the new optional request property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/redis/cloud_authentication`
  - added the optional property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/redis/cloud_authentication` to the response with the `201` status
- **2025-11-11** `28774c89f2cb` — 1 breaking, 1 info
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/kong` became nullable for the status `201`
  - the request property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/kong` became nullable
- **2025-10-29** `19e869275e28` — 3 breaking, 2 info
  - the request property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/kong` became not nullable
  - the `allOf[#/components/schemas/AcmePluginConfig]/name` request property type changed from `string` to no type
  - the `allOf[#/components/schemas/AcmePluginConfig]/name` response's property type changed from `string` to no type for status `201`
  - removed the pattern `[a-zA-Z0-9]*[!-/:-@[-`{-~]*@+[a-zA-Z0-9]*%.?[a-zA-Z0-9]*` from the request property `allOf[#/components/schemas/AcmePluginConfig]/config/account_email`
  - the `allOf[#/components/schemas/AcmePluginConfig]/config/account_email` response's property pattern `[a-zA-Z0-9]*[!-/:-@[-`{-~]*@+[a-zA-Z0-9]*%.?[a-zA-Z0-9]*` was removed for the status `201`
- **2025-09-16** `f03059016622` — 5 breaking
  - the request property `allOf[#/components/schemas/PluginBase]/partials/items/name` became not nullable
  - the request property `allOf[#/components/schemas/PluginBase]/partials/items/path` became not nullable
  - the `allOf[#/components/schemas/PluginBase]/id` request property's minLength was increased from `0` to `1`
  - the `allOf[#/components/schemas/PluginBase]/name` request property's minLength was increased from `0` to `1`
  - the `allOf[#/components/schemas/PluginBase]/partials/items/id` request property's minLength was increased from `0` to `1`
- **2025-08-22** `96118a9cd7f4` — 33 breaking, 79 info
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/account_key` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/account_key/key_set` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/domains` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/eab_hmac_key` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/eab_kid` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/preferred_chain` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/consul` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/consul/host` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/consul/kv_path` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/consul/port` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/consul/timeout` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/consul/token` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/kong` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/redis` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/redis/extra_options` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/redis/host` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/redis/password` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/redis/server_name` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/redis/username` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/shm` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/vault` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/vault/auth_path` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/vault/auth_role` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/vault/host` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/vault/jwt_path` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/vault/kv_path` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/vault/port` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/vault/timeout` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/vault/tls_server_name` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config/vault/token` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/PluginBase]/partials/items/name` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/PluginBase]/partials/items/path` became nullable for the status `201`
  - the request property `allOf[#/components/schemas/AcmePluginConfig]/config/account_key` became nullable
  - the request property `allOf[#/components/schemas/AcmePluginConfig]/config/account_key/key_set` became nullable
  - the request property `allOf[#/components/schemas/AcmePluginConfig]/config/domains` became nullable
  - the request property `allOf[#/components/schemas/AcmePluginConfig]/config/eab_hmac_key` became nullable
  - the request property `allOf[#/components/schemas/AcmePluginConfig]/config/eab_kid` became nullable
  - the request property `allOf[#/components/schemas/AcmePluginConfig]/config/preferred_chain` became nullable
  - the request property `allOf[#/components/schemas/AcmePluginConfig]/config/storage_config` became nullable
  - …72 more
- **2025-07-22** `2c77aeaee5fb` — 3 breaking, 3 info
  - the request property `allOf[#/components/schemas/AcmePluginConfig]/config` became required
  - the request property `allOf[#/components/schemas/AcmePluginConfig]/config/account_email` became required
  - the response property `allOf[#/components/schemas/PluginBase]/tags` became nullable for the status `201`
  - the request property `allOf[#/components/schemas/PluginBase]/tags` became nullable
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config` became required for the status `201`
  - the response property `allOf[#/components/schemas/AcmePluginConfig]/config/account_email` became required for the status `201`
- **2025-06-17** `c308b7426a7c` — 2 breaking
  - the `allOf[#/components/schemas/AcmePluginConfig]/protocols` request property format changed from no format to `set`
  - the `allOf[#/components/schemas/AcmePluginConfig]/protocols` response's property format changed from no format to `set` for status `201`
- **2025-05-21** `69704304ad5f` — 2 info
  - added the new optional request property `allOf[#/components/schemas/PluginBase]/partials`
  - added the optional property `allOf[#/components/schemas/PluginBase]/partials` to the response with the `201` status
- **2025-04-15** `fc6abbc537f3` — 2 breaking, 6 info
  - the response property `allOf[#/components/schemas/PluginBase]/created_at` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/PluginBase]/updated_at` became nullable for the status `201`
  - the request optional property `allOf[#/components/schemas/PluginBase]/created_at` became not read-only
  - the request optional property `allOf[#/components/schemas/PluginBase]/updated_at` became not read-only
  - the request property `allOf[#/components/schemas/PluginBase]/created_at` became nullable
  - the request property `allOf[#/components/schemas/PluginBase]/updated_at` became nullable
  - the response optional property `allOf[#/components/schemas/PluginBase]/created_at` became not read-only for the status `201`
  - the response optional property `allOf[#/components/schemas/PluginBase]/updated_at` became not read-only for the status `201`
- **2025-02-10** `d833d4dbb1fa` — 1 breaking, 1 warning, 4 info
  - added `#/components/schemas/PluginBase` to the request body `allOf` list
  - removed `#/components/schemas/Plugin` from the request body `allOf` list
  - added the new optional request property `allOf[#/components/schemas/AcmePluginConfig]/protocols`
  - added `#/components/schemas/PluginBase` to the response body `allOf` list for the response status `201`
  - removed `#/components/schemas/Plugin` from the response body `allOf` list for the response status `201`
  - added the optional property `allOf[#/components/schemas/AcmePluginConfig]/protocols` to the response with the `201` status
- **2024-12-13** `8aedc289a938` — 1 breaking
  - request body became required
- **2024-12-06** `426663331655` — 1 breaking
  - the request property `allOf[#/components/schemas/Plugin]/tags` became not nullable
- **2024-11-11** `08ead66e9ebb` — 4 breaking, 1 warning, 25 info
  - added the new required request property `allOf[#/components/schemas/Plugin]/config`
  - added the new required request property `allOf[#/components/schemas/Plugin]/name`
  - the `allOf[#/components/schemas/Plugin]/` request property type changed from no type to `object`
  - the `allOf[#/components/schemas/Plugin]/` response's property type changed from no type to `object` for status `201`
  - removed `#/components/schemas/PluginWithoutParents, subschema #2` from the `allOf[#/components/schemas/Plugin]/` request property `allOf` list
  - added the new optional request property `allOf[#/components/schemas/Plugin]/consumer`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/consumer_group`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/enabled`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/id`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/instance_name`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/ordering`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/protocols`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/route`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/service`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/tags`
  - added the optional property `allOf[#/components/schemas/Plugin]/consumer` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Plugin]/consumer_group` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Plugin]/created_at` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Plugin]/enabled` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Plugin]/id` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Plugin]/instance_name` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Plugin]/ordering` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Plugin]/protocols` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Plugin]/route` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Plugin]/service` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Plugin]/tags` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/Plugin]/updated_at` to the response with the `201` status
  - removed `#/components/schemas/PluginWithoutParents, subschema #2` from the `allOf[#/components/schemas/Plugin]/` response property `allOf` list for the response status `201`
  - added the required property `allOf[#/components/schemas/Plugin]/config` to the response with the `201` status
  - added the required property `allOf[#/components/schemas/Plugin]/name` to the response with the `201` status
- **2024-09-11** `be7c36317ba6` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/kong/apis/konnect-api/docs/v2/control-planes/:controlPlaneId/core-entities/plugins#Acme/post.md) · [API](https://skmtc.dev/kong/apis/konnect-api.md) · [Page](https://skmtc.dev/kong/apis/konnect-api/changes/v2/control-planes/:controlPlaneId/core-entities/plugins#Acme/post)
