| title | engagementRole resource type |
|---|---|
| description | Represents a predefined Viva Engage role. |
| author | richafnu |
| ms.date | 09/22/2025 |
| ms.localizationpriority | medium |
| ms.subservice | viva-engage |
| doc_type | resourcePageType |
Namespace: microsoft.graph
Represents a predefined Viva Engage role. Each role includes a unique identifier and display name and can be assigned to one or more users within the platform.
Inherits from entity.
| Method | Return type | Description |
|---|---|---|
| List | engagementRole collection | Get a list of all the roles that can be assigned in Viva Engage. |
| List members | engagementRoleMember collection | Get a list of users with assigned roles in Viva Engage. |
| List assigned roles | engagementRole | Get a list of all the roles assigned to a user in Viva Engage. |
| Property | Type | Description |
|---|---|---|
| displayName | String | The name of the role. |
| id | String | The unique identifier of the role. Read-only. Inherited from entity |
| Relationship | Type | Description |
|---|---|---|
| members | engagementRoleMember collection | Users that have this role assigned. |
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.engagementRole",
"displayName": "String",
"id": "String (identifier)"
}