Sign in

v1

latestOpenAPI 3.0.0Proprietary - Commercial Use Only2026-08-06172139621.6 KB
Financial Risk

Updates a monitored company's risk exposure.

Updates the given company's risk exposure data. To calculate the cost of data breach, Black Kite needs to identify the number of records that you shared with the target organization and the unit cost per record. The default numbers are calculated based on the industry and the country of an organization by using IBM Security and Ponemon Institute 'Cost of a Data Breach Study'.

patch/api/v2/companies/{id}/riskexposure

Path parameters

idinteger required
Example:123

The id of the company whose risk exposure is to be updated.

Request body

NoOf_PII_PHI_PCI_Recordsnumber nullable

Count of records with either PII, PHI or PCI information shared with the organization.Count of records with either PII, PHI or PCI information shared with the organization..

UnitCostOf_PII_PHI_PCI_Recordsnumber float nullable

$ amount of the cost per record of PII-PHI-PCI records.

UnitCostOf_BlackKiteCalculationboolean

Use Black Kite's amount of the cost per record of PII-PHI-PCI.

NoOfNon_PII_PHI_PCI_Recordsnumber nullable

Count of records with no PII, PHI or PCI information shared with the organization.

UnitCostOfNon_PII_PHI_PCI_Recordsnumber float nullable

$ amount of the cost per record of non-PII-PHI-PCI records.

HaveInternalAccessboolean

Indicates whether the organization has access to our internal network.

TimeToIdentifyAndContainInHoursnumber nullable

This value is only effective when SimulationId is 3, that is Availability (RC).

SimulationType'Availability' | 'Confidentiality'

A simulation type, such as; Availability or Confidentiality. Leave null, if no change is intended.

Example request

{
  "NoOf_PII_PHI_PCI_Records": 300,
  "SimulationType": "Confidentiality"
}

Response

Success