/conversations/{id}/messagesList conversation messages
Returns accessible message history ordered by createdAt descending, then id descending. Pass sessionId to retrieve only messages belonging to that session, including closed sessions. The session must belong to this conversation and be accessible to the caller; otherwise returns 404. With sessionId, the summary describes the selected session and its latest non-deleted message; conversation-wide messagingWindow, automationOutcome, and actionContext are omitted, and waitingSince is null. For an empty session, lastMessageAt is the session creation time and the preview is empty. Follow nextPageToken with the same conversation and sessionId. Page size may change between pages. Pages are separate snapshots; pagination does not freeze later messages or updates.
Authorization
Scheme
- bearerAuth
Required scopes
- conversation:read
Allowed roles
- owner
- admin
- agent
List messages for a conversation in scope.
Parameters
- Name
id- Type
- path string
- Description
- Required parameter.
- Name
sessionId- Type
- query string
- Description
- Filter by the session ID from a message or webhook. Omit for all accessible sessions.
- Name
pageSize- Type
- query integer
- Description
- Values above 100 are reduced to 100; 0 or omitted uses the default (50).
- Name
pageToken- Type
- query string
- Description
- Optional parameter.
Responses
- 200
List of messages
- application/json ListMessagesResponse
- default
Error
- application/json ProblemDetails