Delete a reminder

DELETE https://chat.zulip.org/api/v1/reminders/{reminder_id}

Delete, and therefore cancel sending, a previously scheduled reminder.

Changes: New in Zulip 11.0 (feature level 399).

Usage examples

curl -sSX DELETE https://chat.zulip.org/api/v1/reminders/1 \
    -u BOT_EMAIL_ADDRESS:BOT_API_KEY

Parameters

reminder_id integer required in path

Example: 1

The ID of the reminder to delete.

This is different from the unique ID that the message would have after being sent.


Response

Example response(s)

Changes: As of Zulip 7.0 (feature level 167), if any parameters sent in the request are not supported by this endpoint, a successful JSON response will include an ignored_parameters_unsupported array.

A typical successful JSON response may look like:

{
    "msg": "",
    "result": "success"
}

A typical failed JSON response for when no reminder exists with the provided ID:

{
    "code": "BAD_REQUEST",
    "msg": "Reminder does not exist",
    "result": "error"
}