Required. The name of the entity type to delete entries for. Format: projects/<Project ID>/agent/entityTypes/<Entity Type ID>.
Authorization requires the following IAM permission on the specified resource parent:
dialogflow.entityTypes.batchDeleteEntities
Request body
The request body contains data with the following structure:
JSON representation
{"entityValues": [string],"languageCode": string}
Fields
entityValues[]
string
Required. The reference values of the entities to delete. Note that these are not fully-qualified names, i.e. they don't start with projects/<Project ID>.
languageCode
string
Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see Multilingual intent and entity data.
Response body
If successful, the response body contains an instance of Operation.
[[["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 operation deletes entities within a specified entity type and is a long-running operation that returns an \u003ccode\u003eOperation\u003c/code\u003e type.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request uses the \u003ccode\u003ePOST\u003c/code\u003e method to a specific endpoint with a defined URL structure for deleting entities, and the \u003ccode\u003eparent\u003c/code\u003e parameter is required, formatted as \u003ccode\u003eprojects/<Project ID>/agent/entityTypes/<Entity Type ID>\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires \u003ccode\u003eentityValues\u003c/code\u003e, which are the reference values of the entities to be deleted, and optionally accepts a \u003ccode\u003elanguageCode\u003c/code\u003e to specify the language for accessing language-specific data.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful completion, the response body contains an \u003ccode\u003eOperation\u003c/code\u003e instance, and this action requires specific IAM permissions (\u003ccode\u003edialogflow.entityTypes.batchDeleteEntities\u003c/code\u003e) and OAuth scopes.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.agent.entityTypes.entities.batchDelete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDeletes entities in the specified entity type.\n\nThis method is a [long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations). The returned `Operation` type has the following method-specific fields:\n\n- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)\n- `response`: An [Empty message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)\n\nNote: You should always train an agent prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/es/docs/training).\n\n### HTTP request\n\n`POST https://{endpoint}/v2/{parent=projects/*/locations/*/agent/entityTypes/*}/entities:batchDelete`\n\nWhere `{endpoint}` is one of the [supported service endpoints](/dialogflow/es/docs/reference/rest#rest_endpoints).\n\nThe URLs use [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/dialogflow/es/docs/reference/rest/v2/projects.locations.operations#Operation).\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)."]]
