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."],[[["\u003cp\u003eThis endpoint retrieves a list of messages associated with a specified conversation, ordered chronologically from newest to oldest, based on their \u003ccode\u003ecreateTime\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request method is \u003ccode\u003eGET\u003c/code\u003e, and the URL structure requires defining the conversation's location and ID within the path, using \u003ccode\u003eprojects/*/locations/*/conversations/*\u003c/code\u003e in the format.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required, identifying the conversation and needing \u003ccode\u003edialogflow.messages.list\u003c/code\u003e IAM permissions.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters, such as \u003ccode\u003efilter\u003c/code\u003e, \u003ccode\u003epageSize\u003c/code\u003e, and \u003ccode\u003epageToken\u003c/code\u003e, can refine the query, allowing for time-based filtering and pagination.\u003c/p\u003e\n"],["\u003cp\u003eThe request body for this endpoint must be empty, and the successful response is in the format of \u003ccode\u003eListMessagesResponse\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,[]]
