# Cloud BOT API Documentation

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

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

## Cloud BOT actions

- POST `create-bot-subscription` Create Bot Subscription
- DELETE `delete-bot-subscription` Delete Bot Subscription
- GET `export-bot-definition` Export Bot Definition
- GET `get-bot-details` Get Bot Details
- GET `get-job` Get Job
- GET `issue-ws-token` Issue WS Token
- GET `list-bot-jobs` List Bot Jobs
- GET `list-bot-subscriptions` List Bot Subscriptions
- GET `list-bots` List Bots
- GET `list-contracts` List Contracts
- POST `run-bot` Run Bot
- DELETE `suspend-job` Suspend Job