v1

latestOpenAPI 3.0.0Proprietary - Commercial Use Only2026-08-06172139621.6 KB
Assessment

Updates the ransomware exposure values for an assessment's FAIR calculation.

Updates the ransomware exposure inputs used in the FAIR risk calculation for a specific assessment. At least one field is required. Fields not provided will retain their current values.

patch/api/v2/companies/{id}/assessments/{assessmentId}/ransomware-exposure

Path parameters

idinteger required
Example:123

The id of the company whose assessment ransomware exposure will be updated.

assessmentIdinteger required
Example:456

The id of the assessment.

Request body

NoOf_PII_PHI_PCI_Recordsinteger

Number of PII/PHI/PCI records.

UnitCostOf_PII_PHI_PCI_Recordsnumber double

Unit cost per PII/PHI/PCI record.

AvgDownTimeDaysnumber double

Average downtime in days. Maximum allowed value is 9999.

RevenueAtRisknumber double

Revenue at risk.

HaveInternalAccessboolean

Whether the company has internal network access.

UnitCostOf_BlackKiteCalculationboolean

Whether to use the Black Kite calculation for PII/PHI/PCI unit cost.

Example request

{
  "NoOf_PII_PHI_PCI_Records": 48922,
  "UnitCostOf_PII_PHI_PCI_Records": 116,
  "AvgDownTimeDays": 5,
  "RevenueAtRisk": 500000,
  "HaveInternalAccess": true,
  "UnitCostOf_BlackKiteCalculation": true
}

Response

Assessment ransomware exposure updated successfully.