From fa0b9c6cf4a42b1856ac94fc62fa5cf9f8e9c29f Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Mon, 15 Jun 2026 10:43:50 +0000
Subject: [PATCH] docs: sync API changelog (nvm-monorepo@995eeb3)

---
 docs/development-guide/api-changelog.mdx | 26 ++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 docs/development-guide/api-changelog.mdx

diff --git a/docs/development-guide/api-changelog.mdx b/docs/development-guide/api-changelog.mdx
new file mode 100644
index 00000000..da7d4dab
--- /dev/null
+++ b/docs/development-guide/api-changelog.mdx
@@ -0,0 +1,26 @@
+---
+title: "API Changelog"
+description: "Every wire-shape change between supported Nevermined API versions. The version identifier is the platform release MAJOR.MINOR."
+---
+
+{/* GENERATED FILE — DO NOT EDIT. */}
+{/* Source of truth: nvm-monorepo apps/api/src/api-versioning/registry.ts. */}
+{/* Synced by the sync-api-changelog-docs workflow. */}
+
+Clients pin an API version per API key (editable in the dashboard) or per request
+via the `Nevermined-Version` header; the platform reshapes requests and responses so
+every supported pin keeps working. See the [versioning guide](/docs/development-guide/api-versioning).
+
+- **Floor (oldest supported version):** `1.0`
+- **Live current version:** `GET /api/v1/meta/versions`
+
+## 1.1
+
+_Changes relative to `1.0`:_
+
+- **Remove the legacy creditsConfig.proofRequired request alias — the canonical key is onchainMirror (clients below 1.1 keep the alias)** (`request`)
+  - `POST /api/v1/protocol/plans`
+  - `POST /api/v1/protocol/agents/plans`
+- **Remove the deprecated always-null permission slots orderLimit/planCost/creditsPerOrder from responses (clients below 1.1 keep receiving them as null)** (`response`)
+  - `GET /api/v1/x402/permissions`
+  - `GET /api/v1/x402/permissions/:permissionHash`