# Chatling API Documentation

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

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

## Chatling actions

- GET `chat-with-knowledge-base-ai` Chat With Knowledge Base AI
- POST `create-contact` Create Contact
- POST `duplicate-chatbot` Duplicate Chatbot
- GET `get-ai-credits-usage` Get AI Credits Usage
- GET `get-chatbots-usage` Get Chatbots Usage
- GET `get-email-credits-usage` Get Email Credits Usage
- GET `get-knowledge-base-usage` Get Knowledge Base Usage
- GET `get-user-seats-usage` Get User Seats Usage
- GET `list-ai-languages` List AI Languages
- GET `list-ai-models` List AI Models
- GET `list-chatbot-templates` List Chatbot Templates
- GET `list-chatbots` List Chatbots
- GET `list-contacts` List Contacts
- GET `list-conversation-messages` List Conversation Messages
- GET `list-conversations` List Conversations
- GET `list-settings` List Settings
- PUT `rate-ai-answer` Rate AI Answer
- GET `retrieve-chatbot` Retrieve Chatbot
- GET `retrieve-contact` Retrieve Contact
- GET `retrieve-conversation` Retrieve Conversation
- PUT `update-chatbot-settings` Update Chatbot Settings
- PUT `update-conversation` Update Conversation
- PUT `update-settings` Update Settings