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.
A list of versions. There will be a maximum number of items returned based on the pageSize field in the request. The list may in some cases be empty or contain fewer entries than pageSize even if this isn't the last page.
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 list all versions within a specified Flow using the Dialogflow CX API.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request is a GET request to a URL that includes placeholders for project, location, agent, and flow IDs, and requires a parent parameter to specify the target Flow.\u003c/p\u003e\n"],["\u003cp\u003eYou can use \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e query parameters to manage the number of results returned in a single request.\u003c/p\u003e\n"],["\u003cp\u003eThe response body includes a list of \u003ccode\u003eversions\u003c/code\u003e, each representing a specific version of the Flow, as well as a \u003ccode\u003enextPageToken\u003c/code\u003e to retrieve additional pages of results.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this operation requires specific IAM permissions on the parent resource, and you have to use one of the listed authorization scopes.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.agents.flows.versions.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.ListVersionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns the list of all versions in the specified [Flow](/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows#Flow).\n\n### HTTP request\n\n`GET https://{endpoint}/v3beta1/{parent=projects/*/locations/*/agents/*/flows/*}/versions`\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 [Versions.ListVersions](/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions/list#google.cloud.dialogflow.cx.v3beta1.Versions.ListVersions).\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)."]]