From d5fb3f317681595c1f5e5cb2100bc95a01acdf0f Mon Sep 17 00:00:00 2001
From: Mateusz Mandera <mateusz.mandera@zulip.com>
Date: Fri, 16 Feb 2024 01:06:32 +0100
Subject: [PATCH] authentication_methods: Bump feature level and add changelog
 entries.

---
 api_docs/changelog.md     | 11 +++++++++++
 version.py                |  2 +-
 zerver/openapi/zulip.yaml |  8 ++++++++
 3 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/api_docs/changelog.md b/api_docs/changelog.md
index c95f5f3546..56cca108ed 100644
--- a/api_docs/changelog.md
+++ b/api_docs/changelog.md
@@ -20,6 +20,17 @@ format used by the Zulip server that they are interacting with.
 
 ## Changes in Zulip 9.0
 
+**Feature level 243**
+
+* [`POST /register`](/api/register-queue), [`GET
+  /events`](/api/get-events): Changed the format of
+  `realm_authentication_methods` and `authentication_methods`,
+  respectively, to use a dictionary rather than a boolean as the value
+  for each authentication method. The new dictionaries are more
+  extensively and contain fields indicating whether the backend is
+  unavailable to the current realm due to Zulip Cloud plan
+  restrictions or any other reason.
+
 **Feature level 242**
 
 * [`POST /register`](/api/register-queue), [`POST /events`](/api/get-events),
diff --git a/version.py b/version.py
index f4761b9582..bd0e92a152 100644
--- a/version.py
+++ b/version.py
@@ -33,7 +33,7 @@ DESKTOP_WARNING_VERSION = "5.9.3"
 # Changes should be accompanied by documentation explaining what the
 # new level means in api_docs/changelog.md, as well as "**Changes**"
 # entries in the endpoint's documentation in `zulip.yaml`.
-API_FEATURE_LEVEL = 242
+API_FEATURE_LEVEL = 243
 
 # Bump the minor PROVISION_VERSION to indicate that folks should provision
 # only when going from an old version of the code to a newer version. Bump
diff --git a/zerver/openapi/zulip.yaml b/zerver/openapi/zulip.yaml
index 5d6b563477..251e98b097 100644
--- a/zerver/openapi/zulip.yaml
+++ b/zerver/openapi/zulip.yaml
@@ -4183,6 +4183,10 @@ paths:
                                         methods are enabled for the organization. For authentication UI itself,
                                         clients should use the pre-authentication metadata returned by
                                         [`GET /server_settings`](/api/get-server-settings).
+
+                                        **Changes**: In Zulip 9.0 (feature level 243), the values in this
+                                        dictionary were changed. Previously, the values were a simple boolean
+                                        indicating whether the backend is enabled or not.
                                     bot_creation_policy:
                                       type: integer
                                       description: |
@@ -14540,6 +14544,10 @@ paths:
                           methods are enabled for the organization. For authentication UI itself,
                           clients should use the pre-authentication metadata returned by
                           [`GET /server_settings`](/api/get-server-settings).
+
+                          **Changes**: In Zulip 9.0 (feature level 241), the values in this
+                          dictionary were changed. Previously, the values were a simple boolean
+                          indicating whether the backend is enabled or not.
                       realm_allow_message_editing:
                         type: boolean
                         description: |