Lists messages that belong to a given conversation. messages are ordered by createTime in descending order. To fetch updates without duplication, send request with filter create_time_epoch_microseconds >
[first item's createTime of previous request] and empty pageToken.
HTTP request
GET https://{endpoint}/v2/{parent=projects/*/locations/*/conversations/*}/messages
Required. The name of the conversation to list messages for. Format: projects/<Project ID>/locations/<Location
ID>/conversations/<Conversation ID>
Authorization requires the following IAM permission on the specified resource parent:
dialogflow.messages.list
Query parameters
Parameters
filter
string
Optional. Filter on message fields. Currently predicates on createTime and create_time_epoch_microseconds are supported. createTime only support milliseconds accuracy. E.g., create_time_epoch_microseconds > 1551790877964485 or createTime > 2017-01-15T01:30:15.01Z.
For more information about filtering, see API Filtering.
pageSize
integer
Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.
pageToken
string
Optional. The nextPageToken value returned from a previous list request.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[[["This endpoint retrieves a list of messages associated with a specified conversation, ordered chronologically from newest to oldest, based on their `createTime`."],["The HTTP request method is `GET`, and the URL structure requires defining the conversation's location and ID within the path, using `projects/*/locations/*/conversations/*` in the format."],["The `parent` path parameter is required, identifying the conversation and needing `dialogflow.messages.list` IAM permissions."],["Optional query parameters, such as `filter`, `pageSize`, and `pageToken`, can refine the query, allowing for time-based filtering and pagination."],["The request body for this endpoint must be empty, and the successful response is in the format of `ListMessagesResponse`."]]],[]]
