# 2Smart Cloud API Documentation

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

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

## 2Smart Cloud actions

- POST `create-favorite-widgets` Add favorite widget
- POST `create-selected-widgets` Add selected widget
- POST `create-slack-webhooks` Add slack webhook
- POST `create-telegram-chat-ids` Add telegram chat_id
- POST `create-whatsapp-chat-ids` Add WhatsApp chat_id
- GET `get-admin-aggregated-value` Aggregated value for topic
- GET `get-share-v1-aggregated-value` Aggregated value for topic
- GET `list-public-schemas` All products (in production status) schemas
- GET `list-schemas` All products (in production status) schemas
- POST `create-schemas-versions` All products (in production status) schemas
- GET `list-schemas-versions` All products (in production status) schemas
- POST `create-share-v1-schema-versions` All products (in production status) schemas
- GET `list-public-schemas-versions` All products (in production status) schemas with each major latest versions
- POST `create-public-schemas-versions` All products (in production status) schemas with each major latest versions
- GET `list-share-v1-references` All references
- GET `list-public-references` All references
- GET `list-references` All references
- GET `get-admin-products-approve` Approve products
- GET `get-vendor-products-approve` Approve products
- DELETE `archive-vendor-firmwares-by-id-archive` Archive firmware
- DELETE `archive-vendor-products-by-id-archive` Archive product
- DELETE `archive-vendor-layouts-by-id-archive` Archive/Unarchive dashboard
- DELETE `archive-vendor-dashboards-by-id-archive` Archive/Unarchive layout
- GET `get-vendor-statistics-bar` Bar statistics
- POST `create-vendor-binaries-mock` Binary mock upload
- POST `create-vendor-binaries` Binary upload
- POST `create-vendor-builds` Build upload
- POST `create-favorite-widget-groups-bulk-add` Bulk add favorite widgets to groups
- POST `create-favorite-widgets-bulk-delete` Bulk delete favorite widgets
- POST `create-shared-devices-bulk-delete` Bulk Delete shared device
- POST `create-share-link-devices-bulk-delete` Bulk Delete shared device
- PUT `bulk-update-favorite-widget-groups-bulk-update` Bulk update favorite widgets groups positions
- PUT `bulk-update-vendor-locales-bulk-update` Bulk Update locales
- POST `create-users-change-password` Change password mobile user
- POST `create-devices-by-device-id-check-biometric` Check if there is biometric keys for this device
- GET `list-users-check-biometric` Check if user has biometric key
- PUT `check-phone-triggers-by-id-check` Check phone trigger
- POST `create-vendor-check-reset-password-token` Check reset vendor password token
- POST `create-users-clear-phone-number` Clear phone number of mobile user
- GET `get-admin-products-clear-abbreviations` Clear products abbreviations
- POST `create-vendor-api-tokens` Create api token
- POST `create-vendor-build-parts` Create build part
- POST `create-vendor-dashboards` Create dashboard
- POST `create-devices-by-device-id-credentials` Create favorite widget group
- POST `create-favorite-widget-groups` Create favorite widget group
- POST `create-vendor-firmwares` Create firmware
- POST `create-vendor-firmware-builds` Create firmware build
- POST `create-vendor-firmware-changelogs` Create firmware changelog
- POST `create-shares-invite` Create invite share
- POST `create-vendor-layouts` Create layout
- POST `create-vendor-market-events` Create market event
- POST `create-market-events` Create market event
- POST `create-vendor-pairing-config` Create pairing config
- POST `create-phone-numbers-bulk` Create phone number
- POST `create-phone-numbers` Create phone number
- POST `create-phone-triggers` Create phone trigger
- POST `create-vendor-products` Create Product
- POST `create-products` Create Product
- POST `create-shares` Create share
- POST `create-share-links` Create share link
- DELETE `delete-vendor-api-tokens-by-id-delete` Delete api token
- POST `create-users-delete-biometric` Delete biometric key for device
- DELETE `delete-vendor-build-parts-by-id-delete` Delete build part
- DELETE `delete-vendor-dashboards-by-id-delete` Delete dashboard
- PUT `update-favorite-widgets-by-id` Delete favorite widget
- DELETE `delete-favorite-widget-groups-by-id-delete` Delete favorite widget group
- DELETE `delete-vendor-firmwares-by-id-delete` Delete firmware
- DELETE `delete-vendor-firmware-builds-by-id-delete` Delete firmware build
- DELETE `delete-vendor-firmware-changelogs-by-id-delete` Delete firmware changelog
- DELETE `delete-vendor-layouts-by-id-delete` Delete layout
- POST `delete-mobile-user` Delete mobile user
- DELETE `delete-notification-records-by-id-delete` Delete notification record
- DELETE `delete-vendor-notification-records-by-id-delete` Delete notification record
- DELETE `delete-vendor-pairing-config-by-id-delete` Delete pairing config
- DELETE `delete-phone-numbers-by-id-delete` Delete phone number
- DELETE `delete-phone-triggers-by-id-delete` Delete phone trigger
- DELETE `delete-vendor-products-by-id-delete` Delete product
- GET `get-admin-products-delete` Delete products
- DELETE `delete-vendor-sensors-info-delete` Delete sensor info
- DELETE `delete-shares-by-id-delete` Delete share
- DELETE `delete-share-links-by-id-delete` Delete share link
- DELETE `delete-shared-devices-by-id-delete` Delete shared device
- DELETE `delete-share-link-devices-by-id-delete` Delete shared device
- DELETE `delete-slack-webhooks-by-id-delete` Delete slack webhook
- DELETE `delete-telegram-chat-ids-by-id-delete` Delete telegram chat id
- DELETE `delete-whatsapp-chat-ids-by-id-delete` Delete WhatsApp chat id
- PUT `discard-draft-vendor-products-by-id-discard-draft` Discard product draft
- PUT `duplicate-vendor-product-versions-by-id-duplicate` Duplicate product version
- POST `create-vendors-files` File upload
- POST `create-vendor-files` File upload
- GET `list-csrf-token` Get CSRF Token
- GET `list-favorite-widget-groups` Get favorite widgets groups list
- GET `list-favorite-widgets` Get favorite widgets list
- GET `list-market` Get market products list
- GET `get-users-mqtt` Get mqtt credentials for user
- POST `create-mqtt-tokens` Get mqtt credentials for user
- GET `list-market-devices` Get products list for devices
- GET `list-selected-widgets` Get selected widgets list
- GET `list-slack-webhooks` Get slack webhooks list
- GET `list-telegram-chat-ids` Get telegram chat ids list
- GET `get-vendor-profile` Get vendor info
- POST `create-vendors-profile` Get vendor info
- GET `list-whatsapp-chat-ids` Get WhatsApp chat ids list
- GET `get-admin-products-hide` Hide products
- POST `create-vendor-link-mobile` Link vendor account to mobile
- GET `list-vendor-api-tokens` List api tokens
- GET `list-vendor-dashboards` List dashboards
- GET `list-admin-devices` List devices
- GET `list-vendor-firmware-builds` List firware builds
- GET `list-vendor-firmware-changelogs` List firware changelogs
- GET `list-vendor-firmwares` List firwares
- GET `list-layouts` List layouts
- GET `list-vendor-layouts` List layouts
- GET `list-vendor-locales` List locales
- GET `list-notification-records` List notification record
- GET `list-vendor-notification-records` List notification record
- GET `get-vendor-products-abbreviations` List of product abbreviations
- GET `list-product-versions` List of product versions
- GET `list-phone-numbers` List phone trigger
- GET `list-phone-triggers` List phone trigger
- GET `get-vendor-products-lite` List products
- GET `list-vendor-products` List products
- GET `list-admin-products` List products
- GET `list-products` List products
- GET `list-vendor-product-versions` List products
- GET `get-vendor-product-versions-major` List products versions major
- GET `list-vendor-sensors-info` List sensors info
- GET `list-shares-topics` List share
- GET `list-share-links` List share links
- GET `get-share-v1-timelines-number` List share timelines number
- GET `get-share-v1-timelines-string` List share timelines string
- GET `list-shared-devices` List shared devices
- GET `list-share-link-devices` List shared devices
- GET `list-shares` List shares
- GET `list-vendor-statistics` List statistics
- GET `get-vendor-statistics-intervals` List statistics intervals
- GET `list-vendor-statistics-version-intervals` List statistics intervals
- GET `get-vendor-statistics-versions` List statistics versions
- GET `get-timelines-aggregated-value` List timelines
- GET `list-vendor-timelines` List timelines
- GET `list-timelines` List timelines
- GET `list-share-v1-timelines` List timelines
- GET `get-timelines-number` List timelines number
- GET `get-vendor-timelines-number` List timelines number
- GET `get-timelines-string` List timelines string
- GET `get-vendor-timelines-string` List timelines string
- POST `create-sessions` Login mobile user
- POST `create-sessions-apple` Login mobile user with Apple
- POST `create-sessions-biometric` Login mobile user with biometric key
- POST `create-sessions-facebook` Login mobile user with Facebook
- POST `create-sessions-google` Login mobile user with Google
- POST `create-vendor-login` Login vendor
- POST `create-vendor-login-apple` Login vendor with Apple
- POST `create-vendor-login-facebook` Login vendor with Facebook
- POST `create-vendor-login-google` Login vendor with Google
- POST `create-vendor-logout` Lougout vendor
- PUT `mark-read-notification-records-mark-read` Mark notification records as read
- PUT `mark-read-vendor-notification-records-mark-read` Mark notification records as read
- GET `get-vendor-statistics-pie` Pie statistics
- GET `get-vendor-statistics-version-progress` Pie statistics
- GET `get-users-profile` Profile mobile user
- PUT `publish-vendor-products-by-id-publish` Publish product
- GET `get-share-v1-references-by-name` Reference be name
- GET `get-references-by-name` Reference be name
- GET `get-public-references-by-name` Reference be name
- GET `get-admin-products-refuse` Refuse products
- GET `get-users-check-exists` Register mobile user
- POST `create-users` Register mobile user
- POST `create-vendor-register` Register vendor
- PUT `rename-favorite-widgets-by-id-rename` Rename favorite widget's title
- POST `create-reported-issues` Report user issue
- POST `create-vendor-reported-issues` Report vendor issue
- POST `create-firmware-builds` Request firmware build link user
- POST `create-vendor-request-platform-demo` Request platform demo
- POST `create-users-request-reset-password` Request vendor reset password
- POST `create-vendor-request-reset-password` Request vendor reset password
- POST `create-users-reset-password` Reset mobile password
- POST `create-vendor-reset-password` Reset vendor password
- POST `create-landing-emails-contact-us` Send `contact us` email
- POST `create-vendor-sensors-info` Sensor info create
- PUT `update-vendor-sensors-info-update` Sensor info update
- PUT `solve-admin-reported-issues-solve-by-id` Set report as solved
- PUT `unsolve-admin-reported-issues-unsolve-by-id` Set report as unsolved
- GET `get-vendor-api-tokens-by-id` Show api token
- GET `get-vendor-dashboards-by-id` Show dashboard
- GET `get-vendor-firmwares-by-id-ap` Show firmware
- GET `get-vendor-firmwares-by-id` Show firmware
- GET `get-vendor-firmware-builds-by-id` Show firmware build
- GET `get-vendor-layouts-by-id` Show layout
- POST `create-vendor-product-by-id-pairing-config` Show layout
- GET `get-vendor-notification-records-by-id` Show notification record
- GET `get-notification-records-by-id` Show notification record
- GET `get-products-by-id` Show product
- GET `get-vendor-products-by-id` Show product
- GET `get-products-by-id-firmware-version` Show product firmware version
- GET `get-public-products-by-id-firmware-version` Show product firmware version
- GET `get-selected-widgets-by-id` Show selected widget
- GET `get-share-links-by-id` Show share link
- GET `get-share-v1-short-link-by-id` Show share-link
- GET `get-share-v1-link` Show share-link
- PUT `stage-vendor-products-by-id-stage` Stage product
- PUT `translate-vendor-translate` Translate widget values
- GET `get-admin-products-unhide` Unhide products
- PUT `unhide-shares-by-id-unhide` Unhide share
- PUT `unstage-vendor-products-by-id-unstage` Unstage product
- PUT `update-vendor-api-tokens-by-id-update` Update api token
- PUT `update-vendor-build-parts-by-id` Update build part
- PUT `factory-vendor-build-parts-by-id-factory` Update build part
- POST `update-changelog-vendor-product-versions-by-id-update-changelog` Update changelogs
- PUT `update-vendor-dashboards-by-id-update` Update dashboard
- PUT `update-favorite-widget-groups-by-id-update` Update favorite widget's group
- PUT `update-vendor-firmwares-by-id-ap-update` Update firmware
- PUT `update-vendor-firmwares-by-id-update` Update firmware
- PUT `update-vendor-firmware-changelogs-by-id-update` Update firmware changelog
- PUT `update-vendor-layouts-by-id-update` Update layout
- PUT `update-layouts-by-id-update` Update layout
- PUT `update-users-update` Update mobile user
- POST `create-users-update-biometric` Update mobile user with biometric
- PUT `update-notification-configs-by-id-update` Update notification config
- PUT `update-notification-records-by-id-update` Update notification record
- PUT `update-vendor-pairing-config-by-id` Update pairing config
- PUT `update-phone-numbers-by-id-update` Update phone trigger
- PUT `update-phone-triggers-by-id-update` Update phone trigger
- PUT `update-vendor-products-by-id-update` Update product
- PUT `update-shares-by-id-update` Update share
- PUT `update-share-links-by-id-update` Update share link
- PUT `update-shared-devices-by-id-update` Update shared device
- PUT `update-share-link-devices-by-id-update` Update shared device
- PUT `update-slack-webhooks-by-id-update` Update slack webhook
- PUT `update-telegram-chat-ids-by-id-update` Update telegram chats's info
- POST `create-vendor-change-password` Update vendor
- PUT `update-vendor-update` Update vendor
- PUT `update-whatsapp-chat-ids-by-id-update` Update WhatsApp chats's info
- POST `create-vendor-survey` User survey
- POST `create-users-validate-reset-password-code` Validate reset password code
- POST `create-shares-verify` Verify share emails
