---
title: "Update organization risk configuration"
method: PATCH
path: "/v0/platform/organization/configuration/risk-exposure"
tags: ["Organization Risk Config"]
---

# Update organization risk configuration

`PATCH /v0/platform/organization/configuration/risk-exposure`

Update your organization's risk exposure settings. Pass a category name or verdict level with a new value to override the platform default, or pass null to revert to the default. Any key you omit stays unchanged.

## Request body

- PatchRiskConfigRequest — A partial update to your organization's risk exposure settings. Only the fields you include are changed.
  - `category_overrides` object — Risk score overrides by category name. Pass a value in [0, 1] to set an override, or null to revert to the platform default.
  - `verdict_overrides` object — Verdict threshold overrides by level. Pass a value in [0, 1] to set an override, or null to revert to the platform default. The resulting thresholds must be strictly increasing (warning < high_risk < malicious).
    - `warning` number, nullable — Scores at or above this value are classified as warning. Set to null to revert to the platform default.
    - `high_risk` number, nullable — Scores at or above this value are classified as high_risk. Set to null to revert to the platform default.
    - `malicious` number, nullable — Scores at or above this value are classified as malicious. Set to null to revert to the platform default.

## Response `200`

Success

- OrganizationRiskConfigView — Your organization's risk exposure settings, including category risk scores and verdict thresholds.
  - `categories` OrganizationCategoryRiskView[], required — The risk score configuration for each exposure category.
    - `category` string, required — The exposure category name, such as sanctioned_entity, stolen_funds, or mixer.
    - `default_risk_score` number, required — Scores at or above this value contribute to this category's risk. Platform default, set by Blockaid.
    - `override_risk_score` number, nullable, required — Your organization's custom risk score for this category. Overrides the platform default when set, or null to use the default.
  - `verdicts` VerdictThresholdView[], required — The score thresholds that determine each verdict level.
    - `level` 'warning' | 'high_risk' | 'malicious', required — The verdict level this threshold applies to. benign is excluded as it is the implicit default below warning.
    - `default_threshold` number, required — The minimum aggregate score at which this verdict is applied, as set by Blockaid.
    - `override_threshold` number, nullable, required — Your organization's custom minimum score for this verdict. Overrides the platform default when set, or null to use the default.

## Other responses

- `400` — Returned when a value is out of the [0, 1] range or the resulting verdict thresholds are not strictly increasing (warning < high_risk < malicious).
- `404` — Returned when an unknown category name is provided.

---

[API](https://skmtc.net/blockaid-official/apis/blockaid-api.md) · [All operations](https://skmtc.net/blockaid-official/apis/blockaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockaid-official/blockaid-api/revisions/17c41f337b2e/schema)