Update Finding Settings

Enable or disable detection for one or more finding types in a single write. Enabling a type whose detector is a scheduled job also queues an immediate run.

POST /api/v1/findings/settings/update

Update Finding Settings

cURL

curl --request POST \
  --url https://{tenantDomain}.conductor.one/api/v1/findings/settings/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "settings": [
    {
      "enabled": true
    }
  ]
}
'

200

{
  "list": [
    {
      "enabled": true
    }
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Authorization · string · header · required

This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the c1TokenSource.Token() function.

Body

application/json

The UpdateFindingSettingsRequest message.

settings · Finding Settings Entry · object[] | null

Applied as one atomic write, so an admin changing several types either lands all of them or none.

Show child attributes

Response

200 - application/json

Successful response

The UpdateFindingSettingsResponse message.

list · Finding Type Setting · object[] | null

The full catalog after the write, in the same shape ListFindingSettings returns.

Show child attributes