Merge pull request #9466 from garchiro7/3935571-Add-roles-permissions

Add roles for townhalls and webinars

api-reference/v1.0/api/virtualeventtownhall-cancel.md

@@ -5,14 +5,16 @@ author: "frankpeng7"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: apiPageType
-ms.date: 08/06/2024
+ms.date: 11/22/2024
 ---
 
 # virtualEventTownhall: cancel
 Namespace: microsoft.graph
 
 Cancel a [virtualEventTownhall](../resources/virtualeventtownhall.md). A canceled town hall has its **status** set to `canceled` permanently. You can still get a canceled town hall by using the [Get virtualEventTownhall](../api/virtualeventtownhall-get.md) API.
 
+Only the **Organizer** can cancel a townhall event.
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
@@ -71,7 +73,6 @@ POST https://graph.microsoft.com/v1.0/solutions/virtualEvents/townhalls/bce9a3ca
 
 ---
 
----
 
 ### Response
 

api-reference/v1.0/api/virtualeventtownhall-get.md

@@ -5,7 +5,7 @@ author: "frankpeng7"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: apiPageType
-ms.date: 08/08/2024
+ms.date: 11/22/2024
 ---
 
 # Get virtualEventTownhall
@@ -14,6 +14,8 @@ Namespace: microsoft.graph
 
 Read the properties and relationships of a [virtualEventTownhall](../resources/virtualeventtownhall.md) object.
 
