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}/v2beta1/{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-03-05 UTC."],[[["This page details how to list messages within a given conversation using the Dialogflow API's `GET` method."],["The `parent` path parameter is required and specifies the conversation to list messages from, using the format `projects/\u003cProject ID\u003e/locations/\u003cLocation ID\u003e/conversations/\u003cConversation ID\u003e`."],["You can filter messages based on their `createTime` or `create_time_epoch_microseconds` using the optional `filter` query parameter, allowing for filtering based on a time constraint."],["The request body for listing messages must be empty, and the response will contain a `ListMessagesResponse` instance if successful."],["To use this API, one of two OAuth scopes are required: `https://www.googleapis.com/auth/cloud-platform` or `https://www.googleapis.com/auth/dialogflow`."]]],[]]
