API documentation

Artifact Architecture

Decionis turns runtime decisions into durable authority records: proof of one action, lineage across a workflow, and an organization-level ledger.

Model

The product is not only the proof. The product is the system that produces, links, and institutionalizes proof.

Decision Dossier

Proof of one governed action: execution intent, signed verdict, reason codes, policy snapshot, and verification links.

Decision Chain

Proof across a workflow: every related decision is linked so reviewers can reconstruct sequence, causality, and handoffs.

Execution Ledger

Proof across the organization: governed volume, outcome mix, policy coverage, drift, overrides, and saved-risk posture.

Layers

The artifact architecture creates institutional memory by connecting control, evidence, and operating history.

LayerArtifacts
Control planeAction Gate, execution intent envelope, signed authority, enforcement action.
Artifact layerPolicy Snapshot, Decision Dossier, reason codes, Decision Chain, integrity hashes.
Institutional memoryExecution Ledger, override trail, drift evidence, Policy Decision Graph binding.

Contract

Every governed action should leave enough structure to answer why it was allowed, blocked, escalated, or sent to review.

{
  "decision_id": "dec_01HX...",
  "execution_intent": {
    "actor": "agent_42",
    "action": "TRANSFER_FUNDS",
    "workflow": "treasury_ops"
  },
  "authority": {
    "status": "ESCALATE",
    "execution_action": "HAND_OFF",
    "reason_codes": ["APPROVAL_REQUIRED"]
  },
  "policy_snapshot": {
    "policy_id": "treasury-transfer-policy-v3",
    "version": "3.2.1",
    "hash": "sha256:..."
  },
  "artifacts": {
    "dossier_url": "/v1/protocol/dossiers/dos_01HX...",
    "chain_url": "/v1/protocol/decision-chains/chain_01HX...",
    "ledger_entry_hash": "sha256:..."
  }
}

Dependency loop

The moat compounds when Decionis artifacts become part of the customer operating record.

StepEffect
More decisions governedMore execution intent and outcome evidence enters Decionis.
More dossiers generatedMore portable proof exists for audits, appeals, and reviews.
More policy data capturedMore policy versions, reason codes, and override patterns are preserved.
Better enforcement insightCoverage, drift, saved risk, and exception patterns become measurable.
Higher dependencyOperations depend on Decionis artifacts to explain and improve authority.

Implementation

Start with the protocol decision route, then attach the evidence artifacts that make the decision durable.

NeedStart here
Runtime authorityhttps://docs.decionis.com/decision-protocol
Workflow hookhttps://docs.decionis.com/protocol-hooks
Policy version proofhttps://docs.decionis.com/policy-snapshot
Reason vocabularyhttps://docs.decionis.com/reason-codes
Workflow lineagehttps://docs.decionis.com/decision-chain
Ledger and integrity posturehttps://docs.decionis.com/audit-anchoring
Policy source of truthhttps://docs.decionis.com/policy-decision-graph
Operating principle

Every action becomes provable, traceable, auditable, and contestable. Logs say what happened; Decionis artifacts say why execution had authority.