Get a message's edit history

Fetch the message edit history of a previously edited message.

GET https://chat.zymocosm.com/api/v1/messages/{message_id}/history

Note that edit history may be disabled in some organizations; see the Zulip Help Center documentation on editing messages.

Usage examples

#!/usr/bin/env python3

import zulip

# Pass the path to your zuliprc file here.
client = zulip.Client(config_file="~/zuliprc")

# Get the edit history for message with ID "message_id"
result = client.get_message_history(message_id)
print(result)

curl -sSX GET -G https://chat.zymocosm.com/api/v1/messages/42/history \
    -u BOT_EMAIL_ADDRESS:BOT_API_KEY

Arguments

Argument Example Required Description
message_id 42 Yes

The ID of the message you want to fetch the history of.

Response

Return values

  • message_history: a chronologically sorted array of snapshot objects, containing the modified state of the message before and after the edit:
    • topic: the topic for the message.
    • content: the body of the message.
    • rendered_content: the already rendered, HTML version of content.
    • prev_content: the body of the message before being edited.
    • prev_rendered_content: the already rendered, HTML version of prev_content.
    • user_id: the ID of the user that made the edit.
    • content_html_diff: an HTML diff between this version of the message and the previous one.
    • timestamp: the UNIX timestamp for this editi.

Please note that the original message's snapshot only contains the fields topic, content, rendered_content, timestamp and user_id. This snapshot will be the only one present if the message has never been edited.

Also note that if a message's content was edited (but not the topic) or the topic was edited (but not the content), the snapshot object will only contain data for the modified fields (e.g. if only the topic was edited, prev_content, prev_rendered_content, and content_html_diff will not appear).

Example response

A typical successful JSON response may look like:

{
    "message_history": [
        {
            "content": "Hello!",
            "rendered_content": "<p>Hello!</p>",
            "timestamp": 1530129122,
            "topic": "party at my houz",
            "user_id": 5
        },
        {
            "content": "Howdy!",
            "content_html_diff": "<div><p><span class=\"highlight_text_inserted\">Howdy!</span></p> <p><span class=\"highlight_text_deleted\">Hello!</span></p></div>",
            "prev_content": "Hello!",
            "prev_rendered_content": "<p>Hello!</p>",
            "prev_topic": "party at my houz",
            "rendered_content": "<p>Howdy!</p>",
            "timestamp": 1530129134,
            "topic": "party at my house",
            "user_id": 5
        }
    ],
    "msg": "",
    "result": "success"
}

An example JSON response for when the specified message does not exist:

{
    "code": "BAD_REQUEST",
    "msg": "Invalid message(s)",
    "result": "error"
}