You can update an existing conversation.
If you want to reply to a coveration or take an action such as assign, unassign, open, close or snooze, take a look at the reply and manage endpoints.
You can update an existing conversation.
If you want to reply to a coveration or take an action such as assign, unassign, open, close or snooze, take a look at the reply and manage endpoints.
display_as | string Set to plaintext to retrieve conversation messages in plain text. Example: display_as=plaintext |
{ "read": true, "custom_attributes": { "issue_type": "Billing", "priority": "High" } }
200
conversation found
401
Unauthorized
403
API plan restricted
404
Not found
{ "type": "conversation", "id": "1597", "created_at": 1715077868, "updated_at": 1715077869, "waiting_since": null, "snoozed_until": null, "source": { "type": "conversation", "id": "403918921", "delivered_as": "admin_initiated", "subject": "", "body": "<p>this is the message body</p>", "author": { "type": "admin", "id": "991271645", "name": "Ciaran157 Lee", "email": "admin157@email.com" }, "attachments": [ ], "url": null, "redacted": false }, "contacts": { "type": "contact.list", "contacts": [ { "type": "contact", "id": "663a02ec262d16a19645ee5b", "external_id": "70" } ] }, "first_contact_reply": null, "admin_assignee_id": null, "team_assignee_id": null, "open": false, "state": "closed", "read": true, "tags": { "type": "tag.list", "tags": [ ] }, "priority": "not_priority", "sla_applied": null, "statistics": null, "conversation_rating": null, "teammates": null, "title": null, "custom_attributes": { "issue_type": "Billing", "priority": "High" }, "topics": { }, "ticket": null, "linked_objects": { "type": "list", "data": [ ], "total_count": 0, "has_more": false }, "ai_agent": null, "ai_agent_participated": false, "conversation_parts": { "type": "conversation_part.list", "conversation_parts": [ { "type": "conversation_part", "id": "359", "part_type": "conversation_attribute_updated_by_admin", "body": null, "created_at": 1715077869, "updated_at": 1715077869, "notified_at": 1715077869, "assigned_to": null, "author": { "id": "991271646", "type": "bot", "name": "Operator", "email": "operator+this_is_an_id310_that_should_be_at_least_@intercom.io" }, "attachments": [ ], "external_id": null, "redacted": false }, { "type": "conversation_part", "id": "360", "part_type": "conversation_attribute_updated_by_admin", "body": null, "created_at": 1715077869, "updated_at": 1715077869, "notified_at": 1715077869, "assigned_to": null, "author": { "id": "991271646", "type": "bot", "name": "Operator", "email": "operator+this_is_an_id310_that_should_be_at_least_@intercom.io" }, "attachments": [ ], "external_id": null, "redacted": false } ], "total_count": 2 } }