# Botsonic API Documentation

This is the complete API documentation for connecting to the Botsonic 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 **Botsonic connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

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

## Botsonic actions

- POST `bulk-upload-urls` Bulk Upload URLs
- POST `create-bot` Create Bot
- POST `create-faq` Create FAQ
- POST `create-starter-question` Create Starter Question
- DELETE `delete-bot` Delete Bot
- DELETE `delete-bot-data` Delete Bot Data
- DELETE `delete-faq` Delete FAQ
- DELETE `delete-starter-question` Delete Starter Question
- PUT `end-chat` End Chat
- POST `generate-business-response` Generate Business Response
- POST `generate-response` Generate Response
- GET `get-bot` Get Bot
- GET `get-bot-api-key` Get Bot API Key
- GET `get-conversation` Get Conversation
- GET `list-bot-data` List Bot Data
- GET `list-bots` List Bots
- GET `list-conversations` List Conversations
- GET `list-faqs` List FAQs
- GET `list-starter-presets` List Starter Presets
- GET `list-starter-questions` List Starter Questions
- PUT `update-starter-question` Update Starter Question
- POST `upload-file` Upload File
- POST `upload-text` Upload Text