---
title: "Changes to Update the role of a User or a Group on an Organization"
method: PATCH
path: "/orgs/{orgId}/users/{userId}"
---

# Changes to Update the role of a User or a Group on an Organization

`PATCH /orgs/{orgId}/users/{userId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 9 revisions.

- **2025-06-21** `4db6186594e3`: 2 breaking, 1 warning, 3 info

## Changes

- **2025-06-21** `4db6186594e3`: 2 breaking, 1 warning, 3 info
  - added the pattern `^[a-z0-9](?:-?[a-z0-9]+)+$` to the `path` request parameter `userId`
  - the request property `role` became required
  - removed the optional property `user` from the response with the `200` status
  - added the media type `application/json` for the response with the status `404`
  - added the non-success response with the status `403`
  - added the optional property `idp_id` to the response with the `200` status

---

[Operation](https://skmtc.dev/humanitec/apis/humanitec-api/docs/orgs/:orgId/users/:userId/patch.md) - [API](https://skmtc.dev/humanitec/apis/humanitec-api.md) - [Page](https://skmtc.dev/humanitec/apis/humanitec-api/changes/orgs/:orgId/users/:userId/patch)