Welcome
The Decionis Policy Evaluation API and the Decionis Shield Spending Authority API in one portal and one set of SDKs.
This portal covers both Decionis APIs in a single reference and a single set of SDKs:
- Decionis Policy Evaluation API: evaluates captured execution intent against versioned policies before your system acts, and returns a signed decision (allow, block or escalate) backed by a verifiable Decision Dossier.
- Decionis Shield Spending Authority API: asks a user's Shield for authority before your app or AI agent spends their money, and returns ALLOW, ASK (hold until the user approves) or BLOCK.
What you'll find here
- API Reference: every operation of both APIs, grouped by capability, with request and response examples and a live API playground. Shield endpoints are under Authorization and Evidence.
- SDKs: one client library per language for C# (.NET), Python and TypeScript, generated by APIMatic, covering both APIs.
- Context Plugin: brings the APIs and SDKs into AI coding assistants such as Claude Code, Cursor and Codex.
Base URL
Both APIs are served from:
https://api.decionis.comAuthentication
Policy Evaluation API: send your organization API key as a bearer token:
Authorization: Bearer $DECIONIS_API_KEYShield API: send your Shield API key as a bearer token, with your registered integration and environment:
Authorization: Bearer $SHIELD_API_KEY
X-Shield-App-Id: your-app-id
X-Shield-Environment: sandboxSee Decionis for Developers and Shield for Developers to get started.
Common tasks
- Evaluate a decision:
POST /v1/protocol/evaluate-decision - Issue an execution grant:
POST /v1/authority/grants - Fetch a Decision Dossier:
GET /v1/protocol/dossiers/{dossier_id} - Request spending authority (Shield):
POST /v1/shield/authorize - Ask the user to approve an ASK decision (Shield):
POST /v1/shield/decisions/{decisionId}/approval

