API documentation

Saved Risk Value

Saved Risk Value is Decionis' audit estimate for governed exposure: what execution was held, what exception exposure was accepted, and which dossier evidence supports the claim.

Definition

SRV helps operators explain Decionis as execution risk infrastructure, not only compliance logging.

Governed exposure

The protocol ledger records the amount or business exposure attached to governed decisions.

Held risk

Non-allow enforcement outcomes convert amount and risk score into an estimated exposure held by the gate.

Controlled exceptions

Override dossiers record accepted exposure, upside, blast radius, approver context, and expiry.

Inputs

Saved Risk Value should be assembled from Decionis protocol artifacts, not from client-side rule thresholds.

ArtifactField examples
Execution Ledgeramount, risk_score, execution_action, outcome, policy_version
Decision Dossierdossier_id, reason_codes, policy_snapshot, signature
Override Dossierestimated_risk_eur, potential_upside_eur, blast_radius
Decision Chainworkflow lineage and related held or escalated steps

Measurement

The workspace SRV panel uses a conservative audit estimate.

{
  "saved_risk_value": {
    "risk_held": "sum(amount * risk_score for non-allow enforcement decisions)",
    "exposure_governed": "sum(amount for protocol ledger decisions)",
    "controlled_exception_exposure": "sum(override.metadata.estimated_risk_eur)",
    "traceability": "every estimate links back to ledger rows and override dossiers"
  }
}

Boundaries

SRV is an audit posture metric, not a guarantee of actual loss avoided.

StatementBoundary
Risk heldEstimated from protocol evidence and risk scores; it is not a P&L guarantee.
Controlled exceptionAn accepted override can preserve upside while keeping exposure auditable.
No policy logic in clientsApplications still submit execution intent; Decionis remains the policy authority.
Reviewable by auditorsEvery number should be traceable to a dossier, chain, ledger row, or override record.

Routes

Use the protocol ledger and dossier routes as the source of measurement.

UseRoute
Execution LedgerGET /v1/orgs/:orgId/decision-ledger
Decision DossierGET /v1/protocol/dossiers/:dossierId
Decision ChainGET /v1/protocol/decision-chains/:chainId
Decision EvaluationPOST /v1/protocol/evaluate-decision
Operational posture

Use https://api.decionis.com/v1 for runtime calls. Pair https://docs.decionis.com/decision-dossier with https://docs.decionis.com/overrides and https://docs.decionis.com/audit-anchoring when presenting SRV to finance, risk, or audit teams.