# BotStar API Documentation

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

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

## BotStar actions

- POST `create-bot` Create Bot
- POST `create-bot-attribute` Create Bot Attribute
- POST `create-cms-entity` Create CMS Entity
- POST `create-cms-entity-fields` Create CMS Entity Fields
- POST `create-cms-entity-item` Create CMS Entity Item
- POST `create-user-attribute` Create User Attribute
- DELETE `delete-bot-attribute` Delete Bot Attribute
- DELETE `delete-cms-entity` Delete CMS Entity
- DELETE `delete-cms-entity-fields` Delete CMS Entity Fields
- DELETE `delete-cms-entity-item` Delete CMS Entity Item
- GET `get-bot` Get Bot
- GET `get-cms-entity` Get CMS Entity
- GET `get-cms-entity-item` Get CMS Entity Item
- GET `get-user-info` Get User Info
- GET `list-bot-attributes` List Bot Attributes
- GET `list-bots` List Bots
- GET `list-cms-entities` List CMS Entities
- GET `list-cms-entity-items` List CMS Entity Items
- PUT `publish-bot` Publish Bot
- PUT `update-bot-attribute` Update Bot Attribute
- PUT `update-cms-entity` Update CMS Entity
- PUT `update-cms-entity-fields` Update CMS Entity Fields
- PUT `update-cms-entity-item` Update CMS Entity Item
- PUT `update-user-attributes` Update User Attributes