Intent
The caller submits actor, action, context, tenant, policy references, idempotency, and correlation data.
API documentation
Decision Protocol
The Decionis Decision Protocol is the canonical contract for governed execution: send intent, receive authority, preserve proof.
Contract
DDP v0.1 standardizes how applications, agents, SDKs, public API calls, and native surfaces talk to the Decionis policy gate.
Authority
Decionis returns a signed verdict: ALLOW, BLOCK, ESCALATE, REVIEW_REQUIRED, or ERROR.
Proof
The protocol links the verdict to a Decision Dossier, policy snapshot, reason codes, and ledger evidence.
Envelope
The envelope is intentionally narrow. Clients describe execution intent; Decionis owns the policy judgment.
{
"tenant_id": "bank_001",
"actor": {
"id": "agent_42",
"type": "AI_AGENT",
"role": "treasury_rebalancer"
},
"action": {
"type": "TRANSFER_FUNDS",
"resource": "liquidity_pool",
"amount": 250000,
"currency": "EUR"
},
"context": {
"workflow": "treasury_ops",
"source_system": "ServiceNow",
"environment": "production"
},
"policy_refs": ["treasury-transfer-policy-v3"],
"idempotency_key": "txn_123456",
"correlation_id": "corr_01HX"
}Artifacts
The protocol becomes defensible when the decision is linked to institutional memory.
| Artifact | Purpose |
|---|---|
| Intent Envelope | What execution was requested, by whom, and under what context. |
| Signed Decision | The allow, block, escalate, or review verdict issued by Decionis. |
| Policy Snapshot | The policy version and digest active at decision time. |
| Decision Dossier | Portable evidence bundle for audit, appeal, and verification. |
| Decision Chain | Workflow lineage across related governed steps. |
| Execution Ledger | Organization-level record of governed execution. |
| Policy Graph | Source-of-truth binding between surfaces, workflows, and strategies. |
Routes
Runtime integrations should converge on protocol routes even when wrapped by SDKs or native surfaces.
| Use | Route |
|---|---|
| Canonical decision | POST /v1/protocol/evaluate-decision |
| Universal action gate | POST /v1/action-gate/evaluate |
| Decision Dossier | GET /v1/protocol/dossiers/:dossierId |
| Decision Chain | GET /v1/protocol/decision-chains/:chainId |
| Execution Ledger | GET /v1/orgs/:orgId/decision-ledger |
| Policy Graph | GET /v1/orgs/:orgId/policies/decision-graph |
Boundaries
DDP is a policy-gate protocol, not a place to hardcode guardrails in client applications.
| Layer | Boundary |
|---|---|
| SDK or native surface | Capture intent, send protocol call, enforce Decionis response. |
| Decionis | Evaluate policy, produce signed authority, create dossier and ledger evidence. |
| Application | Continue, stop, hand off, or request review based on the signed verdict. |
| Auditor or reviewer | Verify dossier, chain, snapshot, reason codes, and override evidence. |
Implementation posture
Use https://api.decionis.com/v1 as the runtime base. Start with https://docs.decionis.com/decision-evaluation, then add https://docs.decionis.com/decision-dossier, https://docs.decionis.com/policy-snapshot, and https://docs.decionis.com/policy-decision-graph as the integration matures.