---
title: "Set User Role"
method: PATCH
path: "/manage/set-user-role"
tags: ["public"]
---

# Set User Role

`PATCH /manage/set-user-role`

## Request body

- UserRoleUpdateRequest
  - `user_email` string, required
  - `new_role` 'limited' | 'basic' | 'admin' | 'curator' | 'global_curator' | 'slack_user' | 'ext_perm_user', required — User roles - Basic can't perform any admin actions - Admin can perform all admin actions - Curator can perform admin actions for groups they are curators of - Global Curator can perform admin actions for all groups they are a member of - Limited can access a limited set of basic api endpoints - Slack are users that have used onyx via slack but dont have a web login - External permissioned users that have been picked up during the external permissions sync process but don't have a web login
  - `explicit_override` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

> 13 revisions in range; 9 could not be searched.

- **2025-08-21** `9321c45d93b5` — 1 info
  - api tag `public` removed

[Change history](https://skmtc.dev/onyx-dot-app/apis/onyx-api/changes/manage/set-user-role/patch.md)

---

[API](https://skmtc.dev/onyx-dot-app/apis/onyx-api.md) · [All operations](https://skmtc.dev/onyx-dot-app/apis/onyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/onyx-dot-app/onyx-api/revisions/2980a9073ffe/schema)