Mirror
/
zulip
mirror of https://github.com/zulip/zulip.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

api-docs: Clarify API feature level 271 changelog and changes notes. 

Fixes #30864.
This commit is contained in:
Lauryn Menard 2024-07-17 05:00:55 +02:00 committed by Tim Abbott
parent b9c33ce5f1
commit 08d48d3d97
2 changed files with 22 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
api_docs/changelog.md
View File

@ -43,9 +43,11 @@ format used by the Zulip server that they are interacting with.
[`GET /messages/matches_narrow`](/api/check-messages-match-narrow), [`GET /messages/matches_narrow`](/api/check-messages-match-narrow),
[`POST /messages/flags/narrow`](/api/update-message-flags-for-narrow), [`POST /messages/flags/narrow`](/api/update-message-flags-for-narrow),
[`POST /register`](/api/register-queue): [`POST /register`](/api/register-queue):
Added support for a new [search/narrow filter](/api/construct-narrow#changes), Added support for a new [search/narrow filter](/api/construct-narrow#changes)
`with`, which returns messages in the same channel and topic as that operator, `with`, which uses a message ID for its operand. It returns
of the operand of filter, with the first unread message as anchor. messages in the same conversation as the message with the specified
ID, and is designed to be used for creating permanent links to topics
that continue to work when a topic is moved or resolved.
**Feature level 270** **Feature level 270**

30
api_docs/construct-narrow.md
View File

@ -53,8 +53,9 @@ messages](/api/update-message-flags-for-narrow)).
## Changes ## Changes
* In Zulip 9.0 (feature level 271), narrows gained support * In Zulip 9.0 (feature level 271), support was added for a new filter
for a new `with` operator for linking to topics. operator, `with`, which uses a [message ID](#message-ids) for its
operand, and is designed for creating permanent links to topics.
* In Zulip 9.0 (feature level 265), support was added for a new * In Zulip 9.0 (feature level 265), support was added for a new
`is:followed` filter, matching messages in topics that the current `is:followed` filter, matching messages in topics that the current
@ -94,20 +95,23 @@ messages](/api/update-message-flags-for-narrow)).
### Message IDs ### Message IDs
The `with` operator is designed to be used in links that should follow The `near`, `id` and `with` operators use message IDs for their
a topic across being moved. Its operand is a message ID. operands. The `near` and `id` operators are documented in the help
center [here](/help/search-for-messages#search-by-message-id).
The `near` and `id` operators, documented in the help center, The `with` operator is designed to be used for permanent links to topics,
also use message IDs for their operands. which means they should continue to work when the topic is
[moved](/help/move-content-to-another-topic) or
[resolved](/help/resolve-a-topic). If the message with the specified ID
exists, and can be accessed by the user, then it will return messages
with the `channel`/`topic`/`dm` operators corresponding to the current
conversation containing that message, and replacing any such filters
included in the narrow.
* `with:12345`: Search for the conversation (stream/topic pair) which * `with:12345`: Search for the conversation that contains the message
contains the message with ID `12345`. If such a message exists, and with ID `12345`.
can be accessed by the user, then the search will be treated as having
the `channel`/`topic`/`dm` operators corresponding to the
conversation containing that message, replacing any such operators
in the original request.
* `near:12345`: Search messages around the message with ID `12345`. * `near:12345`: Search messages around the message with ID `12345`.
* `id:12345`: Search for only message with ID `12345`. * `id:12345`: Search for only the message with ID `12345`.
The message ID operand for the `with` and `id` operators may be encoded The message ID operand for the `with` and `id` operators may be encoded
as either a number or a string. The message ID operand for the `near` as either a number or a string. The message ID operand for the `near`