REST Resource: projects.locations.apps.versions

Resource: AppVersion

In Customer Engagement Suite (CES), an app version is a snapshot of the app at a specific point in time. It is immutable and cannot be modified once created.

JSON representation
{
  "name": string,
  "displayName": string,
  "description": string,
  "creator": string,
  "createTime": string,
  "snapshot": {
    object (AppSnapshot)
  },
  "etag": string
}
Fields
name

string

Identifier. The unique identifier of the app version. Format: projects/{project}/locations/{location}/apps/{app}/versions/{version}

displayName

string

Optional. The display name of the app version.

description

string

Optional. The description of the app version.

creator

string

Output only. Email of the user who created the app version.

createTime

string (Timestamp format)

Output only. Timestamp when the app version was created.

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".

snapshot

object (AppSnapshot)

Output only. The snapshot of the app when the version is created.

etag

string

Output only. Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes.

AppSnapshot

A snapshot of the app.

JSON representation
{
  "app": {
    object (App)
  },
  "agents": [
    {
      object (Agent)
    }
  ],
  "tools": [
    {
      object (Tool)
    }
  ],
  "examples": [
    {
      object (Example)
    }
  ],
  "guardrails": [
    {
      object (Guardrail)
    }
  ],
  "toolsets": [
    {
      object (Toolset)
    }
  ]
}
Fields
app

object (App)

Optional. The basic settings for the app.

agents[]

object (Agent)

Optional. List of agents in the app.

tools[]

object (Tool)

Optional. List of tools in the app.

examples[]

object (Example)

Optional. List of examples in the app.

guardrails[]

object (Guardrail)

Optional. List of guardrails in the app.

toolsets[]

object (Toolset)

Optional. List of toolsets in the app.

Methods

create

Creates a new app version in the given app.

delete

Deletes the specified app version.

get

Gets details of the specified app version.

list

Lists all app versions in the given app.

restore

Restores the specified app version.