---
title: "Updates the ransomware exposure values for an assessment's FAIR calculation."
method: PATCH
path: "/api/v2/companies/{id}/assessments/{assessmentId}/ransomware-exposure"
tags: ["Assessment"]
---

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

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

## Request

- Base URL: `https://app.blackkitetech.com`
- URL: `https://app.blackkitetech.com/api/v2/companies/{id}/assessments/{assessmentId}/ransomware-exposure`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://app.blackkitetech.com//api/v2/oauth/token`
- TypeScript: <https://skmtc.dev/blackkitetech/apis/black-kite-api/docs/api/v2/companies/:id/assessments/:assessmentId/ransomware-exposure/patch.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Path parameters

- `id` integer, required
- `assessmentId` integer, required

## Request body

- object
  - `NoOf_PII_PHI_PCI_Records` integer: Number of PII/PHI/PCI records.
  - `UnitCostOf_PII_PHI_PCI_Records` number, double: Unit cost per PII/PHI/PCI record.
  - `AvgDownTimeDays` number, double: Average downtime in days. Maximum allowed value is 9999.
  - `RevenueAtRisk` number, double: Revenue at risk.
  - `HaveInternalAccess` boolean: Whether the company has internal network access.
  - `UnitCostOf_BlackKiteCalculation` boolean: Whether to use the Black Kite calculation for PII/PHI/PCI unit cost.

## Response `200`

Assessment ransomware exposure updated successfully.

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `default`: Failure

---

[API](https://skmtc.dev/blackkitetech/apis/black-kite-api.md) - [All operations](https://skmtc.dev/blackkitetech/apis/black-kite-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blackkitetech/apis/black-kite-api/revisions/0950b35c0e4a?raw)