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.com

Authentication

Policy Evaluation API: send your organization API key as a bearer token:

Authorization: Bearer $DECIONIS_API_KEY

Shield 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: sandbox

See 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

On this page