---
title: createRole
slug: /main-concepts/metadata-standard/schemas/api/teams/createrole
---

# CreateRoleRequest

*Request for creating a Role entity*

## Properties

- **`name`**: Refer to *../../entity/teams/role.json#/definitions/roleName*.
- **`displayName`** *(string)*: Optional name used for display purposes. Example 'Data Consumer'.
- **`description`**: Optional description of the role. Refer to *../../type/basic.json#/definitions/markdown*.
- **`policies`**: Policies that is attached to this role. At least one policy is required. Refer to *../../type/entityReference.json#/definitions/entityReferenceList*.


Documentation file automatically generated at 2022-07-14 10:51:34.749986.