# Antfly Cluster Management API

**Canonical:** https://apis.io/apis/antfly/antfly-cluster-management-api/  
**Provider:** Antfly — https://apis.io/providers/antfly/  
**Base URL:** https://api.antfly.io  
**Documentation:** https://antfly.io/docs/api

Antfly Cluster Management API is one of 20 APIs that [Antfly](https://apis.io/providers/antfly/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include cluster_management. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Monitor and manage your Antfly cluster's health and status. ## Cluster Health The cluster health endpoint provides real-time status of all stores and shards: - **healthy**: All nodes and shards operational - **degraded**: Some shards unavailable but cluster functional - **unhealthy**: Critical failures affecting availability - **error**: Cluster-wide failures ## Monitoring - Health check endpoint: `GET /healthz` - Prometheus metrics: `GET /metrics` on port 4200 Use these endpoints to integrate with monitoring systems and alerting infrastructure.

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| GET | `/db/v1/status` | Get cluster status |
| GET | `/db/v1/cluster` | Get cluster topology |
| GET | `/db/v1/connections` | List configured external connections |
| POST | `/db/v1/connections/{connection_id}/inference/{operation}` | Invoke an Antfly-compatible inference connection |
| GET | `/db/v1/secrets` | List secrets status |
| PUT | `/db/v1/secrets/{key}` | Store a secret |
| DELETE | `/db/v1/secrets/{key}` | Delete a secret |
| POST | `/db/v1/backup` | Backup all tables or selected tables |
| POST | `/db/v1/restore` | Restore multiple tables from a backup |
| GET | `/db/v1/restore/jobs` | List durable restore jobs |
| GET | `/db/v1/restore/jobs/{job_id}` | Get durable restore job status |
| DELETE | `/db/v1/restore/jobs/{job_id}` | Request cooperative restore cancellation |
| GET | `/db/v1/backups` | List available backups |
| POST | `/db/v1/settings` | Publish or remove a durable SQL setting |
| POST | `/db/v1/store-roots/enroll` | Approve a physical store-root signing identity |
| POST | `/db/v1/store-roots/enrollment-status` | Check one exact physical store-root enrollment |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/antfly/openapi/antfly-cluster-management-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/antfly/json-schema/antfly-memory-recall-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/antfly/json-schema/antfly-memory-inspection-schema.json
- **JSONSchema** — https://artifacts.apis.io/antfly/json-schema/antfly-memory-record-page-schema.json
- **JSONSchema** — https://artifacts.apis.io/antfly/json-schema/antfly-memory-record-schema.json
- **JSONSchema** — https://artifacts.apis.io/antfly/json-schema/antfly-memory-relationship-proposal-schema.json
- **JSONSchema** — https://artifacts.apis.io/antfly/json-schema/antfly-inference-generate-request-schema.json

## Other Antfly APIs (12)

- [Antfly AI API](https://apis.io/apis/antfly/antfly-ai-api/)
- [Antfly Data Operations API](https://apis.io/apis/antfly/antfly-data-operations-api/)
- [Antfly Documents API](https://apis.io/apis/antfly/antfly-documents-api/)
- [Antfly Index Management API](https://apis.io/apis/antfly/antfly-index-management-api/)
- [Antfly Inference API](https://apis.io/apis/antfly/antfly-inference-api/)
- [Antfly Installed API](https://apis.io/apis/antfly/antfly-installed-api/)
- [Antfly Memory API](https://apis.io/apis/antfly/antfly-memory-api/)
- [Antfly Ml API](https://apis.io/apis/antfly/antfly-ml-api/)
- [Antfly Models API](https://apis.io/apis/antfly/antfly-models-api/)
- [Antfly Packages API](https://apis.io/apis/antfly/antfly-packages-api/)
- [Antfly Permission API](https://apis.io/apis/antfly/antfly-permission-api/)
- [Antfly Personal Connections API](https://apis.io/apis/antfly/antfly-personal-connections-api/)

## Tags

cluster_management

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/antfly/antfly-cluster-management-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/antfly/.