Try Gemini 1.5 Pro, our most advanced multimodal model in Vertex AI, and see what you can build with a 1M token context window. Try Gemini 1.5 Pro, our most advanced multimodal model in Vertex AI, and see what you can build with a 1M token context window.

Method: projects.locations.agents.flows.delete

HTTP request
Path parameters
Query parameters
Request body
Response body
Authorization scopes
Try it!

Deletes a specified flow.

HTTP request

DELETE https://{endpoint}/v3beta1/{name=projects/*/locations/*/agents/*/flows/*}

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters

Parameters

Parameters
`name`	`string` Required. The name of the flow to delete. Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>`. Authorization requires the following IAM permission on the specified resource `name`: `dialogflow.flows.delete`

name

string

Required. The name of the flow to delete. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>.

Authorization requires the following IAM permission on the specified resource name:

dialogflow.flows.delete

Query parameters

Parameters

Parameters
`force`	`boolean` This field has no effect for flows with no incoming transitions. For flows with incoming transitions: If `force` is set to false, an error will be returned with message indicating the incoming transitions. If `force` is set to true, Dialogflow will remove the flow, as well as any transitions to the flow (i.e. [Target flow][EventHandler.target_flow] in event handlers or [Target flow][TransitionRoute.target_flow] in transition routes that point to this flow will be cleared).

force

boolean

This field has no effect for flows with no incoming transitions. For flows with incoming transitions:

If force is set to false, an error will be returned with message indicating the incoming transitions.
If force is set to true, Dialogflow will remove the flow, as well as any transitions to the flow (i.e. [Target flow][EventHandler.target_flow] in event handlers or [Target flow][TransitionRoute.target_flow] in transition routes that point to this flow will be cleared).

Request body

The request body must be empty.

Response body

If successful, the response body is empty.

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.