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 containing the changelogs. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.
Query parameters
Parameters
filter
string
The filter string. Supports filter by userEmail, resource, type and createTime. Some examples: 1. By user email: userEmail = "someone@google.com" 2. By resource name: resource = "projects/123/locations/global/agents/456/flows/789" 3. By resource display name: displayName = "my agent" 4. By action: action = "Create" 5. By type: type = "flows" 6. By create time. Currently predicates on createTime and create_time_epoch_seconds are supported: create_time_epoch_seconds > 1551790877 AND createTime <= 2017-01-15T01:30:15.01Z 7. Combination of above filters: resource = "projects/123/locations/global/agents/456/flows/789" AND userEmail = "someone@google.com" AND createTime <= 2017-01-15T01:30:15.01Z
pageSize
integer
The maximum number of items to return in a single page. By default 100 and at most 1000.
pageToken
string
The nextPageToken value returned from a previous list request.
The list of changelogs. There will be a maximum number of items returned based on the pageSize field in the request. The changelogs will be ordered by timestamp.
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 page details how to retrieve a list of Changelogs via an HTTP GET request using the specified endpoint and path.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required to specify the agent containing the changelogs in the format: \u003ccode\u003eprojects/<ProjectID>/locations/<LocationID>/agents/<AgentID>\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou can filter the Changelogs using query parameters, including filtering by \u003ccode\u003euserEmail\u003c/code\u003e, \u003ccode\u003eresource\u003c/code\u003e, \u003ccode\u003etype\u003c/code\u003e, or \u003ccode\u003ecreateTime\u003c/code\u003e, with support for combining multiple filters.\u003c/p\u003e\n"],["\u003cp\u003eThe response body will include a list of changelogs and a \u003ccode\u003enextPageToken\u003c/code\u003e for retrieving subsequent pages of results if available.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires either the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/dialogflow\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.agents.changelogs.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.ListChangelogsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns the list of Changelogs.\n\n### HTTP request\n\n`GET https://{endpoint}/v3beta1/{parent=projects/*/locations/*/agents/*}/changelogs`\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 [Changelogs.ListChangelogs](/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.changelogs/list#google.cloud.dialogflow.cx.v3beta1.Changelogs.ListChangelogs).\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)."]]