> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Risk

Updates an existing risk with new values. User must have the `risk.update` scope.

<Note>
  External Documentation

  To learn more, visit the [Hyperproof documentation](https://developer.hyperproof.app/api-details#api=risks-api\&operation=patch-risk).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                          |
  | ---------------- | ------------------------------------------------------------------------------------ |
  | Risk ID          | The unique identifier of the risk. Can be obtained by using the `List Risks` action. |
  | Risk Identifier  | The identifier of the risk.                                                          |
  | Risk Name        | The name of the risk.                                                                |
  | Risk description | The description of the risk.                                                         |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter              | Description                                      |
  | ---------------------- | ------------------------------------------------ |
  | Category               | The category of the risk.                        |
  | Clear Category         | Whether to clear the category.                   |
  | Clear Impact Level     | Whether to clear the impact level.               |
  | Clear Likelihood Level | Whether to clear the likelihood level.           |
  | Clear Tolerance Level  | Whether to clear the tolerance level.            |
  | Impact Level           | The impact level of the risk.                    |
  | Impact Rational        | The rational behind the impact of the risk.      |
  | Likelihood Level       | The likelihood level of the risk.                |
  | Likelihood Rationale   | The rationale behind the likelihood of the risk. |
  | Response               | The response to the risk.                        |
  | Status                 | The status of the risk.                          |
  | Tolerance Level        | The tolerance level of the risk.                 |
</div>

## Example Output

```json theme={"dark"}
{
	"id": "d88d505d-5199-11ee-a644-522476618ae8",
	"orgId": "ce83e3cd-5199-11ee-a644-522476618ae8",
	"riskIdentifier": "FGSC-RA1",
	"riskRegisterId": "9f25da4f-1532-11ee-a87d-8e36b9d27de7",
	"name": "Free Gas Safety Checks not provided in a complete and timely manner",
	"description": "Requests from eligible customers for a Free Gas Safety Check are not actioned in an appropriate timescale leading to poor customer service, the potential for safety issues and non compliance with our SLCs.",
	"category": "Controls Program - Customer Operations",
	"response": "accept",
	"responseRationale": "accepted",
	"likelihoodLevel": 1,
	"likelihoodRationale": "security",
	"impactLevel": 1,
	"impactRationale": "cyber",
	"notes": "Reviewed by our internal team",
	"ownerId": "ce83e3cd-5199-11ee-a644-522476618aek",
	"toleranceLevel": 1,
	"overrideActualRisk": false,
	"overrideActualRiskReason": "low",
	"overrideActualRiskBy": "ac57e976-69ab-11ed-b991-1284f382c88o",
	"overrideActualRiskOn": "2023-08-10 20:27:32.890116+00",
	"actualRisk": 4,
	"overrideResidualLikelihood": false,
	"residualLikelihoodLevel": 3,
	"overrideResidualLikelihoodBy": "ac57e976-69ab-12ab-b991-1284f382c88a",
	"overrideResidualLikelihoodOn": "2023-08-10 20:27:32.890116+00",
	"overrideResidualImpact": true,
	"residualImpactLevel": 2,
	"overrideResidualImpactBy": "ac57e976-69ab-11ed-b991-1284f382c88d",
	"overrideResidualImpactOn": "2023-08-10 20:27:32.890116+00",
	"customFields": [
		{
			"fieldId": "ceb912ab-519b-11ee-a644-522476618ae8",
			"fieldName": "Sponsor",
			"fieldType": "text",
			"textValue": "John Smith"
		}
	],
	"status": "active",
	"createdBy": "82d7c228-8bcd-11e9-a94b-ab3de8494987",
	"createdOn": "2023-09-12T18:26:10.005365Z",
	"updatedBy": "82d7c228-8bcd-11e9-a94b-ab3de8494987",
	"updatedOn": "2023-09-12T18:26:10.005365Z",
	"permissions": []
}
```

## Workflow Library Example

[Update Risk with Hyperproof and Send Results Via Email](https://library.blinkops.com/workflows/update-risk-with-hyperproof-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/update-risk-with-hyperproof-and-send-results-via-email/canvas" />
</div>