---
title: "Remove a role from the user"
method: DELETE
path: "/users/{userId}/roles"
tags: ["Permissions"]
---

# Remove a role from the user

`DELETE /users/{userId}/roles`

Specify the role ID to remove from the user.

## Request body

- object
  - `role_id` string, uuid, required — Identifier of the organisation role to assign or remove. Roles grant a bundle of permissions across the user's organisation; for per-site permissions use the `site-roles` endpoint instead.

## Response `204`

The role was successfully removed.

## Other responses

- `401` — The user is unauthenticated
- `403` — The authenticated user does not have permission.
- `404` — The resource couldn't be found
- `422` — The request didn't pass validation

---

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