/v1/comms/conversations/{id}Read one conversation
One conversation by its id, exactly as the inbox lists it: the other side (contact_identifier, contact_name), our line it is on (account_identifier), the medium, the records it is filed under, whether it is unread and its last word. Reach for this to know who a thread is with and which line answers it; its messages are get_comms_conversations_id_messages. Another workspace's conversation, or a private one the caller is not on, is a 404.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Responses
the action's answer
{
"account_identifier": "string",
"contact_identifier": "string",
"contact_name": "string",
"contact_role": "string",
"created_at": "2026-01-01T00:00:00Z",
"id": 1,
"is_archived": true,
"is_muted": true,
"is_pinned": true,
"is_starred": true,
"labels": [
{
"id": "",
"name": "string",
"tone": "string"
}
],
"last_message_at": "2026-01-01T00:00:00Z",
"last_message_direction": "string",
"last_message_preview": "string",
"medium": "string",
"messages": [
{
"call": "string",
"content": "string",
"content_html": "string",
"conversation_id": "",
"delivered_at": "string",
"delivery": "string",
"direction": "string",
"external_id": "",
"id": "",
"is_deleted": "string",
"medium": "string",
"occurred_at": "string",
"parent_message_id": "",
"read_at": "string",
"recorded_at": "string",
"sender_id": "",
"sender_name": "string",
"sender_type": "string",
"status": "string",
"subject": "string",
"text": "string"
}
],
"ownerAccountId": "",
"records": [
{
"definition_id": "",
"definition_key": "string",
"linked_at": "string",
"name": "string",
"row_id": "",
"status": "string",
"status_label": "string",
"status_tone": "string"
}
],
"subject": "string",
"unread_count": 1,
"visibility": "string"
}an RFC3339 instant with its offset, such as ; a bare date, a time with no offset, or words like "tomorrow" are not instants
an RFC3339 instant with its offset, such as ; a bare date, a time with no offset, or words like "tomorrow" are not instants
a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}