- HTTP request
- Path parameters
- Request body
- Response body
- Authorization scopes
- ImportOption
- FlowImportStrategy
- Try it!
Imports the specified flow to the specified agent from a binary file.
This method is a long-running operation
. The returned Operation
type has the following method-specific fields:
-
metadata: An empty Struct message -
response:ImportFlowResponse
Note: You should always train a flow prior to sending it queries. See the training documentation .
HTTP request
POST https://{endpoint}/v3/{parent=projects/*/locations/*/agents/*}/flows:import
Where {endpoint}
is one of the supported service endpoints
.
The URLs use gRPC Transcoding syntax.
Path parameters
parent
string
Required. The agent to import the flow into. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>
.
Authorization requires the following IAM
permission on the specified resource parent
:
-
dialogflow.flows.create
Request body
The request body contains data with the following structure:
| JSON representation |
|---|
{ "importOption" : enum ( |
importOption
enum (
ImportOption
)
Flow import mode. If not specified, KEEP
is assumed.
flowImportStrategy
object (
FlowImportStrategy
)
Optional. Specifies the import strategy used when resolving resource conflicts.
flow
. Required. The flow to import. flow
can be only one of the following:flowUri
string
The Google Cloud Storage
URI to import flow from. The format of this URI must be gs://<bucket-name>/<object-name>
.
Dialogflow performs a read operation for the Cloud Storage object on the caller's behalf, so your request authentication must have read permissions for the object. For more information, see Dialogflow access control .
flowContent
Response body
If successful, the response body contains an instance of Operation
.
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 .
ImportOption
Import option.
| Enums | |
|---|---|
IMPORT_OPTION_UNSPECIFIED
|
Unspecified. Treated as KEEP
. |
KEEP
|
Always respect settings in exported flow content. It may cause a import failure if some settings (e.g. custom NLU) are not supported in the agent to import into. |
FALLBACK
|
Fallback to default settings if some settings are not supported in the agent to import into. E.g. Standard NLU will be used if custom NLU is not available. |
FlowImportStrategy
The flow import strategy used for resource conflict resolution associated with an ImportFlowRequest
.
| JSON representation |
|---|
{
"globalImportStrategy"
:
enum (
|
| Fields | |
|---|---|
globalImportStrategy
|
Optional. Import strategy for resource conflict resolution, applied globally throughout the flow. It will be applied for all display name conflicts in the imported content. If not specified, 'CREATE_NEW' is assumed. |

