# Cradl AI API Documentation

This is the complete API documentation for connecting to the Cradl 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 **Cradl 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/cradlAI/actions/{actionSlug}/run
```

## Cradl AI actions

- POST `create-agent` Create Agent
- POST `create-agent-run` Create Agent Run
- POST `create-document` Create Document
- POST `create-function` Create Function
- POST `create-hook` Create Hook
- DELETE `delete-agent` Delete Agent
- DELETE `delete-agent-run` Delete Agent Run
- DELETE `delete-document` Delete Document
- DELETE `delete-function` Delete Function
- DELETE `delete-hook` Delete Hook
- GET `get-agent` Get Agent
- GET `get-agent-run` Get Agent Run
- GET `get-document` Get Document
- GET `get-function` Get Function
- GET `get-hook` Get Hook
- GET `list-agent-runs` List Agent Runs
- GET `list-agents` List Agents
- GET `list-documents` List Documents
- GET `list-functions` List Functions
- GET `list-hooks` List Hooks
- PUT `update-agent` Update Agent
- PUT `update-agent-run` Update Agent Run
- PUT `update-document` Update Document
- PUT `update-function` Update Function
- PUT `update-hook` Update Hook