# KnowledgeOwl API Documentation

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

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

## KnowledgeOwl actions

- POST `create-article` Create Article
- POST `create-category` Create Category
- POST `create-file` Create File
- POST `create-reader` Create Reader
- POST `create-tag` Create Tag
- POST `create-webhook-subscription` Create Webhook Subscription
- DELETE `delete-article` Delete Article
- DELETE `delete-category` Delete Category
- DELETE `delete-file` Delete File
- DELETE `delete-reader` Delete Reader
- DELETE `delete-tag` Delete Tag
- DELETE `delete-webhook-subscription` Delete Webhook Subscription
- GET `get-article` Get Article
- GET `get-category` Get Category
- GET `get-file` Get File
- GET `get-reader` Get Reader
- GET `get-tag` Get Tag
- GET `get-webhook-subscription` Get Webhook Subscription
- GET `list-articles` List Articles
- GET `list-categories` List Categories
- GET `list-files` List Files
- GET `list-readers` List Readers
- GET `list-tags` List Tags
- GET `list-webhook-subscriptions` List Webhook Subscriptions
- PUT `replace-file-contents` Replace File Contents
- PUT `update-article` Update Article
- PUT `update-category` Update Category
- PUT `update-file` Update File
- PUT `update-reader` Update Reader
- PUT `update-tag` Update Tag
- PUT `update-webhook-subscription` Update Webhook Subscription