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.

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

Resource: Version

Represents a version of a flow.

JSON representation 
{
 "name": string,
 "displayName": string,
 "description": string,
 "nluSettings": {
 object (NluSettings )
 },
 "createTime": string,
 "state": enum (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 (NluSettings )

Output only. The NLU settings of the flow at version creation.
createTime

string (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月02日T15:01:23Z", "2014年10月02日T15:01:23.045123456Z" or "2014年10月02日T15:01:23+05:30".
state

enum (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

compareVersions

Compares the specified base version with target version.

create

Creates a Version in the specified Flow .

delete

Deletes the specified Version .

get

Retrieves the specified Version .

list

Returns the list of all versions in the specified Flow .

load

Loads resources in the specified version to the draft flow.

patch

Updates the specified Version .

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025年08月21日 UTC.