---
title: "Changes to Adds a User or a Group to an Application with a Role"
method: POST
path: "/orgs/{orgId}/apps/{appId}/users"
---

# Changes to Adds a User or a Group to an Application with a Role

`POST /orgs/{orgId}/apps/{appId}/users`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 9 revisions.

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

## Changes

- **2025-06-21** `4db6186594e3`: 4 breaking, 8 warning, 3 info
  - added the pattern `^[a-z0-9](?:-?[a-z0-9]+)+$` to the `path` request parameter `appId`
  - the request property `id` became required
  - the request property `role` became required
  - added the pattern `^[a-z0-9](?:-?[a-z0-9]+)+$` to the request property `id`
  - for the `path` request parameter `appId`, the maxLength was set to `50`
  - removed the request property `created_at`
  - removed the request property `email`
  - removed the request property `invite`
  - removed the request property `name`
  - removed the request property `type`
  - removed the request property `user`
  - 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/apps/:appId/users/post.md) - [API](https://skmtc.dev/humanitec/apis/humanitec-api.md) - [Page](https://skmtc.dev/humanitec/apis/humanitec-api/changes/orgs/:orgId/apps/:appId/users/post)