Policies API

Governance policy engine — create, evaluate, and enforce data policies across products.

Endpoints Overview

Method	Endpoint	Description
POST	/spaces/{slug}/policies	Create policy
GET	/spaces/{slug}/policies	List policies
GET	/spaces/{slug}/policies/compliance-summary	Compliance dashboard
GET	/spaces/{slug}/policies/templates	List templates
GET	/spaces/{slug}/policies/{id}	Get policy
PATCH	/spaces/{slug}/policies/{id}	Update policy
DELETE	/spaces/{slug}/policies/{id}	Delete policy
POST	/spaces/{slug}/policies/{id}/archive	Archive policy
POST	/spaces/{slug}/policies/{id}/unarchive	Unarchive policy
POST	/spaces/{slug}/policies/{id}/evaluate	Evaluate policy
GET	/spaces/{slug}/policies/{id}/evaluations	List evaluations
POST	/spaces/{slug}/policies/evaluate-all	Evaluate all policies
GET	/spaces/{slug}/products/{pid}/violations	Product violations

---

Create Policy

POST /spaces/{slug}/policies

{
  "name": "Documentation Required",
  "description": "All products must have a description",
  "policy_type": "documentation",
  "rule_expression": "product.description IS NOT NULL",
  "severity": "high",
  "is_enabled": true
}

---

List Policies

GET /spaces/{slug}/policies

Query Parameters

Parameter	Type	Description
include_archived	boolean	Include archived policies
policy_type	string	Filter by type
is_enabled	boolean	Filter by enabled status
skip	integer	Pagination offset
limit	integer	Page size (max 200)

---

Compliance Summary

GET /spaces/{slug}/policies/compliance-summary

Returns aggregated compliance dashboard data for the space.

---

Evaluate Policy

POST /spaces/{slug}/policies/{policy_id}/evaluate

Manually triggers evaluation of a policy against all products in the space.

---

Evaluate All Policies

POST /spaces/{slug}/policies/evaluate-all

Re-evaluates all enabled policies against all products. Returns a summary with total products evaluated and violations found.

---

List Evaluations

GET /spaces/{slug}/policies/{policy_id}/evaluations

Returns evaluation results with product names and compliance status.

---

Product Violations

GET /spaces/{slug}/products/{product_id}/violations

Returns active policy violations for a specific product (used for violation banners in the UI).

---

Error Responses

Status	Description
404	Policy not found
409	Policy name already exists