Workflow lineage
workflow_id, step_id, and sequence identify where the decision sits in the execution path.
Loading…
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.
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.
- Step 1Upstream signalSAP payment intent
amount, vendor risk packet, owner threshold
source_system=sap_s4 - Step 2Policy evaluationfinance_controls_v4.2
threshold review and CFO approval requirement
outcome=ESCALATE - Step 3Decision DossierDSR-7F92-AC11
signed verdict, reason codes, policy snapshot
signature=ed25519 - Step 4Chain linkcfo-review-step
parent dossier and workflow sequence preserved
sequence=2 depth=1 - Step 5Ledger entryappend-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 keyEvaluate 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 keyRetrieve 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.
| Field | Meaning |
|---|---|
| chain_id | Stable identifier for the workflow chain. |
| workflow_id | Caller-supplied workflow or execution path identifier. |
| step_id | Caller-supplied step name for this evaluation. |
| sequence | Optional ordered position in the workflow. |
| root_evaluation_id | First evaluation in the chain. |
| parent_evaluation_ids | Immediate evaluation dependencies. |
| parent_dossier_ids | Immediate dossier dependencies. |
| lineage_depth | Distance from the root evaluation. |
| integrity_hash | Hash of the link context and references. |
| dossier_api_path | Org-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 /docs/decision-dossier to inspect a single decision and /docs/execution-map to see how chain, dossier, ledger, and dispatch artifacts fit together.