Method: projects.agent.environments.patch

Updates the specified agent environment.

This method allows you to deploy new agent versions into the environment. When an environment is pointed to a new agent version by setting environment.agent_version, the environment is temporarily set to the LOADING state. During that time, the environment keeps on serving the previous version of the agent. After the new agent version is done loading, the environment is set back to the RUNNING state. You can use "-" as Environment ID in environment name to update version in "draft" environment. WARNING: this will negate all recent changes to draft and can't be undone. You may want to save the draft to a version before calling this function.

HTTP request

PATCH https://dialogflow.googleapis.com/v2beta1/{environment.name=projects/*/agent/environments/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
environment.name

string

Output only. The unique identifier of this agent environment. Supported formats: - projects/<Project Number / ID>/agent/environments/<Environment ID> - projects/<Project Number / ID>/locations/<Location ID>/agent/environments/<Environment ID>

Query parameters

Parameters
updateMask

string (FieldMask format)

Required. The mask to control which fields get updated.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

allowLoadToDraftAndDiscardChanges

boolean

Optional. This field is used to prevent accidental overwrite of the draft environment, which is an operation that cannot be undone. To confirm that the caller desires this overwrite, this field must be explicitly set to true when updating the draft environment (environment ID = -).

Request body

The request body contains an instance of Environment.

Response body

If successful, the response body contains an instance of Environment.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/dialogflow

For more information, see the Authentication Overview.