# REST Resource: projects.locations.agents.flows.versions

- [Resource: Version](https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions#Version)
  - [JSON representation](https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions#Version.SCHEMA_REPRESENTATION)
- [State](https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions#State)
- [Methods](https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions#METHODS_SUMMARY)

## Resource: Version

Represents a version of a flow.

| JSON representation |
|---|
| ``` { "name": string, "displayName": string, "description": string, "nluSettings": { object (`https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/NluSettings`) }, "createTime": string, "state": enum (`https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions#State`) } ``` |

| Fields ||
|---|---|
| `name` | `string` Format: projects//locations//agents//flows//versions/. Version ID is a self-increasing number generated by Dialogflow upon version creation. |
| `displayName` | `string` Required. The human-readable name of the version. Limit of 64 characters. |
| `description` | `string` The description of the version. The maximum length is 500 characters. If exceeded, the request is rejected. |
| `nluSettings` | ``object (`https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/NluSettings`)`` Output only. The NLU settings of the flow at version creation. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Create time of the version. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `state` | ``enum (`https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions#State`)`` Output only. The state of this version. This field is read-only and cannot be set by create and update methods. |

## State

The state of the version.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | Not specified. This value is not used. |
| `RUNNING` | Version is not ready to serve (e.g. training is running). |
| `SUCCEEDED` | Training has succeeded and this version is ready to serve. |
| `FAILED` | Version training failed. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions/compareVersions` | Compares the specified base version with target version. |
| ### `https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions/create` | Creates a `https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions#Version` in the specified `https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows#Flow`. |
| ### `https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions/delete` | Deletes the specified `https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions#Version`. |
| ### `https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions/get` | Retrieves the specified `https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions#Version`. |
| ### `https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions/list` | Returns the list of all versions in the specified `https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows#Flow`. |
| ### `https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions/load` | Loads resources in the specified version to the draft flow. |
| ### `https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions/patch` | Updates the specified `https://docs.cloud.google.com/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.flows.versions#Version`. |