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 webpage details how to retrieve a list of changelogs using a \u003ccode\u003eGET\u003c/code\u003e request to a specific URL endpoint, structured with gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a \u003ccode\u003eparent\u003c/code\u003e path parameter indicating the agent containing the changelogs, and supports filtering of changelogs by user email, resource, action, type, and create time via the \u003ccode\u003efilter\u003c/code\u003e query parameter.\u003c/p\u003e\n"],["\u003cp\u003eYou can control the number of items returned per page using the \u003ccode\u003epageSize\u003c/code\u003e query parameter, and retrieve subsequent pages of results using the \u003ccode\u003epageToken\u003c/code\u003e query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and the successful response will include a list of changelogs, ordered by timestamp, along with a \u003ccode\u003enextPageToken\u003c/code\u003e for paginated results.\u003c/p\u003e\n"],["\u003cp\u003eAccessing this data requires authorization with 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 scopes.\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}/v3/{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/v3/projects.locations.agents.changelogs/list#google.cloud.dialogflow.cx.v3.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)."]]
