Some products and features are in the process of being renamed. Generative playbook and flow features are also being migrated to a single consolidated console. See the details.
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[[["\u003cp\u003eThis endpoint allows the deletion of a specific version of a Tool within a Dialogflow agent.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ename\u003c/code\u003e path parameter, which is required, specifies the unique identifier of the tool version to be deleted using a defined format.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eforce\u003c/code\u003e query parameter can be used to forcefully remove a tool and any of its references, but if it is set to false and the Tool is in use, an error will be returned.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request is a \u003ccode\u003eDELETE\u003c/code\u003e operation to a specific URL defined by the endpoint and tool version \u003ccode\u003ename\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eA successful deletion results in an empty JSON object response body, and this operation requires specific authorization scopes for execution.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.agents.tools.versions.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDeletes the specified version of the [Tool](/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.tools#Tool).\n\n### HTTP request\n\n`DELETE https://{endpoint}/v3beta1/{name=projects/*/locations/*/agents/*/tools/*/versions/*}`\n\nWhere `{endpoint}` is one of the [supported service endpoints](/dialogflow/cx/docs/reference/rest#rest_endpoints).\n\nThe URLs use [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/dialogflow`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