+All roles can get the details of a townhall event.
+
 [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
 
 ## Permissions

api-reference/v1.0/api/virtualeventtownhall-publish.md

@@ -5,14 +5,16 @@ author: "frankpeng7"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: apiPageType
-ms.date: 08/06/2024
+ms.date: 11/22/2024
 ---
 
 # virtualEventTownhall: publish
 Namespace: microsoft.graph
 
 Publish a [virtualEventTownhall](../resources/virtualeventtownhall.md) to make it visible to its audience.
 
+Only the **Organizer** can publish a townhall event.
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
@@ -71,7 +73,6 @@ POST https://graph.microsoft.com/v1.0/solutions/virtualEvents/townhalls/bce9a3ca
 
 ---
 
----
 
 ### Response
 

api-reference/v1.0/api/virtualeventtownhall-update.md

@@ -5,14 +5,16 @@ author: "frankpeng7"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: apiPageType
-ms.date: 08/08/2024
+ms.date:11/22/2024
 ---
 
 # Update virtualEventTownhall
 Namespace: microsoft.graph
 
 Update the properties of a [virtualEventTownhall](../resources/virtualeventtownhall.md) object.
 
+Only the **Organizer** and **Co-organizer** can make changes to a townhall event.
+
 [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
 
 ## Permissions

api-reference/v1.0/api/virtualeventwebinar-cancel.md

@@ -5,14 +5,16 @@ author: "frankpeng7"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: apiPageType
-ms.date: 08/06/2024
+ms.date: 11/22/2024
 ---
 
 # virtualEventWebinar: cancel
 Namespace: microsoft.graph
 
 Cancel a [virtualEventWebinar](../resources/virtualeventwebinar.md). A canceled webinar has its **status** set to `canceled` permanently. You can still get a canceled webinar by using the [Get virtualEventWebinar](../api/virtualeventwebinar-get.md) API.
 
+Only the **Organizer** can cancel a webinar.
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
@@ -71,8 +73,6 @@ POST https://graph.microsoft.com/v1.0/solutions/virtualEvents/townhalls/a57082a9
 
 ---
 
----
-
 ### Response
 
 The following example shows the response.

api-reference/v1.0/api/virtualeventwebinar-get.md

@@ -5,13 +5,16 @@ author: "awang119"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: apiPageType
+ms.date: 11/22/2024
 ---
 
 # Get virtualEventWebinar
 Namespace: microsoft.graph
 
 Read the properties and relationships of a [virtualEventWebinar](../resources/virtualeventwebinar.md) object.
 
+All roles can get the details of a webinar event.
+
 [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
 
 ## Permissions

api-reference/v1.0/api/virtualeventwebinar-publish.md

@@ -5,13 +5,16 @@ author: "frankpeng7"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: apiPageType
+ms.date: 11/22/2024
 ---
 
 # virtualEventWebinar: publish
 Namespace: microsoft.graph
 
 Publish a [virtualEventWebinar](../resources/virtualeventwebinar.md) to make it visible to its audience.
 
+Only the **Organizer** can publish a webinar.
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
@@ -70,8 +73,6 @@ POST https://graph.microsoft.com/v1.0/solutions/virtualEvents/webinars/a57082a9-
 
 ---
 
----
-
 ### Response
 
 The following example shows the response.

api-reference/v1.0/api/virtualeventwebinar-update.md

@@ -5,13 +5,16 @@ author: "frankpeng7"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: apiPageType
+ms.date: 11/22/2024
 ---
 
 # Update virtualEventWebinar
 Namespace: microsoft.graph
 
 Update the properties of a [virtualEventWebinar](../resources/virtualeventwebinar.md) object.
 
+Only the **Organizer** and **Co-organizer** can make changes to a webinar event.
+
 [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
 
 ## Permissions

api-reference/v1.0/resources/virtualeventtownhall.md

@@ -5,6 +5,7 @@ author: "awang119"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: resourcePageType
+ms.date: 11/22/2024
 ---
 
 # virtualEventTownhall resource type
@@ -25,6 +26,18 @@ Inherits from [virtualEvent](../resources/virtualevent.md).
 | [Publish](../api/virtualeventtownhall-publish.md) | None | Publish a [virtualEventTownhall](../resources/virtualeventtownhall.md).|
 | [Cancel](../api/virtualeventtownhall-cancel.md) | None | Cancel a [virtualEventTownhall](../resources/virtualeventtownhall.md).|
 
+### Roles required to act on virtualEventTownhall objects
+
+The following table shows the roles that can perform various actions on virtual event town halls.
+
+|Role          | Create	    | Get	       | Update	    | Publish 	 | Cancel 	  |
+| ------           | ----------- | ---------- | ---------- | ---------- | ---------- |
+|Organizer         |	✅|	✅|	✅|	✅|	✅|
+|Co-organizer      |	❌|	✅|	✅|	❌|	❌|
+|Presenter         | 	❌|	✅|	❌|	❌|	❌|
+|Attendee          |	❌|	✅|	❌|	❌|	❌|
+|Custom application|	❌|	✅|	❌|	❌|	❌|
+
 ## Properties
 
 |Property|Type|Description|

api-reference/v1.0/resources/virtualeventwebinar.md

@@ -5,6 +5,7 @@ author: "awang119"
 ms.localizationpriority: medium
 ms.subservice: "cloud-communications"
 doc_type: resourcePageType
+ms.date: 11/22/2024
 ---
 
 # virtualEventWebinar resource type
@@ -28,6 +29,20 @@ Inherits from [virtualEvent](../resources/virtualevent.md).
 | [List by user role](../api/virtualeventwebinar-getbyuserrole.md) | [virtualEventWebinar](../resources/virtualeventwebinar.md) collection | Get a **virtualEventWebinar** collection where the signed-in user is either the organizer or a coorganizer. |
 | [List by user ID and role](../api/virtualeventwebinar-getbyuseridandrole.md) | [virtualEventWebinar](../resources/virtualeventwebinar.md) collection | Get a **virtualEventWebinar** collection where the specified user is either the organizer or a coorganizer. |
 
+### Roles required to act on virtualEventWebinar objects
+
+The following table shows the roles that can perform various actions on webinars.
+## Roles
+
+|Role          | Create	    | Get	       | Update	    | Publish 	 | Cancel 	  | List in org	| List by user role	| List by user ID & role |
+| ------           | ----------- | ---------- | ---------- | ---------- | ---------- | ----------  | ----------------- | ---------------------- |
+|Organizer         |	✅|	✅|	✅|	✅|	✅|	❌|	✅|	❌|
+|Co-organizer      |	❌|	✅|	✅|	❌|	❌|	❌|	✅|	❌|
+|Presenter         | 	❌|	✅|	❌|	❌|	❌|	❌|	✅|	❌|
+|Attendee          |	❌|	✅|	❌|	❌|	❌|	❌|	✅|	❌|
+|Custom application|	❌|	✅|	❌|	❌|	❌|	✅|	❌|	✅|
+
+
 ## Properties
 
 | Property | Type | Description |