Invite a guest to sign up
const url = 'https://app.mondochat.io/v1/conversations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/invite';const options = {method: 'POST', 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 POST \ --url https://app.mondochat.io/v1/conversations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/invite \ --header 'Authorization: Bearer <token>'Posts a signup_invite card from the caller to a guest peer. It needs workspace.queue and passes the same send gates as a message. Needs a session token.
Errors: 403 policy_denied with reason queue when workspace.queue is off; 403 policy_denied with reason invite when the peer is not a guest or guests.nudge.signup_url is not set; 403 limit_reached with reason invite for a second invite in the conversation within 24 hours.
Guide: Conversations.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Responses
Section titled “Responses”Successful Response
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.
Example
{ "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"}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"}