Skip to main content
The Model Governance API provides controls for responsible AI deployment: approval workflows before production promotion, automated drift detection, and fairness parity checks across customer segments.

​
GET /api/v1/model-governance

Retrieve governance status for a model including approval history and drift check results.

​
Query Parameters

ParameterTypeRequiredDescription
modelIdstringYesAlgorithm model ID

​
Response

{
  "modelId": "clx...",
  "approvals": [
    {
      "id": "clx...",
      "modelId": "clx...",
      "version": 3,
      "requestedBy": "data-scientist@example.com",
      "status": "approved",
      "reviewedBy": "admin@example.com",
      "reason": "AUC improved from 0.82 to 0.87",
      "createdAt": "2026-03-18T10:00:00.000Z"
    }
  ],
  "driftChecks": [
    {
      "id": "clx...",
      "modelId": "clx...",
      "version": 3,
      "driftDetected": false,
      "psiScore": 0.04,
      "aucDelta": -0.01,
      "checkedAt": "2026-03-18T12:00:00.000Z"
    }
  ]
}

​
POST /api/v1/model-governance

Perform governance actions. Editor or Admin (review requires Admin).

​
Actions

​
request_approval — Request approval to promote a model version

{
  "action": "request_approval",
  "modelId": "clx...",
  "version": 3,
  "metrics": { "auc": 0.87, "precision": 0.82, "recall": 0.79 }
}
Response (201): 
{ "approvalId": "clx...", "status": "pending" }

​
review — Approve or reject a model promotion (Admin only)

{
  "action": "review",
  "approvalId": "clx...",
  "decision": "approved",
  "reason": "AUC meets threshold, no drift detected"
}
Response: 
{ "approvalId": "clx...", "status": "approved" }

​
drift_check — Run a drift detection check

Compares baseline vs. current score distributions using PSI (Population Stability Index) and AUC delta. 
{
  "action": "drift_check",
  "modelId": "clx...",
  "version": 3,
  "baselineScores": [0.1, 0.3, 0.5, 0.7, 0.9],
  "currentScores": [0.15, 0.35, 0.45, 0.65, 0.85],
  "baselineAuc": 0.85,
  "currentAuc": 0.82,
  "thresholds": { "psi": 0.2, "aucDelta": 0.05 }
}
Response: 
{
  "driftDetected": false,
  "psiScore": 0.03,
  "aucDelta": -0.03,
  "details": { ... }
}

​
parity_check — Check fairness across customer segments

{
  "action": "parity_check",
  "segmentScores": {
    "segment_a": [0.8, 0.7, 0.9, 0.85],
    "segment_b": [0.6, 0.5, 0.7, 0.65]
  },
  "maxDeviation": 0.15
}
Response: 
{
  "parityPassed": false,
  "maxObservedDeviation": 0.20,
  "segmentMeans": {
    "segment_a": 0.8125,
    "segment_b": 0.6125
  }
}