OpenMetadata/openmetadata-docs/content/v1.7.x/main-concepts/metadata-standard/schemas/api/teams/createRole.md

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

# CreateRoleRequest

*Request for creating a Role entity*

## Properties

- **`name`**: Refer to *[../../type/basic.json#/definitions/entityName](#/../type/basic.json#/definitions/entityName)*.
- **`displayName`** *(string)*: Optional name used for display purposes. Example 'Data Consumer'.
- **`description`**: Optional description of the role. Refer to *[../../type/basic.json#/definitions/markdown](#/../type/basic.json#/definitions/markdown)*.
- **`policies`** *(array)*: Policies that is attached to this role. At least one policy is required.
  - **Items**: Refer to *[../../type/basic.json#/definitions/entityName](#/../type/basic.json#/definitions/entityName)*.
- **`domain`** *(string)*: Fully qualified name of the domain the Table belongs to.


Documentation file automatically generated at 2025-01-15 09:05:41.923720+00:00.
doc: added 0.13.3 documentation (#11271) 2023-04-25 16:58:47 +02:00			`---`
			`title: createRole`
			`slug: /main-concepts/metadata-standard/schemas/api/teams/createrole`
			`---`

			`# CreateRoleRequest`

			`Request for creating a Role entity`

			`## Properties`

Feat: update generate docs schema (#19372) * Updated generate_docs_schema * Updated generate_docs_schema * Updated generate_docs_schema * applied generate_docs_schema script * Revert the changes in this file --------- Co-authored-by: Tarun <tarun.p@deuexsolutions.com> Co-authored-by: Prajwal214 <167504578+Prajwal214@users.noreply.github.com> 2025-01-15 17:46:55 +05:30			- `name`: Refer to [../../type/basic.json#/definitions/entityName](#/../type/basic.json#/definitions/entityName).
doc: added 0.13.3 documentation (#11271) 2023-04-25 16:58:47 +02:00			- `displayName` (string): Optional name used for display purposes. Example 'Data Consumer'.
Feat: update generate docs schema (#19372) * Updated generate_docs_schema * Updated generate_docs_schema * Updated generate_docs_schema * applied generate_docs_schema script * Revert the changes in this file --------- Co-authored-by: Tarun <tarun.p@deuexsolutions.com> Co-authored-by: Prajwal214 <167504578+Prajwal214@users.noreply.github.com> 2025-01-15 17:46:55 +05:30			- `description`: Optional description of the role. Refer to [../../type/basic.json#/definitions/markdown](#/../type/basic.json#/definitions/markdown).
[Docs] - Incremental upgrade docs & bring back versions (#13008) 2023-08-27 10:55:55 +02:00			- `policies` (array): Policies that is attached to this role. At least one policy is required.
Feat: update generate docs schema (#19372) * Updated generate_docs_schema * Updated generate_docs_schema * Updated generate_docs_schema * applied generate_docs_schema script * Revert the changes in this file --------- Co-authored-by: Tarun <tarun.p@deuexsolutions.com> Co-authored-by: Prajwal214 <167504578+Prajwal214@users.noreply.github.com> 2025-01-15 17:46:55 +05:30			`- Items: Refer to [../../type/basic.json#/definitions/entityName](#/../type/basic.json#/definitions/entityName).`
			- `domain` (string): Fully qualified name of the domain the Table belongs to.
doc: added 0.13.3 documentation (#11271) 2023-04-25 16:58:47 +02:00

Feat: update generate docs schema (#19372) * Updated generate_docs_schema * Updated generate_docs_schema * Updated generate_docs_schema * applied generate_docs_schema script * Revert the changes in this file --------- Co-authored-by: Tarun <tarun.p@deuexsolutions.com> Co-authored-by: Prajwal214 <167504578+Prajwal214@users.noreply.github.com> 2025-01-15 17:46:55 +05:30			`Documentation file automatically generated at 2025-01-15 09:05:41.923720+00:00.`