Risk Register API

Space-scoped risk register for tracking, categorizing, and linking risks to data products.

Endpoints Overview

Method	Endpoint	Description
POST	/catalog/spaces/{slug}/risk-register	Create risk entry
GET	/catalog/spaces/{slug}/risk-register	List risk entries
GET	/catalog/spaces/{slug}/risk-register/heat-map	Risk heat map
GET	/catalog/spaces/{slug}/risk-register/templates	Risk templates
GET	/catalog/spaces/{slug}/risk-register/{id}	Get risk entry
PUT	/catalog/spaces/{slug}/risk-register/{id}	Update risk entry
POST	/catalog/spaces/{slug}/risk-register/{id}/link-products	Link products
DELETE	/catalog/spaces/{slug}/risk-register/{id}/products/{pid}	Unlink product

---

List Risk Entries

GET /catalog/spaces/{slug}/risk-register

Query Parameters

Parameter	Type	Description
category	string	Filter by risk category
status	string	Filter by status
tier	string	Filter by risk tier
product_id	UUID	Filter by linked product
limit	integer	Page size (max 100)
offset	integer	Pagination offset

---

Risk Heat Map

GET /catalog/spaces/{slug}/risk-register/heat-map

Returns aggregated risk data bucketed by likelihood and impact for heat map visualization.

---

Risk Templates

GET /catalog/spaces/{slug}/risk-register/templates

Returns pre-built risk category templates for quick risk creation.

---

Create Risk Entry

POST /catalog/spaces/{slug}/risk-register

{
  "title": "Model drift in credit scoring",
  "description": "Performance degradation detected",
  "category": "model_performance",
  "likelihood": "probable",
  "impact": "high",
  "mitigation_plan": "Monthly model retraining"
}

---

Link Products

POST /catalog/spaces/{slug}/risk-register/{entry_id}/link-products

{
  "product_ids": ["uuid-1", "uuid-2"]
}

---

Unlink Product

DELETE /catalog/spaces/{slug}/risk-register/{entry_id}/products/{product_id}

---

Error Responses

Status	Description
404	Risk entry not found