API base
All routes below are rooted at the public API base.
https://api.decionis.com/v1Decionis exposes a governed API surface for canonical decision evaluation, signal intake, policy encoding, execution handoff, downloadable validation packs, and Decision Dossier verification. Most integrations start with OTP-based onboarding, issue a mapping deployment bundle, persist the returned org API key, and then call /v1/protocol/evaluate-decision. /v1/action-gate/evaluate remains available as a higher-level wrapper when a surface needs a pre-modeled response envelope.
Use the API base for programmatic requests and the docs surface for reference material.
All routes below are rooted at the public API base.
https://api.decionis.com/v1Share this docs surface with partner engineering teams.
https://docs.decionis.com/apiZero-config onboarding starts with public account verification, which returns the onboarding grant and org ID. Then a mapping session is created, and the deployment bundle returns the org API key, connector ID, webhook secret, webhook URL, and current policy version. The first governed partner call should then use POST /v1/protocol/evaluate-decision with that org API key. Live provider traffic can continue through the Decionis-issued webhook, while outbound decision callbacks use the first-class WEBHOOK integration provider.
Every Decionis package that resolves on its public registry today, and which one to reach for. Nothing is listed until it installs.
| Package | Purpose | Get it | Status |
|---|---|---|---|
| @decionis/sdkAsk | Ask the hosted protocol for a verdict from your application. | npm install @decionis/sdk | Current |
| @decionis/verifyVerify | Verify a signed Decision Dossier independently, offline. | npx @decionis/verify <verification link> | Current |
| decionis/governGate CI/CD | Require a verdict before a GitHub workflow step executes. | uses: decionis/govern@v2 | Current |
| @decionis/mcpConnect agents | Gate an agent's tool calls, egress and spending. | npx @decionis/mcp | Current |
| @decionis/surface | Embed the policy and inline guard engine directly. | npm install @decionis/surface | Current |
| @decionis/iso8583 | Gate ISO 8583 authorizations before they settle. | npm install @decionis/iso8583 @decionis/sdk | Current |
| @decionis/langchain | Gate a LangChain tool or LangGraph node. | npm install @decionis/langchain | Current |
| @decionis/agent-safe-pipeline | Reference architecture and library: agents propose, Decionis decides, a trusted executor runs on a single-use intent-bound grant. | npm install @decionis/agent-safe-pipeline | Current |
| @decionis/agentsafe | The AgentSafe runtime: the gateway and trusted executor in front of an API, a tool or a TCP service. | npm install --global @decionis/agentsafe | Current |
| com.decionis:decionis-java | The Java client for the Decionis API, for Java 17 services. | implementation("com.decionis:decionis-java:0.3.0") | Current |
| com.decionis:decionis-spring-boot-starter | @DecionisGate for Spring Boot 3: the method runs only after the verdict allows it. | implementation("com.decionis:decionis-spring-boot-starter:0.3.0") | Current |
| Decionis | The .NET client for the Decionis API, for .NET 8 services. | dotnet add package Decionis --version 0.3.0 | Current |
| @decionis/sdk-node | The previous name for the application SDK.Use @decionis/sdk instead. | npm install @decionis/sdk | Legacy |
| @decionis/dossier-verify | The previous name for the dossier verifier.Use @decionis/verify instead. | npx @decionis/verify <verification link> | Legacy |
| @decionis/iso8583-interceptor | The previous name for the ISO 8583 interceptor.Use @decionis/iso8583 instead. | npm install @decionis/iso8583 | Legacy |
The API as OpenAPI 3.1, for generating a client in any language or importing into your gateway.
Every operation you can call with an org API key or without one, one tag per resource, so a generator writes one client class per resource. Operator and internal routes are left out.
https://docs.decionis.com/openapi/decionis-protocol-public.yamlEvery operation, each marked public, operator or internal, as JSON. This is the contract discovery agents read.
https://docs.decionis.com/.well-known/openapi.jsonThe Decionis app for Make uses a first-party OAuth flow instead of asking users to copy an org API key. These endpoints are intended and supported specifically for the Make connector.
GET /v1/public/auth/make/authorize reuses the active Decionis account session or sends the user through Decionis sign-in, resolves the workspace, and installs the fixed Shadow-mode Make starter policy. POST /v1/public/auth/make/token exchanges the one-time code for a Make-scoped org credential. GET /v1/make/me validates that credential and returns the resolved workspace. Existing pre-release connections can idempotently install the same starter policy with POST /v1/make/policy/bootstrap.
GET https://api.decionis.com/v1/public/auth/make/authorize
POST https://api.decionis.com/v1/public/auth/make/token
GET https://api.decionis.com/v1/make/me
POST https://api.decionis.com/v1/make/policy/bootstrapDecionis runs one OAuth client for Make; the connection uses it, and other client IDs are refused. The token response carries no expires_in and no refresh_token: the access token is a Make-scoped org credential that does not expire and stays valid until it is revoked under API keys in the workspace. Each authorization mints a new credential.
{
"access_token": "dcy_org_…",
"token_type": "Bearer",
"org_id": "<org_uuid>",
"user_email": "you@example.com",
"account_name": "Example workspace",
"scope": "decision:read decision:write"
}POST /v1/make/webhooks stores a Make webhook URL (HTTPS on make.com) for the authenticated org and returns 201 with subscription.id. Registering the same URL again returns the same ID. DELETE /v1/make/webhooks/{subscription_id} with that ID removes the registration and returns removed: true; an unknown ID returns 404 MAKE_WEBHOOK_NOT_FOUND.
POST https://api.decionis.com/v1/make/webhooks
{ "url": "https://hook.us2.make.com/…" }
201 { "subscription": { "id": "<subscription_uuid>", "event_name": "decision.resolved" } }
DELETE https://api.decionis.com/v1/make/webhooks/<subscription_uuid>
200 { "removed": true, "subscription_id": "<subscription_uuid>" }Each decision recorded through POST /v1/protocol/evaluate-decision in the workspace sends one decision.resolved event to every registered Make webhook. Every delivery includes x-decionis-event: decision.resolved and x-decionis-delivery-id (equal to id); x-decionis-signature is included when callback signing is configured. id is the event ID: it is unchanged across the up to eight delivery attempts, so use it to drop duplicates.
{
"type": "decision.resolved",
"id": "<event_uuid>",
"org_id": "<org_uuid>",
"dossier_id": "<dossier_uuid>",
"evaluation_id": "<evaluation_uuid>",
"idempotency_key": "make-review-001",
"outcome": "ESCALATE",
"reconciliation_status": null,
"occurred_at": "2026-11-13T12:00:00.000Z"
}The fixed Make starter policy runs in Shadow mode: actions below 1,000 currency units return ALLOW, actions from 1,000 through 9,999.99 return ESCALATE, actions at or above 10,000 return BLOCK, and actions without an amount return ESCALATE. Replace it with an approved workspace policy before enforcement.
Use the protocol route as the default decision surface once onboarding and deployment-bundle issuance are complete.
POST /v1/protocol/evaluate-decision is the primary route for new governed decision integrations, including the finance CFD workflow pack added for partner broker flows.
https://api.decionis.com/v1/protocol/evaluate-decisionPOST /v1/action-gate/evaluate stays available for adapters that want an action-gate-specific response envelope, but it is not the public canonical path for new finance decision use cases.
https://api.decionis.com/v1/action-gate/evaluateEvery response carries outcome (APPROVE, ESCALATE, REJECT or REVIEW) and reason_codes, an array of machine-readable reasons in a fixed order: outcome code, policy guard reason, resolution, selected rule action. verdict (ALLOW, ESCALATE or BLOCK) is present on Protocol 1.1 responses; elsewhere APPROVE maps to ALLOW, ESCALATE and REVIEW to ESCALATE, and REJECT to BLOCK. policy_evaluation.evaluated_at is the evaluation time. policy_snapshot.effective_from and effective_to bound the policy's validity window; effective_to is null for a policy with no end date, such as the Make starter policy.
{
"outcome": "ESCALATE",
"reason_codes": ["PROTOCOL_OUTCOME_ESCALATE", "POLICY_MATCHED", "POLICY_ACTION_REQUIRE_REVIEW"],
"policy_version": "make-starter-v1",
"dossier_id": "<dossier_uuid>",
"evaluation_id": "<evaluation_uuid>",
"mode": "SHADOW",
"policy_evaluation": { "evaluated_at": "2026-11-13T12:00:00.000Z", "selected_rule_id": "make-starter-escalate-mid-value", … },
"policy_snapshot": { "effective_from": "2026-01-01T00:00:00.000Z", "effective_to": null, … },
"verification": { … }
}OTP verify -> signal mapping session -> deployment bundle -> store the org API key -> call POST /v1/protocol/evaluate-decision. The Decision Evaluation page includes the full Geminix Capital CFD request and response examples.
These are the primary reference areas for partner integrations.
API key posture, public routes, and webhook trust requirements.
Canonical /v1/protocol/evaluate-decision payloads, response fields, and wrapper route guidance.
Implementation order for teams adopting Decionis for the first time.
Sample-driven zero-config mapping sessions, required fields, and dry-run validation.
Inbound signal ingress plus outbound WEBHOOK callback configuration, trust headers, and retry posture.
Versioned policy bundles and execution dispatch artifact submission.
Org-scoped dossier retrieval, share-safe public verification, and portable artifacts.
Org-level evidence exports, manifest hashes, and downloadable regulator-facing bundles.
One-screen map of supported integrations, enforcement patterns, proof artifacts, and outcome proof pages.
Shareable OpenAPI import path and verify route for Google Cloud and Vertex AI agent workflows.
| Area | Primary docs path |
|---|---|
| Auth | https://docs.decionis.com/auth |
| Decision Evaluation | https://docs.decionis.com/decision-evaluation |
| Quickstart | https://docs.decionis.com/quickstart |
| Signal Mapping | https://docs.decionis.com/signal-mapping |
| Webhooks | https://docs.decionis.com/webhooks |
| Policy Encoding | https://docs.decionis.com/policy-encoding |
| Decision Dossier | https://docs.decionis.com/decision-dossier |
| Validation Packs | https://docs.decionis.com/validation-packs |
| Evidence Index | https://decionis.com/proof |
| Vertex AI | https://docs.decionis.com/vertex-ai-extension |
| Vertex Go-Live | https://docs.decionis.com/vertex-go-live |
Use this file as the shareable import artifact for Vertex AI Extension or mirror it into your Google Cloud-controlled storage path.
https://docs.decionis.com/openapi/decionis-vertex-extension-v1.yamlThis page keeps the current auth model and request flow explicit so partners do not assume Google-specific auth is already required in phase 1.
https://docs.decionis.com/vertex-ai-extensionUse this page once the adapter call is working and you want a production-ready rollout checklist for proof, telemetry, metering, and rollback.
https://docs.decionis.com/vertex-go-liveThis is the smallest useful route set for a partner integrating Decionis as a governed decision surface.
/v1/public/auth/register/startPublicRequest the sponsor email OTP that starts self-serve onboarding.
/v1/public/auth/register/verifyPublicVerify the OTP and receive the onboarding grant plus resolved org ID.
/v1/public/pilot/signal-mapping/sessionsOnboarding grant or org API keyCreate a sample-driven mapping session after OTP verify returns the onboarding grant.
curl -X POST https://api.decionis.com/v1/public/pilot/signal-mapping/sessions \
-H "Authorization: Bearer <onboarding_grant>" \
-H "Content-Type: application/json" \
-d '{
"org_id": "<org_uuid>"
}'/v1/public/pilot/signal-mapping/sessions/:sessionId/deployment-bundleOnboarding grant or org API keyIssue the org API key, connector ID, webhook secret, webhook URL, and policy version once the mapping baseline is ready.
curl -X POST https://api.decionis.com/v1/public/pilot/signal-mapping/sessions/<session_id>/deployment-bundle \
-H "Authorization: Bearer <onboarding_grant>" \
-H "Content-Type: application/json" \
-d '{
"provider_key": "partner_webhook",
"workflow_key": "decision_intake",
"source_label": "primary_stream"
}'/v1/orgs/:orgId/integrations/WEBHOOK/connectAPI keyCreate or update the standard outbound decision callback destination for a partner or internal receiver.
curl -X POST https://api.decionis.com/v1/orgs/<org_id>/integrations/WEBHOOK/connect \
-H "Authorization: Bearer dcy_org_xxx" \
-H "Content-Type: application/json" \
-d '{
"config": {
"endpoint_url": "https://partner.example.com/decionis/webhook",
"provider_name": "partner-webhook",
"workflow_id": "decision_intake"
},
"credentials": {
"webhook_secret": "whsec_partner_xxx"
},
"subscriptions": [
{
"event_name": "decisioning.v2.ran",
"is_enabled": true,
"filter": {}
}
]
}'/v1/protocol/evaluate-decisionAPI keyCanonical governed decision route. An org-scoped credential, including a Make OAuth credential, resolves org_id from the bearer token; an explicit matching org_id remains accepted.
curl -X POST https://api.decionis.com/v1/protocol/evaluate-decision -H "Authorization: Bearer dcy_org_xxx" -H "Idempotency-Key: cfd-order-${ORDER_ID}" -H "Content-Type: application/json" -d '{
"org_id": "<org_uuid>",
"decision_type": "CFD_TRADE_EXECUTION",
"amount": 18000,
"risk_score": 0.74,
"objective_profile": "risk_conservative",
"mode": "ENFORCEMENT",
"workflow_key": "cfd_trade_execution",
"vertical_pack": "cfd_trade_execution",
"context": {
"broker": "Geminix Capital",
"instrument": "EURUSD",
"side": "BUY",
"order_type": "MARKET",
"notional": 18000,
"leverage": 12,
"margin_available": 5400,
"stop_loss": 1.0715,
"take_profit": 1.094,
"time_in_force": "GTC",
"approval_path": ["desk_risk", "finance_control"],
"policy_version": "cfd_trade_execution-v1"
}
}'/v1/action-gate/evaluateAPI keyHigher-level wrapper for surfaces that want an action-gate envelope. Use /v1/protocol/evaluate-decision as the default public route when you are integrating a new decision workflow directly.
/v1/protocol/policies/bundlesAPI keySubmit a versioned policy bundle when the integration participates in policy authoring.
/v1/orgs/:orgId/audit-exportsAPI keyQueue a validation pack or downloadable regulator-evidence bundle once the workspace is live.
/v1/google-cloud/vertex/extensions/verifyAPI keyPhase 1 Vertex AI adapter route that normalizes agent intent, invokes Decionis Protocol, and returns a governed verdict plus Decision Dossier verification links.
curl -X POST https://api.decionis.com/v1/google-cloud/vertex/extensions/verify \
-H "Authorization: Bearer dcy_org_xxx" \
-H "Content-Type: application/json" \
-d '{
"org_id": "<org_uuid>",
"decision_type": "TRANSACTION_ROUTING",
"workflow_key": "finance_transaction_routing",
"system_of_record": "SAP",
"intent": {
"action_type": "CREATE_VENDOR_PAYMENT"
}
}'/v1/reader/verifyAPI keyVerify a Decision Dossier reference with an org-scoped credential and return signature validity, signed outcome, and verification metadata. Every result returns 200: read verified and verification_status (VERIFIED, INVALID, EXPIRED or TAMPERED). The response carries a dossier summary, not the dossier payload; dossier, integrity and verification are null when no dossier was found.
POST https://api.decionis.com/v1/reader/verify
{ "artifact_ref": "<dossier_uuid or verification URL>" }
200 {
"service": "decionis",
"artifact_type": "DECISION_DOSSIER",
"artifact_ref": "<dossier_uuid>",
"verified": true,
"verification_status": "VERIFIED",
"verified_at": "2026-11-13T12:00:05.000Z",
"message": "…",
"dossier": {
"dossier_id": "<dossier_uuid>",
"decision_evaluation_id": "<evaluation_uuid>",
"generated_at": "2026-11-13T12:00:00.000Z",
"decision_type": "APPROVE_INVOICE",
"decision_domain": null,
"source_system": null,
"entity": null,
"entity_id": "invoice-review-001",
"action": "APPROVE_INVOICE",
"outcome": "ESCALATE",
"confidence": 0.9,
"confidence_percent": "90%",
"policy_version": "make-starter-v1",
"objective_profile": "…",
"mode": "SHADOW",
"signals_evaluated": 6,
"evidence_hash_count": 0
},
"integrity": {
"payload_sha256": "…",
"ledger_entry_id": "…",
"ledger_entry_hash": "…",
"ledger_chain_verified": true
},
"verification": {
"verification_api_path": "/v1/public/decision-dossiers/<dossier_uuid>/verify",
"verification_url": "https://api.decionis.com/v1/public/decision-dossiers/<dossier_uuid>/verify?sig=…",
"verification_page_url": "https://decionis.com/verify/decision-dossiers/<dossier_uuid>?sig=…",
"signature_algorithm": "HMAC-SHA256",
"signature": "…",
"asymmetric_proof": { … },
"asymmetric_proof_bundle": null
}
}/v1/public/decision-dossiers/:dossierId/verify?sig=<signature>PublicVerify a Decision Dossier through a share-safe public route without exposing the full org-scoped artifact.
The docs surface should make failure posture explicit so integrators can recover without support.
| Status | Meaning | Expected action |
|---|---|---|
| 400 | Payload shape or required field mismatch | Fix request shape and retry. |
| 401 | Missing or invalid API credentials | Rotate or supply a valid API key. |
| 403 | Caller is outside org or route trust boundary | Use the correct org-scoped credential or public route. |
| 409 | Artifact version or connector state conflict | Resolve the latest state, then resubmit. |
| 422 | Mapping, policy, or dossier input is semantically invalid | Correct the payload content, not just the syntax. |