---
title: "List cluster features"
method: GET
path: "/cluster-features"
tags: ["Cluster Features"]
---

# List cluster features

`GET /cluster-features`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/cluster-features`
- Auth: API key in header `API-Key`

Returns the catalog of Keycloak feature flags that can be toggled on tenant clusters.

## Headers

- `API-Version` '2026-06-01.beta', required

## Response `200`

The request has succeeded.

- ClusterFeatureInfo[]
  - `name` string, required: Feature flag identifier as used in the `features` and `features_disabled` cluster fields.
  - `display_name` string, required: Human-readable feature name.
  - `description` string, nullable, required: Short description of what the feature does.
  - `preview` boolean, required: Whether this feature is currently in preview and may change.
  - `min_version` string, required: Cluster version in semver format. Check the documentation for the latest supported versions.
  - `max_version` string, required: Cluster version in semver format. Check the documentation for the latest supported versions.

## Other responses

- `401`: Access is unauthorized.
- `429`: Client error
- `500`: Server error
- `501`: Server error

---

[API](https://skmtc.dev/skycloak/apis/skycloak-public-api.md) · [All operations](https://skmtc.dev/skycloak/apis/skycloak-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skycloak/apis/skycloak-public-api/revisions/33a69e2ce35f?raw)