Thin
The hook packages actor, action, context, idempotency, and correlation data.
API documentation
Protocol Hooks
Protocol Hooks are thin execution gate actions that let workflow surfaces ask Decionis for authority before protected work continues.
Purpose
Hooks make Decionis the default policy gate in existing workflow tools without moving policy logic into those tools.
Binding-driven
Policy version, thresholds, approvals, and escalation posture resolve inside Decionis.
Dossier-backed
Every hook response can carry a signed Decision Dossier reference for audit review.
Hook types
Use the most specific hook where a native adapter exists. Use the universal action gate for workflow systems that only need an HTTP gate.
| Surface | Hook |
|---|---|
| SDK / direct API | POST /v1/protocol/evaluate-decision |
| Universal workflow gate | POST /v1/action-gate/evaluate |
| Salesforce Flow / Agentforce | POST /v1/orgs/:orgId/salesforce/action-gate |
| Atlassian Forge | POST /v1/atlassian/forge/action-gate |
| Power Automate | Custom connector over /v1/action-gate/evaluate |
| ServiceNow | Workflow script or IntegrationHub call to /v1/action-gate/evaluate |
Contract
The workflow submits business context and waits for a governed action.
{
"surface": "POWER_AUTOMATE",
"workflow_key": "vendor_payment_release",
"actor": { "id": "flow:finance-release", "type": "WORKFLOW" },
"action": {
"type": "RELEASE_PAYMENT",
"amount": 250000,
"currency": "EUR"
},
"context": {
"vendor_tier": "strategic",
"source_record": "invoice_123"
},
"idempotency_key": "invoice_123:release",
"correlation_id": "corr_01HX"
}Power Automate
The Microsoft connector spec is packaged as a hook so flows can branch on Decionis action without encoding the policy.
| Step | Behavior |
|---|---|
| Call Decionis | Flow invokes the connector before protected downstream work. |
| Read verdict | Flow reads continue, stop, hand off, or review action. |
| Preserve proof | Flow stores dossier URL or posts it to Teams for review. |
| Avoid rules | Flow does not own thresholds, formulas, or approval policy. |
Connector artifact
The packaged OpenAPI connector is available at /marketplace/microsoft/power-automate/decionis-power-automate-openapi.json.
Boundaries
Protocol Hooks are adapters, not policy engines.
| Layer | Owns |
|---|---|
| Workflow hook | Request packaging, retry behavior, and response branching. |
| Policy Decision Graph | Policy binding, version selection, thresholds, and approvals. |
| Decision Protocol | Signed verdict, reason codes, dossier reference, and audit trail. |
| Application workflow | Continue, stop, hand off, or review based on the response. |
Runtime base
Use https://api.decionis.com/v1 for hook calls. Pair this page with https://docs.decionis.com/decision-protocol, https://docs.decionis.com/decision-evaluation, and https://docs.decionis.com/policy-decision-graph when implementing a new workflow surface.