---
title: "Risk API"
description: "Risk scores, the signals behind them, and the weights you control."
label: "Risk"
generated: "the API catalogue in apps/control-plane/src/routes/developer.ts"
---


Risk is explainable by construction: every score decomposes into named signals with their individual contributions. Weights and thresholds are yours to tune, and tuning is an audited change.

## Endpoints

| | Endpoint | Permission | Notes |
| --- | --- | --- | --- |
| `GET` | `/v1/risk/overview` | `risk:read` | — |
| `GET` | `/v1/risk/events` | `risk:read` | — |
| `PUT` | `/v1/risk/configuration` | `risk:configure` | — |

## What each endpoint does

### `GET /v1/risk/overview`

Risk Center aggregates.

Requires `risk:read`.

### `GET /v1/risk/events`

Risk events with signal evidence.

Requires `risk:read`.

### `PUT /v1/risk/configuration`

Tune signal weights and thresholds.

Requires `risk:configure`.