# Bolna API Documentation

This is the complete API documentation for connecting to the Bolna API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Bolna connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/bolna/actions/{actionSlug}/run
```

## Bolna actions

- POST `create-agent` Create Agent
- POST `create-knowledgebase-from-url` Create Knowledgebase from URL
- DELETE `delete-agent` Delete Agent
- DELETE `delete-knowledgebase` Delete Knowledgebase
- GET `get-agent` Get Agent
- GET `get-knowledgebase` Get Knowledgebase
- GET `get-user-details` Get User Details
- GET `list-agent-batches` List Agent Batches
- GET `list-agents` List Agents
- GET `list-all-agent-executions` List All Agent Executions
- GET `list-all-knowledgebases` List All Knowledgebases
- GET `list-all-voices` List All Voices
- GET `list-phone-numbers` List Phone Numbers
- GET `list-providers` List Providers
- GET `list-sip-trunks` List SIP Trunks
- GET `list-violations` List Violations
- PUT `patch-update-agent` Patch Update Agent
- GET `search-phone-numbers` Search Phone Numbers
- PUT `stop-agent-calls` Stop Agent Calls
- PUT `update-agent` Update Agent