# Insighto.ai API Documentation

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

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

## Insighto.ai actions

- PUT `add-datasource-to-assistant` Add Datasource To Assistant
- PUT `add-datasource-file` Add Datasourcefile
- PUT `add-datasource-text-blob` Add Datasourcefile Text Blob
- PUT `add-intent-to-assistant` Add Intent To Assistant
- POST `create-assistant` Create Assistant
- POST `create-data-source` Create Data Source
- POST `create-intent` Create Intent
- POST `create-widget` Create Widget
- DELETE `delete-assistant-by-id` Delete Assistant By Id
- DELETE `delete-datasource-by-id` Delete Datasource By Id
- DELETE `delete-widget-by-id` Delete Widget By Id
- GET `get-assistant-by-id` Get Assistant By Id
- GET `get-contact-by-id` Get Contact By Id
- GET `get-conversation-by-id` Get Conversation By Id
- GET `get-datasource-by-id` Get Datasource By Id
- GET `get-intent-by-id` Get Intent By Id
- GET `list-conversations-by-contact-id` Get List Of Conversations By Contact Id
- GET `get-conversation-transcript` Get Transcript Of A Conversation
- GET `get-widget-by-id` Get Widget By Id
- GET `list-assistants` List Assistants
- GET `list-contacts` List Contacts
- GET `list-conversations` List Conversations
- GET `list-data-source-files-by-datasource-id` List Data Source Files For Data Source Id
- GET `list-data-sources` List Data Sources
- GET `list-intents` List Intents
- GET `list-widgets` List Widgets
- PUT `update-assistant-by-id` Update Assistant By Id
- PUT `update-contact-by-id` Update Contact By Id
- PUT `update-widget-by-id` Update Widget By Id
- POST `upsert-contact-by-email-or-phone-number` Upsert Contact By Email Or Phone Number