Skip to main content
The public runtime API is the decision endpoint used by Averta SDK wrappers. Most applications should use a provider wrapper: Use the raw API only when you are building a custom provider adapter, integrating from a language without an SDK package, or cannot use the SDK. Start with the raw API integration guide before reading endpoint details.

​
Base URL

https://api.averta.io

​
Authentication

Send your Averta API key as a bearer token. 
Authorization: Bearer <averta-api-key>
The key must have an attached policy. A key without a policy is not a valid guarded setup.

​
Runtime Endpoint

Create decision

Call POST /v1/decide for request, tool-call, tool-result, and output checkpoints.

​
Decision Outcomes

The API can return:
  • allow
  • block
  • restrict_tools
  • rewrite
Valid outcomes depend on checkpoint_type. See Decisions for SDK behavior.