Get a message's edit history
Fetch the message edit history of a previously edited message.
GET https://chat.convergenceservices.in/api/v1/messages/<message_id>/history
Note that edit history may be disabled in some organizations; see the
uKnowva Messenger 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 -X GET https://chat.convergenceservices.in/api/v1/messages/<message_id>/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"
}