Get messages in a conversation

GET

/api/conversations/{id}/messages

• Production

Returns all messages in a conversation thread, ordered chronologically. Includes messages from all participants (customer, AI agent, human agent, system). For email conversations, the content contains the parsed email body.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

The unique identifier of the conversation.

Responses

200

Chronologically ordered list of all messages in the conversation.

Chronologically ordered list of messages in a conversation.

Array<object>

A single message within a conversation thread. Messages can originate from customers, AI agents, or human agents.

object

id

required

Unique identifier for the message.

string format: uuid

Example

m1a2b3c4-5678-9abc-def0-1234567890ab

role

required

Who sent the message. ‘customer’ is the external party, ‘agent’ is the AI or human agent, ‘system’ is an automated system notification (e.g., status change).

string

Allowed values: customer agent system

Example

customer

content

required

The full text content of the message. For email messages this includes the email body. HTML is stripped for display.

string

Example

Hi, could you let me know when order #4521 will be delivered?

senderName

Display name of the message sender. For customer messages, this is the contact name. For agent messages, this is the AI sender name or human agent name.

string | null

Example

Jan Mueller

createdAt

required

Timestamp when the message was received or sent.

string format: date-time

Example

2026-03-24T08:15:00.000Z

404

No conversation exists with the given ID in the authenticated tenant.

Standard error response returned by all endpoints on failure.

object

error

required

A human-readable error message describing what went wrong.

string

Example

Conversation not found