# Dify API Documentation

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

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

## Dify actions

- PUT `configure-annotation-reply` Configure Annotation Reply
- POST `convert-audio-to-text` Convert Audio to Text
- POST `convert-text-to-audio` Convert Text to Audio
- POST `create-annotation` Create Annotation
- DELETE `delete-annotation` Delete Annotation
- DELETE `delete-conversation` Delete Conversation
- GET `download-file` Download File
- GET `get-annotation-reply-job-status` Get Annotation Reply Job Status
- GET `get-app-info` Get App Info
- GET `get-app-meta` Get App Meta
- GET `get-app-parameters` Get App Parameters
- GET `get-app-webapp-settings` Get App WebApp Settings
- GET `get-end-user-info` Get End User Info
- GET `get-next-suggested-questions` Get Next Suggested Questions
- GET `get-workflow-run-detail` Get Workflow Run Detail
- GET `list-annotations` List Annotations
- GET `list-app-feedbacks` List App Feedbacks
- GET `list-conversation-messages` List Conversation Messages
- GET `list-conversation-variables` List Conversation Variables
- GET `list-conversations` List Conversations
- GET `list-workflow-logs` List Workflow Logs
- PUT `rename-conversation` Rename Conversation
- POST `send-chat-message` Send Chat Message
- PUT `stop-chat-message-generation` Stop Chat Message Generation
- POST `submit-message-feedback` Submit Message Feedback
- PUT `update-annotation` Update Annotation
- PUT `update-conversation-variable` Update Conversation Variable
- POST `upload-file` Upload File