> ## Documentation Index
> Fetch the complete documentation index at: https://docs.averta.io/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> The Averta runtime decision API.

The public runtime API is the decision endpoint used by Averta SDK wrappers.

Most applications should use a provider wrapper:

* [OpenAI](/openai/overview)
* [Anthropic](/anthropic/overview)

Use the raw API only when you are building a [custom provider adapter](/custom/overview), integrating from a language without an SDK package, or cannot use the SDK. Start with the [raw API integration guide](/custom/raw-api) before reading endpoint details.

## Base URL

```text theme={null}
https://api.averta.io
```

## Authentication

Send your Averta API key as a bearer token.

```http theme={null}
Authorization: Bearer <averta-api-key>
```

The key must have an attached [policy](/concepts/policies). A key without a policy is not a valid guarded setup.

## Runtime Endpoint

<CardGroup cols={1}>
  <Card title="Create decision" icon="shield-check" href="/api-reference/endpoint/create-decision">
    Call `POST /v1/decide` for request, tool-call, tool-result, and output checkpoints.
  </Card>
</CardGroup>

## Decision Outcomes

The API can return:

* `allow`
* `block`
* `restrict_tools`
* `rewrite`

Valid outcomes depend on `checkpoint_type`. See [Decisions](/concepts/decisions) for SDK behavior.