Some products and features are in the process of being renamed. Generative playbook and flow features are also being migrated to a single consolidated console. See the details.
Required. The agent to list all conversations for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.
Authorization requires the following IAM permission on the specified resource parent:
dialogflow.conversations.list
Query parameters
Parameters
filter
string
Optional. The filter string. Supports filter by createTime, metrics.has_end_interaction, metrics.has_live_agent_handoff, intents.display_name, pages.display_name and flows.display_name. Timestamps expect an [RFC-3339][https://datatracker.ietf.org/doc/html/rfc3339] formatted string (e.g. 2012-04-21T11:30:00-04:00). UTC offsets are supported. Some examples: 1. By create time: createTime > "2022-04-21T11:30:00-04:00" 2. By intent display name: intents.display_name : "billing" 3. By end interaction signal: metrics.has_end_interaction = true
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.
Request body
The request body must be empty.
Response body
The response message for [Conversations.ListConversations][].
If successful, the response body contains data with the following structure:
The list of conversations. There will be a maximum number of items returned based on the pageSize field. The returned conversations will be sorted by startTime in descending order (newest conversation first).
nextPageToken
string
Token to retrieve the next page of results, or empty if there are no more results in the list.
[[["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 document describes how to list all conversations for a given agent using a \u003ccode\u003eGET\u003c/code\u003e HTTP request to a specified endpoint.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required to specify the agent, using the format: \u003ccode\u003eprojects/<ProjectID>/locations/<LocationID>/agents/<AgentID>\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters, including \u003ccode\u003efilter\u003c/code\u003e, \u003ccode\u003epageSize\u003c/code\u003e, and \u003ccode\u003epageToken\u003c/code\u003e, can be used to refine the list of conversations returned, like using the \u003ccode\u003efilter\u003c/code\u003e to sort by various categories.\u003c/p\u003e\n"],["\u003cp\u003eThe response body will include a list of \u003ccode\u003econversations\u003c/code\u003e and an optional \u003ccode\u003enextPageToken\u003c/code\u003e for retrieving additional pages of conversations.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires one of the specified OAuth scopes: \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/dialogflow\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.agents.conversations.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListConversationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns the list of all conversations.\n\n### HTTP request\n\n`GET https://{endpoint}/v3beta1/{parent=projects/*/locations/*/agents/*}/conversations`\n\nWhere `{endpoint}` is one of the [supported service endpoints](/dialogflow/cx/docs/reference/rest#rest_endpoints).\n\nThe URLs use [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response message for \\[Conversations.ListConversations\\]\\[\\].\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/dialogflow`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]