# AgentX API Documentation

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

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

## AgentX actions

- PUT `add-conversation-context` Add Conversation Context
- POST `create-conversation` Create Conversation
- GET `get-agent-detail` Get Agent Detail
- GET `get-conversation-detail` Get Conversation Detail
- GET `get-user-profile` Get User Profile
- GET `list-agents` List Agents
- GET `list-agents-as-object` List Agents As Object
- GET `list-conversations` List Conversations
- DELETE `reset-conversation-context` Reset Conversation Context
- POST `send-message` Send Message
- POST `send-message-sse` Send Message SSE
- POST `send-message-sse-with-stream` Send Message SSE With Stream
- POST `send-message-with-attachment` Send Message With Attachment
- PUT `vote-on-message` Vote On Message