---
title: "How many users hold this role"
method: GET
path: "/api/roles/{role_id}/holders"
tags: ["Permissions"]
---

# How many users hold this role

`GET /api/roles/{role_id}/holders`

The blast radius of a role edit, as one number.

Exists so the confirmation dialog can say WHO it affects instead of "all
holders". The frontend cannot compute this: the only role-assignment field it
receives is `Z_Users.idrole` (8 rows on the test clone), while the real answer
comes mostly from `Z_UserRoles` (210) — counting client-side would understate
a 142-user role as 1 and make the warning worse than useless.

## Path parameters

- `role_id` integer, required

## Headers

- `x-api-token` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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