# Allerto API

> Voice agents that answer (inbound) and place (outbound) phone calls in Italian and English. One agent JSON schema drives the REST API, the CLI, the MCP server and the console. Test keys (alt_test_) never phone anyone.

Base URL: https://api.allerto.cloud/v1 · Auth: Authorization: Bearer <API key> · OpenAPI: https://api.allerto.cloud/v1/openapi.json · MCP: https://api.allerto.cloud/mcp

## Docs

- [Overview](https://api.allerto.cloud/docs/index.md): Voice agents that answer and place phone calls, configured and used entirely through an API.
- [Quickstart](https://api.allerto.cloud/docs/quickstart.md): From an API key to a completed test call and its webhook, in five minutes.
- [Agents](https://api.allerto.cloud/docs/agents.md): The agent document, field by field, for inbound and outbound agents; drafts, versions and numbers.
- [Tools during calls](https://api.allerto.cloud/docs/tools.md): Let an agent read and update your own system while it talks, through your MCP server, with confirmation for actions.
- [Calls and campaigns](https://api.allerto.cloud/docs/calls.md): Placing outbound calls, attempts and retries, calling windows, statuses, outcomes and campaigns.
- [Webhooks](https://api.allerto.cloud/docs/webhooks.md): The call.completed and call.attempt_failed events, signature verification and retries.
- [Test mode](https://api.allerto.cloud/docs/test-mode.md): Test keys, test numbers and predictable outcomes, with webhooks and no phone calls.
- [CLI](https://api.allerto.cloud/docs/cli.md): Install the allerto command, log in with an API key and manage agents, calls and campaigns from a terminal or CI.
- [AI agents and MCP](https://api.allerto.cloud/docs/ai-agents.md): Let Claude, Cursor or any AI agent configure and use Allerto through MCP, OpenAPI or llms.txt.
- [Platform rules](https://api.allerto.cloud/docs/platform-rules.md): The rules every agent follows, whatever its configuration, and where each is enforced.
- [Privacy and data retention](https://api.allerto.cloud/docs/privacy.md): What Allerto keeps about each call, for how long, recordings and the AI disclosure.
- [Errors](https://api.allerto.cloud/docs/errors.md): Error format and the stable error codes of the API.
- [API reference](https://api.allerto.cloud/docs/reference.md): Every endpoint of the Allerto API, the agent JSON Schema and the machine-readable specification.

## Optional

- [Everything in one file](https://api.allerto.cloud/llms-full.txt)
- [Agent JSON Schema](https://api.allerto.cloud/v1/agents/schema)