Governance API

Recertification cycle management — create cycles, populate and analyze audits, manage schedules and workflow defaults.

Endpoints Overview

Method	Endpoint	Description
POST	/spaces/{slug}/governance/cycles	Create cycle
GET	/spaces/{slug}/governance/cycles	List cycles
GET	/spaces/{slug}/governance/cycles/{id}	Get cycle detail
POST	.../{id}/populate	Auto-populate audits
POST	.../{id}/analyze	Run smart analysis
POST	.../{id}/bulk-apply	Bulk apply recommendations
POST	.../{id}/complete	Complete cycle
POST	.../{id}/cancel	Cancel cycle
POST	.../{id}/reopen	Reopen cycle
DELETE	.../{id}	Delete cycle
POST	.../{id}/archive	Archive cycle
POST	.../{id}/unarchive	Unarchive cycle
PUT	.../{id}/workflow	Set cycle workflow
PUT	/spaces/{slug}/governance/audits/{id}/review	Review audit item
PATCH	/spaces/{slug}/governance/audits/{id}	Update audit
GET	/spaces/{slug}/governance/schedule	Get schedule
PUT	/spaces/{slug}/governance/schedule	Update schedule
PATCH	/spaces/{slug}/governance/schedule/toggle	Toggle schedule
GET	/spaces/{slug}/governance/workflow-defaults	List workflow defaults
POST	/spaces/{slug}/governance/workflow-defaults	Create workflow default
PATCH	/spaces/{slug}/governance/workflow-defaults/{id}	Update workflow default
DELETE	/spaces/{slug}/governance/workflow-defaults/{id}	Delete workflow default

---

Create Cycle

POST /spaces/{slug}/governance/cycles

{
  "name": "Q1 2026 Recertification",
  "description": "Quarterly access review",
  "due_date": "2026-03-31T00:00:00Z"
}

---

Auto-Populate Audits

POST /spaces/{slug}/governance/cycles/{cycle_id}/populate

Scans live data to create audit items for all products and access assignments in the space.

---

Smart Analysis

POST /spaces/{slug}/governance/cycles/{cycle_id}/analyze

Runs AI-powered analysis on audit items, enriching them with signals and recommendations.

---

Bulk Apply Recommendations

POST /spaces/{slug}/governance/cycles/{cycle_id}/bulk-apply

{
  "recommendation_filter": "certify",
  "min_confidence": "high"
}

---

Complete / Cancel / Reopen Cycle

POST /spaces/{slug}/governance/cycles/{cycle_id}/complete
POST /spaces/{slug}/governance/cycles/{cycle_id}/cancel
POST /spaces/{slug}/governance/cycles/{cycle_id}/reopen

---

Review Audit Item

PUT /spaces/{slug}/governance/audits/{audit_id}/review

Submit a review decision for an individual audit item.

---

Schedule Management

GET /spaces/{slug}/governance/schedule
PUT /spaces/{slug}/governance/schedule
PATCH /spaces/{slug}/governance/schedule/toggle

Manage automated recertification scheduling (frequency, enabled status).

---

Error Responses

Status	Description
404	Cycle, audit, or space not found
409	Invalid state transition