Decionis
Decionis Docs
Base URL: https://api.decionis.com/v1
QuickstartMain siteContact
API documentation

Decision Chain

A Decision Chain links related protocol evaluations into workflow lineage. It lets reviewers reconstruct the order of gated steps, parent decisions, resulting dossiers, and integrity hashes for one execution path.

Model

Use the chain when one governed action depends on prior Decionis decisions.

Workflow lineage

workflow_id, step_id, and sequence identify where the decision sits in the execution path.

Parent links

parent_evaluation_ids and parent_dossier_ids preserve dependency context without copying private artifacts.

Integrity hash

Each chain link records an integrity hash so a reviewer can detect lineage drift.

Explorer

The Decision Chain Explorer is the workspace view that makes lineage review visual: upstream source context, dossier proof, chain links, and ledger entries appear in one ordered timeline.

Decision Chain Explorer

Timeline view for following one dossier from incoming context to ledger proof.

  1. Step 1
    Upstream signal
    SAP payment intent

    amount, vendor risk packet, owner threshold

    source_system=sap_s4
  2. Step 2
    Policy evaluation
    finance_controls_v4.2

    threshold review and CFO approval requirement

    outcome=ESCALATE
  3. Step 3
    Decision Dossier
    DSR-7F92-AC11

    signed verdict, reason codes, policy snapshot

    signature=ed25519
  4. Step 4
    Chain link
    cfo-review-step

    parent dossier and workflow sequence preserved

    sequence=2 depth=1
  5. Step 5
    Ledger entry
    append-only audit anchor

    downstream record for audit review and replay

    ledger_hash=sha256:...

Attach lineage

Send decision_chain with evaluate-decision when the caller knows the workflow relationship.

POST/v1/protocol/evaluate-decisionAPI key

Evaluate a decision and attach it to a workflow chain in the same protocol response.

curl -X POST https://api.decionis.com/v1/protocol/evaluate-decision \
  -H "Authorization: Bearer dcy_org_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "org_id": "11111111-1111-4111-8111-111111111111",
    "decision_type": "CFD_TRADE_EXECUTION",
    "workflow_key": "cfd_trade_execution",
    "amount": 18000,
    "mode": "ENFORCEMENT",
    "decision_chain": {
      "workflow_id": "cfd-order-flow-001",
      "step_id": "broker_execution_gate",
      "sequence": 2,
      "parent_dossier_ids": ["22222222-2222-4222-8222-222222222222"]
    }
  }'

Retrieve

Use the chain retrieval route for audit review, support investigation, or workspace display.

GET/v1/protocol/decision-chains/:chainId?org_id=<org_uuid>API key

Retrieve the ordered chain with dossier links and integrity status for each linked step.

curl "https://api.decionis.com/v1/protocol/decision-chains/77777777-7777-4777-8777-777777777777?org_id=11111111-1111-4111-8111-111111111111" \
  -H "Authorization: Bearer dcy_org_xxx"

Fields

The chain is a reference graph, not a copy of every decision artifact.

FieldMeaning
chain_idStable identifier for the workflow chain.
workflow_idCaller-supplied workflow or execution path identifier.
step_idCaller-supplied step name for this evaluation.
sequenceOptional ordered position in the workflow.
root_evaluation_idFirst evaluation in the chain.
parent_evaluation_idsImmediate evaluation dependencies.
parent_dossier_idsImmediate dossier dependencies.
lineage_depthDistance from the root evaluation.
integrity_hashHash of the link context and references.
dossier_api_pathOrg-scoped route for the linked Decision Dossier.

Integrity

Chain integrity is designed to be checked alongside dossier verification and ledger proof.

{
  "service": "decionis",
  "protocol_version": "1.0.0",
  "chain_id": "77777777-7777-4777-8777-777777777777",
  "workflow_id": "cfd-order-flow-001",
  "count": 2,
  "max_lineage_depth": 1,
  "integrity_verified": true,
  "links": [
    {
      "step_id": "broker_execution_gate",
      "dossier_id": "33333333-3333-4333-8333-333333333333",
      "parent_dossier_ids": ["22222222-2222-4222-8222-222222222222"],
      "integrity_hash": "chain-link-hash",
      "integrity_verified": true
    }
  ]
}
Pair chain review with dossier proof

Use https://docs.decionis.com/decision-dossier to inspect a single decision and https://docs.decionis.com/execution-map to see how chain, dossier, ledger, and dispatch artifacts fit together.