- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
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 continues 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 an agent version in the default environment. WARNING: this will negate all recent changes to the draft agent and can't be undone. You may want to save the draft agent to a version before calling this method.
HTTP request
PATCH https://{endpoint}/v2/{environment.name=projects/*/locations/*/agent/environments/*}
Where {endpoint}
is one of the supported service endpoints.
The URLs use gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
environment.name |
Output only. The unique identifier of this agent environment. Supported formats:
The environment ID for the default environment is |
Query parameters
Parameters | |
---|---|
updateMask |
Required. The mask to control which fields get updated. This is a comma-separated list of fully qualified names of fields. Example: |
allowLoadToDraftAndDiscardChanges |
Optional. This field is used to prevent accidental overwrite of the default 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 default 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.