Skip to main content

Cluster API

Memorose exposes a small operational API for Raft cluster management.

Endpoints​

POST /v1/cluster/initialize​

Initialize the local cluster or all shard groups.

POST /v1/cluster/join​

Join a node.

Request body:

{
  "node_id": 2,
  "address": "127.0.0.1:5002"
}

DELETE /v1/cluster/nodes/:node_id​

Remove a node from the cluster.

Notes​

  • In single-node mode, join and leave operate on the local raft group.
  • In sharded mode, these calls fan out across shard groups.
  • Use the dashboard cluster views for operator-facing status inspection.