From 2d85612ff07815f4deb9ade7f44174938d817e6d Mon Sep 17 00:00:00 2001 From: Lauryn Menard Date: Wed, 18 May 2022 21:44:58 +0200 Subject: [PATCH] api-docs: Add `create_web_public_stream_policy` to realm update. Adds `create_web_public_stream_policy` to the `get-events` API documentation for the `realm op:update` event. Also, fixes changelog entries for feature levels 103 and 104, which are related to the API documentation changes or fix an error in references to the undocumented endpoint `PATCH /realm`. --- templates/zerver/api/changelog.md | 5 +++-- zerver/openapi/zulip.yaml | 7 +++++++ 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/templates/zerver/api/changelog.md b/templates/zerver/api/changelog.md index 8bd6ac389c..284a7d8724 100644 --- a/templates/zerver/api/changelog.md +++ b/templates/zerver/api/changelog.md @@ -214,7 +214,7 @@ No changes; feature level used for Zulip 5.0 release. **Feature level 104** -* [`PATCH /realm`]: Added `string_id` parameter for changing an +* `PATCH /realm`: Added `string_id` parameter for changing an organization's subdomain. Currently, this is only allowed for changing a demo organization to a normal one. @@ -222,7 +222,8 @@ No changes; feature level used for Zulip 5.0 release. * [`POST /register`](/api/register-queue): Added `create_web_public_stream_policy` policy for which users can create web-public streams. -* [`PATCH /realm`]: Added support for updating `create_web_public_stream_policy`. +* [`GET /events`](/api/get-events), `PATCH /realm`: Added support for updating + `create_web_public_stream_policy`. * [`POST /register`](/api/register-queue): Added `can_create_web_public_streams` boolean field to the response. diff --git a/zerver/openapi/zulip.yaml b/zerver/openapi/zulip.yaml index 037e2efb4e..148e4148a4 100644 --- a/zerver/openapi/zulip.yaml +++ b/zerver/openapi/zulip.yaml @@ -3717,6 +3717,13 @@ paths: **Changes**: Before Zulip 5.0 (feature level 102), permission to create streams was controlled by the `create_stream_policy` setting. + create_web_public_stream_policy: + type: integer + description: | + The [policy](/api/roles-and-permissions#permission-levels) + for which users can create web public streams in this organization. + + **Changes**: New in Zulip 5.0 (feature level 103). default_code_block_language: type: string nullable: true