Method: projects.agent.restore

Restores the specified agent from a ZIP file.

Replaces the current agent version with a new one. All the intents and entity types in the older version are deleted.

Operation <response: google.protobuf.Empty, metadata: google.protobuf.Struct>

HTTP request

POST https://dialogflow.googleapis.com/v2/{parent=projects/*}/agent:restore

The URL uses Google API HTTP annotation syntax.

Path parameters

Parameters
parent

string

Required. The project that the agent to restore is associated with. Format: projects/<Project ID>.

Authorization requires the following Google IAM permission on the specified resource parent:

  • dialogflow.agents.restore

Request body

The request body contains data with the following structure:

JSON representation
{

  // Union field agent can be only one of the following:
  "agentUri": string,
  "agentContent": string
  // End of list of possible types for union field agent.
}
Fields
Union field agent. Required. The agent to restore. agent can be only one of the following:
agentUri

string

The URI to a Google Cloud Storage file containing the agent to restore. Note: The URI must start with "gs://".

agentContent

string (bytes format)

The agent to restore.

Example for how to restore an agent via the command line:

curl \
  'https://dialogflow.googleapis.com/v2/projects/<project_name>/agent:restore\
   -X POST \
   -H 'Authorization: Bearer '$(gcloud auth application-default
   print-access-token) \
   -H 'Accept: application/json' \
   -H 'Content-Type: application/json' \
   --compressed \
   --data-binary "{
       'agentContent': '$(cat <agent zip file> | base64 -w 0)'
   }"

A base64-encoded string.

Response body

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

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.