---
title: "Get users with the role"
method: GET
path: "/v1/roles/{roleId}/users"
tags: ["Roles"]
---

# Get users with the role

`GET /v1/roles/{roleId}/users`

## Request

- Base URL: `https://api.tetrascience.com`
- URL: `https://api.tetrascience.com/v1/roles/{roleId}/users`
- Auth: API key in header `ts-auth-token` and API key in header `x-org-slug`

## Query parameters

- `search` string
- `status` 'active' | 'inactive' | 'locked'
- `authType` 'password' | 'service'

## Parameters

- `#/paths/~1v1~1roles~1{roleId}/get/parameters/0` (unresolved $ref)
- `#/paths/~1v1~1roles/get/parameters/0` (unresolved $ref)
- `#/paths/~1v1~1roles/get/parameters/1` (unresolved $ref)

## Other responses

- `401`: Invalid token
- `403`: Caller is not authorized to perform this action
- `404`: Role not found

---

[API](https://skmtc.dev/tetrascience/apis/administration.md) - [All operations](https://skmtc.dev/tetrascience/apis/administration/llms.txt) - [OpenAPI document](https://skmtc.dev/tetrascience/apis/administration/revisions/c1c829febcc5?raw)