Method: projects.knowledgeBases.delete

Deletes the specified knowledge base.

Note: The projects.agent.knowledgeBases resource is deprecated; only use projects.knowledgeBases.

HTTP request

DELETE https://{endpoint}/v2beta1/{name=projects/*/knowledgeBases/*}

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

The URLs use gRPC Transcoding syntax.

Path parameters



Required. The name of the knowledge base to delete. Format: projects/<Project ID>/locations/<Location ID>/knowledgeBases/<Knowledge Base ID>.

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

  • dialogflow.knowledgeBases.delete

Query parameters



Optional. Force deletes the knowledge base. When set to true, any documents in the knowledge base are also deleted.

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.