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.
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.