From 2f96b1756eff1f83049db10000857cabf6ba7466 Mon Sep 17 00:00:00 2001
From: Lauryn Menard <lauryn@zulip.com>
Date: Thu, 18 May 2023 16:00:25 +0200
Subject: [PATCH] api-changelog: Add notes for feature level 3 `zulip_version`
 change.

Original API changelog note was made in commit 2c63130195ed5b.
---
 api_docs/changelog.md     |  9 +++++----
 zerver/openapi/zulip.yaml | 10 +++++++++-
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/api_docs/changelog.md b/api_docs/changelog.md
index 834b2121a1..daa9edcb94 100644
--- a/api_docs/changelog.md
+++ b/api_docs/changelog.md
@@ -1408,11 +1408,12 @@ No changes; feature level used for Zulip 3.0 release.
   `POST /register` to make them accessible to all the clients;
   they were only internally available to Zulip's web app prior to this.
 
-**Feature level 3**:
+**Feature level 3**
 
-* `zulip_version` and `zulip_feature_level` are always returned
-  in `POST /register`; previously they were only returned if `event_types`
-  included `zulip_version`.
+* [`POST /register`](/api/register-queue): `zulip_version` and
+  `zulip_feature_level` are always returned in the endpoint response.
+  Previously, they were only present if `event_types` included
+  `zulip_version`.
 * Added new `presence_enabled` user notification setting; previously
   [presence](/help/status-and-availability) was always enabled.
 
diff --git a/zerver/openapi/zulip.yaml b/zerver/openapi/zulip.yaml
index 00403186ff..d46b39db65 100644
--- a/zerver/openapi/zulip.yaml
+++ b/zerver/openapi/zulip.yaml
@@ -10668,7 +10668,11 @@ paths:
                         description: |
                           The server's current [Zulip feature level](/api/changelog).
 
-                          **Changes**: New in Zulip 3.0 (feature level 1).
+                          **Changes**: As of Zulip 3.0 (feature level 3), this is always present
+                          in the endpoint's response. Previously, it was only present if
+                          `event_types` included `zulip_version`.
+
+                          New in Zulip 3.0 (feature level 1).
                       zulip_version:
                         type: string
                         description: |
@@ -10676,6 +10680,10 @@ paths:
                           like `2.1.7`. But for a server running a [version from Git][git-release],
                           it will be a Git reference to the commit, like `5.0-dev-1650-gc3fd37755f`.
 
+                          **Changes**: As of Zulip 3.0 (feature level 3), this is always present
+                          in the endpoint's response. Previously, it was only present if
+                          `event_types` included `zulip_version`.
+
                           [git-release]: https://zulip.readthedocs.io/en/latest/overview/release-lifecycle.html#git-versions
                       zulip_merge_base:
                         type: string