diff --git a/api-reference/v1.0/api/virtualeventtownhall-cancel.md b/api-reference/v1.0/api/virtualeventtownhall-cancel.md index 17cef0a9c08..df7dd40bf7b 100644 --- a/api-reference/v1.0/api/virtualeventtownhall-cancel.md +++ b/api-reference/v1.0/api/virtualeventtownhall-cancel.md @@ -5,7 +5,7 @@ author: "frankpeng7" ms.localizationpriority: medium ms.subservice: "cloud-communications" doc_type: apiPageType -ms.date: 08/06/2024 +ms.date: 11/22/2024 --- # virtualEventTownhall: cancel @@ -13,6 +13,8 @@ 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 diff --git a/api-reference/v1.0/api/virtualeventtownhall-get.md b/api-reference/v1.0/api/virtualeventtownhall-get.md index c5b54605fdb..bbd0c51a6bb 100644 --- a/api-reference/v1.0/api/virtualeventtownhall-get.md +++ b/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 diff --git a/api-reference/v1.0/api/virtualeventtownhall-publish.md b/api-reference/v1.0/api/virtualeventtownhall-publish.md index 5aed4a61b20..c012e4742ff 100644 --- a/api-reference/v1.0/api/virtualeventtownhall-publish.md +++ b/api-reference/v1.0/api/virtualeventtownhall-publish.md @@ -5,7 +5,7 @@ author: "frankpeng7" ms.localizationpriority: medium ms.subservice: "cloud-communications" doc_type: apiPageType -ms.date: 08/06/2024 +ms.date: 11/22/2024 --- # virtualEventTownhall: publish @@ -13,6 +13,8 @@ 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 diff --git a/api-reference/v1.0/api/virtualeventtownhall-update.md b/api-reference/v1.0/api/virtualeventtownhall-update.md index ab6c711281e..d9af6a815cf 100644 --- a/api-reference/v1.0/api/virtualeventtownhall-update.md +++ b/api-reference/v1.0/api/virtualeventtownhall-update.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 --- # Update virtualEventTownhall @@ -13,6 +13,8 @@ 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 diff --git a/api-reference/v1.0/api/virtualeventwebinar-cancel.md b/api-reference/v1.0/api/virtualeventwebinar-cancel.md index f83a16ab0f6..2289c5d1f6b 100644 --- a/api-reference/v1.0/api/virtualeventwebinar-cancel.md +++ b/api-reference/v1.0/api/virtualeventwebinar-cancel.md @@ -5,7 +5,7 @@ author: "frankpeng7" ms.localizationpriority: medium ms.subservice: "cloud-communications" doc_type: apiPageType -ms.date: 08/06/2024 +ms.date: 11/22/2024 --- # virtualEventWebinar: cancel @@ -13,6 +13,8 @@ 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. diff --git a/api-reference/v1.0/api/virtualeventwebinar-get.md b/api-reference/v1.0/api/virtualeventwebinar-get.md index 4ff40ca755d..d25745dccfb 100644 --- a/api-reference/v1.0/api/virtualeventwebinar-get.md +++ b/api-reference/v1.0/api/virtualeventwebinar-get.md @@ -5,6 +5,7 @@ author: "awang119" ms.localizationpriority: medium ms.subservice: "cloud-communications" doc_type: apiPageType +ms.date: 11/22/2024 --- # Get virtualEventWebinar @@ -12,6 +13,8 @@ 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 diff --git a/api-reference/v1.0/api/virtualeventwebinar-publish.md b/api-reference/v1.0/api/virtualeventwebinar-publish.md index b46fa47cbf9..0bafc682cb0 100644 --- a/api-reference/v1.0/api/virtualeventwebinar-publish.md +++ b/api-reference/v1.0/api/virtualeventwebinar-publish.md @@ -5,6 +5,7 @@ author: "frankpeng7" ms.localizationpriority: medium ms.subservice: "cloud-communications" doc_type: apiPageType +ms.date: 11/22/2024 --- # virtualEventWebinar: publish @@ -12,6 +13,8 @@ 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. diff --git a/api-reference/v1.0/api/virtualeventwebinar-update.md b/api-reference/v1.0/api/virtualeventwebinar-update.md index 97cf2f907a2..b7a45f5dd55 100644 --- a/api-reference/v1.0/api/virtualeventwebinar-update.md +++ b/api-reference/v1.0/api/virtualeventwebinar-update.md @@ -5,6 +5,7 @@ author: "frankpeng7" ms.localizationpriority: medium ms.subservice: "cloud-communications" doc_type: apiPageType +ms.date: 11/22/2024 --- # Update virtualEventWebinar @@ -12,6 +13,8 @@ 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 diff --git a/api-reference/v1.0/resources/virtualeventtownhall.md b/api-reference/v1.0/resources/virtualeventtownhall.md index 94656bf13b1..70f849957bf 100644 --- a/api-reference/v1.0/resources/virtualeventtownhall.md +++ b/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| diff --git a/api-reference/v1.0/resources/virtualeventwebinar.md b/api-reference/v1.0/resources/virtualeventwebinar.md index 584d3bc8411..9517762b2ba 100644 --- a/api-reference/v1.0/resources/virtualeventwebinar.md +++ b/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 |