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 webhook to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/webhooks/<WebhookID>.
Authorization requires the following IAM permission on the specified resource name:
dialogflow.webhooks.delete
Query parameters
Parameters
force
boolean
This field has no effect for webhook not being used. For webhooks that are used by pages/flows/transition route groups:
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 webhook, as well as any references to the webhook (i.e. Webhook and tagin fulfillments that point to this webhook will be removed).
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 for the deletion of a specified webhook using a DELETE HTTP request.\u003c/p\u003e\n"],["\u003cp\u003eThe request URL requires a \u003ccode\u003ename\u003c/code\u003e parameter to identify the specific webhook to be deleted, with a specific format of \u003ccode\u003eprojects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/webhooks/<WebhookID>\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAn optional \u003ccode\u003eforce\u003c/code\u003e query parameter can be used to manage how the deletion is handled if the webhook is in use, where setting it to true will remove the webhook and references, and setting it to false will return an error.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and a successful deletion results in an empty JSON object response.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this request requires one of the specified OAuth scopes, including \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/dialogflow\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.agents.webhooks.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 webhook.\n\n### HTTP request\n\n`DELETE https://{endpoint}/v3beta1/{name=projects/*/locations/*/agents/*/webhooks/*}`\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)."]]
