API Reference: Interventions

Endpoints for recording human-in-the-loop actions on decisions.

Create Intervention — POST /records/{id}/intervene

Field           Type     Required  Description
actor_email     string   Yes       Email of the human reviewer
action          string   Yes       APPROVED, REJECTED, OVERRIDE, ESCALATED
reason          string   Yes       Explanation for the action
new_outcome     object   If OVERRIDE  The new decision
evidence_urls   array    No        Links to documents
metadata        object   No        Additional data

curl -X POST https://api.xase.ai/v1/records/rec_8a7f3b2c/intervene   -H "Authorization: Bearer xase_pk_..."   -H "Content-Type: application/json"   -d '{
    "actor_email": "joao.silva@company.com",
    "action": "OVERRIDE",
    "reason": "Additional documentation verified",
    "new_outcome": {
      "decision": "APPROVED",
      "credit_limit": 30000
    },
    "evidence_urls": [
      "https://storage.company.com/docs/collateral_123.pdf"
    ],
    "metadata": {
      "review_duration_seconds": 340
    }
  }'

Response

{
  "id": "int_7f6e5d4c3b2a1098",
  "record_id": "rec_8a7f3b2c4d5e6f7a",
  "actor_email": "joao.silva@company.com",
  "action": "OVERRIDE",
  "reason": "Additional documentation verified",
  "new_outcome": { "decision": "APPROVED", "credit_limit": 30000 },
  "signature": "RSA-SHA256:abc123...",
  "signed_at": "2025-01-15T14:35:00.000Z"
}

All interventions are signed with RSA-SHA256 and identity-linked. Timestamps must be strictly monotonic with the decision.