Catch up a conversation
const url = 'https://app.mondochat.io/v1/conversations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/changes?since=1&limit=100';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://app.mondochat.io/v1/conversations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/changes?since=1&limit=100' \ --header 'Authorization: Bearer <token>'Returns every message of the conversation whose seq is above since, by seq, as the caller sees them: deleted messages as tombstones, redacted ones without content, and hidden lists the ones the caller deleted for themselves. participants carries both read and delivered pointers. Answers 410 gone with reason stale_cursor when since is below the conversation’s floor or above latest_seq; reload the conversation and sync from the new latest_seq. Takes a session token. See https://docs.mondochat.io/guides/messages/.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Query Parameters
Section titled “Query Parameters”Responses
Section titled “Responses”Successful Response
The messages that changed after a seq, and both participants’ positions.
object
True when another call returns more rows.
Messages the viewer deleted for themselves after since.
Every message whose row changed after since, by seq, as the viewer sees it.
A message in a conversation, as the viewer sees it.
object
True for an away reply the server sent for its sender.
The conversation it belongs to.
When it was sent.
True when the sender deleted it for everyone. It has no text, caption, photo, card or quote.
True for the viewer’s own message once the peer received or read it, never for a silently dropped one.
True when the sender marked it forwarded, or it came from the forward route.
The message’s id.
text, photo, video, voice, system or card.
True for view-once media: it carries no links and no caption for anyone, and its recipient opens it through the open route.
A photo, video, voice note or avatar and the links to read it.
object
The media’s id.
What the media is.
pending until the upload is completed, held while it waits for the receiver’s consent or for moderation, rejected or deleted once it is gone.
The id of the user who uploaded it.
One entry per emoji in the order they were set; none on a deleted or redacted message.
One emoji on a message and how many users set it.
object
How many users reacted with it.
The emoji.
True when the viewer’s own reaction is this emoji.
True for the viewer’s own message once the peer read it; false while either participant has read_receipts off.
True when a moderator removed the content.
The message a message quotes.
The message’s place in its conversation’s sync order. Keep the copy with the higher seq.
held and rejected come from moderation or photo consent, and undelivered is a message dropped silently because the peer blocked the sender.
The conversation’s latest seq, read before the rows.
The since for the next call.
Both participants’ pointers now.
A participant’s read and delivered positions.
Example
{ "has_more": false, "hidden": [], "items": [ { "client_msg_id": "c1f0a5e2-7d2b-4d57-9a53-0a6f5b6f1d10", "conversation_id": "0199d6a0-2000-7000-8000-000000000001", "created_at": "2026-11-01T09:30:00Z", "delivered_to_peer": true, "id": "0199d6a0-3000-7000-8000-000000000001", "kind": "text", "reactions": [ { "count": 1, "emoji": "👍", "mine": false } ], "read_by_peer": false, "redacted": false, "sender_id": "0199d6a0-1000-7000-8000-000000000001", "seq": 12, "status": "sent", "text": "Hi Bob" } ], "latest_seq": 12, "next": 12, "participants": [ { "last_delivered_message_id": "0199d6a0-3000-7000-8000-000000000001", "last_read_message_id": "0199d6a0-3000-7000-8000-000000000001", "user_id": "0199d6a0-1000-7000-8000-000000000002" } ]}Problem
An RFC 9457 problem: the body of every error answer.
object
The stable error code to branch on, such as policy_denied.
What went wrong this time, when there is more to say.
For validation, one entry per invalid field.
One invalid field.
object
The path to the field.
What is wrong with it.
The path of the request.
For policy_denied and limit_reached, the rule or limit that refused the request; for forbidden, a short cause such as you_blocked; for banned, temporary when the ban expires.
The HTTP status code.
A short summary of the problem.
A URL that names the problem, https://app.mondochat.io/problems/<code>.
Example
{ "code": "policy_denied", "detail": null, "instance": "/v1/conversations/0199d6a0-2000-7000-8000-000000000001", "reason": "pins", "status": 403, "title": "Policy denied", "type": "https://app.mondochat.io/problems/policy_denied"}