Change Requests API

Change request management with impact analysis, quality validation, and field-level lineage tracing.

Endpoints Overview

Method	Endpoint	Description
POST	/products/{pid}/change-requests	Create change request
GET	/products/{pid}/change-requests	List product change requests
POST	/products/{pid}/change-requests/{id}/transition	Transition status
POST	/products/{pid}/change-requests/{id}/validate	Re-run quality checks
GET	/products/{pid}/impact-preview	Preview impact analysis
GET	/products/{pid}/field-downstream-usage	Field downstream usage
GET	/products/{pid}/field-upstream-sources	Field upstream sources
GET	/products/{pid}/fields/{fid}/quality-checks	Field quality checks
POST	/products/{pid}/ai-impact-assessment	AI impact assessment

---

Create Change Request

POST /products/{product_id}/change-requests

Automatically performs impact analysis and creates notifications for downstream owners.

{
  "title": "Add email validation column",
  "description": "Adding a derived column for email format validation",
  "change_type": "schema_change",
  "proposed_schema": { "columns": [...] },
  "target_date": "2026-03-15T00:00:00Z"
}

---

Transition Status

POST /products/{product_id}/change-requests/{request_id}/transition

{
  "status": "approved"
}

Valid transitions:

• pending → under_review | cancelled
• under_review → approved | rejected | cancelled
• approved → implemented | cancelled

---

Preview Impact Analysis

GET /products/{product_id}/impact-preview

Returns downstream products, affected owners, impacted contracts, and breaking change assessment.

---

AI Impact Assessment

POST /products/{product_id}/ai-impact-assessment

Generates an AI-powered impact assessment including risk level, business impact, and affected downstream products.

---

Error Responses

Status	Description
400	Invalid state transition
404	Product or change request not found