Retrieve workflow lineage for linked Decionis decisions
Returns the protocol-owned Decision Chain for a workflow. Decision Chains link evaluated execution intents into a causal graph without exposing policy rules or application-side guardrail logic.
Authorization
ApiKeyAuth An organization API key. Its scopes decide what it may call;
decision:shadow is the narrowest: SHADOW evaluations through
POST /v1/authority/grants or its alias
POST /v1/authority/enforce-and-bind only (DECISION_SHADOW_MODE_DENIED
in any other mode; DECISION_SHADOW_FIELD_DENIED for a body carrying
context.decionis_policy, evidence or escalation), with no
integration dispatch. A key whose only scope is decision:shadow
(an AgentSafe hosted gateway's) reaches exactly those two,
POST /v1/auth/credential-context, POST /v1/hosted-gateway/keys/confirm
and POST /v1/hosted-gateway/keys/revoke-self; every other route
answers 403 HOSTED_GATEWAY_KEY_PATH_DENIED.
decision:enforce is an enforced hosted gateway's key: evaluations
in SHADOW or ENFORCEMENT through POST /v1/authority/grants or its
alias (400 DECISION_ENFORCE_FIELD_DENIED for a body carrying
context.decionis_policy; it never holds policy:write), and the
grants and managed escalations they bind. A key whose scopes are
decision:enforce (with or without decision:shadow) reaches exactly
POST /v1/authority/enforce-and-bind, POST /v1/authority/grants,
GET /v1/authority/grants/{grant_id},
POST /v1/authority/grants/{grant_id}/claims,
POST /v1/authority/grants/{grant_id}/receipts,
POST /v1/authority/grants/{grant_id}/reconciliations,
POST /v1/execution/verify-token, POST /v1/execution/claim-token,
POST /v1/execution/consume-token, POST /v1/execution/finalize-token,
GET /v1/authority/escalations/{escalation_id},
DELETE /v1/authority/escalations/{escalation_id},
POST /v1/auth/credential-context, POST /v1/hosted-gateway/keys/confirm
and POST /v1/hosted-gateway/keys/revoke-self, each id a UUID; every
other route answers 403 HOSTED_GATEWAY_KEY_PATH_DENIED.
In: header
Path Parameters
uuidQuery Parameters
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/protocol/decision-chains/497f6eca-6276-4993-bfeb-53cbbbba6f08?org_id=497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "service": "string", "protocol_version": "string", "org_id": "a40f5d1f-d889-42e9-94ea-b9b33585fc6b", "chain_id": "01c3b16e-4d9b-4398-a3ec-0a1f8f0bb259", "workflow_id": "string", "root_evaluation_id": "eed94b47-3a4b-4847-bd0a-1662da45f6ac", "count": 0, "max_lineage_depth": 0, "integrity_verified": true, "ledger_verification": { "valid": true, "complete": true, "checked": 0, "max_entries": 1 }, "links": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "chain_id": "01c3b16e-4d9b-4398-a3ec-0a1f8f0bb259", "workflow_id": "string", "step_id": "string", "sequence": 0, "decision_evaluation_id": "e30a38b7-75b4-419e-b147-0c698676729e", "dossier_id": "8a9bfc13-db6c-4e62-a117-1a4399450d29", "parent_evaluation_ids": [ "4509dcad-2b90-45c5-9d5c-0367bb956d30" ], "parent_dossier_ids": [ "cbb7f561-c3ee-4755-b6d8-80da670d1a41" ], "root_evaluation_id": "eed94b47-3a4b-4847-bd0a-1662da45f6ac", "lineage_depth": 0, "integrity_hash": "string", "integrity_verified": true, "outcome": "string", "policy_version": "string", "authority_classification": "AUTHORITATIVE", "verdict": "ALLOW", "execution_binding_digest": "string", "dossier_api_path": "string", "created_at": "2019-08-24T14:15:22Z" } ], "link_limit": 1, "links_truncated": true, "evidence_lineage": [ { "stage": "CLAIM", "evaluation_id": "4108ec8e-6efd-4b9b-bace-0bb4c296c324", "dossier_id": "8a9bfc13-db6c-4e62-a117-1a4399450d29", "status": "string", "occurred_at": "2019-08-24T14:15:22Z", "ledger_entry_id": "34c94b99-ae7e-4ed1-928e-78f0df05c275", "ledger_entry_hash": "string", "evidence_digest": "string", "evidence_hash_verified": true, "execution_correlation_id": "string", "binding_digest": "string", "observed_at": "2019-08-24T14:15:22Z", "observation_method": "string", "observer": { "id": "string", "version": "string" }, "expected_effect_digest": "string", "observed_effect_digest": "string", "evidence_reference": "string" } ], "evidence_lineage_limit": 1, "evidence_lineage_truncated": true}