Method: projects.locations.agents.webhooks.delete

Deletes the specified webhook.

HTTP request

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

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

The URLs use gRPC Transcoding syntax.

Path parameters



Required. The name of the webhook to delete. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/webhooks/<Webhook ID>.

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

  • dialogflow.webhooks.delete

Query parameters



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 empty.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.