# Grist API Documentation

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

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

## Grist actions

- POST `add-columns` Add Columns
- POST `add-records` Add Records
- POST `add-tables` Add Tables
- POST `create-document` Create Document
- POST `create-webhook` Create Webhook
- DELETE `delete-column` Delete Column
- DELETE `delete-document` Delete Document
- DELETE `delete-records` Delete Records
- DELETE `delete-webhook` Delete Webhook
- GET `get-document` Get Document
- GET `get-organization` Get Organization
- GET `get-workspace` Get Workspace
- GET `list-columns` List Columns
- GET `list-organizations` List Organizations
- GET `list-records` List Records
- GET `list-tables` List Tables
- GET `list-webhooks` List Webhooks
- GET `list-workspaces` List Workspaces
- PUT `replace-columns` Replace Columns
- PUT `replace-records` Replace Records
- GET `run-sql-query` Run SQL Query
- PUT `update-records` Update Records
- PUT `update-tables` Update Tables
- PUT `update-webhook` Update Webhook