---
title: "Add / remove users to role"
method: POST
path: "/v1/roles/{roleId}/users"
tags: ["Roles"]
---

# Add / remove users to role

`POST /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`

## Parameters

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

## Request body

- object
  - `userIdsToAdd` Id[] (unresolved $ref)
  - `userIdsToRemove` Id[] (unresolved $ref)

## Response `204`

Users added / removed from role successfully

## 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)