api_docs: Correct Zulip 3.0 feature level 1 changelog and notes.

Corrects omissions or inconsistencies between the api changelog
and the api documentation for Zulip 3.0, feature level 1,
except for the final two bullet points about GitLab authentication
and adding None as a video call provider option.

The final two bullet points will be addressed in separate commits.

Part of work on #22102.
This commit is contained in:
Lauryn Menard 2022-07-11 15:53:17 +02:00 committed by Tim Abbott
parent c5ebb74280
commit ddd9cc3ec9
2 changed files with 53 additions and 30 deletions

View File

@ -1019,7 +1019,8 @@ No changes; feature level used for Zulip 3.0 release.
* [`GET /users`](/api/get-users): User objects for bots now
contain a `bot_owner_id`, replacing the previous `bot_owner` field
(which had the email address of the bot owner).
* [`GET /users/{user_id}`](/api/get-user): Endpoint added.
* [`GET /users/{user_id}`](/api/get-user): New endpoint added to get
a single user's details by the user's ID.
* [`GET /messages`](/api/get-messages): Add support for string-format
values for the `anchor` parameter, deprecating and replacing the
`use_first_unread_anchor` parameter.
@ -1027,24 +1028,26 @@ No changes; feature level used for Zulip 3.0 release.
Message objects now use `topic_links` rather than `subject_links` to
indicate links either present in the topic or generated by linkifiers
applied to the topic.
* [`POST /users/me/subscriptions`](/api/subscribe): Replaced
`is_announcement_only` boolean with `stream_post_policy` enum for
specifying who can post to a stream.
* [`PATCH /streams/{stream_id}`](/api/update-stream): Replaced
`is_announcement_only` boolean with `stream_post_policy` enum for
specifying who can post to a stream.
* [`GET /streams`](/api/get-streams): Replaced
`is_announcement_only` boolean with `stream_post_policy` enum for
specifying who can post to a stream.
* `GET /api/v1/user_uploads`: Added new endpoint for requesting a
temporary URL for an uploaded file that does not require
authentication to access (e.g. for passing from a Zulip desktop,
mobile, or terminal app to the user's default browser).
* Added `EMAIL_ADDRESS_VISIBILITY_NOBODY` possible value for
* [`GET /streams`](/api/get-streams),
[`POST /users/me/subscriptions`](/api/subscribe),
[`PATCH /streams/{stream_id}`](/api/update-stream): Stream objects now
have `stream_post_policy` enum for specifying who can post to the stream,
deprecating and replacing the `is_announcement_only` boolean.
* [`GET /user_uploads/{realm_id_str}/{filename}`](/api/get-file-temporary-url):
New endpoint added for requesting a temporary URL for an uploaded
file that does not require authentication to access (e.g. for passing
from a Zulip desktop, mobile, or terminal app to the user's default
browser).
* [`POST /register`](/api/register-queue), [`GET /events`](/api/get-events),
`PATCH /realm`: Nobody added as an option for the realm setting
`email_address_visibility`.
* Added `private_message_policy` realm setting.
* `muted_topic` objects now are a 3-item tuple: (`stream_id`, `topic`,
`date_muted`). Previously, they were a 2-item tuple.
* [`POST /register`](/api/register-queue), [`GET /events`](/api/get-events),
`PATCH /realm`: Added realm setting `private_message_policy`.
* [`POST /register`](/api/register-queue), [`GET /events`](/api/get-events):
`muted_topics` array objects now are 3-item tuples that include the
stream name, the topic name, and the time when the topic was muted.
Previously, they were 2-item tuples and did not include the time when
the topic was muted.
* `GitLab` authentication is now available.
* Added `None` as a video call provider option.

View File

@ -1859,10 +1859,14 @@ paths:
type: array
description: |
Array of tuples, where each tuple describes a muted topic.
The first element of tuple is the stream name in which the topic
The first element of the tuple is the stream name in which the topic
has to be muted, the second element is the topic name to be muted
and the third element is an integer UNIX timestamp representing
when the topic was muted.
**Changes**: Before Zulip 3.0 (feature level 1), the `muted_topics`
array objects were 2-item tuples and did not include the timestamp
information for when the topic was muted.
items:
type: array
items:
@ -3782,11 +3786,13 @@ paths:
The [policy][permission-level] for which users in this organization can see
the real email addresses of other users.
- 1 = everyone
- 2 = members only
- 3 = administrators only
- 4 = nobody (though note that administrators can change this setting).
- 5 = moderators only
- 1 = Everyone
- 2 = Members only
- 3 = Administrators only
- 4 = Nobody (though note that administrators can change this setting)
- 5 = Moderators only
**Changes**: Nobody added as an option in Zulip 3.0 (feature level 1).
[permission-level]: /api/roles-and-permissions#permission-levels
email_changes_disabled:
@ -3998,6 +4004,8 @@ paths:
- 1 = Everyone
- 2 = Nobody
**Changes**: New in Zulip 3.0 (feature level 1).
send_welcome_emails:
type: boolean
description: |
@ -6125,6 +6133,8 @@ paths:
tags: ["messages"]
description: |
Get a temporary URL for access to the file that doesn't require authentication.
**Changes**: New in Zulip 3.0 (feature level 1).
parameters:
- name: realm_id_str
in: path
@ -9132,6 +9142,8 @@ paths:
type: integer
description: |
The server's current [Zulip feature level](/api/changelog).
**Changes**: New in Zulip 3.0 (feature level 1).
zulip_version:
type: string
description: |
@ -9302,10 +9314,14 @@ paths:
Present if `muted_topics` is present in `fetch_event_types`.
Array of tuples, where each tuple describes a muted topic.
The first element of tuple is the stream name in which the topic
The first element of the tuple is the stream name in which the topic
has to be muted, the second element is the topic name to be muted
and the third element is an integer UNIX timestamp representing
when the topic was muted.
**Changes**: Before Zulip 3.0 (feature level 1), the `muted_topics`
array objects were 2-item tuples and did not include the timestamp
information for when the topic was muted.
items:
type: array
items:
@ -10940,11 +10956,13 @@ paths:
The [policy][permission-level] for which users in this organization can see
the real email addresses of other users.
- 1 = everyone
- 2 = members only
- 3 = administrators only
- 4 = nobody (though note that administrators can change this setting).
- 5 = moderators only
- 1 = Everyone
- 2 = Members only
- 3 = Administrators only
- 4 = Nobody (though note that administrators can change this setting)
- 5 = Moderators only
**Changes**: Nobody added as an option in Zulip 3.0 (feature level 1).
[permission-level]: /api/roles-and-permissions#permission-levels
realm_email_changes_disabled:
@ -11154,6 +11172,8 @@ paths:
- 1 = Everyone
- 2 = Nobody
**Changes**: New in Zulip 3.0 (feature level 1).
realm_user_group_edit_policy:
type: integer
description: |