---
title: "Get cluster's members"
method: GET
path: "/clusters/{clusterId}/members"
tags: ["Clusters"]
---

# Get cluster's members

`GET /clusters/{clusterId}/members`

## Request

- Base URL: `/management/v2/environments/DEFAULT` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/management/v2/environments/DEFAULT/clusters/{clusterId}/members`
- Auth: one of:
  - HTTP basic
  - API key in cookie `Auth-Graviteeio-APIM`

User must have the CLUSTER_MEMBER[READ] permission.

## Response `200`

Page of members

- object
  - `data` Member[]: List of members.
    - `id` string: Member's uuid.
    - `displayName` string: Member's name.
    - `roles` Role[]: The list of roles for this Member.
      - `name` string: Role's name.
      - `scope` 'API' | 'APPLICATION' | 'GROUP' | 'ENVIRONMENT' | 'ORGANIZATION' | 'PLATFORM' | 'INTEGRATION' | 'CLUSTER' | 'API_PRODUCT' | 'AI_CATALOG' | 'EXPLORER' | 'AI_WORKSPACE': Scope of a role.
  - `links` Links: List of links for pagination
    - `self` string: Link to current resource
    - `first` string: In a paginated response, link to the first page
    - `last` string: In a paginated response, link to the last page
    - `previous` string: In a paginated response, link to the previous page. Maybe null if current is the first page
    - `next` string: In a paginated response, link to the next page. Maybe null if current is the last page
  - `metadata` ResponseMetadata: Generic object to handle additional information about an entity. Can also be used for pagination data.
  - `pagination` Pagination: Generic object to handle pagination data.
    - `page` integer: The current page.
    - `perPage` integer: The number of items requested per page.
    - `pageCount` integer: The total number of pages.
    - `pageItemsCount` integer: The number of items for the current page.
    - `totalCount` integer: The total number of items, or `-1` if the count could not be computed within the configured timeout.

## Other responses

- `default`: Generic error response

## Changes

- **2026-07-29** `85691063daf3`: 1 warning
  - added the new `AI_WORKSPACE` enum value to the `data/items/roles/items/scope` response property for the response status `200`
- **2026-07-21** `9ca54e4978f6`: 1 warning
  - added the new `EXPLORER` enum value to the `data/items/roles/items/scope` response property for the response status `200`
- **2026-06-23** `3da0ac8a4f72`: 1 warning, 1 info
  - added the new `AI_CATALOG` enum value to the `data/items/roles/items/scope` response property for the response status `200`
  - removed the `CATALOG` enum value from the `data/items/roles/items/scope` response property for the response status `200`
- **2026-06-22** `760aad84364f`: 1 warning
  - added the new `CATALOG` enum value to the `data/items/roles/items/scope` response property for the response status `200`
- **2026-01-26** `39e3ff2bd9d5`: 1 warning
  - added the new `API_PRODUCT` enum value to the `data/items/roles/items/scope` response property for the response status `200`

[Operation history](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/changes/clusters/:clusterId/members/get.md)

---

[API](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments.md) - [All operations](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/llms.txt) - [OpenAPI document](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/revisions/b736a7e375df?raw)