> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Documentation for the ClickHouse Keeper HTTP API and embedded dashboard

# Keeper HTTP API and Dashboard

ClickHouse Keeper provides an HTTP API and embedded web dashboard for monitoring, health checks, and storage management.
This interface allows operators to inspect cluster status, execute commands, and manage Keeper storage through a web browser or HTTP clients.

<h2 id="configuration">
  Configuration
</h2>

To enable the HTTP API, add the `http_control` section to your `keeper_server` configuration:

```xml theme={null}
<keeper_server>
    <!-- Other keeper_server configuration -->

    <http_control>
        <port>9182</port>
        <!-- <secure_port>9443</secure_port> -->
    </http_control>
</keeper_server>
```

<h3 id="configuration-options">
  Configuration Options
</h3>

| Setting                                   | Default  | Description                                |
| ----------------------------------------- | -------- | ------------------------------------------ |
| `http_control.port`                       | -        | HTTP port for dashboard and API            |
| `http_control.secure_port`                | -        | HTTPS port (requires SSL configuration)    |
| `http_control.readiness.endpoint`         | `/ready` | Custom path for the readiness probe        |
| `http_control.storage.session_timeout_ms` | `30000`  | Session timeout for storage API operations |

<h2 id="endpoints">
  Endpoints
</h2>

<h3 id="dashboard">
  Dashboard
</h3>

* **Path**: `/dashboard`
* **Method**: GET
* **Description**: Serves an embedded web dashboard for monitoring and managing Keeper

The dashboard provides:

* Real-time cluster status visualization
* Node monitoring (role, latency, connections)
* Storage browser
* Command execution interface

<h3 id="readiness-probe">
  Readiness Probe
</h3>

* **Path**: `/ready` (configurable)
* **Method**: GET
* **Description**: Health check endpoint

Success response (HTTP 200):

```json theme={null}
{
  "status": "ok",
  "details": {
    "role": "leader",
    "hasLeader": true
  }
}
```

<h3 id="commands-api">
  Commands API
</h3>

* **Path**: `/api/v1/commands/{command}`
* **Methods**: GET, POST
* **Description**: Executes Four-Letter Word commands or ClickHouse Keeper Client CLI commands

Query parameters:

* `command` - The command to execute
* `cwd` - Current working directory for path-based commands (default: `/`)

Examples:

```bash theme={null}
# Four-Letter Word command
curl http://localhost:9182/api/v1/commands/stat

# ZooKeeper CLI command
curl "http://localhost:9182/api/v1/commands/ls?command=ls%20'/'&cwd=/"
```

<h3 id="storage-api">
  Storage API
</h3>

* **Base Path**: `/api/v1/storage`
* **Description**: REST API for Keeper storage operations

The Storage API follows REST conventions where HTTP methods indicate the operation type:

| Operation | Path                                   | Method | Status Code | Description          |
| --------- | -------------------------------------- | ------ | ----------- | -------------------- |
| Get       | `/api/v1/storage/{path}`               | GET    | 200         | Get node data        |
| List      | `/api/v1/storage/{path}?children=true` | GET    | 200         | List child nodes     |
| Exists    | `/api/v1/storage/{path}`               | HEAD   | 200         | Check if node exists |
| Create    | `/api/v1/storage/{path}`               | POST   | 201         | Create new node      |
| Update    | `/api/v1/storage/{path}?version={v}`   | PUT    | 200         | Update node data     |
| Delete    | `/api/v1/storage/{path}?version={v}`   | DELETE | 204         | Delete node          |