---
title: "Create a role for a prebuilt entity in a version of the application."
method: POST
path: "/apps/{appId}/versions/{versionId}/prebuilts/{entityId}/roles"
---

# Create a role for a prebuilt entity in a version of the application.

`POST /apps/{appId}/versions/{versionId}/prebuilts/{entityId}/roles`

## Request

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

## Path parameters

- `appId` string, uuid, required
- `versionId` string, required
- `entityId` string, uuid, required

## Request body

- EntityRoleCreateObject: Object model for creating an entity role.
  - `name` string: The entity role name.

## Response `201`

The ID of the created entity role

- string, uuid: The ID (GUID) returned by an operation.

## 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)