# Twist API Documentation

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

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

## Twist actions

- PUT `archive-channel` Archive Channel
- POST `create-channel` Create Channel
- POST `create-comment` Create Comment
- POST `create-message` Create Message
- POST `create-thread` Create Thread
- GET `get-channel` Get Channel
- GET `get-current-user` Get Current User
- GET `get-default-workspace` Get Default Workspace
- POST `get-or-create-conversation` Get or Create Conversation
- GET `get-thread` Get Thread
- GET `get-workspace` Get Workspace
- GET `list-channels` List Channels
- GET `list-comments` List Comments
- GET `list-conversations` List Conversations
- GET `list-messages` List Messages
- GET `list-threads` List Threads
- GET `list-unread-threads` List Unread Threads
- GET `list-workspaces` List Workspaces
- PUT `mark-thread-as-read` Mark Thread as Read
- PUT `move-thread-to-channel` Move Thread to Channel
- GET `search-content` Search Content
- PUT `update-channel` Update Channel
- PUT `update-thread` Update Thread
- POST `upload-attachment` Upload Attachment