---
title: "GET /v2/GetClusterLayoutHistory"
method: GET
path: "/v2/GetClusterLayoutHistory"
tags: ["Cluster layout"]
---

# GET /v2/GetClusterLayoutHistory

`GET /v2/GetClusterLayoutHistory`

Returns the history of layouts in the cluster

## Response `200`

Cluster layout history

- GetClusterLayoutHistoryResponse
  - `currentVersion` integer, required — The current version number of the cluster layout
  - `minAck` integer, required — All nodes in the cluster are aware of layout versions up to this version number (at least)
  - `updateTrackers` object, nullable — Detailed update trackers for nodes (see `https://garagehq.deuxfleurs.fr/blog/2023-12-preserving-read-after-write-consistency/`)
  - `versions` ClusterLayoutVersion[], required — Layout version history
    - `gatewayNodes` integer, required — Number of nodes with a gateway role in this layout version
    - `status` 'Current' | 'Draining' | 'Historical', required
    - `storageNodes` integer, required — Number of nodes with an assigned storage capacity in this layout version
    - `version` integer, required — Version number of this layout version

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.dev/deuxfleurs/apis/garage-administration-api.md) · [All operations](https://skmtc.dev/deuxfleurs/apis/garage-administration-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deuxfleurs/garage-administration-api/revisions/07ffb2d0febb/schema)