---
title: "Update a role for a given hierarchical entity in a version of the application."
method: PUT
path: "/apps/{appId}/versions/{versionId}/hierarchicalentities/{hEntityId}/roles/{roleId}"
---

# Update a role for a given hierarchical entity in a version of the application.

`PUT /apps/{appId}/versions/{versionId}/hierarchicalentities/{hEntityId}/roles/{roleId}`

## Request

- Base URL: `{Endpoint}/luis/authoring/v3.0-preview`
- URL: `{Endpoint}/luis/authoring/v3.0-preview/apps/{appId}/versions/{versionId}/hierarchicalentities/{hEntityId}/roles/{roleId}`
- Auth: API key in header `Ocp-Apim-Subscription-Key`

## Path parameters

- `appId` string, uuid, required
- `versionId` string, required
- `hEntityId` string, uuid, required
- `roleId` string, uuid, required

## Request body

- EntityRoleUpdateObject: Object model for updating an entity role.
  - `name` string: The entity role name.

## Response `200`

Successfully updated the entity role.

- OperationStatus: Response of an Operation status.
  - `code` 'Failed' | 'FAILED' | 'Success': Status Code.
  - `message` string: Status details.

## Other responses

- `default`: Error Response.

---

[API](https://skmtc.dev/azure/apis/luis-authoring-client.md) - [All operations](https://skmtc.dev/azure/apis/luis-authoring-client/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/luis-authoring-client/revisions/a26a0f7e5a37?raw)