---
title: "List Users"
method: GET
path: "/v1/postgres/{postgres_cluster_id}/users"
tags: ["Postgres Clusters"]
---

# List Users

`GET /v1/postgres/{postgres_cluster_id}/users`

List all Postgres users within a specific cluster.

## Path parameters

- `postgres_cluster_id` string, required

## Response `200`

OK

- ListPostgresUsersResponse
  - `data` PostgresUser[]
    - `role` 'schema_admin' | 'writer' | 'reader' — User role.
    - `username` string — User name.

## Other responses

- `404` — Cluster not found

## Changes

- **2026-08-12** `f54480c4ce7f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/machines/apis/machines-api/changes/v1/postgres/:postgres_cluster_id/users/get.md)

---

[API](https://skmtc.dev/machines/apis/machines-api.md) · [All operations](https://skmtc.dev/machines/apis/machines-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/machines/machines-api/revisions/80746f322f20/schema)