Method: projects.updateDetectorSettings

Set the organization or project's detector settings. Detector settings are present at the organization and the project level. Detector settings for a project override the detector settings for the project's organization.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Resource name of the organization-level or project-level detector settings. Its format is "organizations/[organization_id]/detectorSettings" or "projects/[project_number]/detectorSettings".

Request body

The request body contains data with the following structure:

JSON representation
  "updateMask": string,
  "settings": {
    object (DetectorSettings)

string (FieldMask format)

FieldMask for updating a subset of fields in DetectorSettings.

A comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".


object (DetectorSettings)

Response body

If successful, the response body contains an instance of DetectorSettings.

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

IAM Permissions

Requires the following Cloud IAM permission on the name resource:

  • threatdetection.detectorSettings.update

For more information, see the Cloud IAM Documentation.