zulip/api_docs
Lauryn Menard 31daef7f79 response: Remove "result: partially_completed" for success responses.
In feature levels 153 and 154, a new value of "partially_completed"
for `result` in a success (HTTP status code 200) was added for two
endpoints that process messages in batches: /api/delete-topic and
/api/mark-all-as-read.

Prior to these changes, `result` was either "success" or "error" for
all responses, which was a useful API invariant to have for clients.

So, here we remove "partially_completed" as a potential value for
"result" in a response. And instead, for the two endpoints noted
above, we return a boolean field "complete" to indicate if the
response successfully deleted/marked as read all the targeted
messages (complete: true) or if only some of the targeted messages
were processed (complete: false).

The "code" field for an error string that was also returned as part
of a partially completed response is removed in these changes as
well.

The web app does not currently use the /api/mark-all-as-read
endpoint, but it does use the /api/delete-topic endpoint, so these
changes update that to check the `complete` boolean instead of the
string value for `result`.
2023-09-18 13:18:24 -07:00
..
include api_docs: Split bulk mark read documentation to individual pages. 2023-08-21 17:25:14 -07:00
api-doc-template.md
api-keys.md settings: Improve wording of "Show API key" modal. 2023-03-08 18:48:37 -08:00
changelog.md response: Remove "result: partially_completed" for success responses. 2023-09-18 13:18:24 -07:00
client-libraries.md
configuring-python-bindings.md
construct-narrow.md narrow: Support string and integer encoding of "id" operator. 2023-07-20 13:14:20 -07:00
create-scheduled-message.md scheduled-messages: Add API documentation for new endpoint. 2023-05-26 18:05:55 -07:00
create-stream.md
deploying-bots.md api docs: Rename "private message" -> "direct message". 2023-06-23 14:36:16 -07:00
http-headers.md api_docs: Add page documenting HTTP headers in the api docs. 2023-03-07 12:51:17 -08:00
incoming-webhooks-overview.md web: Save a needless 301 redirect from /integrations to /integrations/. 2023-03-24 14:51:01 -07:00
incoming-webhooks-walkthrough.md api docs: Rename "private message" -> "direct message". 2023-06-23 14:36:16 -07:00
index.md web: Save a needless 301 redirect from /integrations to /integrations/. 2023-03-24 14:51:01 -07:00
installation-instructions.md
integrations-overview.md web: Save a needless 301 redirect from /integrations to /integrations/. 2023-03-24 14:51:01 -07:00
missing.md
non-webhook-integrations.md
outgoing-webhooks.md api docs: Rename "private message" -> "direct message". 2023-06-23 14:36:16 -07:00
real-time-events.md
rest-error-handling.md api_docs: Add page documenting HTTP headers in the api docs. 2023-03-07 12:51:17 -08:00
rest.md api_docs: Add page documenting HTTP headers in the api docs. 2023-03-07 12:51:17 -08:00
roles-and-permissions.md help: Update URLs to match "Restrict message editing and deletion" title. 2023-02-10 15:56:16 -08:00
running-bots.md
send-message.md message-type: Add support for "direct" as value for type parameter. 2023-04-18 12:29:33 -07:00
sidebar_index.md api_docs: Add page documenting HTTP headers in the api docs. 2023-03-07 12:51:17 -08:00
writing-bots.md api docs: Rename "private message" -> "direct message". 2023-06-23 14:36:16 -07:00