GET
/conversations/{conversationId}/messagesList messages in a conversation
Returns a paginated list of messages in a conversation. Internal agent notes are excluded by default. Requires a team-role API key.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
conversationIdrequired | path | string | Conversation ID |
includeInternal | query | boolean | Include internal agent notes (default: false) |
cursor | query | string | Pagination cursor from previous response |
limit | query | integer | Items per page (max 100)(default: 30) |
Response
List of messages
Returns an array of objects:
| Field | Type | Description |
|---|---|---|
idrequired | string | TypeID - a type-prefixed UUID |
conversationIdrequired | string | TypeID - a type-prefixed UUID |
senderTyperequired | "visitor" | "agent" | "system" | Who sent the message |
isInternalrequired | boolean | Whether this is an internal agent note not visible to the visitor |
authorPrincipalIdrequired | string | null | Principal ID of the author, null for system messages |
authorNamerequired | string | null | Display name of the author, null for system messages |
contentrequired | string | |
createdAtrequired | string | ISO 8601 timestamp |
meta
| Field | Type | Description |
|---|---|---|
paginationrequired | object |
Errors
401Unauthorized404Conversation not foundExample request
curl \
"https://feedback.quackback.io/api/v1/conversations/:conversationId/messages" \
-H "Authorization: Bearer qb_your_api_key_here"