Full name: projects.locations.instances.batchValidateWatchlistEntities
Validates a batch of entities that could be added into watchlist under an instance.
HTTP request
Path parameters
Parameters
parent
string
Required. The parent resource shared by all existing entities. Format: projects/{project}/locations/{location}/instances/{instance} If this is set, the parent field in the ValidateWatchlistEntityRequest messages must either be empty or match this field.
Request body
The request body contains data with the following structure:
[[["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-08-25 UTC."],[[["\u003cp\u003eThis endpoint, \u003ccode\u003eprojects.locations.instances.batchValidateWatchlistEntities\u003c/code\u003e, allows for the validation of multiple entities that could be added to a watchlist under a specific instance via a POST HTTP request.\u003c/p\u003e\n"],["\u003cp\u003eThe request must include a JSON body with an array of \u003ccode\u003eValidateWatchlistEntityRequest\u003c/code\u003e objects, each containing the entity and the parent resource it belongs to.\u003c/p\u003e\n"],["\u003cp\u003eThe response body contains an array of \u003ccode\u003eValidateWatchlistEntityResponse\u003c/code\u003e objects, detailing the validation results for each requested entity.\u003c/p\u003e\n"],["\u003cp\u003eAccess to this functionality requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e and the IAM permission \u003ccode\u003echronicle.entities.batchValidate\u003c/code\u003e on the specified parent resource.\u003c/p\u003e\n"],["\u003cp\u003eThe possible response error types that can be encountered are \u003ccode\u003eERROR_TYPE_UNSPECIFIED\u003c/code\u003e, indicating a valid entity, or \u003ccode\u003eNOT_FOUND\u003c/code\u003e, indicating that the entity was not found.\u003c/p\u003e\n"]]],[],null,["# Method: instances.batchValidateWatchlistEntities\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 - [JSON representation](#body.BatchValidateWatchlistEntitiesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [ValidateWatchlistEntityRequest](#ValidateWatchlistEntityRequest)\n - [JSON representation](#ValidateWatchlistEntityRequest.SCHEMA_REPRESENTATION)\n- [ValidateWatchlistEntityResponse](#ValidateWatchlistEntityResponse)\n - [JSON representation](#ValidateWatchlistEntityResponse.SCHEMA_REPRESENTATION)\n- [ErrorType](#ErrorType)\n- [Try it!](#try-it)\n\n**Full name**: projects.locations.instances.batchValidateWatchlistEntities\n\nValidates a batch of entities that could be added into watchlist under an instance.\n\n### HTTP request\n\nChoose a location: \nafrica-south1 asia-northeast1 asia-south1 asia-southeast1 asia-southeast2 australia-southeast1 europe-west12 europe-west2 europe-west3 europe-west6 europe-west9 me-central1 me-central2 me-west1 northamerica-northeast2 southamerica-east1 us eu \n\n\u003cbr /\u003e\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nResponse message for validating entities that could be added into a watchlist in batch under an instance.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `chronicle.entities.batchValidate`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs).\n\nValidateWatchlistEntityRequest\n------------------------------\n\nRequest message for validating an entity that could be added into a watchlist under an instance.\n\nValidateWatchlistEntityResponse\n-------------------------------\n\nResponse message for validating an entity that could be added into a watchlist under an instance.\n\nErrorType\n---------\n\nError type encountered during validation."]]