Method: projects.locations.agents.tools.versions.delete

Deletes the specified version of the Tool.

HTTP request

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

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

The URLs use gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The name of the tool version to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/tools/<ToolID>/versions/<VersionID>.

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

  • dialogflow.tools.update

Query parameters

Parameters
force

boolean

Optional. This field has no effect for Tools not being used. For Tools that are used:

  • If force is set to false, an error will be returned with message indicating the referenced resources.
  • If force is set to true, Dialogflow will remove the tool, as well as any references to the tool.

Request body

The request body must be empty.

Response body

If successful, the response body is an empty JSON object.

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.