From c3d27347b03947e349e54806a25d914cc91c5d53 Mon Sep 17 00:00:00 2001
From: zmstone <zmstone@gmail.com>
Date: Sun, 28 Apr 2024 14:54:01 +0200
Subject: [PATCH] docs: update changlog for pr 12940

---
 changes/ce/feat-12940.en.md | 12 ++++++++++++
 changes/ce/fix-12940.en.md  |  3 ---
 2 files changed, 12 insertions(+), 3 deletions(-)
 create mode 100644 changes/ce/feat-12940.en.md
 delete mode 100644 changes/ce/fix-12940.en.md

diff --git a/changes/ce/feat-12940.en.md b/changes/ce/feat-12940.en.md
new file mode 100644
index 000000000..24bdcc4e2
--- /dev/null
+++ b/changes/ce/feat-12940.en.md
@@ -0,0 +1,12 @@
+Add `ignore_readonly` argument to `PUT /configs` API.
+
+Prior to this change, EMQX would retrun 400 (BAD_REQUEST) if the raw config
+included readonly root keys (`cluster`, `rpc`, and `node`).
+
+After this enhancement it can be called as `PUT /configs?ignore_readonly=true`,
+EMQX will in this case ignore readonly root config keys, and apply the rest.
+
+A warning message is logged to warn that the readonly keys are dropped.
+
+Also fixed an exception when config has bad HOCON syntax (returns 500).
+Now bad syntax will cause the API to return 400 (BAD_REQUEST).
diff --git a/changes/ce/fix-12940.en.md b/changes/ce/fix-12940.en.md
deleted file mode 100644
index 8304effd5..000000000
--- a/changes/ce/fix-12940.en.md
+++ /dev/null
@@ -1,3 +0,0 @@
-Fix config update API `/configs` 500 error when config has bad HOCON syntax.
-
-Now bad syntax will cause the API to return 400 (BAD_REQUEST).