Override a factor candidate decision
POST /v1/factors/candidate-decisions/:id/override — Appends an auditable manual exception without replacing the original automatic PASS or REJECT decision.
POST /v1/factors/candidate-decisions/:id/override
Appends an auditable manual exception without replacing the original automatic PASS or REJECT decision.
| Method | POST |
| Path | /v1/factors/candidate-decisions/:id/override |
| Auth | Authorization: Bearer <token> required |
| Category | research |
Request body
{ "targetDecision": "pass", "reason": "Verified provider outage affected the automatic rejection." }Response body
{ "override": { "overrideId": "override_...", "candidateId": "candidate_...", "sourceDecision": "reject", "targetDecision": "pass", "assuranceLevel": "integrity_relaxed" } }Notes
REJECT-to-PASS exceptions are permanently marked integrity_relaxed. A second override is rejected so the audit history remains append-only.