diff --git a/.vscode/settings.json b/.vscode/settings.json index 5b5ae08d1b8..f1deb27bad8 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -17,6 +17,12 @@ "cloud.exclusions.json" ], "url": "https://raw.githubusercontent.com/microsoftgraph/msgraph-cloud-support/main/schema/cloud.exclusions.schema.json" - } + }, + { + "fileMatch": [ + "toc.mapping.json" + ], + "url": "https://raw.githubusercontent.com/microsoftgraph/msgraph-toc-gen/main/schema/toc.mapping.schema.json" + } ] } \ No newline at end of file diff --git a/api-reference/beta/api/call-startrecording.md b/api-reference/beta/api/call-startrecording.md index cb1d551aa41..b2062901506 100644 --- a/api-reference/beta/api/call-startrecording.md +++ b/api-reference/beta/api/call-startrecording.md @@ -65,10 +65,34 @@ The following example shows the request. POST https://graph.microsoft.com/beta/communications/calls/02000980-58ea-4bf2-bb77-8ba548da56f7/microsoft.graph.StartRecording ``` +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/call-startrecording-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/call-startrecording-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/call-startrecording-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/call-startrecording-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/call-startrecording-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/call-startrecording-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/call-startrecording-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + --- --- diff --git a/api-reference/beta/api/call-starttranscription.md b/api-reference/beta/api/call-starttranscription.md index f435f6050ba..bf3783fb5a9 100644 --- a/api-reference/beta/api/call-starttranscription.md +++ b/api-reference/beta/api/call-starttranscription.md @@ -75,10 +75,34 @@ Content-Length: 56 } ``` +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/call-starttranscription-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/call-starttranscription-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/call-starttranscription-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/call-starttranscription-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/call-starttranscription-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/call-starttranscription-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/call-starttranscription-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + --- --- diff --git a/api-reference/beta/api/call-stoprecording.md b/api-reference/beta/api/call-stoprecording.md index 4d884bd3e7b..33fee818115 100644 --- a/api-reference/beta/api/call-stoprecording.md +++ b/api-reference/beta/api/call-stoprecording.md @@ -65,10 +65,34 @@ The following example shows the request. POST https://graph.microsoft.com/beta/communications/calls/02000980-58ea-4bf2-bb77-8ba548da56f7/microsoft.graph.StopRecording ``` +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/call-stoprecording-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/call-stoprecording-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/call-stoprecording-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/call-stoprecording-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/call-stoprecording-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/call-stoprecording-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/call-stoprecording-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + --- --- diff --git a/api-reference/beta/api/call-stoptranscription.md b/api-reference/beta/api/call-stoptranscription.md index c2a6d32dc55..ac907a09f91 100644 --- a/api-reference/beta/api/call-stoptranscription.md +++ b/api-reference/beta/api/call-stoptranscription.md @@ -76,10 +76,34 @@ Content-Length: 56 ``` +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/call-stoptranscription-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/call-stoptranscription-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/call-stoptranscription-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/call-stoptranscription-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/call-stoptranscription-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/call-stoptranscription-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/call-stoptranscription-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + --- --- diff --git a/api-reference/beta/api/copilotadminlimitedmode-get.md b/api-reference/beta/api/copilotadminlimitedmode-get.md index f04576def5f..8c4b9c49008 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-get.md +++ b/api-reference/beta/api/copilotadminlimitedmode-get.md @@ -27,11 +27,12 @@ Choose the permission or permissions marked as least privileged for this API. Us "name": "copilotadminlimitedmode-get-permissions" } --> -> **Note:** Global admin or Global reader permission is required to call this API. [!INCLUDE [permissions-table](../includes/permissions/copilotadminlimitedmode-get-permissions.md)] +> [!IMPORTANT] +> Global Reader is the least privileged [administrator role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) supported for this operation. ## HTTP request diff --git a/api-reference/beta/api/copilotadminlimitedmode-update.md b/api-reference/beta/api/copilotadminlimitedmode-update.md index 74dbce6d721..ab68825ff4c 100644 --- a/api-reference/beta/api/copilotadminlimitedmode-update.md +++ b/api-reference/beta/api/copilotadminlimitedmode-update.md @@ -27,11 +27,14 @@ Choose the permission or permissions marked as least privileged for this API. Us "name": "copilotadminlimitedmode-update-permissions" } --> -> **Note:** Global admin or Global reader permission is required to call this API. [!INCLUDE [permissions-table](../includes/permissions/copilotadminlimitedmode-update-permissions.md)] +> [!IMPORTANT] +> +> In delegated scenarios with work or school accounts, the signed-in user must be assigned the *Global Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json). + ## HTTP request -| Permission type | Permissions (from least to most privileged) | -|:---------------------------------------|:------------------------------------------------------| -| Delegated (work or school account) | User.ReadBasic.All, User.Read.All, Directory.Read.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | User.Read.All, Directory.Read.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Directory.Read.All|Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Directory.Read.All|Directory.ReadWrite.All | + +> [!NOTE] +> The *Directory.\** permissions allow you to retrieve any supported directory object type via this API. To retrieve only a specific type, you can use permissions specific to the resource. ### Group memberships for the signed-in user + -| Permission type | Permissions (from least to most privileged) | -|:-|:-| -| Delegated (work or school account) | User.Read, User.ReadBasic.All, User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Not supported. | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|User.Read|User.ReadBasic.All and GroupMember.Read.All, User.Read.All and GroupMember.Read.All, User.ReadBasic.All and Group.Read.All, User.Read.All and Group.Read.All, Directory.Read.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Not supported.|Not supported.| ### Group memberships for other users + -| Permission type | Permissions (from least to most privileged) | -|:-|:-| -| Delegated (work or school account) | User.ReadBasic.All, User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|User.ReadBasic.All and GroupMember.Read.All|User.Read.All and GroupMember.Read.All, User.ReadBasic.All and Group.Read.All, User.Read.All and Group.Read.All, Directory.Read.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|User.ReadBasic.All and GroupMember.Read.All|User.Read.All and GroupMember.Read.All, User.Read.All and Group.Read.All, Directory.Read.All| ### Group memberships for a group + -| Permission type | Permissions (from least to most privileged) | -|:-|:-| -| Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|GroupMember.Read.All|Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|GroupMember.Read.All|Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All| ### Group memberships for a service principal + -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Application.Read.All|Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Application.Read.All|Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All| ### Group memberships for an organizational contact - -[!INCLUDE [permissions-table](../includes/permissions/directoryobject-checkmembergroups-6-permissions.md)] + + +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Directory.Read.All|Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Directory.Read.All|Directory.ReadWrite.All | + +### Group memberships for a device + + +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Device.Read.All|Directory.Read.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Device.Read.All|Directory.Read.All, Directory.ReadWrite.All | ## HTTP request diff --git a/api-reference/beta/api/directoryobject-checkmemberobjects.md b/api-reference/beta/api/directoryobject-checkmemberobjects.md index bf231ea8e16..3264a477744 100644 --- a/api-reference/beta/api/directoryobject-checkmemberobjects.md +++ b/api-reference/beta/api/directoryobject-checkmemberobjects.md @@ -15,7 +15,15 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Check for membership in a list of group IDs, administrative unit IDs, or directory role IDs, for the IDs of the specified [user](../resources/user.md), [group](../resources/group.md), [service principal](../resources/serviceprincipal.md), [organizational contact](../resources/orgcontact.md), [device](../resources/device.md), or [directory object](../resources/directoryobject.md). This method is transitive. +Check for membership in a list of group IDs, administrative unit IDs, or directory role IDs, for the IDs of the specified +- [user](../resources/user.md) +- [group](../resources/group.md) +- [service principal](../resources/serviceprincipal.md) +- [organizational contact](../resources/orgcontact.md) +- [device](../resources/device.md) +- [directory object](../resources/directoryobject.md). + +This method is transitive. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] @@ -25,60 +33,62 @@ One of the following permissions is required to call this API. To learn more, in ### Memberships for a directory object -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Directory.Read.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Directory.Read.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Directory.Read.All|Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Directory.Read.All|Directory.ReadWrite.All | + +> [!NOTE] +> The *Directory.\** permissions allow you to retrieve any supported directory object type via this API. To retrieve only a specific type, you can use permissions specific to the resource. ### Memberships for the signed-in user -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | User.Read, User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Not supported. | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|User.Read|User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Not supported.|Not supported.| ### Memberships for other users -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|User.ReadBasic.All and GroupMember.Read.All|User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|User.ReadBasic.All and GroupMember.Read.All|User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All| ### Memberships for a group -| Permission type | Permissions (from least to most privileged) | -| :------------------------------------- | :------------------------------------------------------------------------------------------ | -| Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|GroupMember.Read.All|Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|GroupMember.Read.All|Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All| ### Memberships for a service principal -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Application.Read.All|Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Application.Read.All|Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All| ### Memberships for an organizational contact -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Directory.Read.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Directory.Read.All|Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Directory.Read.All|Directory.ReadWrite.All | ### Memberships for a device -| Permission type | Permissions (from least to most privileged) | -|:---------------------------------------|:--------------------------------------------| -| Delegated (work or school account) | Device.Read.All, Directory.Read.All, Directory.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Device.Read.All, Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | - +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Device.Read.All|Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Device.Read.All|Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | ## HTTP request diff --git a/api-reference/beta/api/directoryobject-getmemberobjects.md b/api-reference/beta/api/directoryobject-getmemberobjects.md index b266abdb970..2d73be38987 100644 --- a/api-reference/beta/api/directoryobject-getmemberobjects.md +++ b/api-reference/beta/api/directoryobject-getmemberobjects.md @@ -14,9 +14,15 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Return all IDs for the groups, administrative units, and directory roles that a [user](../resources/user.md), [group](../resources/group.md), [service principal](../resources/serviceprincipal.md), [organizational contact](../resources/orgcontact.md), [device](../resources/device.md), or [directory object](../resources/directoryobject.md) is a member of. This function is transitive. +Return all IDs for the groups, administrative units, and directory roles that an object of one of the following types is a member of: +- [user](../resources/user.md) +- [group](../resources/group.md) +- [service principal](../resources/serviceprincipal.md) +- [organizational contact](../resources/orgcontact.md) +- [device](../resources/device.md) +- [directory object](../resources/directoryobject.md) -**Note:** Only users and role-enabled groups can be members of directory roles. +This function is transitive. Only users and role-enabled groups can be members of directory roles. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] @@ -25,52 +31,62 @@ One of the following permissions is required to call this API. To learn more, in ### Memberships for a directory object -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Directory.Read.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Directory.Read.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Directory.Read.All|Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Directory.Read.All|Directory.ReadWrite.All | -### Memberships for a user +> [!NOTE] +> The *Directory.\** permissions allow you to retrieve any supported directory object type via this API. To retrieve only a specific type, you can use permissions specific to the resource. + +### Memberships for the signed-in user + +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|User.Read|User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Not supported.|Not supported.| + +### Memberships for other users -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | User.Read, User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|User.ReadBasic.All and GroupMember.Read.All|User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|User.ReadBasic.All and GroupMember.Read.All|User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All| ### Memberships for a group -| Permission type | Permissions (from least to most privileged) | -| :------------------------------------- | :------------------------------------------------------------------------------------------ | -| Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|GroupMember.Read.All|Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|GroupMember.Read.All|Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All| ### Memberships for a service principal -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Application.Read.All|Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Application.Read.All|Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All| ### Memberships for an organizational contact -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Directory.Read.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Directory.Read.All|Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Directory.Read.All|Directory.ReadWrite.All | ### Memberships for a device -| Permission type | Permissions (from least to most privileged) | -|:---------------------------------------|:--------------------------------------------| -| Delegated (work or school account) | Device.Read.All, Directory.Read.All, Directory.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Device.Read.All, Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | - +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Device.Read.All|Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Device.Read.All|Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | ## HTTP request @@ -80,10 +96,15 @@ Memberships for a directory object. POST /directoryObjects/{id}/getMemberObjects ``` -Memberships for a user. +Memberships for the signed-in user. ```http POST /me/getMemberObjects +``` + +Memberships for other user. + +```http POST /users/{id | userPrincipalName}/getMemberObjects ``` diff --git a/api-reference/beta/api/driveitem-copy.md b/api-reference/beta/api/driveitem-copy.md index a23e67927ff..58d620636cb 100644 --- a/api-reference/beta/api/driveitem-copy.md +++ b/api-reference/beta/api/driveitem-copy.md @@ -378,6 +378,7 @@ Location: https://contoso.sharepoint.com/_api/v2.0/monitor/4A3407B5-88FC-4504-8B The following example attempts to copy the child items in a folder identified by `{item-id}` into a folder identified by the `driveId` and `id` values. One of the child items is a folder item. The destination might have items with colliding names to the children at the source folder. The request attempts to resolve potential name conflicts by setting the optional query parameter `@microsoft.graph.conflictBehavior` to replace. The request is accepted but the monitoring url reports failures. Instead use `rename` or `fail` if at least one of the children is a folder item. #### Request +# [HTTP](#tab/http) ```http @@ -393,6 +394,40 @@ Content-Type: application/json } ``` +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/copy-item-conflicts-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/copy-item-conflicts-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/copy-item-conflicts-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/copy-item-conflicts-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/copy-item-conflicts-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/copy-item-conflicts-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [PowerShell](#tab/powershell) +[!INCLUDE [sample-code](../includes/snippets/powershell/copy-item-conflicts-powershell-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/copy-item-conflicts-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + #### Response @@ -714,4 +749,4 @@ For error information, see [Error responses][error-response]. "suppressions": [ ] } ---> \ No newline at end of file +--> diff --git a/api-reference/beta/api/filestoragecontainer-restore.md b/api-reference/beta/api/filestoragecontainer-restore.md index 9ec130894db..f3a9ff058bd 100644 --- a/api-reference/beta/api/filestoragecontainer-restore.md +++ b/api-reference/beta/api/filestoragecontainer-restore.md @@ -99,7 +99,6 @@ POST https://graph.microsoft.com/beta/storage/fileStorage/deletedContainers/b!IS --- - ### Response The following example shows the response. diff --git a/api-reference/beta/api/mailbox-createimportsession.md b/api-reference/beta/api/mailbox-createimportsession.md new file mode 100644 index 00000000000..c958d780ffe --- /dev/null +++ b/api-reference/beta/api/mailbox-createimportsession.md @@ -0,0 +1,90 @@ +--- +title: "mailbox: createImportSession" +description: "Create a session to import an Exchange mailbox item using its FastTransfer stream (FTS) format." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: apiPageType +--- + +# mailbox: createImportSession + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Create a session to [import an Exchange mailbox item](/graph/import-exchange-mailbox-item) using its [FastTransfer stream](/openspecs/exchange_server_protocols/ms-oxcfxics/a2648823-0a98-43ee-98e8-590e4f7bcbbe) (FTS) format. + +## 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). + + +[!INCLUDE [permissions-table](../includes/permissions/mailbox-createimportsession-permissions.md)] + +## HTTP request + + +``` http +POST /admin/exchange/mailboxes/{mailboxId}/createImportSession +``` + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| + +## Request body + +Don't supply a request body for this method. + +## Response + +If successful, this action returns a `200 OK` response code and a [mailboxItemImportSession](../resources/mailboxitemimportsession.md) in the response body. + +## Examples + +### Request + +The following example shows how to create an import session. The opaque URL, returned in the **importUrl** property of the response, is preauthenticated and contains the appropriate authorization token for subsequent POST queries in the https://outlook.office365.com domain. That token expires by **expirationDateTime**. Don't customize this URL for subsequent POST operations. + + +``` http +POST https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/createImportSession +``` + +### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-type: application/json +Content-length: 232 + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.mailboxItemImportSession", + "importUrl": "https://outlook.office365.com/api/gbeta/Mailboxes('MBX:e0643f21@a7809c93')/importItem?authtoken=eyJhbGciOiJSUzI1NiIsImtpZCI6IjFTeXQ1b", + "expirationDateTime": "2024-10-17T19:00:48.1052906Z" +} +``` diff --git a/api-reference/beta/api/mailbox-delete-folders.md b/api-reference/beta/api/mailbox-delete-folders.md new file mode 100644 index 00000000000..b5c1a9a16a8 --- /dev/null +++ b/api-reference/beta/api/mailbox-delete-folders.md @@ -0,0 +1,81 @@ +--- +title: "Delete mailboxFolder" +description: "Delete a mailboxFolder or a child mailboxFolder within a mailbox." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: apiPageType +--- + +# Delete mailboxFolder + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Delete a [mailboxFolder](../resources/mailboxfolder.md) or a child **mailboxFolder** within a mailbox. + +## 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). + + +[!INCLUDE [permissions-table](../includes/permissions/mailbox-delete-folders-permissions.md)] + +## HTTP request + + +``` http +DELETE /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/$ref +DELETE /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders/{mailboxFolderId}/$ref +``` + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| + +## Request body + +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `204 No Content` response code. + +## Examples + +### Request + +The following example shows how to delete a mailbox folder. + +``` http +DELETE https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0648f21@aab09c93/folders/AAMkAGVmMDEzM/$ref +``` + +### Response + +The following example shows the response. + + +``` http +HTTP/1.1 204 No Content +``` diff --git a/api-reference/beta/api/mailbox-exportitems.md b/api-reference/beta/api/mailbox-exportitems.md new file mode 100644 index 00000000000..d57ae1d6f7c --- /dev/null +++ b/api-reference/beta/api/mailbox-exportitems.md @@ -0,0 +1,114 @@ +--- +title: "mailbox: exportItems" +description: "Export Exchange mailboxItem objects in full-fidelity FastTransfer format for backup purposes." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: apiPageType +--- + +# mailbox: exportItems + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Export Exchange [mailboxItem](../resources/mailboxitem.md) objects in full-fidelity [FastTransfer stream](/openspecs/exchange_server_protocols/ms-oxcfxics/ed7d3455-9bdf-40eb-90bd-8dfe6164a250#gt_12daff0e-4241-4498-a93f-212795ab2450) format for backup purposes. This item format can be restored to the same mailbox or a different one. + +You can export up to 20 items in a single export request. + +## 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). + + +[!INCLUDE [permissions-table](../includes/permissions/mailbox-exportitems-permissions.md)] + +## HTTP request + + +``` http +POST /admin/exchange/mailboxes/{mailboxId}/exportItems +``` + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Content-Type|application/json. Required.| + +## Request body + +In the request body, supply a JSON representation of the parameters. + +The following table lists the parameters that are required when you call this action. + +|Parameter|Type|Description| +|:---|:---|:---| +|itemIds|String collection|A collection of identifiers of [mailboxItem](../resources/mailboxitem.md) objects to export. All identifiers in the collection _must_ be for items in the same mailbox. Maximum size of this collection is 20 strings.| + +## Response + +If successful, this action returns a `200 OK` response code and a collection of [exportItemResponse](../resources/exportitemresponse.md) objects in the response body. + +## Examples + +### Request + +The following example exports two items present in the user's mailbox. The **itemIds** of the items to be exported are specified in the request body. + +``` http +POST https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/exportItems +Content-type: application/json + +{ + "itemIds": [ + "EDSVrdi3lRAADmpnf1AAA=", + "EDSVrdi3lRAAD45b7RAAA=" + ] +} +``` + +### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-type: application/json +Content-length: 232 + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.exportItemResponse)", + "value": [ + { + "itemId": "EDSVrdi3lRAADmpnf1AAA=", + "changeKey": "CQAAABYAAACQ2fKdhq8oSKEDSVrdi3lRAAEu4C+G" + }, + { + "itemId": "EDSVrdi3lRAAD45b7RAAA=", + "changeKey": "CQAAABYAAACQ2fKdhq8oSKEDSVrdi3lRAAD4pUax" + } + ] +} +``` diff --git a/api-reference/beta/api/mailbox-list-folders.md b/api-reference/beta/api/mailbox-list-folders.md new file mode 100644 index 00000000000..8751ffc7186 --- /dev/null +++ b/api-reference/beta/api/mailbox-list-folders.md @@ -0,0 +1,164 @@ +--- +title: "List folders" +description: "Get all the mailboxFolder objects in the specified mailbox, including any search folders." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: apiPageType +--- + +# List folders + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Get all the [mailboxFolder](../resources/mailboxfolder.md) objects in the specified mailbox, including any search folders. + +## 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). + + +[!INCLUDE [permissions-table](../includes/permissions/mailbox-list-folders-permissions.md)] + +## HTTP request + + +``` http +GET /admin/exchange/mailboxes/{mailboxId}/folders +``` + +## Optional query parameters + +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| + +## Request body + +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `200 OK` response code and a collection of [mailboxFolder](../resources/mailboxfolder.md) objects in the response body. + +## Examples + +### Example 1: List folders + +The following example shows how to get the **mailboxFolder** collection directly under the root folder of the user's mailbox. + +#### Request + +The following example shows a request. + +``` http +GET https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders +``` + +#### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-type: application/json +Content-length: 232 + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders", + "value": [ + { + "@odata.type": "#microsoft.graph.mailboxFolder", + "id": "EDSVrdi3lRAAACgfQBAAA=", + "displayName": "Archive", + "parentFolderId": "NJWt2LeVEAAAIBCAAAAA==", + "parentMailboxUrl": "https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93", + "childFolderCount": 0, + "totalItemCount": 2, + "type": "IPF.Note" + }, + { + "@odata.type": "#microsoft.graph.mailboxFolder", + "id": "NJWt2LeVEAAAIBDQAAAA==", + "displayName": "Calendar", + "parentFolderId": "NJWt2LeVEAAAIBCAAAAA==", + "parentMailboxUrl": "https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93", + "childFolderCount": 5, + "totalItemCount": 6, + "type": "IPF.Appointment" + } + ], + "@odata.nextLink": "https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders?%24skip=10" +} +``` + +### Example 2: List folders with query parameters + +The following example uses the `$filter`, `$select`, and `$top` query parameters. The `$filter` parameter refines the results and returns only folders of **type** `IPF.Appointment`. The `$select` parameter is specified to return only the **displayName** and **type** properties, and the `$top` parameter sets the page size of the result set to return the first five folders in the mailbox. + +#### Request + +The following example shows a request. + +``` http +GET https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders?$filter=type eq 'IPF.Appointment'&$select=displayName,type&$top=5 +``` + +#### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-type: application/json +Content-length: 232 + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders", + "value": [ + { + "@odata.type": "#microsoft.graph.mailboxFolder", + "id": "NJWt2LeVEAAAIBDQAAAA==", + "displayName": "Calendar", + "parentMailboxUrl": "https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93", + "type": "IPF.Appointment" + } + ] +} +``` diff --git a/api-reference/beta/api/mailbox-post-folders.md b/api-reference/beta/api/mailbox-post-folders.md new file mode 100644 index 00000000000..07bfc811191 --- /dev/null +++ b/api-reference/beta/api/mailbox-post-folders.md @@ -0,0 +1,114 @@ +--- +title: "Create mailboxFolder" +description: "Create a new mailboxFolder or child mailboxFolder in a user's mailbox." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: apiPageType +--- + +# Create mailboxFolder + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Create a new [mailboxFolder](../resources/mailboxfolder.md) or child **mailboxFolder** in a user's mailbox. + +## 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). + + +[!INCLUDE [permissions-table](../includes/permissions/mailbox-post-folders-permissions.md)] + +## HTTP request + + +``` http +POST /admin/exchange/mailboxes/{mailboxId}/folders +POST /admin/exchange/mailboxes/{mailboxId}/folders/inbox/childFolders +``` + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Content-Type|application/json. Required.| + +## Request body + +In the request body, supply a JSON representation of the [mailboxFolder](../resources/mailboxfolder.md) object. + +You can specify the following properties when you create a **mailboxFolder**. + +|Property|Type|Description| +|:---|:---|:---| +|displayName|String|The display name of the folder. Required.| +|type|String|Describes the folder class type. Required.| + +## Response + +If successful, this method returns a `201 Created` response code and a [mailboxFolder](../resources/mailboxfolder.md) object in the response body. + +## Examples + +### Request + +The following example shows how to create a new mailbox folder. + +``` http +POST https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0648f21@aab09c93/folders + +{ + "displayName": "Announcements", + "type": "IPF.Note", + "singleValueExtendedProperties": [ + { + "id": "String 0x3001", + "value": "Announcements" + } + ] +} +``` + +### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 201 Created +Content-type: application/json +Content-length: 179 + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/exchange/mailboxes('MBX%3A73c326ef%402829ab8a')/folders/$entity", + "id": "AQMkAGUw==", + "displayName": "Announcements", + "parentFolderId": "AQMkAGUc==", + "parentMailboxUrl": "https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0648f21@aab09c93", + "childFolderCount": 0, + "totalItemCount": 0, + "type": "IPF.Note" +} +``` diff --git a/api-reference/beta/api/mailboxfolder-delta.md b/api-reference/beta/api/mailboxfolder-delta.md new file mode 100644 index 00000000000..7e22caf1af7 --- /dev/null +++ b/api-reference/beta/api/mailboxfolder-delta.md @@ -0,0 +1,132 @@ +--- +title: "mailboxFolder: delta" +description: "Get a set of mailboxFolder objects that have been added, deleted, or removed from the user's mailbox." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: apiPageType +--- + +# mailboxFolder: delta + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Get a set of [mailboxFolder](../resources/mailboxfolder.md) objects that have been added, deleted, or removed from the user's mailbox. + +A **delta** function call for folders in a mailbox is similar to a GET request, except that by appropriately applying [state tokens](/graph/delta-query-overview) in one or more of these calls, you can query for incremental changes in the folders. This approach allows you to maintain and synchronize a local store of a user's mail folders without having to fetch all the folders of that mailbox from the server every time. + +## 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). + + +[!INCLUDE [permissions-table](../includes/permissions/mailboxfolder-delta-permissions.md)] + +## HTTP request + + +``` http +GET /admin/exchange/mailboxes/{mailboxId}/folders/delta +GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders/delta +``` + +## Query parameters + +Tracking changes in folders incurs a round of one or more **delta** function calls. If you use any query parameter (other than `$deltaToken` and `$skipToken`), you must specify it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters into the token portion of the `nextLink` or `deltaLink` URL provided in the response. You only need to specify any desired query parameters once upfront. In subsequent requests, simply copy and apply the `nextLink` or `deltaLink` URL from the previous response, as that URL already includes the encoded, desired parameters. + +| Query parameter|Description| +|:----------------|:--------| +| $deltaToken|A [state token](/graph/delta-query-overview) returned in the `deltaLink` URL of the previous **delta** function call for the same folder collection, which indicates the completion of that round of change tracking. Save and apply the entire `deltaLink` URL including this token in the first request of the next round of change tracking for that collection.| +| $skipToken|A [state token](/graph/delta-query-overview) returned in the `nextLink` URL of the previous **delta** function call, indicating further changes are available to be tracked in the same folder collection.| + +### OData query parameters + +You can use the `$select` query parameter to specify only the properties you need for best performance. The **id** and **parentMailboxUrl** properties are always returned. + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Prefer|odata.maxpagesize={x}. Optional.| + +## Request body + +Don't supply a request body for this method. + +## Response + +If successful, this function returns a `200 OK` response code and a collection of [mailboxFolder](../resources/mailboxfolder.md) objects in the response body. + +## Examples + +### Request + +The following example shows how to make a single **delta** function call, and limit the maximum number of folders in the response body to two. + +To track changes in the folders of a mailbox, you make one or more **delta** function calls, with appropriate state tokens, to get the set of incremental changes since the last delta query. + +For a similar example that shows how to use the state tokens to track changes in the items of a folder, see [Get incremental changes to messages in a folder](/graph/delta-query-messages). The main differences between tracking folders and tracking items in a folder are in the delta query request URLs and the query responses that return **folder** rather than **item** collections. + + +``` http +GET https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders/delta +Prefer: odata.maxpagesize=2 +``` + +### Response + +If the request is successful, the response includes a state token that is either a `$skipToken` (in an **@odata.nextLink** response header) or a `$deltaToken` (in an **@odata.deltaLink** response header). Respectively, they indicate whether you should continue with the round or you completed getting all the changes for that round. + +The following example shows a `$deltaToken` in an **@odata.deltaLink** response header. + +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-type: application/json +Content-length: 254 + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(mailboxFolder)", + "@odata.deltaLink": "https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders/delta?$deltatoken={_deltaToken_}", + "value": [ + { + "@odata.type": "#microsoft.graph.mailboxFolder", + "displayName": "Inbound", + "parentMailboxUrl": "https://graph.microsoft.com/beta/admin/Exchange/Mailboxes/MBX:e0643f21@a7809c93", + "id": "AAMkAGUwNjQ4ZjIxLTQ3Y2YtNDViMi1iZjc4LTMzNjMwNWM0ZGE2YQAuAAAAAADbrwBIJbBSTKolRbhHUzSHAQCQ2fKdhq8oSKEDSVrdi3lRAAACgfP9AAA=" + }, + { + "@odata.type": "#microsoft.graph.mailboxFolder", + "displayName": "Outbound", + "parentMailboxUrl": "https://graph.microsoft.com/beta/admin/Exchange/Mailboxes/MBX:e0643f21@a7809c93", + "id": "AAMkAGUwNjQ4ZjIxLTQ3Y2YtNDViMi1iZjc4LTMzNjMwNWM0ZGE2YQAuAAAAAADbrwBIJbBSTKolRbhHUzSHAQCQ2fKdhq8oSKEDSVrdi3lRAAACgfP_AAA=" + } + ] +} +``` + +## Related content +- [Use delta query to track changes in Microsoft Graph data](/graph/delta-query-overview) +- [Get incremental changes to items in a folder](./mailboxitem-delta.md) diff --git a/api-reference/beta/api/mailboxfolder-get.md b/api-reference/beta/api/mailboxfolder-get.md new file mode 100644 index 00000000000..f0c1181a3a7 --- /dev/null +++ b/api-reference/beta/api/mailboxfolder-get.md @@ -0,0 +1,100 @@ +--- +title: "Get mailboxFolder" +description: "Read the properties and relationships of a mailboxFolder object." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: apiPageType +--- + +# Get mailboxFolder + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Read the properties and relationships of a [mailboxFolder](../resources/mailboxfolder.md) object. + +## 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). + + +[!INCLUDE [permissions-table](../includes/permissions/mailboxfolder-get-permissions.md)] + +## HTTP request + + +``` http +GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId} +GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders/{mailboxFolderId} +``` + +## Optional query parameters + +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| + +## Request body + +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `200 OK` response code and a [mailboxFolder](../resources/mailboxfolder.md) object in the response body. + +## Examples + +### Request + +The following example shows a request. + +``` http +GET https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders/NJWt2LeVEAAAIBDAAAAA== +``` + +### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-type: application/json +Content-length: 232 + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders$entity", + "@odata.type": "#microsoft.graph.mailboxFolder", + "id": "NJWt2LeVEAAAIBDAAAAA==", + "displayName": "Inbox", + "parentFolderId": "NJWt2LeVEAAAIBCAAAAA==", + "parentMailboxUrl": "https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93", + "childFolderCount": 3, + "totalItemCount": 58, + "type": "IPF.Note" +} +``` diff --git a/api-reference/beta/api/mailboxfolder-list-childfolders.md b/api-reference/beta/api/mailboxfolder-list-childfolders.md new file mode 100644 index 00000000000..f3bfced4c48 --- /dev/null +++ b/api-reference/beta/api/mailboxfolder-list-childfolders.md @@ -0,0 +1,114 @@ +--- +title: "List childFolders" +description: "Get the mailboxFolder collection under the specified mailboxFolder in a mailbox." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: apiPageType +--- + +# List childFolders + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Get the [mailboxFolder](../resources/mailboxfolder.md) collection under the specified [mailboxFolder](../resources/mailboxfolder.md) in a mailbox. + +## 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). + + +[!INCLUDE [permissions-table](../includes/permissions/mailboxfolder-list-childfolders-permissions.md)] + +## HTTP request + + +``` http +GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders +``` + +## Optional query parameters + +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| + +## Request body + +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `200 OK` response code and a collection of [mailboxFolder](../resources/mailboxfolder.md) objects in the response body. + +## Examples + +### Request + +The following example shows how to get the mailbox folder collection under a specified folder. + + +``` http +GET https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders/NJWt2LeVEAAAIBDAAAAA==/childFolders +``` + +### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-type: application/json +Content-length: 232 + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders('NJWt2LeVEAAAIBDAAAAA==')/childFolders", + "value": [ + { + "@odata.type": "#microsoft.graph.mailboxFolder", + "id": "EDSVrdi3lRAAEvNS16AAA=", + "displayName": "Folder_1", + "parentFolderId": "NJWt2LeVEAAAIBDAAAAA==", + "parentMailboxUrl": "https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93", + "childFolderCount": 0, + "totalItemCount": 20, + "type": "IPF.Note" + }, + { + "@odata.type": "#microsoft.graph.mailboxFolder", + "id": "EDSVrdi3lRAAEED0yTAAA=", + "displayName": "Folder_2", + "parentFolderId": "NJWt2LeVEAAAIBDAAAAA==", + "parentMailboxUrl": "https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93", + "childFolderCount": 0, + "totalItemCount": 1, + "type": "IPF.Note" + } + ] +} +``` diff --git a/api-reference/beta/api/mailboxfolder-list-items.md b/api-reference/beta/api/mailboxfolder-list-items.md new file mode 100644 index 00000000000..1a886adc292 --- /dev/null +++ b/api-reference/beta/api/mailboxfolder-list-items.md @@ -0,0 +1,167 @@ +--- +title: "List items" +description: "Get the mailboxItem collection within a specified folder in a mailbox." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: apiPageType +--- + +# List items + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Get the [mailboxItem](../resources/mailboxitem.md) collection within a specified [mailboxFolder](../resources/mailboxfolder.md) in a mailbox. + +## 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). + + +[!INCLUDE [permissions-table](../includes/permissions/mailboxfolder-list-items-permissions.md)] + +## HTTP request + + +``` http +GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/items +``` + +## Optional query parameters + +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| + +## Request body + +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `200 OK` response code and a collection of [mailboxItem](../resources/mailboxitem.md) objects in the response body. + +## Examples + +### Example 1: List items + +The following example shows how to get the mailbox items within a specified folder in a mailbox. + +#### Request + +The following example shows a request. + +``` http +GET https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders/NJWt2LeVEAAAIBDAAAAA==/items +``` + +#### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-type: application/json +Content-length: 232 + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders('NJWt2LeVEAAAIBDAAAAA==')/items", + "value": [ + { + "@odata.type": "#microsoft.graph.mailboxItem", + "@odata.etag": "W/\"CQAAABYAAACQ2fKdhq8oSKEDSVrdi3lRAAE8zPIo\"", + "id": "EDSVrdi3lRAAE9J-20AAA=", + "createdDateTime": "2021-09-15T12:16:38Z", + "lastModifiedDateTime": "2021-09-15T12:16:41Z", + "changeKey": "CQAAABYAAACQ2fKdhq8oSKEDSVrdi3lRAAE8zPIo", + "categories": [], + "type": "IPM.Note", + "size": 71133 + }, + { + "@odata.type": "#microsoft.graph.mailboxItem", + "@odata.etag": "W/\"CQAAABYAAACQ2fKdhq8oSKEDSVrdi3lRAAE8zO5W\"", + "id": "EDSVrdi3lRAAE9J-2zAAA=", + "createdDateTime": "2021-09-15T11:06:36Z", + "lastModifiedDateTime": "2021-09-15T11:06:40Z", + "changeKey": "CQAAABYAAACQ2fKdhq8oSKEDSVrdi3lRAAE8zO5W", + "categories": [], + "type": "IPM.Note", + "size": 79968 + } + ], + "@odata.nextLink": "https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders('NJWt2LeVEAAAIBDAAAAA==')/items?%24skip=10" +} +``` + +### Example 2: List items using query parameter + +The following example uses the `$filter`, `$select`, and `$top` query parameters. The `$filter` parameter refines the results and returns only items with **createdDateTime** between `2021-08-21` and `2021-09-16`. The `$select` parameter specifies to return only a subset of the properties of each item in the response, and the `$top` parameter sets the page size of the result set to return only the top item in the mailbox under the specified folder. + +#### Request + +The following example shows a request. + +``` http +GET https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders/Inbox/items?$filter=createdDateTime ge 2021-08-21 and createdDateTime lt 2021-09-16&$select=type,size&$top=1 +``` + +#### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-type: application/json +Content-length: 232 + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders('Inbox')/items", + "value": [ + { + "@odata.type": "#microsoft.graph.mailboxItem", + "@odata.etag": "W/\"CQAAABYAAACQ2fKdhq8oSKEDSVrdi3lRAAFOoqvk\"", + "id": "EDSVrdi3lRAAE9J-2xAAA=", + "type": "IPM.Note", + "size": 91339 + } + ], + "@odata.nextLink": "https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders('Inbox')/items?%24filter=createdDateTime+ge+2021-08-21+and+createdDateTime+lt+2021-09-16&%24select=type%2csize&%24top=1&%24skip=1" +} +``` diff --git a/api-reference/beta/api/mailboxfolder-update.md b/api-reference/beta/api/mailboxfolder-update.md new file mode 100644 index 00000000000..77d0086ce73 --- /dev/null +++ b/api-reference/beta/api/mailboxfolder-update.md @@ -0,0 +1,113 @@ +--- +title: "Update mailboxFolder" +description: "Update mailboxFolder properties such as the displayName within a mailbox." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: apiPageType +--- + +# Update mailboxFolder + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Update [mailboxFolder](../resources/mailboxfolder.md) properties such as the **displayName** within a mailbox. + +> [!NOTE] +> The folder **type** can't be updated. Instead, the folder needs to be deleted and a new folder can be created. + +## 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). + + +[!INCLUDE [permissions-table](../includes/permissions/mailboxfolder-update-permissions.md)] + +## HTTP request + + +``` http +PATCH /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId} +PATCH /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders/{mailboxFolderId} +``` + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Content-Type|application/json. Required.| + +## Request body + +[!INCLUDE [table-intro](../../includes/update-property-table-intro.md)] + +|Property|Type|Description| +|:---|:---|:---| +|displayName|String|The display name of the folder.| + +## Response + +If successful, this method returns a `200 OK` response code and an updated [mailboxFolder](../resources/mailboxfolder.md) object in the response body. + +## Examples + +### Request + +The following example shows how to update certain folder properties of a mailbox folder. + +``` http +PATCH https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0648f21@aab09c93/folders/AAMkAGVmMDEzM + +{ + "displayName": "Announcements", + "singleValueExtendedProperties": [ + { + "id": "String 0x3001", + "value": "Announcements" + } + ] +} +``` + +### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-type: application/json +Content-length: 179 + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/exchange/mailboxes('MBX%3A73c326ef%402829ab8a')/folders/$entity", + "id": "AQMkAGUw==", + "displayName": "Announcements", + "parentFolderId": "AQMkAGUc==", + "parentMailboxUrl": "https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0648f21@aab09c93", + "childFolderCount": 0, + "totalItemCount": 0, + "type": "IPF.Note" +} +``` diff --git a/api-reference/beta/api/mailboxitem-delta.md b/api-reference/beta/api/mailboxitem-delta.md new file mode 100644 index 00000000000..422fb5c5f3d --- /dev/null +++ b/api-reference/beta/api/mailboxitem-delta.md @@ -0,0 +1,136 @@ +--- +title: "mailboxItem: delta" +description: "Get a set of mailboxItem objects that have been added, deleted, or updated in a specified folder." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: apiPageType +--- + +# mailboxItem: delta + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Get a set of [mailboxItem](../resources/mailboxitem.md) objects that have been added, deleted, or updated in a specified [mailboxFolder](../resources/mailboxfolder.md). + +A **delta** function call for items in a folder is similar to a GET request, except that by appropriately applying [state tokens](/graph/delta-query-overview) in one or more of these calls, you can [query for incremental changes in the items in that folder](/graph/delta-query-messages). This approach allows you to maintain and synchronize a local store of a user's mailbox items without having to fetch the entire set of items from the server every time. + +## 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). + + +[!INCLUDE [permissions-table](../includes/permissions/mailboxitem-delta-permissions.md)] + +## HTTP request + + +``` http +GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/items/delta +``` + +## Query parameters + +Tracking changes in items incurs a round of one or more **delta** function calls. If you use any query parameter (other than `$deltaToken` and `$skipToken`), you must specify it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters into the token portion of the `nextLink` or `deltaLink` URL provided in the response. You only need to specify any desired query parameters once upfront. In subsequent requests, simply copy and apply the `nextLink` or `deltaLink` URL from the previous response, as that URL already includes the encoded, desired parameters. + +| Query parameter|Description| +|:----------------|:-------| +| $deltaToken|A [state token](/graph/delta-query-overview) returned in the `deltaLink` URL of the previous **delta** function call for the same item collection, which indicates the completion of that round of change tracking. Save and apply the entire `deltaLink` URL including this token in the first request of the next round of change tracking for that collection.| +| $skipToken|A [state token](/graph/delta-query-overview) returned in the `nextLink` URL of the previous **delta** function call, indicating further changes are available to be tracked in the same item collection.| + +### OData query parameters + +- You can use the `$select` query parameter to specify only the properties you need for best performance. The **id** property is always returned. +- This delta query supports the `$select` and `$top` query parameters for items. +- Limited support exists for `$filter` and `$orderby`: + - The only supported `$filter` expresssions are `$filter=receivedDateTime+ge+{value}` and `$filter=receivedDateTime+gt+{value}`. + - The only supported `$orderby` expression is `$orderby=receivedDateTime+desc`. If you don't include an `$orderby` expression, the return order isn't guaranteed. +- The `$search` query parameter isn't supported. + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Prefer|odata.maxpagesize={x}. Optional.| + +## Request body + +Don't supply a request body for this method. + +## Response + +If successful, this function returns a `200 OK` response code and a collection of [mailboxItem](../resources/mailboxitem.md) objects in the response body. + +## Examples + +### Request + +The following example shows how to make a single **delta** function call and limit the maximum number of items in the response body to two. + +To track changes in the items in a folder, you make one or more **delta** function calls to get the set of incremental changes since the last delta query. + +For an example that shows a round of delta query calls, see [Get incremental changes to items in a folder](/graph/delta-query-messages). + + +``` http +GET https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders/AAMkAGUwNjQ4ZyTAAA=/items/delta +Prefer: odata.maxpagesize=2 +``` + +### Response + +If the request is successful, the response includes a state token that is either a `$skipToken` (in an **@odata.nextLink** response header) or a `$deltaToken` (in an **@odata.deltaLink** response header). Respectively, they indicate whether you should continue with the round or you completed getting all the changes for that round. + +The following example shows a `$skipToken` in an **@odata.nextLink** response header. + +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-Type: application/json +Content-length: 337 + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(mailboxItem)", + "@odata.nextLink": "https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders/AAMkAGUwNjQ4ZyTAAA=/items/delta?$skiptoken={_skipToken_}", + "value": [ + { + "@odata.type": "#microsoft.graph.mailboxItem", + "@odata.etag": "W/\"CQAAABYAAACQ2fKdhq8oSKEDSVrdi3lRAAFR+6ZT\"", + "createdDateTime": "2021-10-19T06:30:30Z", + "lastModifiedDateTime": "2021-10-19T07:17:06Z", + "changeKey": "CQAAABYAAACQ2fKdhq8oSKEDSVrdi3lRAAFR+6ZT", + "categories": [], + "type": "IPM.Note", + "size": 75329, + "id": "AAMkAGUwNjQ4ZyTAACQ2fKdhq8oSKEDSVrdi3lRAAFSX03WAAA=" + } + ] +} +``` + +## Related content + +- [Use delta query to track changes in Microsoft Graph data](/graph/delta-query-overview) +- [Get incremental changes to folders in a mailbox](./mailboxfolder-delta.md) diff --git a/api-reference/beta/api/mailboxitem-get.md b/api-reference/beta/api/mailboxitem-get.md new file mode 100644 index 00000000000..d500341f1b8 --- /dev/null +++ b/api-reference/beta/api/mailboxitem-get.md @@ -0,0 +1,101 @@ +--- +title: "Get mailboxItem" +description: "Read the properties and relationships of a mailboxItem object." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: apiPageType +--- + +# Get mailboxItem + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Read the properties and relationships of a [mailboxItem](../resources/mailboxitem.md) object. + +## 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). + + +[!INCLUDE [permissions-table](../includes/permissions/mailboxitem-get-permissions.md)] + +## HTTP request + + +``` http +GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/items/{mailboxItemId} +``` + +## Optional query parameters + +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| + +## Request body + +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `200 OK` response code and a [mailboxItem](../resources/mailboxitem.md) object in the response body. + +## Examples + +### Request + +The following example shows a request. + +``` http +GET https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0648f21@aab09c93/folders/AAMkAGVmMDEzM/items/AAMkAGI1AAAoZCfHAAA= +``` + + +### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-Type: application/json +Content-length: 232 + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders('Inbox')/items$entity", + "@odata.type": "#microsoft.graph.mailboxItem", + "@odata.etag": "W/\"CQAAABYAAACQ2fKdhq8oSKEDSVrdi3lRAAE8zPIo\"", + "id": "EDSVrdi3lRAAE9J-20AAA=", + "createdDateTime": "2021-09-15T12:16:38Z", + "lastModifiedDateTime": "2021-09-15T12:16:41Z", + "changeKey": "CQAAABYAAACQ2fKdhq8oSKEDSVrdi3lRAAE8zPIo", + "categories": [], + "type": "IPM.Note", + "size": 71133 +} +``` diff --git a/api-reference/beta/api/onlinemeeting-update.md b/api-reference/beta/api/onlinemeeting-update.md index 39f5804ee2d..e90845ac782 100644 --- a/api-reference/beta/api/onlinemeeting-update.md +++ b/api-reference/beta/api/onlinemeeting-update.md @@ -66,7 +66,7 @@ PATCH /users/{userId}/onlineMeetings/{meetingId} > [!NOTE] > -> - **userId** is the object ID of a user in [Microsoft Entra admin center > user management page](https://entra.microsoft.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more information, see [application access policy](/graph/cloud-communication-online-meeting-application-access-policy). +> - `userId` is the object ID of a user in [Microsoft Entra admin center > user management page](https://entra.microsoft.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more information, see [application access policy](/graph/cloud-communication-online-meeting-application-access-policy). > - `meetingId` is the **id** of an [onlineMeeting](../resources/onlinemeeting.md) object. ## Request headers @@ -93,7 +93,7 @@ The last column indicates whether updating this property takes effect for an in- | allowBreakoutRooms | Boolean | Indicates whether breakout rooms are enabled for the meeting. | No | | allowedLobbyAdmitters | [allowedLobbyAdmitterRoles](../resources/onlinemeetingbase.md#allowedlobbyadmitterroles-values) | Specifies the users who can admit from the lobby. Possible values are: `organizerAndCoOrganizersAndPresenters`, `organizerAndCoOrganizers`, `unknownFutureValue`. | Yes | | allowedPresenters | onlineMeetingPresenters | Specifies who can be a presenter in a meeting. | Yes | -| allowLiveShare | Boolean | Indicates whether live share is enabled for the meeting. | No | +| allowLiveShare | meetingLiveShareOptions | Indicates whether live share is enabled for the meeting. | No | | allowMeetingChat | meetingChatMode | Specifies the mode of meeting chat. | Yes | | allowPowerPointSharing | Boolean | Indicates whether PowerPoint live is enabled for the meeting. | No | | allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the meeting. | Yes | @@ -108,7 +108,7 @@ The last column indicates whether updating this property takes effect for an in- > [!NOTE] > ->- For the list of possible values for **allowedPresenters** and **allowMeetingChat**, see [onlineMeeting](../resources/onlinemeeting.md). +>- For the list of possible values for **allowedPresenters**, **allowLiveShare**, and **allowMeetingChat**, see [onlineMeeting](../resources/onlinemeeting.md). >- When updating the value of **allowedPresenters** to `roleIsPresenter`, include a full list of **attendees** with specified attendees' **role** set to `presenter` in the request body. ## Response diff --git a/api-reference/beta/api/site-archive.md b/api-reference/beta/api/site-archive.md index 082f356081b..c7f90fd1862 100644 --- a/api-reference/beta/api/site-archive.md +++ b/api-reference/beta/api/site-archive.md @@ -69,10 +69,34 @@ The following example shows how to archive a site. POST https://graph.microsoft.com/beta/sites/contoso.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740/archive ``` +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/archive-site-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/archive-site-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/archive-site-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/archive-site-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/archive-site-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/archive-site-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/archive-site-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + --- ### Response diff --git a/api-reference/beta/api/site-unarchive.md b/api-reference/beta/api/site-unarchive.md index dbf5b34c3e0..cf8f9127c18 100644 --- a/api-reference/beta/api/site-unarchive.md +++ b/api-reference/beta/api/site-unarchive.md @@ -70,10 +70,34 @@ The following example shows how to unarchive a site. POST https://graph.microsoft.com/beta/sites/contoso.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740/unarchive ``` +# [C#](#tab/csharp) +[!INCLUDE [sample-code](../includes/snippets/csharp/unarchive-site-csharp-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [CLI](#tab/cli) +[!INCLUDE [sample-code](../includes/snippets/cli/unarchive-site-cli-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Go](#tab/go) +[!INCLUDE [sample-code](../includes/snippets/go/unarchive-site-go-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Java](#tab/java) +[!INCLUDE [sample-code](../includes/snippets/java/unarchive-site-java-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/unarchive-site-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) +[!INCLUDE [sample-code](../includes/snippets/php/unarchive-site-php-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +# [Python](#tab/python) +[!INCLUDE [sample-code](../includes/snippets/python/unarchive-site-python-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + --- ### Response diff --git a/api-reference/beta/api/teamschannelplanner-list-plans.md b/api-reference/beta/api/teamschannelplanner-list-plans.md deleted file mode 100644 index 618905138e8..00000000000 --- a/api-reference/beta/api/teamschannelplanner-list-plans.md +++ /dev/null @@ -1,116 +0,0 @@ ---- -title: "List plans" -description: "Get a list of plannerPlan objects owned by a shared channel in Teams." -ms.localizationpriority: medium -author: "DanluCui" -ms.subservice: "planner" -doc_type: apiPageType -ms.date: 01/15/2025 ---- - -# List plans - -Namespace: microsoft.graph - -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - -Get a list of [plannerPlan](../resources/plannerplan.md) objects owned by a shared [channel](../resources/channel.md) in Teams. - -[!INCLUDE [national-cloud-support](../../includes/global-us.md)] - -## 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). - - -[!INCLUDE [permissions-table](../includes/permissions/teamschannelplanner-list-plans-permissions.md)] - -## HTTP request - -```http -GET /teams/{team-id}/channels/{channel-id}/planner/plans -``` - -## Request headers -| Name |Description| -|:----------|:----------| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| - -## Request body -Don't supply a request body for this method. - -## Response - -If successful, this method returns a `200 OK` response code and a collection of [plannerPlan](../resources/plannerplan.md) objects in the response body. - -This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the `403` and `404` responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). - -## Examples - -### Request - -The following example shows a request. - - -```http -GET https://graph.microsoft.com/beta/teams/a738af50-90f1-472c-b3c3-a468f88ceaba/channels/19:yVS-hfmJ8w61Vu4oehlAr-y9G0eeyY11D8elrrDSvCU1@thread.tacv2/planner/plans -``` - -### Response - -The following example shows the response. - ->**Note:** The response object shown here might be shortened for readability. - -```http -HTTP/1.1 200 OK -Content-type: application/json - -{ - "value": [ - { - "@odata.etag": "W/\"JzEtUGxhbiAgQEBAQEBAQEBAQEBAQEBARCc=\"", - "createdDateTime": "2025-01-14T18:03:25.8457422Z", - "isArchived": false, - "owner": "ba2b2488-cb8c-4dbc-882e-a9a8311bfee9", - "title": "travel plan", - "id": "TQZYwVBC4E6BUIg4nfSnfJUADdBY", - "createdBy": { - "application": { - "id": "de8bc8b5-d9f9-48b1-a8ad-b748da725064" - }, - "user": { - "id": "ba2b2488-cb8c-4dbc-882e-a9a8311bfee9" - } - }, - "container": { - "containerId": "a738af50-90f1-472c-b3c3-a468f88ceaba/channels/19:yVS-hfmJ8w61Vu4oehlAr-y9G0eeyY11D8elrrDSvCU1@thread.tacv2", - "type": "teamsChannel", - "url": "https://graph.microsoft.com/beta/teams/a738af50-90f1-472c-b3c3-a468f88ceaba/channels/19:yVS-hfmJ8w61Vu4oehlAr-y9G0eeyY11D8elrrDSvCU1@thread.tacv2" - } - } - ] -} -``` - - - - diff --git a/api-reference/beta/api/usersettings-list-exchange.md b/api-reference/beta/api/usersettings-list-exchange.md new file mode 100644 index 00000000000..4c340e5660e --- /dev/null +++ b/api-reference/beta/api/usersettings-list-exchange.md @@ -0,0 +1,97 @@ +--- +title: "List Exchange settings" +description: "Get a list of Exchange settings, including mailboxes that belong to a user." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: apiPageType +--- + +# List Exchange settings + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Get a list of Exchange settings, including mailboxes that belong to a user. Currently, the mailbox types supported are the user's primary and in-place archive. To learn how to get a list of users in a tenant, see [List users](../api/user-list.md). + +## 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). + + +[!INCLUDE [permissions-table](../includes/permissions/usersettings-list-exchange-permissions.md)] + +## HTTP request + + +``` http +GET /users/{id}/settings/exchange +``` + +## Optional query parameters + +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| + +## Request body + +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `200 OK` response code and a collection of [exchangeSettings](../resources/exchangesettings.md) objects in the response body. + +## Examples + +### Request + +The following example shows a request. + +``` http +GET https://graph.microsoft.com/beta/users/megan@contoso.com/settings/exchange +``` + +### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-type: application/json +Content-length: 232 + +{ + "value": [ + { + "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('megan%40contoso.com')/settings/exchange/$entity", + "primaryMailboxId": "MBX:e0643f21@a7809c93", + "inPlaceArchiveMailboxId": "MBX:4eba5149@a7809c93" + } + ] +} +``` diff --git a/api-reference/beta/includes/permissions/directoryobject-checkmembergroups-6-permissions.md b/api-reference/beta/includes/permissions/directoryobject-checkmembergroups-6-permissions.md deleted file mode 100644 index ddc8495a891..00000000000 --- a/api-reference/beta/includes/permissions/directoryobject-checkmembergroups-6-permissions.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" -ms.topic: include -ms.localizationpriority: medium ---- - -|Permission type|Least privileged permissions|Higher privileged permissions| -|:---|:---|:---| -|Delegated (work or school account)|Application.Read.All|Application.ReadWrite.All, Device.Read.All, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, GroupMember.Read.All, User.Read.All, User.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Application.Read.All|Application.ReadWrite.All, Device.Read.All, Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, GroupMember.Read.All, User.Read.All, User.ReadWrite.All| - diff --git a/api-reference/beta/includes/permissions/mailbox-createimportsession-permissions.md b/api-reference/beta/includes/permissions/mailbox-createimportsession-permissions.md new file mode 100644 index 00000000000..89648571f1c --- /dev/null +++ b/api-reference/beta/includes/permissions/mailbox-createimportsession-permissions.md @@ -0,0 +1,11 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|MailboxItem.ImportExport|Not supported.| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|MailboxItem.ImportExport.All|Not supported.| diff --git a/api-reference/beta/includes/permissions/mailbox-delete-folders-permissions.md b/api-reference/beta/includes/permissions/mailbox-delete-folders-permissions.md new file mode 100644 index 00000000000..a9dcb70c6c4 --- /dev/null +++ b/api-reference/beta/includes/permissions/mailbox-delete-folders-permissions.md @@ -0,0 +1,11 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|MailboxFolder.Read|MailboxFolder.ReadWrite| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|MailboxFolder.Read.All|MailboxFolder.ReadWrite.All| diff --git a/api-reference/beta/includes/permissions/mailbox-exportitems-permissions.md b/api-reference/beta/includes/permissions/mailbox-exportitems-permissions.md new file mode 100644 index 00000000000..89648571f1c --- /dev/null +++ b/api-reference/beta/includes/permissions/mailbox-exportitems-permissions.md @@ -0,0 +1,11 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|MailboxItem.ImportExport|Not supported.| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|MailboxItem.ImportExport.All|Not supported.| diff --git a/api-reference/beta/includes/permissions/mailbox-list-folders-permissions.md b/api-reference/beta/includes/permissions/mailbox-list-folders-permissions.md new file mode 100644 index 00000000000..a9dcb70c6c4 --- /dev/null +++ b/api-reference/beta/includes/permissions/mailbox-list-folders-permissions.md @@ -0,0 +1,11 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|MailboxFolder.Read|MailboxFolder.ReadWrite| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|MailboxFolder.Read.All|MailboxFolder.ReadWrite.All| diff --git a/api-reference/beta/includes/permissions/mailbox-post-folders-permissions.md b/api-reference/beta/includes/permissions/mailbox-post-folders-permissions.md new file mode 100644 index 00000000000..a9dcb70c6c4 --- /dev/null +++ b/api-reference/beta/includes/permissions/mailbox-post-folders-permissions.md @@ -0,0 +1,11 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|MailboxFolder.Read|MailboxFolder.ReadWrite| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|MailboxFolder.Read.All|MailboxFolder.ReadWrite.All| diff --git a/api-reference/beta/includes/permissions/mailboxfolder-delta-permissions.md b/api-reference/beta/includes/permissions/mailboxfolder-delta-permissions.md new file mode 100644 index 00000000000..a9dcb70c6c4 --- /dev/null +++ b/api-reference/beta/includes/permissions/mailboxfolder-delta-permissions.md @@ -0,0 +1,11 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|MailboxFolder.Read|MailboxFolder.ReadWrite| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|MailboxFolder.Read.All|MailboxFolder.ReadWrite.All| diff --git a/api-reference/beta/includes/permissions/mailboxfolder-get-permissions.md b/api-reference/beta/includes/permissions/mailboxfolder-get-permissions.md new file mode 100644 index 00000000000..a9dcb70c6c4 --- /dev/null +++ b/api-reference/beta/includes/permissions/mailboxfolder-get-permissions.md @@ -0,0 +1,11 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|MailboxFolder.Read|MailboxFolder.ReadWrite| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|MailboxFolder.Read.All|MailboxFolder.ReadWrite.All| diff --git a/api-reference/beta/includes/permissions/mailboxfolder-list-childfolders-permissions.md b/api-reference/beta/includes/permissions/mailboxfolder-list-childfolders-permissions.md new file mode 100644 index 00000000000..a9dcb70c6c4 --- /dev/null +++ b/api-reference/beta/includes/permissions/mailboxfolder-list-childfolders-permissions.md @@ -0,0 +1,11 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|MailboxFolder.Read|MailboxFolder.ReadWrite| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|MailboxFolder.Read.All|MailboxFolder.ReadWrite.All| diff --git a/api-reference/beta/includes/permissions/mailboxfolder-list-items-permissions.md b/api-reference/beta/includes/permissions/mailboxfolder-list-items-permissions.md new file mode 100644 index 00000000000..6ba9a7999e0 --- /dev/null +++ b/api-reference/beta/includes/permissions/mailboxfolder-list-items-permissions.md @@ -0,0 +1,11 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|MailboxItem.Read|Not supported.| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|MailboxItem.Read.All|Not supported.| diff --git a/api-reference/beta/includes/permissions/mailboxfolder-update-permissions.md b/api-reference/beta/includes/permissions/mailboxfolder-update-permissions.md new file mode 100644 index 00000000000..a9dcb70c6c4 --- /dev/null +++ b/api-reference/beta/includes/permissions/mailboxfolder-update-permissions.md @@ -0,0 +1,11 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|MailboxFolder.Read|MailboxFolder.ReadWrite| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|MailboxFolder.Read.All|MailboxFolder.ReadWrite.All| diff --git a/api-reference/beta/includes/permissions/mailboxitem-delta-permissions.md b/api-reference/beta/includes/permissions/mailboxitem-delta-permissions.md new file mode 100644 index 00000000000..6ba9a7999e0 --- /dev/null +++ b/api-reference/beta/includes/permissions/mailboxitem-delta-permissions.md @@ -0,0 +1,11 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|MailboxItem.Read|Not supported.| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|MailboxItem.Read.All|Not supported.| diff --git a/api-reference/beta/includes/permissions/mailboxitem-get-permissions.md b/api-reference/beta/includes/permissions/mailboxitem-get-permissions.md new file mode 100644 index 00000000000..6ba9a7999e0 --- /dev/null +++ b/api-reference/beta/includes/permissions/mailboxitem-get-permissions.md @@ -0,0 +1,11 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|MailboxItem.Read|Not supported.| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|MailboxItem.Read.All|Not supported.| diff --git a/api-reference/beta/includes/permissions/teamschannelplanner-list-plans-permissions.md b/api-reference/beta/includes/permissions/teamschannelplanner-list-plans-permissions.md deleted file mode 100644 index e6f029cd184..00000000000 --- a/api-reference/beta/includes/permissions/teamschannelplanner-list-plans-permissions.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" -ms.topic: include -ms.localizationpriority: medium ---- - -|Permission type|Least privileged permissions|Higher privileged permissions| -|:---|:---|:---| -|Delegated (work or school account)|Tasks.Read|Tasks.ReadWrite| -|Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Tasks.Read.All|Tasks.ReadWrite.All| - diff --git a/api-reference/beta/includes/permissions/usersettings-list-exchange-permissions.md b/api-reference/beta/includes/permissions/usersettings-list-exchange-permissions.md new file mode 100644 index 00000000000..021d9164944 --- /dev/null +++ b/api-reference/beta/includes/permissions/usersettings-list-exchange-permissions.md @@ -0,0 +1,11 @@ +--- +description: Automatically generated file. DO NOT MODIFY +ms.topic: include +ms.localizationpriority: medium +--- + +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|User.Read.All|User.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|User.Read.All|User.ReadWrite.All| diff --git a/api-reference/beta/includes/snippets/cli/archive-site-cli-snippets.md b/api-reference/beta/includes/snippets/cli/archive-site-cli-snippets.md new file mode 100644 index 00000000000..8cae91a72eb --- /dev/null +++ b/api-reference/beta/includes/snippets/cli/archive-site-cli-snippets.md @@ -0,0 +1,10 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```bash + + +mgc-beta sites archive post --site-id {site-id} + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/cli/call-startrecording-cli-snippets.md b/api-reference/beta/includes/snippets/cli/call-startrecording-cli-snippets.md new file mode 100644 index 00000000000..20b04d15598 --- /dev/null +++ b/api-reference/beta/includes/snippets/cli/call-startrecording-cli-snippets.md @@ -0,0 +1,10 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```bash + + +mgc-beta communications calls start-recording post --call-id {call-id} + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/cli/call-starttranscription-cli-snippets.md b/api-reference/beta/includes/snippets/cli/call-starttranscription-cli-snippets.md new file mode 100644 index 00000000000..9c7bb3bbffd --- /dev/null +++ b/api-reference/beta/includes/snippets/cli/call-starttranscription-cli-snippets.md @@ -0,0 +1,13 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```bash + + +mgc-beta communications calls start-transcription post --call-id {call-id} --body '{ \ + "language": "en-us" \ +} \ +' + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/cli/call-stoprecording-cli-snippets.md b/api-reference/beta/includes/snippets/cli/call-stoprecording-cli-snippets.md new file mode 100644 index 00000000000..365641fe27b --- /dev/null +++ b/api-reference/beta/includes/snippets/cli/call-stoprecording-cli-snippets.md @@ -0,0 +1,10 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```bash + + +mgc-beta communications calls stop-recording post --call-id {call-id} + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/cli/call-stoptranscription-cli-snippets.md b/api-reference/beta/includes/snippets/cli/call-stoptranscription-cli-snippets.md new file mode 100644 index 00000000000..6d8b10645fe --- /dev/null +++ b/api-reference/beta/includes/snippets/cli/call-stoptranscription-cli-snippets.md @@ -0,0 +1,14 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```bash + + +mgc-beta communications calls stop-transcription post --call-id {call-id} --body '{ \ + "language": "en-us" \ +} \ + \ +' + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/cli/copy-item-conflicts-cli-snippets.md b/api-reference/beta/includes/snippets/cli/copy-item-conflicts-cli-snippets.md new file mode 100644 index 00000000000..021a549dbd8 --- /dev/null +++ b/api-reference/beta/includes/snippets/cli/copy-item-conflicts-cli-snippets.md @@ -0,0 +1,17 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```bash + + +mgc-beta drives items copy post --drive-id {drive-id} --drive-item-id {driveItem-id} --body '{ \ + "parentReference": { \ + "driveId": "b!s8RqPCGh0ESQS2EYnKM0IKS3lM7GxjdAviiob7oc5pXv_0LiL-62Qq3IXyrXnEop", \ + "id": "DCD0D3AD-8989-4F23-A5A2-2C086050513F" \ + }, \ + "childrenOnly": true \ +} \ +' + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/cli/create-ediscoveryholdpolicy-from--cli-snippets.md b/api-reference/beta/includes/snippets/cli/create-ediscoveryholdpolicy-from--cli-snippets.md index c1ca45e60db..bf86dcad3c5 100644 --- a/api-reference/beta/includes/snippets/cli/create-ediscoveryholdpolicy-from--cli-snippets.md +++ b/api-reference/beta/includes/snippets/cli/create-ediscoveryholdpolicy-from--cli-snippets.md @@ -8,7 +8,7 @@ description: "Automatically generated file. DO NOT MODIFY" mgc-beta security cases ediscovery-cases legal-holds create --ediscovery-case-id {ediscoveryCase-id} --body '{ \ "displayName": "My legalHold with sources", \ "description": "Created from Graph API", \ - "contentQuery": "KQL content query", \ + "contentQuery": "KQL content query" \ } \ ' diff --git a/api-reference/beta/includes/snippets/cli/create-retentionlabel-from--cli-snippets.md b/api-reference/beta/includes/snippets/cli/create-retentionlabel-from--cli-snippets.md index ccd16f1cfa2..306671784a9 100644 --- a/api-reference/beta/includes/snippets/cli/create-retentionlabel-from--cli-snippets.md +++ b/api-reference/beta/includes/snippets/cli/create-retentionlabel-from--cli-snippets.md @@ -5,7 +5,7 @@ description: "Automatically generated file. DO NOT MODIFY" ```bash -mgc-beta security labels retention-labels create --body '{ \ +mgc security labels retention-labels create --body '{ \ "@odata.type": "#microsoft.graph.security.retentionLabel", \ "displayName": "Retention Schedule 10005", \ "behaviorDuringRetentionPeriod": "retain", \ diff --git a/api-reference/beta/includes/snippets/cli/create-usersource-and-include-sources-cli-snippets.md b/api-reference/beta/includes/snippets/cli/create-usersource-and-include-sources-cli-snippets.md index a3cf18b2045..711f4ccaedb 100644 --- a/api-reference/beta/includes/snippets/cli/create-usersource-and-include-sources-cli-snippets.md +++ b/api-reference/beta/includes/snippets/cli/create-usersource-and-include-sources-cli-snippets.md @@ -7,7 +7,7 @@ description: "Automatically generated file. DO NOT MODIFY" mgc-beta security cases ediscovery-cases legal-holds user-sources create --ediscovery-case-id {ediscoveryCase-id} --ediscovery-hold-policy-id {ediscoveryHoldPolicy-id} --body '{ \ "email": "admin@contoso.com", \ - "includedSources": "mailbox" \ + "includedSources": "mailbox, site" \ } \ ' diff --git a/api-reference/beta/includes/snippets/cli/post-chatmessage-5-cli-snippets.md b/api-reference/beta/includes/snippets/cli/post-chatmessage-5-cli-snippets.md index 1f27f0301f7..47174f42ed0 100644 --- a/api-reference/beta/includes/snippets/cli/post-chatmessage-5-cli-snippets.md +++ b/api-reference/beta/includes/snippets/cli/post-chatmessage-5-cli-snippets.md @@ -6,17 +6,17 @@ description: "Automatically generated file. DO NOT MODIFY" mgc teams channels messages create --team-id {team-id} --channel-id {channel-id} --body '{ \ - "body": { \ - "contentType": "html", \ - "content": "Testing with file share link. " \ - }, \ - "attachments": [ \ - { \ - "id": "668f7fa8-8129-4de7-b32b-fe1b442e6ef1", \ - "contentType": "reference", \ - "contentUrl": "https://teamsgraph-my.sharepoint.com/:w:/g/personal/test_teamsgraph_onmicrosoft_com/Eah_j2YpgedNsyv-G0QubvEBma6Sd_76UtYkXwoJ-nYVEg?e=0H2Ibm" \ - } \ - ] \ + "body": { \ + "contentType": "html", \ + "content": "Testing with file share link. " \ + }, \ + "attachments": [ \ + { \ + "id": "668f7fa8-8129-4de7-b32b-fe1b442e6ef1", \ + "contentType": "reference", \ + "contentUrl": "https://teamsgraph-my.sharepoint.com/:w:/g/personal/test_teamsgraph_onmicrosoft_com/Eah_j2YpgedNsyv-G0QubvEBma6Sd_76UtYkXwoJ-nYVEg?e=0H2Ibm" \ + } \ + ] \ } \ ' diff --git a/api-reference/beta/includes/snippets/cli/unarchive-site-cli-snippets.md b/api-reference/beta/includes/snippets/cli/unarchive-site-cli-snippets.md new file mode 100644 index 00000000000..fde16728dcb --- /dev/null +++ b/api-reference/beta/includes/snippets/cli/unarchive-site-cli-snippets.md @@ -0,0 +1,10 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```bash + + +mgc-beta sites unarchive post --site-id {site-id} + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/cli/update-gradingcategories-delta-cli-snippets.md b/api-reference/beta/includes/snippets/cli/update-gradingcategories-delta-cli-snippets.md index 959a9e3136c..a3030eb39a2 100644 --- a/api-reference/beta/includes/snippets/cli/update-gradingcategories-delta-cli-snippets.md +++ b/api-reference/beta/includes/snippets/cli/update-gradingcategories-delta-cli-snippets.md @@ -5,27 +5,23 @@ description: "Automatically generated file. DO NOT MODIFY" ```bash -mgc-beta education classes assignment-settings patch --education-class-id {educationClass-id} --body '{ \ +mgc education classes assignment-settings patch --education-class-id {educationClass-id} --body '{ \ "gradingCategories@delta": [ \ { \ // Change this grading category's name \ - "id": "fb859cd3-943b-4cd6-9bbe-fe1c39eace0e", \ - "displayName": "Lab Test" \ + "id": "03bd9196-ce2e-41bd-902f-df9ae02de4db", \ + "displayName": "Lab Updated" \ }, \ { \ - // Delete this grading category \ + // Delete this grading category \ "@odata.context": "https://graph.microsoft.com/beta/$metadata#gradingCategories/$deletedEntity", \ - "id": "e2a86277-24f9-4f29-8196-8c83fc69d00d", \ + "id": "109e5d73-3ef7-42a5-88d8-7e30cdb85f06", \ "reason": "deleted" \ }, \ { \ - // Add a new grading category \ - "displayName": "Lab Practice", \ - "percentageWeight": 30 \ - }, \ - { \ - "displayName": "Lab Theory", \ - "percentageWeight": 10 \ + // Add a new grading category \ + "displayName": "New Homework", \ + "percentageWeight": 50 \ } \ ] \ } \ diff --git a/api-reference/beta/includes/snippets/csharp/archive-site-csharp-snippets.md b/api-reference/beta/includes/snippets/csharp/archive-site-csharp-snippets.md new file mode 100644 index 00000000000..8a92359ef7a --- /dev/null +++ b/api-reference/beta/includes/snippets/csharp/archive-site-csharp-snippets.md @@ -0,0 +1,13 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```csharp + +// Code snippets are only available for the latest version. Current version is 5.x + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp +await graphClient.Sites["{site-id}"].Archive.PostAsync(); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/csharp/call-startrecording-csharp-snippets.md b/api-reference/beta/includes/snippets/csharp/call-startrecording-csharp-snippets.md new file mode 100644 index 00000000000..70e3f9031b7 --- /dev/null +++ b/api-reference/beta/includes/snippets/csharp/call-startrecording-csharp-snippets.md @@ -0,0 +1,13 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```csharp + +// Code snippets are only available for the latest version. Current version is 5.x + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp +var result = await graphClient.Communications.Calls["{call-id}"].StartRecording.PostAsync(null); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/csharp/call-starttranscription-csharp-snippets.md b/api-reference/beta/includes/snippets/csharp/call-starttranscription-csharp-snippets.md new file mode 100644 index 00000000000..0fa94265af0 --- /dev/null +++ b/api-reference/beta/includes/snippets/csharp/call-starttranscription-csharp-snippets.md @@ -0,0 +1,21 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```csharp + +// Code snippets are only available for the latest version. Current version is 5.x + +// Dependencies +using Microsoft.Graph.Beta.Communications.Calls.Item.StartTranscription; + +var requestBody = new StartTranscriptionPostRequestBody +{ + Language = "en-us", +}; + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp +var result = await graphClient.Communications.Calls["{call-id}"].StartTranscription.PostAsync(requestBody); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/csharp/call-stoprecording-csharp-snippets.md b/api-reference/beta/includes/snippets/csharp/call-stoprecording-csharp-snippets.md new file mode 100644 index 00000000000..7b089415ca7 --- /dev/null +++ b/api-reference/beta/includes/snippets/csharp/call-stoprecording-csharp-snippets.md @@ -0,0 +1,13 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```csharp + +// Code snippets are only available for the latest version. Current version is 5.x + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp +var result = await graphClient.Communications.Calls["{call-id}"].StopRecording.PostAsync(null); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/csharp/call-stoptranscription-csharp-snippets.md b/api-reference/beta/includes/snippets/csharp/call-stoptranscription-csharp-snippets.md new file mode 100644 index 00000000000..ae7698594c8 --- /dev/null +++ b/api-reference/beta/includes/snippets/csharp/call-stoptranscription-csharp-snippets.md @@ -0,0 +1,21 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```csharp + +// Code snippets are only available for the latest version. Current version is 5.x + +// Dependencies +using Microsoft.Graph.Beta.Communications.Calls.Item.StopTranscription; + +var requestBody = new StopTranscriptionPostRequestBody +{ + Language = "en-us", +}; + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp +var result = await graphClient.Communications.Calls["{call-id}"].StopTranscription.PostAsync(requestBody); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/csharp/copy-item-conflicts-csharp-snippets.md b/api-reference/beta/includes/snippets/csharp/copy-item-conflicts-csharp-snippets.md new file mode 100644 index 00000000000..1d9cefcf446 --- /dev/null +++ b/api-reference/beta/includes/snippets/csharp/copy-item-conflicts-csharp-snippets.md @@ -0,0 +1,30 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```csharp + +// Code snippets are only available for the latest version. Current version is 5.x + +// Dependencies +using Microsoft.Graph.Beta.Drives.Item.Items.Item.Copy; +using Microsoft.Graph.Beta.Models; + +var requestBody = new CopyPostRequestBody +{ + ParentReference = new ItemReference + { + DriveId = "b!s8RqPCGh0ESQS2EYnKM0IKS3lM7GxjdAviiob7oc5pXv_0LiL-62Qq3IXyrXnEop", + Id = "DCD0D3AD-8989-4F23-A5A2-2C086050513F", + }, + ChildrenOnly = true, +}; + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp +var result = await graphClient.Drives["{drive-id}"].Items["{driveItem-id}"].Copy.PostAsync(requestBody, (requestConfiguration) => +{ + requestConfiguration.QueryParameters.@microsoft.graph.conflictBehavior = "replace"; +}); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/csharp/create-retentionlabel-from--csharp-snippets.md b/api-reference/beta/includes/snippets/csharp/create-retentionlabel-from--csharp-snippets.md index 1fc8de3c6b0..514a9c3a48e 100644 --- a/api-reference/beta/includes/snippets/csharp/create-retentionlabel-from--csharp-snippets.md +++ b/api-reference/beta/includes/snippets/csharp/create-retentionlabel-from--csharp-snippets.md @@ -7,7 +7,7 @@ description: "Automatically generated file. DO NOT MODIFY" // Code snippets are only available for the latest version. Current version is 5.x // Dependencies -using Microsoft.Graph.Beta.Models.Security; +using Microsoft.Graph.Models.Security; var requestBody = new RetentionLabel { diff --git a/api-reference/beta/includes/snippets/csharp/create-usersource-and-include-sources-csharp-snippets.md b/api-reference/beta/includes/snippets/csharp/create-usersource-and-include-sources-csharp-snippets.md index 26c0efb41ed..fb6dc45c0cb 100644 --- a/api-reference/beta/includes/snippets/csharp/create-usersource-and-include-sources-csharp-snippets.md +++ b/api-reference/beta/includes/snippets/csharp/create-usersource-and-include-sources-csharp-snippets.md @@ -12,7 +12,7 @@ using Microsoft.Graph.Beta.Models.Security; var requestBody = new UserSource { Email = "admin@contoso.com", - IncludedSources = SourceType.Mailbox, + IncludedSources = SourceType.Mailbox | SourceType.Site, }; // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp diff --git a/api-reference/beta/includes/snippets/csharp/unarchive-site-csharp-snippets.md b/api-reference/beta/includes/snippets/csharp/unarchive-site-csharp-snippets.md new file mode 100644 index 00000000000..b9b07edc373 --- /dev/null +++ b/api-reference/beta/includes/snippets/csharp/unarchive-site-csharp-snippets.md @@ -0,0 +1,13 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```csharp + +// Code snippets are only available for the latest version. Current version is 5.x + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp +await graphClient.Sites["{site-id}"].Unarchive.PostAsync(); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/csharp/update-gradingcategories-delta-csharp-snippets.md b/api-reference/beta/includes/snippets/csharp/update-gradingcategories-delta-csharp-snippets.md index 43cc540e9a5..e8c796de01c 100644 --- a/api-reference/beta/includes/snippets/csharp/update-gradingcategories-delta-csharp-snippets.md +++ b/api-reference/beta/includes/snippets/csharp/update-gradingcategories-delta-csharp-snippets.md @@ -7,7 +7,7 @@ description: "Automatically generated file. DO NOT MODIFY" // Code snippets are only available for the latest version. Current version is 5.x // Dependencies -using Microsoft.Graph.Beta.Models; +using Microsoft.Graph.Models; using Microsoft.Kiota.Abstractions.Serialization; var requestBody = new EducationAssignmentSettings @@ -20,10 +20,10 @@ var requestBody = new EducationAssignmentSettings new UntypedObject(new Dictionary { { - "id", new UntypedString("fb859cd3-943b-4cd6-9bbe-fe1c39eace0e") + "id", new UntypedString("03bd9196-ce2e-41bd-902f-df9ae02de4db") }, { - "displayName", new UntypedString("Lab Test") + "displayName", new UntypedString("Lab Updated") }, }), new UntypedObject(new Dictionary @@ -32,7 +32,7 @@ var requestBody = new EducationAssignmentSettings "@odata.context", new UntypedString("https://graph.microsoft.com/beta/$metadata#gradingCategories/$deletedEntity") }, { - "id", new UntypedString("e2a86277-24f9-4f29-8196-8c83fc69d00d") + "id", new UntypedString("109e5d73-3ef7-42a5-88d8-7e30cdb85f06") }, { "reason", new UntypedString("deleted") @@ -41,19 +41,10 @@ var requestBody = new EducationAssignmentSettings new UntypedObject(new Dictionary { { - "displayName", new UntypedString("Lab Practice") + "displayName", new UntypedString("New Homework") }, { - "percentageWeight", new UntypedString("30") - }, - }), - new UntypedObject(new Dictionary - { - { - "displayName", new UntypedString("Lab Theory") - }, - { - "percentageWeight", new UntypedString("10") + "percentageWeight", new UntypedString("50") }, }), } diff --git a/api-reference/beta/includes/snippets/go/archive-site-go-snippets.md b/api-reference/beta/includes/snippets/go/archive-site-go-snippets.md new file mode 100644 index 00000000000..66a4fb4f4f6 --- /dev/null +++ b/api-reference/beta/includes/snippets/go/archive-site-go-snippets.md @@ -0,0 +1,22 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```go + + +// Code snippets are only available for the latest major version. Current major version is $v0.* + +// Dependencies +import ( + "context" + msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" + //other-imports +) + + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go +graphClient.Sites().BySiteId("site-id").Archive().Post(context.Background(), nil) + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/go/call-startrecording-go-snippets.md b/api-reference/beta/includes/snippets/go/call-startrecording-go-snippets.md new file mode 100644 index 00000000000..4095090b6ed --- /dev/null +++ b/api-reference/beta/includes/snippets/go/call-startrecording-go-snippets.md @@ -0,0 +1,22 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```go + + +// Code snippets are only available for the latest major version. Current major version is $v0.* + +// Dependencies +import ( + "context" + msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" + //other-imports +) + + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go +startRecording, err := graphClient.Communications().Calls().ByCallId("call-id").StartRecording().Post(context.Background(), nil) + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/go/call-starttranscription-go-snippets.md b/api-reference/beta/includes/snippets/go/call-starttranscription-go-snippets.md new file mode 100644 index 00000000000..bc1900e1394 --- /dev/null +++ b/api-reference/beta/includes/snippets/go/call-starttranscription-go-snippets.md @@ -0,0 +1,26 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```go + + +// Code snippets are only available for the latest major version. Current major version is $v0.* + +// Dependencies +import ( + "context" + msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" + graphcommunications "github.com/microsoftgraph/msgraph-beta-sdk-go/communications" + //other-imports +) + +requestBody := graphcommunications.NewStartTranscriptionPostRequestBody() +language := "en-us" +requestBody.SetLanguage(&language) + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go +startTranscription, err := graphClient.Communications().Calls().ByCallId("call-id").StartTranscription().Post(context.Background(), requestBody, nil) + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/go/call-stoprecording-go-snippets.md b/api-reference/beta/includes/snippets/go/call-stoprecording-go-snippets.md new file mode 100644 index 00000000000..dfafc99bbdd --- /dev/null +++ b/api-reference/beta/includes/snippets/go/call-stoprecording-go-snippets.md @@ -0,0 +1,22 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```go + + +// Code snippets are only available for the latest major version. Current major version is $v0.* + +// Dependencies +import ( + "context" + msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" + //other-imports +) + + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go +stopRecording, err := graphClient.Communications().Calls().ByCallId("call-id").StopRecording().Post(context.Background(), nil) + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/go/call-stoptranscription-go-snippets.md b/api-reference/beta/includes/snippets/go/call-stoptranscription-go-snippets.md new file mode 100644 index 00000000000..d8b6164e9af --- /dev/null +++ b/api-reference/beta/includes/snippets/go/call-stoptranscription-go-snippets.md @@ -0,0 +1,26 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```go + + +// Code snippets are only available for the latest major version. Current major version is $v0.* + +// Dependencies +import ( + "context" + msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" + graphcommunications "github.com/microsoftgraph/msgraph-beta-sdk-go/communications" + //other-imports +) + +requestBody := graphcommunications.NewStopTranscriptionPostRequestBody() +language := "en-us" +requestBody.SetLanguage(&language) + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go +stopTranscription, err := graphClient.Communications().Calls().ByCallId("call-id").StopTranscription().Post(context.Background(), requestBody, nil) + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/go/copy-item-conflicts-go-snippets.md b/api-reference/beta/includes/snippets/go/copy-item-conflicts-go-snippets.md new file mode 100644 index 00000000000..ff8e8e7f809 --- /dev/null +++ b/api-reference/beta/includes/snippets/go/copy-item-conflicts-go-snippets.md @@ -0,0 +1,42 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```go + + +// Code snippets are only available for the latest major version. Current major version is $v0.* + +// Dependencies +import ( + "context" + msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" + graphdrives "github.com/microsoftgraph/msgraph-beta-sdk-go/drives" + graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models" + //other-imports +) + + +requestMicrosoftGraphConflictBehavior := "replace" + +requestParameters := &graphdrives.ItemItemsItemCopyRequestBuilderPostQueryParameters{ + MicrosoftGraphConflictBehavior: &requestMicrosoftGraphConflictBehavior, +} +configuration := &graphdrives.ItemItemsItemCopyRequestBuilderPostRequestConfiguration{ + QueryParameters: requestParameters, +} +requestBody := graphdrives.NewCopyPostRequestBody() +parentReference := graphmodels.NewItemReference() +driveId := "b!s8RqPCGh0ESQS2EYnKM0IKS3lM7GxjdAviiob7oc5pXv_0LiL-62Qq3IXyrXnEop" +parentReference.SetDriveId(&driveId) +id := "DCD0D3AD-8989-4F23-A5A2-2C086050513F" +parentReference.SetId(&id) +requestBody.SetParentReference(parentReference) +childrenOnly := true +requestBody.SetChildrenOnly(&childrenOnly) + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go +copy, err := graphClient.Drives().ByDriveId("drive-id").Items().ByDriveItemId("driveItem-id").Copy().Post(context.Background(), requestBody, configuration) + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/go/create-retentionlabel-from--go-snippets.md b/api-reference/beta/includes/snippets/go/create-retentionlabel-from--go-snippets.md index 516b485e655..cdaf020945b 100644 --- a/api-reference/beta/includes/snippets/go/create-retentionlabel-from--go-snippets.md +++ b/api-reference/beta/includes/snippets/go/create-retentionlabel-from--go-snippets.md @@ -5,13 +5,13 @@ description: "Automatically generated file. DO NOT MODIFY" ```go -// Code snippets are only available for the latest major version. Current major version is $v0.* +// Code snippets are only available for the latest major version. Current major version is $v1.* // Dependencies import ( "context" - msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" - graphmodelssecurity "github.com/microsoftgraph/msgraph-beta-sdk-go/models/security" + msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" + graphmodelssecurity "github.com/microsoftgraph/msgraph-sdk-go/models/security" //other-imports ) diff --git a/api-reference/beta/includes/snippets/go/create-usersource-and-include-sources-go-snippets.md b/api-reference/beta/includes/snippets/go/create-usersource-and-include-sources-go-snippets.md index 805975beaff..53dda844187 100644 --- a/api-reference/beta/includes/snippets/go/create-usersource-and-include-sources-go-snippets.md +++ b/api-reference/beta/includes/snippets/go/create-usersource-and-include-sources-go-snippets.md @@ -18,7 +18,7 @@ import ( requestBody := graphmodelssecurity.NewUserSource() email := "admin@contoso.com" requestBody.SetEmail(&email) -includedSources := graphmodels.MAILBOX_SOURCETYPE +includedSources := graphmodels.MAILBOX, SITE_SOURCETYPE requestBody.SetIncludedSources(&includedSources) // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go diff --git a/api-reference/beta/includes/snippets/go/unarchive-site-go-snippets.md b/api-reference/beta/includes/snippets/go/unarchive-site-go-snippets.md new file mode 100644 index 00000000000..e632c08de20 --- /dev/null +++ b/api-reference/beta/includes/snippets/go/unarchive-site-go-snippets.md @@ -0,0 +1,22 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```go + + +// Code snippets are only available for the latest major version. Current major version is $v0.* + +// Dependencies +import ( + "context" + msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" + //other-imports +) + + +// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go +graphClient.Sites().BySiteId("site-id").Unarchive().Post(context.Background(), nil) + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/java/archive-site-java-snippets.md b/api-reference/beta/includes/snippets/java/archive-site-java-snippets.md new file mode 100644 index 00000000000..c9cd0d0217a --- /dev/null +++ b/api-reference/beta/includes/snippets/java/archive-site-java-snippets.md @@ -0,0 +1,14 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```java + +// Code snippets are only available for the latest version. Current version is 6.x + +GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); + +graphClient.sites().bySiteId("{site-id}").archive().post(); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/java/call-startrecording-java-snippets.md b/api-reference/beta/includes/snippets/java/call-startrecording-java-snippets.md new file mode 100644 index 00000000000..01fc2ed28da --- /dev/null +++ b/api-reference/beta/includes/snippets/java/call-startrecording-java-snippets.md @@ -0,0 +1,14 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```java + +// Code snippets are only available for the latest version. Current version is 6.x + +GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); + +var result = graphClient.communications().calls().byCallId("{call-id}").startRecording().post(null); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/java/call-starttranscription-java-snippets.md b/api-reference/beta/includes/snippets/java/call-starttranscription-java-snippets.md new file mode 100644 index 00000000000..4c35eb3f2a7 --- /dev/null +++ b/api-reference/beta/includes/snippets/java/call-starttranscription-java-snippets.md @@ -0,0 +1,16 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```java + +// Code snippets are only available for the latest version. Current version is 6.x + +GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); + +com.microsoft.graph.beta.communications.calls.item.starttranscription.StartTranscriptionPostRequestBody startTranscriptionPostRequestBody = new com.microsoft.graph.beta.communications.calls.item.starttranscription.StartTranscriptionPostRequestBody(); +startTranscriptionPostRequestBody.setLanguage("en-us"); +var result = graphClient.communications().calls().byCallId("{call-id}").startTranscription().post(startTranscriptionPostRequestBody); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/java/call-stoprecording-java-snippets.md b/api-reference/beta/includes/snippets/java/call-stoprecording-java-snippets.md new file mode 100644 index 00000000000..707d9e2927f --- /dev/null +++ b/api-reference/beta/includes/snippets/java/call-stoprecording-java-snippets.md @@ -0,0 +1,14 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```java + +// Code snippets are only available for the latest version. Current version is 6.x + +GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); + +var result = graphClient.communications().calls().byCallId("{call-id}").stopRecording().post(null); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/java/call-stoptranscription-java-snippets.md b/api-reference/beta/includes/snippets/java/call-stoptranscription-java-snippets.md new file mode 100644 index 00000000000..578414189c9 --- /dev/null +++ b/api-reference/beta/includes/snippets/java/call-stoptranscription-java-snippets.md @@ -0,0 +1,16 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```java + +// Code snippets are only available for the latest version. Current version is 6.x + +GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); + +com.microsoft.graph.beta.communications.calls.item.stoptranscription.StopTranscriptionPostRequestBody stopTranscriptionPostRequestBody = new com.microsoft.graph.beta.communications.calls.item.stoptranscription.StopTranscriptionPostRequestBody(); +stopTranscriptionPostRequestBody.setLanguage("en-us"); +var result = graphClient.communications().calls().byCallId("{call-id}").stopTranscription().post(stopTranscriptionPostRequestBody); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/java/copy-item-conflicts-java-snippets.md b/api-reference/beta/includes/snippets/java/copy-item-conflicts-java-snippets.md new file mode 100644 index 00000000000..e5bfb61dd2f --- /dev/null +++ b/api-reference/beta/includes/snippets/java/copy-item-conflicts-java-snippets.md @@ -0,0 +1,22 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```java + +// Code snippets are only available for the latest version. Current version is 6.x + +GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); + +com.microsoft.graph.beta.drives.item.items.item.copy.CopyPostRequestBody copyPostRequestBody = new com.microsoft.graph.beta.drives.item.items.item.copy.CopyPostRequestBody(); +ItemReference parentReference = new ItemReference(); +parentReference.setDriveId("b!s8RqPCGh0ESQS2EYnKM0IKS3lM7GxjdAviiob7oc5pXv_0LiL-62Qq3IXyrXnEop"); +parentReference.setId("DCD0D3AD-8989-4F23-A5A2-2C086050513F"); +copyPostRequestBody.setParentReference(parentReference); +copyPostRequestBody.setChildrenOnly(true); +var result = graphClient.drives().byDriveId("{drive-id}").items().byDriveItemId("{driveItem-id}").copy().post(copyPostRequestBody, requestConfiguration -> { + requestConfiguration.queryParameters.@microsoft.graph.conflictBehavior = "replace"; +}); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/java/create-retentionlabel-from--java-snippets.md b/api-reference/beta/includes/snippets/java/create-retentionlabel-from--java-snippets.md index ee37e5fcd79..0881272afa8 100644 --- a/api-reference/beta/includes/snippets/java/create-retentionlabel-from--java-snippets.md +++ b/api-reference/beta/includes/snippets/java/create-retentionlabel-from--java-snippets.md @@ -8,18 +8,18 @@ description: "Automatically generated file. DO NOT MODIFY" GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); -com.microsoft.graph.beta.models.security.RetentionLabel retentionLabel = new com.microsoft.graph.beta.models.security.RetentionLabel(); +com.microsoft.graph.models.security.RetentionLabel retentionLabel = new com.microsoft.graph.models.security.RetentionLabel(); retentionLabel.setOdataType("#microsoft.graph.security.retentionLabel"); retentionLabel.setDisplayName("Retention Schedule 10005"); -retentionLabel.setBehaviorDuringRetentionPeriod(com.microsoft.graph.beta.models.security.BehaviorDuringRetentionPeriod.Retain); -retentionLabel.setActionAfterRetentionPeriod(com.microsoft.graph.beta.models.security.ActionAfterRetentionPeriod.StartDispositionReview); -retentionLabel.setRetentionTrigger(com.microsoft.graph.beta.models.security.RetentionTrigger.DateOfEvent); -com.microsoft.graph.beta.models.security.RetentionDurationInDays retentionDuration = new com.microsoft.graph.beta.models.security.RetentionDurationInDays(); +retentionLabel.setBehaviorDuringRetentionPeriod(com.microsoft.graph.models.security.BehaviorDuringRetentionPeriod.Retain); +retentionLabel.setActionAfterRetentionPeriod(com.microsoft.graph.models.security.ActionAfterRetentionPeriod.StartDispositionReview); +retentionLabel.setRetentionTrigger(com.microsoft.graph.models.security.RetentionTrigger.DateOfEvent); +com.microsoft.graph.models.security.RetentionDurationInDays retentionDuration = new com.microsoft.graph.models.security.RetentionDurationInDays(); retentionDuration.setOdataType("microsoft.graph.security.retentionDurationInDays"); retentionDuration.setDays(2555); retentionLabel.setRetentionDuration(retentionDuration); -LinkedList dispositionReviewStages = new LinkedList(); -com.microsoft.graph.beta.models.security.DispositionReviewStage dispositionReviewStage = new com.microsoft.graph.beta.models.security.DispositionReviewStage(); +LinkedList dispositionReviewStages = new LinkedList(); +com.microsoft.graph.models.security.DispositionReviewStage dispositionReviewStage = new com.microsoft.graph.models.security.DispositionReviewStage(); dispositionReviewStage.setStageNumber(1); dispositionReviewStage.setName("Stage1"); HashMap additionalData = new HashMap(); @@ -31,7 +31,7 @@ dispositionReviewStages.add(dispositionReviewStage); retentionLabel.setDispositionReviewStages(dispositionReviewStages); retentionLabel.setDescriptionForAdmins("retain for 7 years"); retentionLabel.setDescriptionForUsers("retain for 7 years"); -com.microsoft.graph.beta.models.security.FilePlanDescriptor descriptors = new com.microsoft.graph.beta.models.security.FilePlanDescriptor(); +com.microsoft.graph.models.security.FilePlanDescriptor descriptors = new com.microsoft.graph.models.security.FilePlanDescriptor(); HashMap additionalData1 = new HashMap(); additionalData1.put("authorityTemplate@odata.bind", "https://graph.microsoft.com/beta/security/labels/authorities('fie3f4fc-b966-4c40-94de-fb8a383658e4')"); additionalData1.put("categoryTemplate@odata.bind", "https://graph.microsoft.com/beta/security/labels/categories('0bjk8-b966-4c40-94de-fb8a383658e4')"); @@ -40,7 +40,7 @@ additionalData1.put("departmentTemplate@odata.bind", "https://graph.microsoft.co additionalData1.put("filePlanReferenceTemplate@odata.bind", "https://graph.microsoft.com/beta/security/labels/filePlanReferences('e095f4fc-b966-4c40-94de-fb8a383658e4')"); descriptors.setAdditionalData(additionalData1); retentionLabel.setDescriptors(descriptors); -retentionLabel.setDefaultRecordBehavior(com.microsoft.graph.beta.models.security.DefaultRecordBehavior.StartLocked); +retentionLabel.setDefaultRecordBehavior(com.microsoft.graph.models.security.DefaultRecordBehavior.StartLocked); HashMap additionalData2 = new HashMap(); additionalData2.put("retentionEventType@odata.bind", "https://graph.microsoft.com/beta/security/triggerTypes/retentionEventTypes('e095f4fc-b966-4c40-94de-fb8a383658e4')"); retentionLabel.setAdditionalData(additionalData2); diff --git a/api-reference/beta/includes/snippets/java/create-usersource-and-include-sources-java-snippets.md b/api-reference/beta/includes/snippets/java/create-usersource-and-include-sources-java-snippets.md index 2014e299f4c..426fad7b7d2 100644 --- a/api-reference/beta/includes/snippets/java/create-usersource-and-include-sources-java-snippets.md +++ b/api-reference/beta/includes/snippets/java/create-usersource-and-include-sources-java-snippets.md @@ -10,7 +10,7 @@ GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); com.microsoft.graph.beta.models.security.UserSource userSource = new com.microsoft.graph.beta.models.security.UserSource(); userSource.setEmail("admin@contoso.com"); -userSource.setIncludedSources(EnumSet.of(com.microsoft.graph.beta.models.security.SourceType.Mailbox)); +userSource.setIncludedSources(EnumSet.of(com.microsoft.graph.beta.models.security.SourceType.Mailbox, com.microsoft.graph.beta.models.security.SourceType.Site)); com.microsoft.graph.models.security.UserSource result = graphClient.security().cases().ediscoveryCases().byEdiscoveryCaseId("{ediscoveryCase-id}").legalHolds().byEdiscoveryHoldPolicyId("{ediscoveryHoldPolicy-id}").userSources().post(userSource); diff --git a/api-reference/beta/includes/snippets/java/unarchive-site-java-snippets.md b/api-reference/beta/includes/snippets/java/unarchive-site-java-snippets.md new file mode 100644 index 00000000000..4060427daed --- /dev/null +++ b/api-reference/beta/includes/snippets/java/unarchive-site-java-snippets.md @@ -0,0 +1,14 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```java + +// Code snippets are only available for the latest version. Current version is 6.x + +GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); + +graphClient.sites().bySiteId("{site-id}").unarchive().post(); + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/java/update-gradingcategories-delta-java-snippets.md b/api-reference/beta/includes/snippets/java/update-gradingcategories-delta-java-snippets.md index fd4fab99bc9..2428cb3f557 100644 --- a/api-reference/beta/includes/snippets/java/update-gradingcategories-delta-java-snippets.md +++ b/api-reference/beta/includes/snippets/java/update-gradingcategories-delta-java-snippets.md @@ -12,22 +12,18 @@ EducationAssignmentSettings educationAssignmentSettings = new EducationAssignmen HashMap additionalData = new HashMap(); LinkedList gradingCategoriesDelta = new LinkedList(); property = new (); -property.setId("fb859cd3-943b-4cd6-9bbe-fe1c39eace0e"); -property.setDisplayName("Lab Test"); +property.setId("03bd9196-ce2e-41bd-902f-df9ae02de4db"); +property.setDisplayName("Lab Updated"); gradingCategoriesDelta.add(property); property1 = new (); property1.setOdataContext("https://graph.microsoft.com/beta/$metadata#gradingCategories/$deletedEntity"); -property1.setId("e2a86277-24f9-4f29-8196-8c83fc69d00d"); +property1.setId("109e5d73-3ef7-42a5-88d8-7e30cdb85f06"); property1.setReason("deleted"); gradingCategoriesDelta.add(property1); property2 = new (); -property2.setDisplayName("Lab Practice"); -property2.setPercentageWeight(30); +property2.setDisplayName("New Homework"); +property2.setPercentageWeight(50); gradingCategoriesDelta.add(property2); - property3 = new (); -property3.setDisplayName("Lab Theory"); -property3.setPercentageWeight(10); -gradingCategoriesDelta.add(property3); additionalData.put("gradingCategories@delta", gradingCategoriesDelta); educationAssignmentSettings.setAdditionalData(additionalData); EducationAssignmentSettings result = graphClient.education().classes().byEducationClassId("{educationClass-id}").assignmentSettings().patch(educationAssignmentSettings); diff --git a/api-reference/beta/includes/snippets/javascript/copy-item-conflicts-javascript-snippets.md b/api-reference/beta/includes/snippets/javascript/copy-item-conflicts-javascript-snippets.md new file mode 100644 index 00000000000..c067bf60128 --- /dev/null +++ b/api-reference/beta/includes/snippets/javascript/copy-item-conflicts-javascript-snippets.md @@ -0,0 +1,25 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```javascript + +const options = { + authProvider, +}; + +const client = Client.init(options); + +const driveItem = { + parentReference: { + driveId: 'b!s8RqPCGh0ESQS2EYnKM0IKS3lM7GxjdAviiob7oc5pXv_0LiL-62Qq3IXyrXnEop', + id: 'DCD0D3AD-8989-4F23-A5A2-2C086050513F' + }, + childrenOnly: true +}; + +await client.api('/me/drive/items/{item-id}/copy') + .version('beta') + .post(driveItem); + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/javascript/create-ediscoveryholdpolicy-from--javascript-snippets.md b/api-reference/beta/includes/snippets/javascript/create-ediscoveryholdpolicy-from--javascript-snippets.md index 222307f3bf0..0d0f4f0ac94 100644 --- a/api-reference/beta/includes/snippets/javascript/create-ediscoveryholdpolicy-from--javascript-snippets.md +++ b/api-reference/beta/includes/snippets/javascript/create-ediscoveryholdpolicy-from--javascript-snippets.md @@ -13,7 +13,7 @@ const client = Client.init(options); const ediscoveryHoldPolicy = { displayName: 'My legalHold with sources', description: 'Created from Graph API', - contentQuery: 'KQL content query', + contentQuery: 'KQL content query' }; await client.api('/security/cases/ediscoveryCases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/legalHolds') diff --git a/api-reference/beta/includes/snippets/javascript/create-retentionlabel-from--javascript-snippets.md b/api-reference/beta/includes/snippets/javascript/create-retentionlabel-from--javascript-snippets.md index 4125e38d366..9a498f8ec7d 100644 --- a/api-reference/beta/includes/snippets/javascript/create-retentionlabel-from--javascript-snippets.md +++ b/api-reference/beta/includes/snippets/javascript/create-retentionlabel-from--javascript-snippets.md @@ -43,7 +43,6 @@ const retentionLabel = { }; await client.api('/security/labels/retentionLabels') - .version('beta') .post(retentionLabel); ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/javascript/create-usersource-and-include-sources-javascript-snippets.md b/api-reference/beta/includes/snippets/javascript/create-usersource-and-include-sources-javascript-snippets.md index 553b404b459..9bf8b4468b2 100644 --- a/api-reference/beta/includes/snippets/javascript/create-usersource-and-include-sources-javascript-snippets.md +++ b/api-reference/beta/includes/snippets/javascript/create-usersource-and-include-sources-javascript-snippets.md @@ -12,7 +12,7 @@ const client = Client.init(options); const userSource = { email: 'admin@contoso.com', - includedSources: 'mailbox' + includedSources: 'mailbox, site' }; await client.api('/security/cases/ediscoveryCases/{ediscoveryCaseId}/legalHolds/{ediscoveryHoldPolicyId}/userSources') diff --git a/api-reference/beta/includes/snippets/javascript/post-chatmessage-5-javascript-snippets.md b/api-reference/beta/includes/snippets/javascript/post-chatmessage-5-javascript-snippets.md index 5956a348a90..cbda614862d 100644 --- a/api-reference/beta/includes/snippets/javascript/post-chatmessage-5-javascript-snippets.md +++ b/api-reference/beta/includes/snippets/javascript/post-chatmessage-5-javascript-snippets.md @@ -11,17 +11,17 @@ const options = { const client = Client.init(options); const chatMessage = { - body: { - contentType: 'html', - content: 'Testing with file share link. ' - }, - attachments: [ - { - id: '668f7fa8-8129-4de7-b32b-fe1b442e6ef1', - contentType: 'reference', - contentUrl: 'https://teamsgraph-my.sharepoint.com/:w:/g/personal/test_teamsgraph_onmicrosoft_com/Eah_j2YpgedNsyv-G0QubvEBma6Sd_76UtYkXwoJ-nYVEg?e=0H2Ibm' - } - ] + body: { + contentType: 'html', + content: 'Testing with file share link. ' + }, + attachments: [ + { + id: '668f7fa8-8129-4de7-b32b-fe1b442e6ef1', + contentType: 'reference', + contentUrl: 'https://teamsgraph-my.sharepoint.com/:w:/g/personal/test_teamsgraph_onmicrosoft_com/Eah_j2YpgedNsyv-G0QubvEBma6Sd_76UtYkXwoJ-nYVEg?e=0H2Ibm' + } + ] }; await client.api('/teams/1e769eab-06a8-4b2e-ac42-1f040a4e52a1/channels/19:e28d1f9b354f4de88d2e9e4d8b983763@thread.tacv2/messages') diff --git a/api-reference/beta/includes/snippets/javascript/update-gradingcategories-delta-javascript-snippets.md b/api-reference/beta/includes/snippets/javascript/update-gradingcategories-delta-javascript-snippets.md index 17c40650b3f..a12c29974a4 100644 --- a/api-reference/beta/includes/snippets/javascript/update-gradingcategories-delta-javascript-snippets.md +++ b/api-reference/beta/includes/snippets/javascript/update-gradingcategories-delta-javascript-snippets.md @@ -14,29 +14,24 @@ const educationAssignmentSettings = { 'gradingCategories@delta': [ { // Change this grading category\'s name - id: 'fb859cd3-943b-4cd6-9bbe-fe1c39eace0e', - displayName: 'Lab Test' + id: '03bd9196-ce2e-41bd-902f-df9ae02de4db', + displayName: 'Lab Updated' }, { - // Delete this grading category + // Delete this grading category '@odata.context': 'https://graph.microsoft.com/beta/$metadata#gradingCategories/$deletedEntity', - id: 'e2a86277-24f9-4f29-8196-8c83fc69d00d', + id: '109e5d73-3ef7-42a5-88d8-7e30cdb85f06', reason: 'deleted' }, { - // Add a new grading category - displayName: 'Lab Practice', - percentageWeight: 30 - }, - { - displayName: 'Lab Theory', - percentageWeight: 10 + // Add a new grading category + displayName: 'New Homework', + percentageWeight: 50 } ] }; await client.api('/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignmentSettings') - .version('beta') .update(educationAssignmentSettings); ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/php/archive-site-php-snippets.md b/api-reference/beta/includes/snippets/php/archive-site-php-snippets.md new file mode 100644 index 00000000000..74a53aa4dc4 --- /dev/null +++ b/api-reference/beta/includes/snippets/php/archive-site-php-snippets.md @@ -0,0 +1,16 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```php + +sites()->bySiteId('site-id')->archive()->post()->wait(); + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/php/call-startrecording-php-snippets.md b/api-reference/beta/includes/snippets/php/call-startrecording-php-snippets.md new file mode 100644 index 00000000000..65e6126ff58 --- /dev/null +++ b/api-reference/beta/includes/snippets/php/call-startrecording-php-snippets.md @@ -0,0 +1,16 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```php + +communications()->calls()->byCallId('call-id')->startRecording()->post()->wait(); + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/php/call-starttranscription-php-snippets.md b/api-reference/beta/includes/snippets/php/call-starttranscription-php-snippets.md new file mode 100644 index 00000000000..94ed390e329 --- /dev/null +++ b/api-reference/beta/includes/snippets/php/call-starttranscription-php-snippets.md @@ -0,0 +1,19 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```php + +setLanguage('en-us'); + +$result = $graphServiceClient->communications()->calls()->byCallId('call-id')->startTranscription()->post($requestBody)->wait(); + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/php/call-stoprecording-php-snippets.md b/api-reference/beta/includes/snippets/php/call-stoprecording-php-snippets.md new file mode 100644 index 00000000000..3216d23574b --- /dev/null +++ b/api-reference/beta/includes/snippets/php/call-stoprecording-php-snippets.md @@ -0,0 +1,16 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```php + +communications()->calls()->byCallId('call-id')->stopRecording()->post()->wait(); + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/php/call-stoptranscription-php-snippets.md b/api-reference/beta/includes/snippets/php/call-stoptranscription-php-snippets.md new file mode 100644 index 00000000000..c37ac1cab8d --- /dev/null +++ b/api-reference/beta/includes/snippets/php/call-stoptranscription-php-snippets.md @@ -0,0 +1,19 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```php + +setLanguage('en-us'); + +$result = $graphServiceClient->communications()->calls()->byCallId('call-id')->stopTranscription()->post($requestBody)->wait(); + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/php/copy-item-conflicts-php-snippets.md b/api-reference/beta/includes/snippets/php/copy-item-conflicts-php-snippets.md new file mode 100644 index 00000000000..134b77c1572 --- /dev/null +++ b/api-reference/beta/includes/snippets/php/copy-item-conflicts-php-snippets.md @@ -0,0 +1,30 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```php + +setDriveId('b!s8RqPCGh0ESQS2EYnKM0IKS3lM7GxjdAviiob7oc5pXv_0LiL-62Qq3IXyrXnEop'); +$parentReference->setId('DCD0D3AD-8989-4F23-A5A2-2C086050513F'); +$requestBody->setParentReference($parentReference); +$requestBody->setChildrenOnly(true); +$requestConfiguration = new CopyRequestBuilderPostRequestConfiguration(); +$queryParameters = CopyRequestBuilderPostRequestConfiguration::createQueryParameters(); +$queryParameters->@microsoftgraphconflictBehavior = "replace"; +$requestConfiguration->queryParameters = $queryParameters; + + +$result = $graphServiceClient->drives()->byDriveId('drive-id')->items()->byDriveItemId('driveItem-id')->copy()->post($requestBody, $requestConfiguration)->wait(); + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/php/create-retentionlabel-from--php-snippets.md b/api-reference/beta/includes/snippets/php/create-retentionlabel-from--php-snippets.md index 0b45f8964f1..8fd5f37ee18 100644 --- a/api-reference/beta/includes/snippets/php/create-retentionlabel-from--php-snippets.md +++ b/api-reference/beta/includes/snippets/php/create-retentionlabel-from--php-snippets.md @@ -5,15 +5,15 @@ description: "Automatically generated file. DO NOT MODIFY" ```php setEmail('admin@contoso.com'); -$requestBody->setIncludedSources(new SourceType('mailbox')); +$requestBody->setIncludedSources(new SourceType('mailbox, site')); $result = $graphServiceClient->security()->cases()->ediscoveryCases()->byEdiscoveryCaseId('ediscoveryCase-id')->legalHolds()->byEdiscoveryHoldPolicyId('ediscoveryHoldPolicy-id')->userSources()->post($requestBody)->wait(); diff --git a/api-reference/beta/includes/snippets/php/unarchive-site-php-snippets.md b/api-reference/beta/includes/snippets/php/unarchive-site-php-snippets.md new file mode 100644 index 00000000000..191467005d9 --- /dev/null +++ b/api-reference/beta/includes/snippets/php/unarchive-site-php-snippets.md @@ -0,0 +1,16 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```php + +sites()->bySiteId('site-id')->unarchive()->post()->wait(); + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/php/update-gradingcategories-delta-php-snippets.md b/api-reference/beta/includes/snippets/php/update-gradingcategories-delta-php-snippets.md index 2bd9bd2c5f4..cae69b4f23b 100644 --- a/api-reference/beta/includes/snippets/php/update-gradingcategories-delta-php-snippets.md +++ b/api-reference/beta/includes/snippets/php/update-gradingcategories-delta-php-snippets.md @@ -5,8 +5,8 @@ description: "Automatically generated file. DO NOT MODIFY" ```php [ [ - 'id' => 'fb859cd3-943b-4cd6-9bbe-fe1c39eace0e', - 'displayName' => 'Lab Test', + 'id' => '03bd9196-ce2e-41bd-902f-df9ae02de4db', + 'displayName' => 'Lab Updated', ], [ '@odata.context' => 'https://graph.microsoft.com/beta/$metadata#gradingCategories/$deletedEntity', - 'id' => 'e2a86277-24f9-4f29-8196-8c83fc69d00d', + 'id' => '109e5d73-3ef7-42a5-88d8-7e30cdb85f06', 'reason' => 'deleted', ], [ - 'displayName' => 'Lab Practice', - 'percentageWeight' => 30, - ], - [ - 'displayName' => 'Lab Theory', - 'percentageWeight' => 10, + 'displayName' => 'New Homework', + 'percentageWeight' => 50, ], ], ]; diff --git a/api-reference/beta/includes/snippets/powershell/copy-item-conflicts-powershell-snippets.md b/api-reference/beta/includes/snippets/powershell/copy-item-conflicts-powershell-snippets.md new file mode 100644 index 00000000000..1fa753d2e1a --- /dev/null +++ b/api-reference/beta/includes/snippets/powershell/copy-item-conflicts-powershell-snippets.md @@ -0,0 +1,19 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```powershell + +Import-Module Microsoft.Graph.Beta.Files + +$params = @{ + parentReference = @{ + driveId = "b!s8RqPCGh0ESQS2EYnKM0IKS3lM7GxjdAviiob7oc5pXv_0LiL-62Qq3IXyrXnEop" + id = "DCD0D3AD-8989-4F23-A5A2-2C086050513F" + } + childrenOnly = $true +} + +Copy-MgBetaDriveItem -DriveId $driveId -DriveItemId $driveItemId -@microsoft.graph.conflictbehavior "replace" -BodyParameter $params + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/powershell/create-usersource-and-include-sources-powershell-snippets.md b/api-reference/beta/includes/snippets/powershell/create-usersource-and-include-sources-powershell-snippets.md index b2bf61af083..7512bba1cc5 100644 --- a/api-reference/beta/includes/snippets/powershell/create-usersource-and-include-sources-powershell-snippets.md +++ b/api-reference/beta/includes/snippets/powershell/create-usersource-and-include-sources-powershell-snippets.md @@ -8,7 +8,7 @@ Import-Module Microsoft.Graph.Beta.Security $params = @{ email = "admin@contoso.com" - includedSources = "mailbox" + includedSources = "mailbox, site" } New-MgBetaSecurityCaseEdiscoveryCaseLegalHoldUserSource -EdiscoveryCaseId $ediscoveryCaseId -EdiscoveryHoldPolicyId $ediscoveryHoldPolicyId -BodyParameter $params diff --git a/api-reference/beta/includes/snippets/powershell/update-gradingcategories-delta-powershell-snippets.md b/api-reference/beta/includes/snippets/powershell/update-gradingcategories-delta-powershell-snippets.md index a35cae6afca..580258a3c3d 100644 --- a/api-reference/beta/includes/snippets/powershell/update-gradingcategories-delta-powershell-snippets.md +++ b/api-reference/beta/includes/snippets/powershell/update-gradingcategories-delta-powershell-snippets.md @@ -4,30 +4,26 @@ description: "Automatically generated file. DO NOT MODIFY" ```powershell -Import-Module Microsoft.Graph.Beta.Education +Import-Module Microsoft.Graph.Education $params = @{ "gradingCategories@delta" = @( @{ - id = "fb859cd3-943b-4cd6-9bbe-fe1c39eace0e" - displayName = "Lab Test" + id = "03bd9196-ce2e-41bd-902f-df9ae02de4db" + displayName = "Lab Updated" } @{ "@odata.context" = "https://graph.microsoft.com/beta/$metadata#gradingCategories/$deletedEntity" - id = "e2a86277-24f9-4f29-8196-8c83fc69d00d" + id = "109e5d73-3ef7-42a5-88d8-7e30cdb85f06" reason = "deleted" } @{ - displayName = "Lab Practice" - percentageWeight = - } - @{ - displayName = "Lab Theory" + displayName = "New Homework" percentageWeight = } ) } -Update-MgBetaEducationClassAssignmentSetting -EducationClassId $educationClassId -BodyParameter $params +Update-MgEducationClassAssignmentSetting -EducationClassId $educationClassId -BodyParameter $params ``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/python/archive-site-python-snippets.md b/api-reference/beta/includes/snippets/python/archive-site-python-snippets.md new file mode 100644 index 00000000000..469b41f8eab --- /dev/null +++ b/api-reference/beta/includes/snippets/python/archive-site-python-snippets.md @@ -0,0 +1,14 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +# Code snippets are only available for the latest version. Current version is 1.x +from msgraph_beta import GraphServiceClient +# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python + +await graph_client.sites.by_site_id('site-id').archive.post() + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/python/call-startrecording-python-snippets.md b/api-reference/beta/includes/snippets/python/call-startrecording-python-snippets.md new file mode 100644 index 00000000000..c9a30d658fb --- /dev/null +++ b/api-reference/beta/includes/snippets/python/call-startrecording-python-snippets.md @@ -0,0 +1,14 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +# Code snippets are only available for the latest version. Current version is 1.x +from msgraph_beta import GraphServiceClient +# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python + +result = await graph_client.communications.calls.by_call_id('call-id').start_recording.post(None) + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/python/call-starttranscription-python-snippets.md b/api-reference/beta/includes/snippets/python/call-starttranscription-python-snippets.md new file mode 100644 index 00000000000..3176bf03b0e --- /dev/null +++ b/api-reference/beta/includes/snippets/python/call-starttranscription-python-snippets.md @@ -0,0 +1,18 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +# Code snippets are only available for the latest version. Current version is 1.x +from msgraph_beta import GraphServiceClient +from msgraph_beta.generated.communications.calls.item.start_transcription.start_transcription_post_request_body import StartTranscriptionPostRequestBody +# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python +request_body = StartTranscriptionPostRequestBody( + language = "en-us", +) + +result = await graph_client.communications.calls.by_call_id('call-id').start_transcription.post(request_body) + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/python/call-stoprecording-python-snippets.md b/api-reference/beta/includes/snippets/python/call-stoprecording-python-snippets.md new file mode 100644 index 00000000000..338f96cdea8 --- /dev/null +++ b/api-reference/beta/includes/snippets/python/call-stoprecording-python-snippets.md @@ -0,0 +1,14 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +# Code snippets are only available for the latest version. Current version is 1.x +from msgraph_beta import GraphServiceClient +# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python + +result = await graph_client.communications.calls.by_call_id('call-id').stop_recording.post(None) + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/python/call-stoptranscription-python-snippets.md b/api-reference/beta/includes/snippets/python/call-stoptranscription-python-snippets.md new file mode 100644 index 00000000000..f0c93429298 --- /dev/null +++ b/api-reference/beta/includes/snippets/python/call-stoptranscription-python-snippets.md @@ -0,0 +1,18 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +# Code snippets are only available for the latest version. Current version is 1.x +from msgraph_beta import GraphServiceClient +from msgraph_beta.generated.communications.calls.item.stop_transcription.stop_transcription_post_request_body import StopTranscriptionPostRequestBody +# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python +request_body = StopTranscriptionPostRequestBody( + language = "en-us", +) + +result = await graph_client.communications.calls.by_call_id('call-id').stop_transcription.post(request_body) + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/python/copy-item-conflicts-python-snippets.md b/api-reference/beta/includes/snippets/python/copy-item-conflicts-python-snippets.md new file mode 100644 index 00000000000..3863bdc8ffa --- /dev/null +++ b/api-reference/beta/includes/snippets/python/copy-item-conflicts-python-snippets.md @@ -0,0 +1,32 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +# Code snippets are only available for the latest version. Current version is 1.x +from msgraph_beta import GraphServiceClient +from msgraph_beta.generated.drives.item.items.item.copy.copy_request_builder import CopyRequestBuilder +from kiota_abstractions.base_request_configuration import RequestConfiguration +from msgraph_beta.generated.drives.item.items.item.copy.copy_post_request_body import CopyPostRequestBody +from msgraph_beta.generated.models.item_reference import ItemReference +# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python +request_body = CopyPostRequestBody( + parent_reference = ItemReference( + drive_id = "b!s8RqPCGh0ESQS2EYnKM0IKS3lM7GxjdAviiob7oc5pXv_0LiL-62Qq3IXyrXnEop", + id = "DCD0D3AD-8989-4F23-A5A2-2C086050513F", + ), + children_only = True, +) +query_params = CopyRequestBuilder.CopyRequestBuilderPostQueryParameters( + @microsoft_graph_conflict_behavior = "replace", +) + +request_configuration = RequestConfiguration( +query_parameters = query_params, +) + +result = await graph_client.drives.by_drive_id('drive-id').items.by_drive_item_id('driveItem-id').copy.post(request_body, request_configuration = request_configuration) + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/python/create-retentionlabel-from--python-snippets.md b/api-reference/beta/includes/snippets/python/create-retentionlabel-from--python-snippets.md index 89ed56aa4ab..d28b398327c 100644 --- a/api-reference/beta/includes/snippets/python/create-retentionlabel-from--python-snippets.md +++ b/api-reference/beta/includes/snippets/python/create-retentionlabel-from--python-snippets.md @@ -5,15 +5,15 @@ description: "Automatically generated file. DO NOT MODIFY" ```python # Code snippets are only available for the latest version. Current version is 1.x -from msgraph_beta import GraphServiceClient -from msgraph_beta.generated.models.security.retention_label import RetentionLabel -from msgraph_beta.generated.models.behavior_during_retention_period import BehaviorDuringRetentionPeriod -from msgraph_beta.generated.models.action_after_retention_period import ActionAfterRetentionPeriod -from msgraph_beta.generated.models.retention_trigger import RetentionTrigger -from msgraph_beta.generated.models.security.retention_duration_in_days import RetentionDurationInDays -from msgraph_beta.generated.models.security.disposition_review_stage import DispositionReviewStage -from msgraph_beta.generated.models.security.file_plan_descriptor import FilePlanDescriptor -from msgraph_beta.generated.models.default_record_behavior import DefaultRecordBehavior +from msgraph import GraphServiceClient +from msgraph.generated.models.security.retention_label import RetentionLabel +from msgraph.generated.models.behavior_during_retention_period import BehaviorDuringRetentionPeriod +from msgraph.generated.models.action_after_retention_period import ActionAfterRetentionPeriod +from msgraph.generated.models.retention_trigger import RetentionTrigger +from msgraph.generated.models.security.retention_duration_in_days import RetentionDurationInDays +from msgraph.generated.models.security.disposition_review_stage import DispositionReviewStage +from msgraph.generated.models.security.file_plan_descriptor import FilePlanDescriptor +from msgraph.generated.models.default_record_behavior import DefaultRecordBehavior # To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python request_body = RetentionLabel( odata_type = "#microsoft.graph.security.retentionLabel", diff --git a/api-reference/beta/includes/snippets/python/create-usersource-and-include-sources-python-snippets.md b/api-reference/beta/includes/snippets/python/create-usersource-and-include-sources-python-snippets.md index 74a1a73d34d..065b6294c1c 100644 --- a/api-reference/beta/includes/snippets/python/create-usersource-and-include-sources-python-snippets.md +++ b/api-reference/beta/includes/snippets/python/create-usersource-and-include-sources-python-snippets.md @@ -11,7 +11,7 @@ from msgraph_beta.generated.models.source_type import SourceType # To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python request_body = UserSource( email = "admin@contoso.com", - included_sources = SourceType.Mailbox, + included_sources = SourceType.Mailbox | SourceType.Site, ) result = await graph_client.security.cases.ediscovery_cases.by_ediscovery_case_id('ediscoveryCase-id').legal_holds.by_ediscovery_hold_policy_id('ediscoveryHoldPolicy-id').user_sources.post(request_body) diff --git a/api-reference/beta/includes/snippets/python/unarchive-site-python-snippets.md b/api-reference/beta/includes/snippets/python/unarchive-site-python-snippets.md new file mode 100644 index 00000000000..f4e2839b9ab --- /dev/null +++ b/api-reference/beta/includes/snippets/python/unarchive-site-python-snippets.md @@ -0,0 +1,14 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```python + +# Code snippets are only available for the latest version. Current version is 1.x +from msgraph_beta import GraphServiceClient +# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python + +await graph_client.sites.by_site_id('site-id').unarchive.post() + + +``` \ No newline at end of file diff --git a/api-reference/beta/includes/snippets/python/update-gradingcategories-delta-python-snippets.md b/api-reference/beta/includes/snippets/python/update-gradingcategories-delta-python-snippets.md index b3a0acd3990..050dd74c015 100644 --- a/api-reference/beta/includes/snippets/python/update-gradingcategories-delta-python-snippets.md +++ b/api-reference/beta/includes/snippets/python/update-gradingcategories-delta-python-snippets.md @@ -5,28 +5,24 @@ description: "Automatically generated file. DO NOT MODIFY" ```python # Code snippets are only available for the latest version. Current version is 1.x -from msgraph_beta import GraphServiceClient -from msgraph_beta.generated.models.education_assignment_settings import EducationAssignmentSettings +from msgraph import GraphServiceClient +from msgraph.generated.models.education_assignment_settings import EducationAssignmentSettings # To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python request_body = EducationAssignmentSettings( additional_data = { "grading_categories@delta" : [ { - "id" : "fb859cd3-943b-4cd6-9bbe-fe1c39eace0e", - "display_name" : "Lab Test", + "id" : "03bd9196-ce2e-41bd-902f-df9ae02de4db", + "display_name" : "Lab Updated", }, { "@odata_context" : "https://graph.microsoft.com/beta/$metadata#gradingCategories/$deletedEntity", - "id" : "e2a86277-24f9-4f29-8196-8c83fc69d00d", + "id" : "109e5d73-3ef7-42a5-88d8-7e30cdb85f06", "reason" : "deleted", }, { - "display_name" : "Lab Practice", - "percentage_weight" : 30, - }, - { - "display_name" : "Lab Theory", - "percentage_weight" : 10, + "display_name" : "New Homework", + "percentage_weight" : 50, }, ], } diff --git a/api-reference/beta/resources/admin.md b/api-reference/beta/resources/admin.md index 4a881899e90..3d95cc4a897 100644 --- a/api-reference/beta/resources/admin.md +++ b/api-reference/beta/resources/admin.md @@ -26,6 +26,7 @@ Represents an entity that acts as a container for administrator functionality. |:---|:---|:---| | edge | [edge](edge.md) | A container for Microsoft Edge resources. Read-only. | | entra | [entra](entra.md) | A container for Microsoft Entra resources. Read-only. | +| exchange | [exchangeAdmin](../resources/exchangeadmin.md) |A container for the Exchange admin functionality. Read-only.| | microsoft365Apps |[adminMicrosoft365Apps](../resources/adminmicrosoft365apps.md)|A container for the Microsoft 365 apps admin functionality.| | people | [peopleAdminSettings](../resources/peopleadminsettings.md) | Represents a setting to control people-related admin settings in the tenant. | | reportSettings |[microsoft.graph.adminReportSettings](../resources/adminreportsettings.md)|A container for administrative resources to manage reports.| diff --git a/api-reference/beta/resources/channel.md b/api-reference/beta/resources/channel.md index 606eeaad864..e0970aee154 100644 --- a/api-reference/beta/resources/channel.md +++ b/api-reference/beta/resources/channel.md @@ -58,8 +58,6 @@ where files are shared, and where tabs are added. |[Unshare channel with team](../api/sharedwithchannelteaminfo-delete.md)|None|Unshare a channel with a team.| |[List allowed members](../api/sharedwithchannelteaminfo-list-allowedmembers.md)|[conversationMember](../resources/conversationmember.md) collection|Get the list of team members who have access to the shared channel.| |[Check user access](../api/channel-doesuserhaveaccess.md)|Boolean|Check whether a user has access to a shared channel or not.| -| **Planner** | | | -|[List plans](../api/teamschannelplanner-list-plans.md) |[plannerPlan](plannerplan.md) collection| Get a list of [plannerPlan](../resources/plannerplan.md) objects owned by a shared [channel](../resources/channel.md) in Teams.| ## Properties @@ -103,14 +101,13 @@ For a POST request example, see [Request (create channel in migration state)](/m | Relationship | Type |Description| |:---------------|:--------|:----------| +|messages|[chatMessage](chatmessage.md) collection|A collection of all the messages in the channel. A navigation property. Nullable.| +|tabs|[teamsTab](../resources/teamstab.md) collection|A collection of all the tabs in the channel. A navigation property.| +|members|[conversationMember](conversationmember.md) collection|A collection of membership records associated with the channel.| |allMembers|[conversationMember](conversationmember.md) collection |A collection of membership records associated with the channel. It includes both direct and indirect members of shared channels.| |[filesFolder](../api/channel-get-filesfolder.md)|[driveItem](driveitem.md)|Metadata for the location where the channel's files are stored.| -|members|[conversationMember](conversationmember.md) collection|A collection of membership records associated with the channel.| -|messages|[chatMessage](chatmessage.md) collection|A collection of all the messages in the channel. Nullable.| |operations|[teamsAsyncOperation](teamsasyncoperation.md) collection| The async operations that ran or are running on this team. | -|planner|[teamsChannelPlanner](teamschannelplanner.md) | Selective Planner services available to this channel. Currently, only shared channels are supported. Read-only. Nullable. | |sharedWithTeams|[sharedWithChannelTeamInfo](../resources/sharedwithchannelteaminfo.md) collection|A collection of teams with which a channel is shared.| -|tabs|[teamsTab](../resources/teamstab.md) collection| A collection of all the tabs in the channel.| ## JSON representation diff --git a/api-reference/beta/resources/exchangeadmin.md b/api-reference/beta/resources/exchangeadmin.md new file mode 100644 index 00000000000..8b229d2a592 --- /dev/null +++ b/api-reference/beta/resources/exchangeadmin.md @@ -0,0 +1,36 @@ +--- +title: "exchangeAdmin resource type" +description: "Represents a container for the Exchange admin functionality." +author: "cparker-msft" +ms.date: 01/10/2025 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: resourcePageType +--- + +# exchangeAdmin resource type + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents a container for the Exchange admin functionality. + +## Relationships +|Relationship|Type|Description| +|:---|:---|:---| +|mailboxes|[mailbox](../resources/mailbox.md) collection|Represents a user's mailboxes.| + +## JSON representation +The following JSON representation shows the resource type. + +``` json +{ + "@odata.type": "#microsoft.graph.exchangeAdmin" +} +``` diff --git a/api-reference/beta/resources/exchangesettings.md b/api-reference/beta/resources/exchangesettings.md new file mode 100644 index 00000000000..bb50fffbbeb --- /dev/null +++ b/api-reference/beta/resources/exchangesettings.md @@ -0,0 +1,47 @@ +--- +title: "exchangeSettings resource type" +description: "Represents the Exchange settings for mailbox discovery." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: resourcePageType +--- + +# exchangeSettings resource type + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents the Exchange settings for mailbox discovery. + +## Methods +| Method | Return Type |Description| +|:---------------|:--------|:----------| +|[List](../api/usersettings-list-exchange.md)|[exchangeSettings](../resources/exchangesettings.md) collection|Get a list of Exchange settings, including mailboxes that belong to a user.| + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|id|String|The unique identifier of the **exchangeSettings** of the user.| +|inPlaceArchiveMailboxId|String|The unique identifier for the user's in-place archive mailbox.| +|primaryMailboxId|String|The unique identifier for the user's primary mailbox.| + +## JSON representation +The following JSON representation shows the resource type. + +``` json +{ + "@odata.type": "#microsoft.graph.exchangeSettings", + "id": "String (identifier)", + "inPlaceArchiveMailboxId": "String", + "primaryMailboxId": "String" +} +``` diff --git a/api-reference/beta/resources/exportitemresponse.md b/api-reference/beta/resources/exportitemresponse.md new file mode 100644 index 00000000000..e1d6780b56f --- /dev/null +++ b/api-reference/beta/resources/exportitemresponse.md @@ -0,0 +1,42 @@ +--- +title: "exportItemResponse resource type" +description: "Represents the result of an export operation performed by the exportItems function." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: resourcePageType +--- + +# exportItemResponse resource type + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents the result of an export operation performed by the [exportItems](../api/mailbox-exportitems.md) function. + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|changeKey|String|The version of the item.| +|data|Stream|Data that represents an item in a base64 encoded [FastTransfer stream](/openspecs/exchange_server_protocols/ms-oxcfxics/ed7d3455-9bdf-40eb-90bd-8dfe6164a250#gt_12daff0e-4241-4498-a93f-212795ab2450) format.| +|error|[mailTipsError](mailtipserror.md)|An error that occurs during an action.| +|itemId|String|The unique identifier of the item.| + +## JSON representation +The following JSON representation shows the resource type. + +``` json +{ + "@odata.type": "#microsoft.graph.exportItemResponse", + "changeKey": "String", + "data": "Stream", + "error": {"@odata.type": "microsoft.graph.mailTipsError"}, + "itemId": "String" +} +``` diff --git a/api-reference/beta/resources/identifierurirestriction.md b/api-reference/beta/resources/identifierurirestriction.md index 26d92f1c7fb..dbcac991406 100644 --- a/api-reference/beta/resources/identifierurirestriction.md +++ b/api-reference/beta/resources/identifierurirestriction.md @@ -24,6 +24,7 @@ Configuration object to configure a restriction for identifier URIs on applicati | excludeSaml | Boolean | If `true`, the restriction isn't enforced for SAML applications in Microsoft Entra ID; else, the restriction is enforced for those applications.| | restrictForAppsCreatedAfterDateTime | String | Specifies the date from which the policy restriction applies to newly created applications. For existing applications, the enforcement date can be retroactively applied.| | state | appManagementRestrictionState | String value that indicates if the restriction is evaluated. The possible values are: `enabled`, `disabled`, and `unknownFutureValue`. If `enabled`, the restriction is evaluated. If `disabled`, the restriction isn't evaluated or enforced.| +| isStateSetByMicrosoft | Boolean | If `true`, Microsoft sets the `identifierUriRestriction` state. If `false`, the tenant modifies the `identifierUriRestriction` state. Read-only.| ## Relationships None. @@ -39,6 +40,7 @@ The following JSON representation shows the resource type. { "@odata.type": "#microsoft.graph.identifierUriRestriction", "state": "String", + "isStateSetByMicrosoft": "Boolean", "restrictForAppsCreatedAfterDateTime": "String (timestamp)", "excludeAppsReceivingV2Tokens": "Boolean", "excludeSaml": "Boolean", diff --git a/api-reference/beta/resources/mailbox-import-export-api-overview.md b/api-reference/beta/resources/mailbox-import-export-api-overview.md new file mode 100644 index 00000000000..8bebc54063c --- /dev/null +++ b/api-reference/beta/resources/mailbox-import-export-api-overview.md @@ -0,0 +1,49 @@ +--- +title: "Use the mailbox import and export APIs in Microsoft Graph (preview)" +description: "Learn how to use the mailbox import and export APIs in Microsoft Graph to import and export contents from Exchange Online mailboxes." +ms.localizationpriority: high +author: "cparker-msft" +ms.subservice: "outlook" +doc_type: conceptualPageType +ms.date: 12/06/2024 +--- + +# Use the mailbox import and export APIs in Microsoft Graph (preview) + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +The mailbox import and export APIs in Microsoft Graph allow your application to import and export contents from Exchange Online mailboxes. Mailbox contents can be accessed as a collection of [folders](./mailboxfolder.md) and [items](./mailboxitem.md) in a consistent format, without the need to manage the metadata or structure of each item type individually. These items can be [exported](../api/mailbox-exportitems.md) in [FastTransfer stream](/openspecs/exchange_server_protocols/ms-oxcfxics/a2648823-0a98-43ee-98e8-590e4f7bcbbe) format with full fidelity. Full-fidelity exports ensure that when you [import](../api/mailbox-createimportsession.md) an item, Exchange recreates it with no loss of information. + +These APIs support access to data in users' primary and [in-place archive](/exchange/clients-and-mobile-in-exchange-online/archive-client-and-compliance-&-security-feature-details?tabs=Archive-features#archive-mailbox) mailboxes on Exchange. + +## How to use the mailbox import and export APIs + +The following steps allow your app to systematically export and import contents from Exchange mailboxes: + +1. [Get a list of mailboxes that belong to a particular user](../api/usersettings-list-exchange.md). +2. Discover the contents of the mailbox as a set of [folders](./mailboxfolder.md) and [items](./mailboxitem.md). +3. [Export items from a mailbox](../api/mailbox-exportitems.md). +4. Create or update mailbox [folders](./mailboxfolder.md). +5. [Import an item into the same or a different mailbox](../api/mailbox-createimportsession.md). + +## Common use cases + +| Use case | REST resource | See also | +| :----------------------------------------------------| :---------------------------------------------------------------------------- | :----------------------------------------| +| Create, get, update, or delete a mailbox folder | [mailboxFolder](../resources/mailboxfolder.md) | [mailboxFolder methods](../resources/mailboxfolder.md#methods) | +| Get one or more mailbox items | [mailboxItem](../resources/mailboxitem.md) | [mailboxItem methods](../resources/mailboxitem.md#methods) | +| Get delta for folders | [mailboxFolder](../resources/mailboxfolder.md) [mailboxFolder: delta](../api/mailboxfolder-delta.md) | +| Get delta for items | [mailboxItem](../resources/mailboxitem.md) | [mailboxItem: delta](../api/mailboxitem-delta.md) | +| Import or export mailboxes | [mailbox](../resources/mailbox.md) | [mailbox methods](../resources/mailboxitem.md#methods) | +| Get a list of mailboxes that belong to a user | [exchangeSettings](../resources/exchangesettings.md) | [List Exchange settings](../api/usersettings-list-exchange.md) | + +## Next steps + +Use the mailbox import and export APIs in Microsoft Graph to import and export contents from Exchange mailboxes. To learn more: + +- Explore the resources and methods that are most helpful to your scenario. +- Try the API in the [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer). + +## Related content + +[Import an Exchange mailbox item using the mailbox import and export APIs](/graph/import-exchange-mailbox-item) \ No newline at end of file diff --git a/api-reference/beta/resources/mailbox.md b/api-reference/beta/resources/mailbox.md new file mode 100644 index 00000000000..db1259a17ae --- /dev/null +++ b/api-reference/beta/resources/mailbox.md @@ -0,0 +1,54 @@ +--- +title: "mailbox resource type" +description: "Represents a user's mailbox." +author: "cparker-msft" +ms.date: 01/10/2025 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: resourcePageType +--- + +# mailbox resource type + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents a user's mailbox. + +Inherits from [directoryObject](../resources/directoryobject.md). + +## Methods +|Method|Return type|Description| +|:---|:---|:---| +|[Create import session](../api/mailbox-createimportsession.md)|[mailboxItemImportSession](../resources/mailboxitemimportsession.md)|Create a session to [import an Exchange mailbox item](/graph/import-exchange-mailbox-item) using its [FastTransfer stream](/openspecs/exchange_server_protocols/ms-oxcfxics/a2648823-0a98-43ee-98e8-590e4f7bcbbe) (FTS) format.| +|[Export items](../api/mailbox-exportitems.md)|[exportItemResponse](../resources/exportitemresponse.md) collection|Export Exchange [mailboxItem](../resources/mailboxitem.md) objects in full-fidelity [FastTransfer stream](/openspecs/exchange_server_protocols/ms-oxcfxics/ed7d3455-9bdf-40eb-90bd-8dfe6164a250#gt_12daff0e-4241-4498-a93f-212795ab2450) format for backup purposes. | + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|deletedDateTime|DateTimeOffset|Date and time when this object was deleted. Always `null` when the object hasn't been deleted. Inherited from [directoryObject](../resources/directoryobject.md).| +|id|String|The unique identifier for the **mailbox**. Inherited from [directoryObject](../resources/directoryobject.md).| + +## Relationships +|Relationship|Type|Description| +|:---|:---|:---| +|folders|[mailboxFolder](../resources/mailboxfolder.md) collection|The collection of folders in the mailbox.| + +## JSON representation +The following JSON representation shows the resource type. + +``` json +{ + "@odata.type": "#microsoft.graph.mailbox", + "deletedDateTime": "String (timestamp)", + "id": "String (identifier)" +} +``` diff --git a/api-reference/beta/resources/mailboxfolder.md b/api-reference/beta/resources/mailboxfolder.md new file mode 100644 index 00000000000..6545193b4a5 --- /dev/null +++ b/api-reference/beta/resources/mailboxfolder.md @@ -0,0 +1,77 @@ +--- +title: "mailboxFolder resource type" +description: "Represents a folder in a user's mailbox, such as inbox, drafts, or other user created folders." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: resourcePageType +--- + +# mailboxFolder resource type + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents a folder in a user's mailbox, such as inbox, drafts, or other user created folders. Folders can contain various mailbox items like messages, events, contacts, other Outlook items, and child folders. + +This resource supports [delta query](/graph/delta-query-overview) to track incremental additions, deletions, and updates, by providing a [delta](../api/mailboxfolder-delta.md) function. It also supports [single-value and multi-value extended properties](../resources/extended-properties-overview.md) for storing and accessing custom data that isn't already exposed in the Microsoft Graph API metadata. + +## Methods +|Method|Return type|Description| +|:---|:---|:---| +|[List](../api/mailbox-list-folders.md)|[mailboxFolder](../resources/mailboxfolder.md) collection|Get all the [mailboxFolder](../resources/mailboxfolder.md) objects in the specified mailbox, including any search folders.| +|[Create](../api/mailbox-post-folders.md)|[mailboxFolder](../resources/mailboxfolder.md)|Create a new [mailboxFolder](../resources/mailboxfolder.md) or child **mailboxFolder** in a user's mailbox.| +|[Get](../api/mailboxfolder-get.md)|[mailboxFolder](../resources/mailboxfolder.md)|Read the properties and relationships of a [mailboxFolder](../resources/mailboxfolder.md) object.| +|[Update](../api/mailboxfolder-update.md)|[mailboxFolder](../resources/mailboxfolder.md)|Update [mailboxFolder](../resources/mailboxfolder.md) properties such as the **displayName** within a mailbox.| +|[Delete](../api/mailbox-delete-folders.md)|None|Delete a [mailboxFolder](../resources/mailboxfolder.md) or a child **mailboxFolder** within a mailbox.| +|[Get delta](../api/mailboxfolder-delta.md)|[mailboxFolder](../resources/mailboxfolder.md) collection|Get a set of [mailboxFolder](../resources/mailboxfolder.md) objects that have been added, deleted, or removed from the user's mailbox.| +|[List child mailbox folders](../api/mailboxfolder-list-childfolders.md)|[mailboxFolder](../resources/mailboxfolder.md) collection|Get the [mailboxFolder](../resources/mailboxfolder.md) collection under the specified **mailboxFolder** in a mailbox.| +|[List items in folder](../api/mailboxfolder-list-items.md)|[mailboxItem](../resources/mailboxitem.md) collection|Get the [mailboxItem](../resources/mailboxitem.md) collection within a specified [mailboxFolder](../resources/mailboxfolder.md) in a mailbox.| +|**Extended properties**| | | +|[Create single-value property](../api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md)|[mailboxFolder](../resources/mailboxfolder.md)|Create one or more single-value extended properties in a new or existing mailbox folder.| +|[Get single-value property](../api/singlevaluelegacyextendedproperty-get.md)|[mailboxFolder](../resources/mailboxfolder.md)|Get mailbox folders that contain a single-value extended property by using `$expand` or `$filter`.| +|[Create multi-value property](../api/multivaluelegacyextendedproperty-post-multivalueextendedproperties.md)|[mailboxFolder](../resources/mailboxfolder.md)|Create one or more multi-value extended properties in a new or existing mailbox folder.| +|[Get multi-value property](../api/multivaluelegacyextendedproperty-get.md)|[mailboxFolder](../resources/mailboxfolder.md)|Get a mailbox folder that contains a multi-value extended property by using `$expand`.| + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|childFolderCount|Int32|The number of immediate child folders in the current folder.| +|displayName|String|The display name of the folder.| +|id|String|The unique identifier for the folder.| +|parentFolderId|String|The unique identifier for the parent folder of this folder.| +|parentMailboxUrl|String|The routing link to the actual underlying mailbox where the folder physically resides. The folder can be accessed using `GET {parentMailboxUrl}/folders/{id}`, which treats the entire URL as an opaque string.

This method is especially important when auto-expanding archiving is enabled for a user's in-place archive mailbox. The user's archive content can span across multiple mailboxes in such scenarios.| +|totalItemCount|Int32|The number of items in the folder.| +|type|String|Describes the folder class type.| + +## Relationships +|Relationship|Type|Description| +|:---|:---|:---| +|childFolders|[mailboxFolder](../resources/mailboxfolder.md) collection|The collection of child folders in this folder.| +|items|[mailboxItem](../resources/mailboxitem.md) collection|The collection of items in this folder.| +|multiValueExtendedProperties|[multiValueLegacyExtendedProperty](../resources/multivaluelegacyextendedproperty.md) collection|The collection of multi-value extended properties defined for the **mailboxFolder**.| +|singleValueExtendedProperties|[singleValueLegacyExtendedProperty](../resources/singlevaluelegacyextendedproperty.md) collection|The collection of single-value extended properties defined for the **mailboxFolder**.| + +## JSON representation +The following JSON representation shows the resource type. + +``` json +{ + "@odata.type": "#microsoft.graph.mailboxFolder", + "displayName": "String", + "childFolderCount": "Int32", + "id": "String (identifier)", + "parentFolderId": "String", + "parentMailboxUrl": "String", + "totalItemCount": "Int32", + "type": "String" +} +``` diff --git a/api-reference/beta/resources/mailboxitem.md b/api-reference/beta/resources/mailboxitem.md new file mode 100644 index 00000000000..f2f7154929a --- /dev/null +++ b/api-reference/beta/resources/mailboxitem.md @@ -0,0 +1,71 @@ +--- +title: "mailboxItem resource type" +description: "Represents an item in a mailboxFolder." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: resourcePageType +--- + +# mailboxItem resource type + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents an item in a [mailboxFolder](../resources/mailboxfolder.md). Items are Exchange mailbox items like message, task, event, contact, or note. + +This resource supports [delta query](/graph/delta-query-overview) to track incremental additions, deletions, and updates, by providing a delta function. It also supports single-value and multi-value extended properties for filtering on custom data that isn't already exposed in the Microsoft Graph API metadata. + +Inherits from [outlookItem](../resources/outlookitem.md). + +## Methods +|Method|Return type|Description| +|:---|:---|:---| +|[List](../api/mailboxfolder-list-items.md)|[mailboxItem](../resources/mailboxitem.md) collection|Get the [mailboxItem](../resources/mailboxitem.md) collection within a specified [mailboxFolder](../resources/mailboxfolder.md) in a mailbox.| +|[Get](../api/mailboxitem-get.md)|[mailboxItem](../resources/mailboxitem.md)|Read the properties and relationships of a [mailboxItem](../resources/mailboxitem.md) object.| +|[Get delta](../api/mailboxitem-delta.md)|[mailboxItem](../resources/mailboxitem.md) collection|Get a set of [mailboxItem](../resources/mailboxitem.md) objects that have been added, deleted, or updated in a specified [mailboxFolder](../resources/mailboxfolder.md).| +|**Extended properties**| | | +|[Get single-value property](../api/singlevaluelegacyextendedproperty-get.md)|[mailboxItem](../resources/mailboxitem.md)|Get mailbox items that contain a single-value extended property by using `$expand` or `$filter`.| +|[Get multi-value property](../api/multivaluelegacyextendedproperty-get.md)|[mailboxItem](../resources/mailboxitem.md)|Get a mailbox item that contains a multi-value extended property by using `$expand`.| + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|categories|String collection|The categories associated with the message. Inherited from [outlookItem](../resources/outlookitem.md).| +|changeKey|String|The version of the item. Inherited from [outlookItem](../resources/outlookitem.md).| +|createdDateTime|DateTimeOffset|The date and time when the item was created. The date and time information uses ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2021 is `2021-01-01T00:00:00Z`. Inherited from [outlookItem](../resources/outlookitem.md).| +|id|String|The unique identifier for the item. Inherited from [outlookItem](../resources/outlookitem.md).| +|lastModifiedDateTime|DateTimeOffset|The date and time when the item was last changed. The date and time information uses ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2021 is `2021-01-01T00:00:00Z`. Inherited from [outlookItem](../resources/outlookitem.md).| +|size|Int64|The length of the item in bytes.| +|type|String|The message class ID of the item.| + +## Relationships +|Relationship|Type|Description| +|:---|:---|:---| +|multiValueExtendedProperties|[multiValueLegacyExtendedProperty](../resources/multivaluelegacyextendedproperty.md) collection|The collection of multi-value extended properties defined for the **mailboxItem**.| +|singleValueExtendedProperties|[singleValueLegacyExtendedProperty](../resources/singlevaluelegacyextendedproperty.md) collection|The collection of single-value extended properties defined for the **mailboxItem**.| + +## JSON representation +The following JSON representation shows the resource type. + +``` json +{ + "@odata.type": "#microsoft.graph.mailboxItem", + "categories": ["String"], + "changeKey": "String", + "createdDateTime": "String (timestamp)", + "id": "String (identifier)", + "lastModifiedDateTime": "String (timestamp)", + "size": "Int64", + "type": "String" +} +``` diff --git a/api-reference/beta/resources/mailboxitemimportsession.md b/api-reference/beta/resources/mailboxitemimportsession.md new file mode 100644 index 00000000000..5b84bbd5de9 --- /dev/null +++ b/api-reference/beta/resources/mailboxitemimportsession.md @@ -0,0 +1,38 @@ +--- +title: "mailboxItemImportSession resource type" +description: "Provides information about how to import items into a user's mailbox." +author: "cparker-msft" +ms.date: 12/06/2024 +ms.localizationpriority: medium +ms.subservice: "outlook" +doc_type: resourcePageType +--- + +# mailboxItemImportSession resource type + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Provides information about how to import items into a user's mailbox. + +## Properties +|Property|Type|Description| +|:---|:---|:---| +|expirationDateTime|DateTimeOffset|The date and time in UTC when the import session expires. The date and time information uses ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2021 is `2021-01-01T00:00:00Z`.| +|importUrl|String|The URL endpoint that accepts POST requests for [FastTransfer stream](/openspecs/exchange_server_protocols/ms-oxcfxics/ed7d3455-9bdf-40eb-90bd-8dfe6164a250#gt_12daff0e-4241-4498-a93f-212795ab2450) format of the item.| + +## JSON representation +The following JSON representation shows the resource type. + +``` json +{ + "@odata.type": "#microsoft.graph.mailboxItemImportSession", + "expirationDateTime": "String (timestamp)", + "importUrl": "String" +} +``` diff --git a/api-reference/beta/resources/security-api-overview.md b/api-reference/beta/resources/security-api-overview.md index f2936c76118..3a3716adc57 100644 --- a/api-reference/beta/resources/security-api-overview.md +++ b/api-reference/beta/resources/security-api-overview.md @@ -19,7 +19,7 @@ The Microsoft Graph security API provides a unified interface and schema to inte - Unlock contextual data to inform investigations. - Automate security tasks, business processes, workflows, and reporting. - Send threat indicators to Microsoft products for customized detections. -- Invoke actions to in response to new threats. +- Invoke actions in response to new threats. - Provide visibility into security data to enable proactive risk management. The Microsoft Graph security API provides key features as described in the following sections. @@ -81,6 +81,7 @@ Alerts from the following security providers are available via these rich alerts - [Microsoft Defender for Identity](/defender-for-identity/alerts-overview) - [Microsoft Defender for Office 365](/microsoft-365/security/office-365-security/overview?view=o365-worldwide&preserve-view=true) - [Microsoft Purview Data Loss Prevention](/microsoft-365/compliance/dlp-learn-about-dlp?view=o365-worldwide&preserve-view=true) +- [Microsoft Purview Insider Risk Management](/purview/insider-risk-management?view=o365-worldwide&preserve-view=true) ### Legacy alerts @@ -105,11 +106,11 @@ Alerts from the following security providers are available via the legacy **aler > **Note:** New providers are continuously onboarding to the Microsoft Graph security ecosystem. To request new providers or for extended support from existing providers, [file an issue in the Microsoft Graph security GitHub repo](https://github.com/microsoftgraph/security-api-solutions/issues/new). -\* File issue: Alert status gets updated across Microsoft Graph security API integrated applications but not reflected in the provider’s management experience. +\* File issue: Alert status gets updated across Microsoft Graph security API integrated applications but isn't reflected in the provider’s management experience. \*\* Microsoft Defender for Endpoint requires additional [user roles](/windows/security/threat-protection/microsoft-defender-atp/user-roles) to those required by the Microsoft Graph security API. Only the users in both Microsoft Defender for Endpoint and Microsoft Graph security API roles can have access to the Microsoft Defender for Endpoint data. Because application-only authentication isn't limited by this, we recommend that you use an application-only authentication token. -\*\*\* Microsoft Defender for Identity alerts are available via the Microsoft Defender for Cloud Apps integration. This means you get Microsoft Defender for Identity alerts only if you have joined Unified SecOps and connected Microsoft Defender for Identity into Microsoft Defender for Cloud Apps. Learn more about [how to integrate Microsoft Defender for Identity and Microsoft Defender for Cloud Apps](/azure-advanced-threat-protection/atp-mcas-integration). +\*\*\* Microsoft Defender for Identity alerts are available via the Microsoft Defender for Cloud Apps integration. This means you get Microsoft Defender for Identity alerts only if you have joined Unified SecOps and connected Microsoft Defender for Identity to Microsoft Defender for Cloud Apps. Learn more about [how to integrate Microsoft Defender for Identity and Microsoft Defender for Cloud Apps](/azure-advanced-threat-protection/atp-mcas-integration). ## Attack simulation and training @@ -152,20 +153,20 @@ Grouping related alerts into an incident gives you a comprehensive view of an at - The scope of the attack, such as how many devices, users, and mailboxes were impacted. - All of the data associated with the attack. -The  [incident](security-incident.md) resource and its APIs allow you to sort through incidents to create an informed cyber security response. It exposes a collection of incidents, with their related  [alerts](security-alert.md), that were flagged in your network, within the time range you specified in your environment retention policy. +The  [incident](security-incident.md) resource and its APIs allow you to sort through incidents to create an informed cybersecurity response. It exposes a collection of incidents, with their related  [alerts](security-alert.md), that were flagged in your network, within the time range you specified in your environment retention policy. ## Information protection **Labels** - Information protection labels provide details about how to properly apply a sensitivity label to information. The information protection label API describes the configuration of sensitivity labels that apply to a user or tenant. -**Threat assessment** - The Microsoft Graph threat assessment API helps organizations to assess the threat received by any user in a tenant. This empowers customers to report spam or suspicious emails, phishing URLs, or malware attachments they receive to Microsoft. Microsoft checks the sample in question and the organizational policies in play before generating a result so that tenant administrators can understand the threat scanning verdict and adjust their organizational policy. They can also use it to report legitimate emails to prevent them from getting blocked. +**Threat assessment** - The Microsoft Graph threat assessment API helps organizations assess the threat received by any user in a tenant. This empowers customers to report spam or suspicious emails, phishing URLs, or malware attachments they receive to Microsoft. Microsoft checks the sample in question and the organizational policies in play before generating a result so that tenant administrators can understand the threat scanning verdict and adjust their organizational policy. They can also use it to report legitimate emails to prevent them from getting blocked. > **Note:** We recommend that you use the [threat submission](https://github.com/microsoftgraph/microsoft-graph-docs/pull/16242/files#threat-submission) API instead. ## Records management -Most organizations need to manage data to proactively comply with industry regulations and internal policies, reduce risk in the event of litigation or a security breach, and let their employees effectively and agilely share knowledge that is current and relevant to them. You can use the [records management APIs](../resources/security-recordsmanagement-overview.md) to systematically apply [retention labels](security-retentionlabel.md) to different types of content that require different retention settings. For example, you can configure the start of retention period from when the content was created, last modified, labeled or when an event occurs for a particular event type. Further, you can use [file plan descriptors](security-fileplandescriptor.md) to improve the manageability of these retention labels. +Most organizations need to manage data to proactively comply with industry regulations and internal policies, reduce risk in the event of litigation or a security breach, and let their employees effectively and agilely share knowledge that is current and relevant to them. You can use the [records management APIs](../resources/security-recordsmanagement-overview.md) to systematically apply [retention labels](security-retentionlabel.md) to different types of content that require different retention settings. For example, you can configure the start of retention period from when the content was created, last modified, labeled, or when an event occurs for a particular event type. Further, you can use [file plan descriptors](security-fileplandescriptor.md) to improve the manageability of these retention labels. ## Secure Score @@ -199,7 +200,7 @@ Threat indicators sent via the Microsoft Graph security API are available today The Microsoft Graph threat submission API helps organizations to submit a threat received by any user in a tenant. This empowers customers to report spam or suspicious emails, phishing URLs, or malware attachments they receive to Microsoft. Microsoft checks the submission against the organizational policies in effect and sends it to human graders for analysis. The result then helps tenant administrators understand the threat scanning verdict and adjust their organizational policy. Admins can also use the results to report legitimate emails to prevent them from getting blocked. -> **Note:** We recommend that you use the threat submission API instead of the deprecated Information Protection threat assessment API. The threat submission API provides unified security threat submission functionality and adds unified result support, user submission query support, tenant allow block list support, admin review support and app-only mode support. +> **Note:** We recommend that you use the threat submission API instead of the deprecated Information Protection threat assessment API. The threat submission API provides unified security threat submission functionality and adds unified result support, user submission query support, tenant-allow block list support, admin review support and app-only mode support. ## Email and collaboration protection @@ -280,10 +281,10 @@ You can use Microsoft Graph [webhooks](/graph/webhooks) to subscribe to and rece ## Next steps -The Microsoft Graph security API can open up new ways for you to engage with different security solutions from Microsoft and partners. Follow these steps to get started: +The Microsoft Graph security API can open up new ways for you to engage with different security solutions from Microsoft and its partners. Follow these steps to get started: - Drill down into [alerts](alert.md), [tiIndicator](tiindicator.md) (preview), [securityAction](securityaction.md) (preview), [secureScore](securescore.md), and [secureScoreControlProfiles](securescorecontrolprofiles.md). -- Try the API in the [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer). Under **Sample Queries**, choose **show more samples** and set the Security category to **on**. +- Try the API in the [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer). Under **Sample queries**, choose **Show more samples** and set the Security category to **On**. - Try [subscribing to and receiving notifications](/graph/webhooks) on entity changes. ## Related content diff --git a/api-reference/beta/resources/signin.md b/api-reference/beta/resources/signin.md index fca74365f8f..b90dbafa7b1 100644 --- a/api-reference/beta/resources/signin.md +++ b/api-reference/beta/resources/signin.md @@ -34,6 +34,7 @@ The [Microsoft Entra data retention policies](/azure/active-directory/reports-mo |appDisplayName|String|The application name displayed in the Microsoft Entra admin center.

Supports `$filter` (`eq`, `startsWith`).| |appId|String|The application identifier in Microsoft Entra ID.

Supports `$filter` (`eq`).| |appliedConditionalAccessPolicies|[appliedConditionalAccessPolicy](appliedconditionalaccesspolicy.md) collection|A list of conditional access policies that the corresponding sign-in activity triggers. Apps need more Conditional Access-related privileges to read the details of this property. For more information, see [Permissions for viewing applied conditional access (CA) policies in sign-ins](../api/signin-list.md#permissions).| +|appOwnerTenantId|String|The identifier of the tenant that owns the client application.

Supports `$filter` (`eq`).| |appliedEventListeners|[appliedAuthenticationEventListener](../resources/appliedauthenticationeventlistener.md) collection|Detailed information about the listeners, such as Azure Logic Apps and Azure Functions, which the corresponding events in the sign-in event triggered.| |appTokenProtectionStatus|tokenProtectionStatus|Token protection creates a cryptographically secure tie between the token and the device it's issued to. This field indicates whether the app token was bound to the device.| |authenticationAppDeviceDetails|[authenticationAppDeviceDetails](../resources/authenticationappdevicedetails.md)|Provides details about the app and device used during a Microsoft Entra authentication step.| @@ -76,6 +77,7 @@ The [Microsoft Entra data retention policies](/azure/active-directory/reports-mo |processingTimeInMilliseconds|Int|The request processing time in milliseconds in AD STS.| |resourceDisplayName|String|The name of the resource that the user signed in to.

Supports `$filter` (`eq`).| |resourceId|String|The identifier of the resource that the user signed in to.

Supports `$filter` (`eq`).| +|resourceOwnerTenantId|String|The identifier of the owner of the resource.

Supports `$filter` (`eq`).| |resourceServicePrincipalId|String|The identifier of the service principal representing the target resource in the sign-in event.| |resourceTenantId|String|The tenant identifier of the resource referenced in the sign in.| |riskDetail|riskDetail|The reason behind a specific state of a risky user, sign-in, or a risk event. The possible values are `none`, `adminGeneratedTemporaryPassword`, `userPerformedSecuredPasswordChange`, `userPerformedSecuredPasswordReset`, `adminConfirmedSigninSafe`, `aiConfirmedSigninSafe`, `userPassedMFADrivenByRiskBasedPolicy`, `adminDismissedAllRiskForUser`, `adminConfirmedSigninCompromised`, `hidden`, `adminConfirmedUserCompromised`, `unknownFutureValue`, `adminConfirmedServicePrincipalCompromised`, `adminDismissedAllRiskForServicePrincipal`, `m365DAdminDismissedDetection`, `userChangedPasswordOnPremises`, `adminDismissedRiskForSignIn`, `adminConfirmedAccountSafe`. Use the `Prefer: include-unknown-enum-members` request header to get the following value or values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `adminConfirmedServicePrincipalCompromised`, `adminDismissedAllRiskForServicePrincipal`, `m365DAdminDismissedDetection`, `userChangedPasswordOnPremises`, `adminDismissedRiskForSignIn`, `adminConfirmedAccountSafe`.The value `none` means that Microsoft Entra risk detection hasn't flagged the user or the sign-in as a risky event so far.

Supports `$filter` (`eq`).
**Note:** Details for this property are only available for Microsoft Entra ID P2 customers. All other customers are returned `hidden`.| diff --git a/api-reference/beta/resources/teamschannelplanner.md b/api-reference/beta/resources/teamschannelplanner.md deleted file mode 100644 index 1e50717ab8a..00000000000 --- a/api-reference/beta/resources/teamschannelplanner.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: "teamsChannelPlanner resource type" -description: "Provides access to Planner resources for a Teams shared channel." -ms.localizationpriority: medium -author: "DanluCui" -ms.subservice: "planner" -doc_type: resourcePageType -ms.date: 01/15/2025 ---- - -# teamsChannelPlanner resource type - -Namespace: microsoft.graph - -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - -Provides access to Planner resources for a Teams shared [channel](channel.md). This resource doesn't contain any usable properties. - -Inherits from [entity](entity.md). - -## Methods -| Method | Return Type |Description| -|:---------------|:--------|:----------| -|[List plans](../api/teamschannelplanner-list-plans.md) |[plannerPlan](plannerplan.md) collection| Get a list of [plannerPlan](../resources/plannerplan.md) objects owned by a shared [channel](../resources/channel.md) in Teams.| - -## Properties -| Property | Type |Description| -|:---------------|:--------|:----------| -|id|String| The unique identifier for the **teamsChannelPlanner** object. Read-only. Inherited from [entity](entity.md).| - -## Relationships -| Relationship | Type |Description| -|:---------------|:--------|:----------| -|plans|[plannerPlan](plannerplan.md) collection| A collection of [plannerPlan](plannerplan.md) objects owned by the Teams channel. Currently, only shared channels are supported. Read-only. Nullable.| - -## JSON representation - -The following JSON representation shows the resource type. - - - -```json -{ - "id": "String (identifier)" -} -``` - - - - diff --git a/api-reference/beta/resources/usersettings.md b/api-reference/beta/resources/usersettings.md index 43a19e71d41..e20facfe3d4 100644 --- a/api-reference/beta/resources/usersettings.md +++ b/api-reference/beta/resources/usersettings.md @@ -17,6 +17,7 @@ Namespace: microsoft.graph Settings that represent a user’s preferences for the following: - Access to Delve +- [Exchange settings](../resources/exchangesettings.md) - [Item insights](../resources/officegraphinsights.md) - [Regional locale and languages](../resources/regionalandlanguagesettings.md) - [Shift scheduling](../resources/shiftpreferences.md) @@ -44,10 +45,12 @@ Configure [contactMergeSuggestions](../resources/contactmergesuggestions.md): - Determine whether suggestions to merge duplicate contacts for a user is enabled. - Disable or enable suggestions to merge duplicate contacts for a user. +Access the user's [Exchange settings](../resources/exchangesettings.md). Get a list of Exchange settings, including mailboxes that belong to a user. + Export users' Windows settings and values stored in a cloud: - Get a list of the user's [windowsSetting](../resources/windowssetting.md) objects. - Get a filtered list of the user's [windowsSetting](../resources/windowssetting.md) objects by passing one of the following in the filter query: - - [windowssettingtype](../resources/enums.md#windowssettingtype-values) + - [windowsSettingType](../resources/enums.md#windowssettingtype-values) - [windowsDeviceId](../resources/windowssetting.md#properties) Inherits from [entity](entity.md). @@ -58,9 +61,10 @@ Inherits from [entity](entity.md). ## Methods | Method | Return Type |Description| |:---------------|:--------|:----------| -|[Get settings](../api/usersettings-get.md) |[userSettings](../resources/usersettings.md)| Get the user and organization settings. | -|[Update settings](../api/usersettings-update.md) |[userSettings](../resources/usersettings.md)| Update the user current settings. | -|[List](../api/usersettings-list-windows.md)|[windowsSetting](../resources/windowssetting.md) collection|Get the **windowsSetting** objects and their properties for the signed in user.| +|[Get](../api/usersettings-get.md) |[userSettings](../resources/usersettings.md)| Get the user and organization settings. | +|[Update](../api/usersettings-update.md) |[userSettings](../resources/usersettings.md)| Update the user current settings. | +|[List Exchange settings](../api/usersettings-list-exchange.md)|[exchangeSettings](../resources/exchangesettings.md) collection|Get a list of Exchange settings, including mailboxes that belong to a user.| +|[List Windows settings](../api/usersettings-list-windows.md)|[windowsSetting](../resources/windowssetting.md) collection|Get the **windowsSetting** objects and their properties for the signed in user.| ## Properties @@ -75,6 +79,7 @@ Inherits from [entity](entity.md). | Relationship | Type | Description | |:---------------|:--------|:----------| |contactMergeSuggestions|[contactMergeSuggestions](contactmergesuggestions.md)| The user's settings for the visibility of merge suggestion for the duplicate contacts in the user's contact list.| +|exchange|[exchangeSettings](../resources/exchangesettings.md)|The Exchange settings for mailbox discovery.| |itemInsights|[userInsightsSettings](userinsightssettings.md)| The user's settings for the visibility of meeting hour insights, and insights derived between a user and other items in Microsoft 365, such as documents or sites. [Get userInsightsSettings](../api/userinsightssettings-get.md) through this navigation property. | |regionalAndLanguageSettings|[regionalAndLanguageSettings](regionalandlanguagesettings.md)| The user's preferences for languages, regional locale and date/time formatting. | |shiftPreferences|[shiftPreferences](shiftpreferences.md)| The shift preferences for the user. | diff --git a/api-reference/beta/toc.yml b/api-reference/beta/toc.yml index 6e0e7a72c32..91acbe6420d 100644 --- a/api-reference/beta/toc.yml +++ b/api-reference/beta/toc.yml @@ -82,6 +82,9 @@ items: - name: Mail href: toc/mail/toc.yml displayName: Outlook, Outlook mail + - name: Mailbox import and export (preview) + href: toc/mailbox-import-and-export-(preview)/toc.yml + displayName: Exchange, Exchange Import-Export, Mailbox, Mailbox import and export - name: Notes href: toc/notes/toc.yml displayName: OneNote diff --git a/api-reference/beta/toc/mailbox-import-and-export-(preview)/toc.yml b/api-reference/beta/toc/mailbox-import-and-export-(preview)/toc.yml new file mode 100644 index 00000000000..dadbb108302 --- /dev/null +++ b/api-reference/beta/toc/mailbox-import-and-export-(preview)/toc.yml @@ -0,0 +1,72 @@ +# +# GENERATED FILE - DO NOT EDIT +# +items: +- name: Overview + href: ../../resources/mailbox-import-export-api-overview.md +- name: Mailbox + items: + - name: Mailbox + href: ../../resources/mailbox.md + - name: Create import session + href: ../../api/mailbox-createimportsession.md + - name: Export items + href: ../../api/mailbox-exportitems.md +- name: Mailbox item + items: + - name: Mailbox item + href: ../../resources/mailboxitem.md + - name: List + href: ../../api/mailboxfolder-list-items.md + - name: Get + href: ../../api/mailboxitem-get.md + - name: Get delta + href: ../../api/mailboxitem-delta.md + - name: Extended properties + items: + - name: Get single-value property + href: ../../api/singlevaluelegacyextendedproperty-get.md + - name: Get multi-value property + href: ../../api/multivaluelegacyextendedproperty-get.md +- name: Mailbox folder + items: + - name: Mailbox folder + href: ../../resources/mailboxfolder.md + - name: List + href: ../../api/mailbox-list-folders.md + - name: Create + href: ../../api/mailbox-post-folders.md + - name: Get + href: ../../api/mailboxfolder-get.md + - name: Update + href: ../../api/mailboxfolder-update.md + - name: Delete + href: ../../api/mailbox-delete-folders.md + - name: Get delta + href: ../../api/mailboxfolder-delta.md + - name: List child mailbox folders + href: ../../api/mailboxfolder-list-childfolders.md + - name: List items in folder + href: ../../api/mailboxfolder-list-items.md + - name: Extended properties + items: + - name: Create single-value property + href: ../../api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md + - name: Get single-value property + href: ../../api/singlevaluelegacyextendedproperty-get.md + - name: Create multi-value property + href: ../../api/multivaluelegacyextendedproperty-post-multivalueextendedproperties.md + - name: Get multi-value property + href: ../../api/multivaluelegacyextendedproperty-get.md +- name: Exchange settings + items: + - name: Exchange settings + href: ../../resources/exchangesettings.md + - name: List + href: ../../api/usersettings-list-exchange.md +- name: Complex types + items: + - name: Export item response + href: ../../resources/exportitemresponse.md + - name: Mailbox item import session + href: ../../resources/mailboxitemimportsession.md diff --git a/api-reference/beta/toc/mailbox-import-and-export/toc.yml b/api-reference/beta/toc/mailbox-import-and-export/toc.yml new file mode 100644 index 00000000000..c7379516ef9 --- /dev/null +++ b/api-reference/beta/toc/mailbox-import-and-export/toc.yml @@ -0,0 +1,72 @@ +# +# GENERATED FILE - DO NOT EDIT +# +items: +- name: Overview + href: ../../resources/exchange-import-export-api-overview.md +- name: Mailbox + items: + - name: Mailbox + href: ../../resources/mailbox.md + - name: Create import session + href: ../../api/mailbox-createimportsession.md + - name: Export items + href: ../../api/mailbox-exportitems.md +- name: Mailbox item + items: + - name: Mailbox item + href: ../../resources/mailboxitem.md + - name: List + href: ../../api/mailboxfolder-list-items.md + - name: Get + href: ../../api/mailboxitem-get.md + - name: Get delta + href: ../../api/mailboxitem-delta.md + - name: Extended properties + items: + - name: Get single-value property + href: ../../api/singlevaluelegacyextendedproperty-get.md + - name: Get multi-value property + href: ../../api/multivaluelegacyextendedproperty-get.md +- name: Mailbox folder + items: + - name: Mailbox folder + href: ../../resources/mailboxfolder.md + - name: List + href: ../../api/mailbox-list-folders.md + - name: Create + href: ../../api/mailbox-post-folders.md + - name: Get + href: ../../api/mailboxfolder-get.md + - name: Update + href: ../../api/mailboxfolder-update.md + - name: Delete + href: ../../api/mailbox-delete-folders.md + - name: Get delta + href: ../../api/mailboxfolder-delta.md + - name: List child mailbox folders + href: ../../api/mailboxfolder-list-childfolders.md + - name: List items in folder + href: ../../api/mailboxfolder-list-items.md + - name: Extended properties + items: + - name: Create single-value property + href: ../../api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md + - name: Get single-value property + href: ../../api/singlevaluelegacyextendedproperty-get.md + - name: Create multi-value property + href: ../../api/multivaluelegacyextendedproperty-post-multivalueextendedproperties.md + - name: Get multi-value property + href: ../../api/multivaluelegacyextendedproperty-get.md +- name: Exchange settings + items: + - name: Exchange settings + href: ../../resources/exchangesettings.md + - name: List + href: ../../api/usersettings-list-exchange.md +- name: Complex types + items: + - name: Export item response + href: ../../resources/exportitemresponse.md + - name: Mailbox item import session + href: ../../resources/mailboxitemimportsession.md diff --git a/api-reference/beta/toc/tasks-and-plans/toc.yml b/api-reference/beta/toc/tasks-and-plans/toc.yml index 4a7c41985fd..8f06cea940a 100644 --- a/api-reference/beta/toc/tasks-and-plans/toc.yml +++ b/api-reference/beta/toc/tasks-and-plans/toc.yml @@ -110,12 +110,6 @@ items: href: ../../api/plannertaskdetails-get.md - name: Update task details href: ../../api/plannertaskdetails-update.md -- name: Teams channel planner - items: - - name: Teams channel planner - href: ../../resources/teamschannelplanner.md - - name: List plans - href: ../../api/teamschannelplanner-list-plans.md - name: Business scenarios (preview) items: - name: Overview diff --git a/api-reference/beta/toc/teamwork-and-communications/toc.yml b/api-reference/beta/toc/teamwork-and-communications/toc.yml index ba70bdd7204..0175ead1403 100644 --- a/api-reference/beta/toc/teamwork-and-communications/toc.yml +++ b/api-reference/beta/toc/teamwork-and-communications/toc.yml @@ -819,10 +819,6 @@ items: href: ../../api/sharedwithchannelteaminfo-list-allowedmembers.md - name: Check user access href: ../../api/channel-doesuserhaveaccess.md - - name: Planner - items: - - name: List plans - href: ../../api/teamschannelplanner-list-plans.md - name: Chat items: - name: Chat diff --git a/api-reference/beta/toc/toc.mapping.json b/api-reference/beta/toc/toc.mapping.json index 207e50a940f..ec635dee8cc 100644 --- a/api-reference/beta/toc/toc.mapping.json +++ b/api-reference/beta/toc/toc.mapping.json @@ -2119,6 +2119,26 @@ } ] }, + { + "name": "Mailbox import and export (preview)", + "overview": "../../resources/mailbox-import-export-api-overview.md", + "keywords": [ + "Exchange", + "Exchange Import-Export", + "Mailbox", + "Mailbox import and export" + ], + "resources": [ + "mailbox", + "mailboxItem", + "mailboxFolder", + "exchangeSettings" + ], + "complexTypes": [ + "exportItemResponse", + "mailboxItemImportSession" + ] + }, { "name": "Notes", "overview": "../../resources/onenote-api-overview.md", @@ -2772,8 +2792,7 @@ "plannerPlanDetails", "plannerRoster", "plannerUser", - "plannerTaskDetails", - "teamsChannelPlanner" + "plannerTaskDetails" ], "complexTypes": [ "businessScenarioGroupTarget", diff --git a/api-reference/v1.0/api/directoryobject-checkmembergroups.md b/api-reference/v1.0/api/directoryobject-checkmembergroups.md index ab4ece2e80f..93ab97b968b 100644 --- a/api-reference/v1.0/api/directoryobject-checkmembergroups.md +++ b/api-reference/v1.0/api/directoryobject-checkmembergroups.md @@ -12,7 +12,15 @@ ms.date: 10/24/2024 Namespace: microsoft.graph -Check for membership in a specified list of group IDs, and return from that list those groups (identified by IDs) of which the specified [user](../resources/user.md), [group](../resources/group.md), [service principal](../resources/serviceprincipal.md), [organizational contact](../resources/orgcontact.md), [device](../resources/device.md), or [directory object](../resources/directoryobject.md) is a member. This function is transitive. +Check for membership in a specified list of [group](../resources/group.md) IDs, and return from that list the IDs of groups where a specified object is a member. The specified object can be of one of the following types: +- [user](../resources/user.md) +- [group](../resources/group.md) +- [service principal](../resources/serviceprincipal.md) +- [organizational contact](../resources/orgcontact.md) +- [device](../resources/device.md) +- [directory object](../resources/directoryobject.md) + +This function is transitive. You can check up to a maximum of 20 groups per request. This function supports all groups provisioned in Microsoft Entra ID. Because Microsoft 365 groups cannot contain other groups, membership in a Microsoft 365 group is always direct. @@ -20,64 +28,72 @@ You can check up to a maximum of 20 groups per request. This function supports a ## Permissions -### Group memberships for a directory object +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +### Group memberships for a directory object -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | User.ReadBasic.All and GroupMember.Read.All, User.Read.All and GroupMember.Read.All, User.ReadBasic.All and Group.Read.All, User.Read.All and Group.Read.All, Directory.Read.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | User.Read.All and GroupMember.Read.All, User.Read.All and Group.Read.All, Directory.Read.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Directory.Read.All|Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Directory.Read.All|Directory.ReadWrite.All | + +> [!NOTE] +> The *Directory.\** permissions allow you to retrieve any supported directory object type via this API. To retrieve only a specific type, you can use permissions specific to the resource. ### Group memberships for the signed-in user -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | User.Read, User.ReadBasic.All and GroupMember.Read.All, User.Read.All and GroupMember.Read.All, User.ReadBasic.All and Group.Read.All, User.Read.All and Group.Read.All, Directory.Read.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Not supported. | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|User.Read|User.ReadBasic.All and GroupMember.Read.All, User.Read.All and GroupMember.Read.All, User.ReadBasic.All and Group.Read.All, User.Read.All and Group.Read.All, Directory.Read.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Not supported.|Not supported.| ### Group memberships for other users -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | User.ReadBasic.All and GroupMember.Read.All, User.Read.All and GroupMember.Read.All, User.ReadBasic.All and Group.Read.All, User.Read.All and Group.Read.All, Directory.Read.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | User.Read.All and GroupMember.Read.All, User.Read.All and Group.Read.All, Directory.Read.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|User.ReadBasic.All and GroupMember.Read.All|User.Read.All and GroupMember.Read.All, User.ReadBasic.All and Group.Read.All, User.Read.All and Group.Read.All, Directory.Read.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|User.ReadBasic.All and GroupMember.Read.All|User.Read.All and GroupMember.Read.All, User.Read.All and Group.Read.All, Directory.Read.All| ### Group memberships for a group -| Permission type | Permissions (from least to most privileged) | -| :------------------------------------- | :------------------------------------------------------------------------------------------ | -| Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|GroupMember.Read.All|Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|GroupMember.Read.All|Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All| ### Group memberships for a service principal -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Application.Read.All|Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Application.Read.All|Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All| ### Group memberships for an organizational contact -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Directory.Read.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Directory.Read.All|Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Directory.Read.All|Directory.ReadWrite.All | ### Group memberships for a device - -[!INCLUDE [permissions-table](../includes/permissions/directoryobject-checkmembergroups-7-permissions.md)] + +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Device.Read.All|Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Device.Read.All|Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | ## HTTP request diff --git a/api-reference/v1.0/api/directoryobject-checkmemberobjects.md b/api-reference/v1.0/api/directoryobject-checkmemberobjects.md index a9fccde63ba..e31f0cd92b2 100644 --- a/api-reference/v1.0/api/directoryobject-checkmemberobjects.md +++ b/api-reference/v1.0/api/directoryobject-checkmemberobjects.md @@ -13,7 +13,15 @@ ms.date: 10/22/2024 Namespace: microsoft.graph -Check for membership in a list of group IDs, administrative unit IDs, or directory role IDs, for the IDs of the specified [user](../resources/user.md), [group](../resources/group.md), [service principal](../resources/serviceprincipal.md), [organizational contact](../resources/orgcontact.md), [device](../resources/device.md), or [directory object](../resources/directoryobject.md). This method is transitive. +Check for membership in a list of group IDs, administrative unit IDs, or directory role IDs, for the IDs of the specified +- [user](../resources/user.md) +- [group](../resources/group.md) +- [service principal](../resources/serviceprincipal.md) +- [organizational contact](../resources/orgcontact.md) +- [device](../resources/device.md) +- [directory object](../resources/directoryobject.md). + +This method is transitive. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] @@ -23,64 +31,65 @@ One of the following permissions is required to call this API. To learn more, in ### Memberships for a directory object -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Directory.Read.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Directory.Read.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Directory.Read.All|Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Directory.Read.All|Directory.ReadWrite.All | + +> [!NOTE] +> The *Directory.\** permissions allow you to retrieve any supported directory object type via this API. To retrieve only a specific type, you can use permissions specific to the resource. ### Memberships for the signed-in user -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | User.Read, User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Not supported. | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|User.Read|User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Not supported.|Not supported.| ### Memberships for other users -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | User.Read, User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|User.ReadBasic.All and GroupMember.Read.All|User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|User.ReadBasic.All and GroupMember.Read.All|User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All| ### Memberships for a group -| Permission type | Permissions (from least to most privileged) | -| :------------------------------------- | :------------------------------------------------------------------------------------------ | -| Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|GroupMember.Read.All|Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|GroupMember.Read.All|Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All| ### Memberships for a service principal -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Application.Read.All|Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Application.Read.All|Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All| ### Memberships for an organizational contact -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Directory.Read.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Directory.Read.All|Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Directory.Read.All|Directory.ReadWrite.All | ### Memberships for a device -| Permission type | Permissions (from least to most privileged) | -|:---------------------------------------|:--------------------------------------------| -| Delegated (work or school account) | Device.Read.All, Directory.Read.All, Directory.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Device.Read.All, Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | - +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Device.Read.All|Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Device.Read.All|Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | ## HTTP request - Memberships for a directory object. ```http diff --git a/api-reference/v1.0/api/directoryobject-getmemberobjects.md b/api-reference/v1.0/api/directoryobject-getmemberobjects.md index 153c6b81061..ba82ff93496 100644 --- a/api-reference/v1.0/api/directoryobject-getmemberobjects.md +++ b/api-reference/v1.0/api/directoryobject-getmemberobjects.md @@ -1,5 +1,5 @@ --- -title: "Get member objects" +title: "directoryObject: getMemberObjects" description: "Return all the groups, administrative units, and directory roles that a user, group, service principal, organizational contact, device, or directory object is a member of. This function is transitive." ms.localizationpriority: medium author: "keylimesoda" @@ -8,13 +8,19 @@ doc_type: apiPageType ms.date: 04/04/2024 --- -# Get member objects +# directoryObject: getMemberObjects Namespace: microsoft.graph -Return all IDs for the groups, administrative units, and directory roles that a [user](../resources/user.md), [group](../resources/group.md), [service principal](../resources/serviceprincipal.md), [organizational contact](../resources/orgcontact.md), [device](../resources/device.md), or [directory object](../resources/directoryobject.md) is a member of. This function is transitive. +Return all IDs for the groups, administrative units, and directory roles that an object of one of the following types is a member of: +- [user](../resources/user.md) +- [group](../resources/group.md) +- [service principal](../resources/serviceprincipal.md) +- [organizational contact](../resources/orgcontact.md) +- [device](../resources/device.md) +- [directory object](../resources/directoryobject.md) -**Note:** Only users and role-enabled groups can be members of directory roles. +This function is transitive. Only users and role-enabled groups can be members of directory roles. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] @@ -23,51 +29,62 @@ One of the following permissions is required to call this API. To learn more, in ### Memberships for a directory object -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Directory.Read.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Directory.Read.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Directory.Read.All|Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Directory.Read.All|Directory.ReadWrite.All | -### Memberships for a user +> [!NOTE] +> The *Directory.\** permissions allow you to retrieve any supported directory object type via this API. To retrieve only a specific type, you can use permissions specific to the resource. + +### Memberships for the signed-in user + +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|User.Read|User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Not supported.|Not supported.| + +### Memberships for other users -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | User.Read, User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|User.ReadBasic.All and GroupMember.Read.All|User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|User.ReadBasic.All and GroupMember.Read.All|User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All| ### Memberships for a group -| Permission type | Permissions (from least to most privileged) | -| :------------------------------------- | :------------------------------------------------------------------------------------------ | -| Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|GroupMember.Read.All|Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|GroupMember.Read.All|Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All| ### Memberships for a service principal -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Application.Read.All|Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Application.Read.All|Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All| ### Memberships for an organizational contact -|Permission type | Permissions (from least to most privileged) | -|:--------------------|:---------------------------------------------------------| -|Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All | -|Delegated (personal Microsoft account) | Not supported. | -|Application | Directory.Read.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Directory.Read.All|Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Directory.Read.All|Directory.ReadWrite.All | ### Memberships for a device -| Permission type | Permissions (from least to most privileged) | -|:---------------------------------------|:--------------------------------------------| -| Delegated (work or school account) | Device.Read.All, Directory.Read.All, Directory.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Device.Read.All, Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | +|Permission type|Least privileged permissions|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|Device.Read.All|Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Device.Read.All|Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | ## HTTP request @@ -78,10 +95,15 @@ Memberships for a directory object POST /directoryObjects/{id}/getMemberObjects ``` -Memberships for a user +Memberships for the signed-in user. ```http POST /me/getMemberObjects +``` + +Memberships for other user. + +```http POST /users/{id | userPrincipalName}/getMemberObjects ``` diff --git a/api-reference/v1.0/api/filestoragecontainer-restore.md b/api-reference/v1.0/api/filestoragecontainer-restore.md index 8e2685327b7..f7e37ca1c6c 100644 --- a/api-reference/v1.0/api/filestoragecontainer-restore.md +++ b/api-reference/v1.0/api/filestoragecontainer-restore.md @@ -97,7 +97,6 @@ POST https://graph.microsoft.com/v1.0/storage/fileStorage/deletedContainers/b!IS --- - ### Response The following example shows the response. diff --git a/api-reference/v1.0/api/onlinemeeting-update.md b/api-reference/v1.0/api/onlinemeeting-update.md index befeaae0c12..ab56a9e9518 100644 --- a/api-reference/v1.0/api/onlinemeeting-update.md +++ b/api-reference/v1.0/api/onlinemeeting-update.md @@ -14,7 +14,7 @@ Namespace: microsoft.graph Update the properties of the specified [onlineMeeting](../resources/onlinemeeting.md) object. -Please see [Request body](#request-body) section for the list of properties that support updating. +For the list of properties that support updating, see the [Request body](#request-body) section. [!INCLUDE [national-cloud-support](../../includes/global-us.md)] @@ -65,7 +65,7 @@ PATCH /users/{userId}/onlineMeetings/{meetingId} > [!NOTE] > -> - **userId** is the object ID of a user in the [Microsoft Entra admin center > user management page](https://entra.microsoft.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [application access policy](/graph/cloud-communication-online-meeting-application-access-policy). +> - `userId` is the object ID of a user in the [Microsoft Entra admin center > user management page](https://entra.microsoft.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more information, see [application access policy](/graph/cloud-communication-online-meeting-application-access-policy). > - `meetingId` is the **id** of an [onlineMeeting](../resources/onlinemeeting.md) object. ## Request headers @@ -77,32 +77,37 @@ PATCH /users/{userId}/onlineMeetings/{meetingId} ## Request body -The following table lists the properties that can be updated. In the request body, include only the properties that need updating, with the following exceptions: +The following table lists the properties that can be updated. In the request body, supply *only* the values for properties that should be updated, with the following exceptions: - Adjusting the start or end date/time of an online meeting always requires both **startDateTime** and **endDateTime** properties in the request body. -- The **organizer** field of the **participants** property cannot be updated. The organizer of the meeting cannot be modified after the meeting is created. +- The **organizer** field of the **participants** property can't be updated. The organizer of the meeting can't be modified after the meeting is created. - Adjusting the **attendees** field of the **participants** property, such as adding or removing an attendee to the meeting, always requires the full list of attendees in the request body. The last column indicates whether updating this property will take effect for an in-progress meeting. | Property | Type | Description | Applies to in-progress meetings? | |-----------------------------|------------------------------------------------------------|-------------------------------------------------------------------------------------|------------------------------| -| startDateTime | DateTime | The meeting start time in UTC. | No | -| endDateTime | DateTime | The meeting end time in UTC. | No | -| subject | String | The subject of the online meeting. | No | -| participants | [meetingParticipants](../resources/meetingparticipants.md) | The participants associated with the online meeting. Only attendees can be updated. | No | -| isEntryExitAnnounced | Boolean | Whether or not to announce when callers join or leave. | Yes | -| lobbyBypassSettings | [lobbyBypassSettings](../resources/lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. | Yes | -| allowedPresenters | onlineMeetingPresenters | Specifies who can be a presenter in a meeting. | Yes | | allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. | Yes | | allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. | Yes | +| allowBreakoutRooms | Boolean | Indicates whether breakout rooms are enabled for the meeting. | No | +| allowedPresenters | onlineMeetingPresenters | Specifies who can be a presenter in a meeting. | Yes | +| allowLiveShare | meetingLiveShareOptions | Indicates whether live share is enabled for the meeting. | No | | allowMeetingChat | meetingChatMode | Specifies the mode of meeting chat. | Yes | +| allowPowerPointSharing | Boolean | Indicates whether PowerPoint live is enabled for the meeting. | No | | allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the meeting. | Yes | +| allowedLobbyAdmitters | [allowedLobbyAdmitterRoles](../resources/onlinemeetingbase.md#allowedlobbyadmitterroles-values) | Specifies the users who can admit from the lobby. Possible values are: `organizerAndCoOrganizersAndPresenters`, `organizerAndCoOrganizers`, `unknownFutureValue`. | Yes | +| allowWhiteboard | Boolean | Indicates whether whiteboard is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| endDateTime | DateTime | The meeting end time in UTC. | No | +| isEntryExitAnnounced | Boolean | Whether or not to announce when callers join or leave. | Yes | +| lobbyBypassSettings | [lobbyBypassSettings](../resources/lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. | Yes | +| participants | [meetingParticipants](../resources/meetingparticipants.md) | The participants associated with the online meeting. Only attendees can be updated. | No | | recordAutomatically | Boolean | Indicates whether to record the meeting automatically. | No | +| startDateTime | DateTime | The meeting start time in UTC. | No | +| subject | String | The subject of the online meeting. | No | > [!NOTE] > ->- For the list of possible values for **allowedPresenters** and **allowMeetingChat**, see [onlineMeeting](../resources/onlinemeeting.md). +>- For the list of possible values for **allowedPresenters**, **allowLiveShare**, and **allowMeetingChat**, see [onlineMeeting](../resources/onlinemeeting.md). >- When updating the value of **allowedPresenters** to `roleIsPresenter`, include a full list of **attendees** with specified attendees' **role** set to `presenter` in the request body. ## Response diff --git a/api-reference/v1.0/includes/permissions/directoryobject-checkmembergroups-7-permissions.md b/api-reference/v1.0/includes/permissions/directoryobject-checkmembergroups-7-permissions.md deleted file mode 100644 index ddc8495a891..00000000000 --- a/api-reference/v1.0/includes/permissions/directoryobject-checkmembergroups-7-permissions.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -description: "Automatically generated file. DO NOT MODIFY" -ms.topic: include -ms.localizationpriority: medium ---- - -|Permission type|Least privileged permissions|Higher privileged permissions| -|:---|:---|:---| -|Delegated (work or school account)|Application.Read.All|Application.ReadWrite.All, Device.Read.All, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, GroupMember.Read.All, User.Read.All, User.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Application.Read.All|Application.ReadWrite.All, Device.Read.All, Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, GroupMember.Read.All, User.Read.All, User.ReadWrite.All| - diff --git a/api-reference/v1.0/includes/snippets/cli/create-ediscoveryholdpolicy-from--cli-snippets.md b/api-reference/v1.0/includes/snippets/cli/create-ediscoveryholdpolicy-from--cli-snippets.md index c1ca45e60db..bf86dcad3c5 100644 --- a/api-reference/v1.0/includes/snippets/cli/create-ediscoveryholdpolicy-from--cli-snippets.md +++ b/api-reference/v1.0/includes/snippets/cli/create-ediscoveryholdpolicy-from--cli-snippets.md @@ -8,7 +8,7 @@ description: "Automatically generated file. DO NOT MODIFY" mgc-beta security cases ediscovery-cases legal-holds create --ediscovery-case-id {ediscoveryCase-id} --body '{ \ "displayName": "My legalHold with sources", \ "description": "Created from Graph API", \ - "contentQuery": "KQL content query", \ + "contentQuery": "KQL content query" \ } \ ' diff --git a/api-reference/v1.0/includes/snippets/cli/create-retentionlabel-from--cli-snippets.md b/api-reference/v1.0/includes/snippets/cli/create-retentionlabel-from--cli-snippets.md index ccd16f1cfa2..306671784a9 100644 --- a/api-reference/v1.0/includes/snippets/cli/create-retentionlabel-from--cli-snippets.md +++ b/api-reference/v1.0/includes/snippets/cli/create-retentionlabel-from--cli-snippets.md @@ -5,7 +5,7 @@ description: "Automatically generated file. DO NOT MODIFY" ```bash -mgc-beta security labels retention-labels create --body '{ \ +mgc security labels retention-labels create --body '{ \ "@odata.type": "#microsoft.graph.security.retentionLabel", \ "displayName": "Retention Schedule 10005", \ "behaviorDuringRetentionPeriod": "retain", \ diff --git a/api-reference/v1.0/includes/snippets/cli/create-usersource-and-include-sources-cli-snippets.md b/api-reference/v1.0/includes/snippets/cli/create-usersource-and-include-sources-cli-snippets.md index a3cf18b2045..711f4ccaedb 100644 --- a/api-reference/v1.0/includes/snippets/cli/create-usersource-and-include-sources-cli-snippets.md +++ b/api-reference/v1.0/includes/snippets/cli/create-usersource-and-include-sources-cli-snippets.md @@ -7,7 +7,7 @@ description: "Automatically generated file. DO NOT MODIFY" mgc-beta security cases ediscovery-cases legal-holds user-sources create --ediscovery-case-id {ediscoveryCase-id} --ediscovery-hold-policy-id {ediscoveryHoldPolicy-id} --body '{ \ "email": "admin@contoso.com", \ - "includedSources": "mailbox" \ + "includedSources": "mailbox, site" \ } \ ' diff --git a/api-reference/v1.0/includes/snippets/cli/delete-page-cli-snippets.md b/api-reference/v1.0/includes/snippets/cli/delete-page-cli-snippets.md index a64bdce29ec..b8dc16dabf1 100644 --- a/api-reference/v1.0/includes/snippets/cli/delete-page-cli-snippets.md +++ b/api-reference/v1.0/includes/snippets/cli/delete-page-cli-snippets.md @@ -5,6 +5,6 @@ description: "Automatically generated file. DO NOT MODIFY" ```bash -mgc sites pages delete --site-id {site-id} --base-site-page-id {baseSitePage-id} +mgc users onenote pages delete --user-id {user-id} --onenote-page-id {onenotePage-id} ``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/cli/post-chatmessage-5-cli-snippets.md b/api-reference/v1.0/includes/snippets/cli/post-chatmessage-5-cli-snippets.md index 1f27f0301f7..47174f42ed0 100644 --- a/api-reference/v1.0/includes/snippets/cli/post-chatmessage-5-cli-snippets.md +++ b/api-reference/v1.0/includes/snippets/cli/post-chatmessage-5-cli-snippets.md @@ -6,17 +6,17 @@ description: "Automatically generated file. DO NOT MODIFY" mgc teams channels messages create --team-id {team-id} --channel-id {channel-id} --body '{ \ - "body": { \ - "contentType": "html", \ - "content": "Testing with file share link. " \ - }, \ - "attachments": [ \ - { \ - "id": "668f7fa8-8129-4de7-b32b-fe1b442e6ef1", \ - "contentType": "reference", \ - "contentUrl": "https://teamsgraph-my.sharepoint.com/:w:/g/personal/test_teamsgraph_onmicrosoft_com/Eah_j2YpgedNsyv-G0QubvEBma6Sd_76UtYkXwoJ-nYVEg?e=0H2Ibm" \ - } \ - ] \ + "body": { \ + "contentType": "html", \ + "content": "Testing with file share link. " \ + }, \ + "attachments": [ \ + { \ + "id": "668f7fa8-8129-4de7-b32b-fe1b442e6ef1", \ + "contentType": "reference", \ + "contentUrl": "https://teamsgraph-my.sharepoint.com/:w:/g/personal/test_teamsgraph_onmicrosoft_com/Eah_j2YpgedNsyv-G0QubvEBma6Sd_76UtYkXwoJ-nYVEg?e=0H2Ibm" \ + } \ + ] \ } \ ' diff --git a/api-reference/v1.0/includes/snippets/cli/update-gradingcategories-delta-cli-snippets.md b/api-reference/v1.0/includes/snippets/cli/update-gradingcategories-delta-cli-snippets.md index 959a9e3136c..a3030eb39a2 100644 --- a/api-reference/v1.0/includes/snippets/cli/update-gradingcategories-delta-cli-snippets.md +++ b/api-reference/v1.0/includes/snippets/cli/update-gradingcategories-delta-cli-snippets.md @@ -5,27 +5,23 @@ description: "Automatically generated file. DO NOT MODIFY" ```bash -mgc-beta education classes assignment-settings patch --education-class-id {educationClass-id} --body '{ \ +mgc education classes assignment-settings patch --education-class-id {educationClass-id} --body '{ \ "gradingCategories@delta": [ \ { \ // Change this grading category's name \ - "id": "fb859cd3-943b-4cd6-9bbe-fe1c39eace0e", \ - "displayName": "Lab Test" \ + "id": "03bd9196-ce2e-41bd-902f-df9ae02de4db", \ + "displayName": "Lab Updated" \ }, \ { \ - // Delete this grading category \ + // Delete this grading category \ "@odata.context": "https://graph.microsoft.com/beta/$metadata#gradingCategories/$deletedEntity", \ - "id": "e2a86277-24f9-4f29-8196-8c83fc69d00d", \ + "id": "109e5d73-3ef7-42a5-88d8-7e30cdb85f06", \ "reason": "deleted" \ }, \ { \ - // Add a new grading category \ - "displayName": "Lab Practice", \ - "percentageWeight": 30 \ - }, \ - { \ - "displayName": "Lab Theory", \ - "percentageWeight": 10 \ + // Add a new grading category \ + "displayName": "New Homework", \ + "percentageWeight": 50 \ } \ ] \ } \ diff --git a/api-reference/v1.0/includes/snippets/csharp/create-retentionlabel-from--csharp-snippets.md b/api-reference/v1.0/includes/snippets/csharp/create-retentionlabel-from--csharp-snippets.md index 1fc8de3c6b0..514a9c3a48e 100644 --- a/api-reference/v1.0/includes/snippets/csharp/create-retentionlabel-from--csharp-snippets.md +++ b/api-reference/v1.0/includes/snippets/csharp/create-retentionlabel-from--csharp-snippets.md @@ -7,7 +7,7 @@ description: "Automatically generated file. DO NOT MODIFY" // Code snippets are only available for the latest version. Current version is 5.x // Dependencies -using Microsoft.Graph.Beta.Models.Security; +using Microsoft.Graph.Models.Security; var requestBody = new RetentionLabel { diff --git a/api-reference/v1.0/includes/snippets/csharp/create-usersource-and-include-sources-csharp-snippets.md b/api-reference/v1.0/includes/snippets/csharp/create-usersource-and-include-sources-csharp-snippets.md index 26c0efb41ed..fb6dc45c0cb 100644 --- a/api-reference/v1.0/includes/snippets/csharp/create-usersource-and-include-sources-csharp-snippets.md +++ b/api-reference/v1.0/includes/snippets/csharp/create-usersource-and-include-sources-csharp-snippets.md @@ -12,7 +12,7 @@ using Microsoft.Graph.Beta.Models.Security; var requestBody = new UserSource { Email = "admin@contoso.com", - IncludedSources = SourceType.Mailbox, + IncludedSources = SourceType.Mailbox | SourceType.Site, }; // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp diff --git a/api-reference/v1.0/includes/snippets/csharp/create-virtualeventregistration-application-csharp-snippets.md b/api-reference/v1.0/includes/snippets/csharp/create-virtualeventregistration-application-csharp-snippets.md index ac11f0a8cde..03c71893d6a 100644 --- a/api-reference/v1.0/includes/snippets/csharp/create-virtualeventregistration-application-csharp-snippets.md +++ b/api-reference/v1.0/includes/snippets/csharp/create-virtualeventregistration-application-csharp-snippets.md @@ -8,13 +8,17 @@ description: "Automatically generated file. DO NOT MODIFY" // Dependencies using Microsoft.Graph.Models; -using Microsoft.Kiota.Abstractions.Serialization; var requestBody = new VirtualEventRegistration { FirstName = "Diane", LastName = "Demoss", Email = "DianeDemoss@contoso.com", + ExternalRegistrationInformation = new VirtualEventExternalRegistrationInformation + { + Referrer = "Facebook", + RegistrationId = "myExternalRegistrationId", + }, PreferredTimezone = "Pacific Standard Time", PreferredLanguage = "en-us", RegistrationQuestionAnswers = new List @@ -50,20 +54,6 @@ var requestBody = new VirtualEventRegistration }, }, }, - AdditionalData = new Dictionary - { - { - "externalRegistrationInformation" , new UntypedObject(new Dictionary - { - { - "referrer", new UntypedString("Facebook") - }, - { - "registrationId", new UntypedString("myExternalRegistrationId") - }, - }) - }, - }, }; // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp diff --git a/api-reference/v1.0/includes/snippets/csharp/create-virtualeventregistration-delegated-csharp-snippets.md b/api-reference/v1.0/includes/snippets/csharp/create-virtualeventregistration-delegated-csharp-snippets.md index 083dad40061..a90e4c16c8e 100644 --- a/api-reference/v1.0/includes/snippets/csharp/create-virtualeventregistration-delegated-csharp-snippets.md +++ b/api-reference/v1.0/includes/snippets/csharp/create-virtualeventregistration-delegated-csharp-snippets.md @@ -8,10 +8,14 @@ description: "Automatically generated file. DO NOT MODIFY" // Dependencies using Microsoft.Graph.Models; -using Microsoft.Kiota.Abstractions.Serialization; var requestBody = new VirtualEventRegistration { + ExternalRegistrationInformation = new VirtualEventExternalRegistrationInformation + { + Referrer = "Facebook", + RegistrationId = "myExternalRegistrationId", + }, PreferredTimezone = "Pacific Standard Time", PreferredLanguage = "en-us", RegistrationQuestionAnswers = new List @@ -48,20 +52,6 @@ var requestBody = new VirtualEventRegistration }, }, }, - AdditionalData = new Dictionary - { - { - "externalRegistrationInformation" , new UntypedObject(new Dictionary - { - { - "referrer", new UntypedString("Facebook") - }, - { - "registrationId", new UntypedString("myExternalRegistrationId") - }, - }) - }, - }, }; // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp diff --git a/api-reference/v1.0/includes/snippets/csharp/delete-page-csharp-snippets.md b/api-reference/v1.0/includes/snippets/csharp/delete-page-csharp-snippets.md index 43bfc0f1180..679a321ddb8 100644 --- a/api-reference/v1.0/includes/snippets/csharp/delete-page-csharp-snippets.md +++ b/api-reference/v1.0/includes/snippets/csharp/delete-page-csharp-snippets.md @@ -7,7 +7,7 @@ description: "Automatically generated file. DO NOT MODIFY" // Code snippets are only available for the latest version. Current version is 5.x // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp -await graphClient.Sites["{site-id}"].Pages["{baseSitePage-id}"].DeleteAsync(); +await graphClient.Me.Onenote.Pages["{onenotePage-id}"].DeleteAsync(); ``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/csharp/update-gradingcategories-delta-csharp-snippets.md b/api-reference/v1.0/includes/snippets/csharp/update-gradingcategories-delta-csharp-snippets.md index 43cc540e9a5..e8c796de01c 100644 --- a/api-reference/v1.0/includes/snippets/csharp/update-gradingcategories-delta-csharp-snippets.md +++ b/api-reference/v1.0/includes/snippets/csharp/update-gradingcategories-delta-csharp-snippets.md @@ -7,7 +7,7 @@ description: "Automatically generated file. DO NOT MODIFY" // Code snippets are only available for the latest version. Current version is 5.x // Dependencies -using Microsoft.Graph.Beta.Models; +using Microsoft.Graph.Models; using Microsoft.Kiota.Abstractions.Serialization; var requestBody = new EducationAssignmentSettings @@ -20,10 +20,10 @@ var requestBody = new EducationAssignmentSettings new UntypedObject(new Dictionary { { - "id", new UntypedString("fb859cd3-943b-4cd6-9bbe-fe1c39eace0e") + "id", new UntypedString("03bd9196-ce2e-41bd-902f-df9ae02de4db") }, { - "displayName", new UntypedString("Lab Test") + "displayName", new UntypedString("Lab Updated") }, }), new UntypedObject(new Dictionary @@ -32,7 +32,7 @@ var requestBody = new EducationAssignmentSettings "@odata.context", new UntypedString("https://graph.microsoft.com/beta/$metadata#gradingCategories/$deletedEntity") }, { - "id", new UntypedString("e2a86277-24f9-4f29-8196-8c83fc69d00d") + "id", new UntypedString("109e5d73-3ef7-42a5-88d8-7e30cdb85f06") }, { "reason", new UntypedString("deleted") @@ -41,19 +41,10 @@ var requestBody = new EducationAssignmentSettings new UntypedObject(new Dictionary { { - "displayName", new UntypedString("Lab Practice") + "displayName", new UntypedString("New Homework") }, { - "percentageWeight", new UntypedString("30") - }, - }), - new UntypedObject(new Dictionary - { - { - "displayName", new UntypedString("Lab Theory") - }, - { - "percentageWeight", new UntypedString("10") + "percentageWeight", new UntypedString("50") }, }), } diff --git a/api-reference/v1.0/includes/snippets/go/create-retentionlabel-from--go-snippets.md b/api-reference/v1.0/includes/snippets/go/create-retentionlabel-from--go-snippets.md index 516b485e655..cdaf020945b 100644 --- a/api-reference/v1.0/includes/snippets/go/create-retentionlabel-from--go-snippets.md +++ b/api-reference/v1.0/includes/snippets/go/create-retentionlabel-from--go-snippets.md @@ -5,13 +5,13 @@ description: "Automatically generated file. DO NOT MODIFY" ```go -// Code snippets are only available for the latest major version. Current major version is $v0.* +// Code snippets are only available for the latest major version. Current major version is $v1.* // Dependencies import ( "context" - msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go" - graphmodelssecurity "github.com/microsoftgraph/msgraph-beta-sdk-go/models/security" + msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" + graphmodelssecurity "github.com/microsoftgraph/msgraph-sdk-go/models/security" //other-imports ) diff --git a/api-reference/v1.0/includes/snippets/go/create-usersource-and-include-sources-go-snippets.md b/api-reference/v1.0/includes/snippets/go/create-usersource-and-include-sources-go-snippets.md index 805975beaff..53dda844187 100644 --- a/api-reference/v1.0/includes/snippets/go/create-usersource-and-include-sources-go-snippets.md +++ b/api-reference/v1.0/includes/snippets/go/create-usersource-and-include-sources-go-snippets.md @@ -18,7 +18,7 @@ import ( requestBody := graphmodelssecurity.NewUserSource() email := "admin@contoso.com" requestBody.SetEmail(&email) -includedSources := graphmodels.MAILBOX_SOURCETYPE +includedSources := graphmodels.MAILBOX, SITE_SOURCETYPE requestBody.SetIncludedSources(&includedSources) // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go diff --git a/api-reference/v1.0/includes/snippets/go/create-virtualeventregistration-application-go-snippets.md b/api-reference/v1.0/includes/snippets/go/create-virtualeventregistration-application-go-snippets.md index 03df242581e..393f478ea61 100644 --- a/api-reference/v1.0/includes/snippets/go/create-virtualeventregistration-application-go-snippets.md +++ b/api-reference/v1.0/includes/snippets/go/create-virtualeventregistration-application-go-snippets.md @@ -22,6 +22,12 @@ lastName := "Demoss" requestBody.SetLastName(&lastName) email := "DianeDemoss@contoso.com" requestBody.SetEmail(&email) +externalRegistrationInformation := graphmodels.NewVirtualEventExternalRegistrationInformation() +referrer := "Facebook" +externalRegistrationInformation.SetReferrer(&referrer) +registrationId := "myExternalRegistrationId" +externalRegistrationInformation.SetRegistrationId(®istrationId) +requestBody.SetExternalRegistrationInformation(externalRegistrationInformation) preferredTimezone := "Pacific Standard Time" requestBody.SetPreferredTimezone(&preferredTimezone) preferredLanguage := "en-us" @@ -69,15 +75,6 @@ registrationQuestionAnswers := []graphmodels.VirtualEventRegistrationQuestionAns virtualEventRegistrationQuestionAnswer2, } requestBody.SetRegistrationQuestionAnswers(registrationQuestionAnswers) -additionalData := map[string]interface{}{ -externalRegistrationInformation := graph.New() -referrer := "Facebook" -externalRegistrationInformation.SetReferrer(&referrer) -registrationId := "myExternalRegistrationId" -externalRegistrationInformation.SetRegistrationId(®istrationId) - requestBody.SetExternalRegistrationInformation(externalRegistrationInformation) -} -requestBody.SetAdditionalData(additionalData) // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go registrations, err := graphClient.Solutions().VirtualEvents().Webinars().ByVirtualEventWebinarId("virtualEventWebinar-id").Registrations().Post(context.Background(), requestBody, nil) diff --git a/api-reference/v1.0/includes/snippets/go/create-virtualeventregistration-delegated-go-snippets.md b/api-reference/v1.0/includes/snippets/go/create-virtualeventregistration-delegated-go-snippets.md index 1a247db67db..5228456b43e 100644 --- a/api-reference/v1.0/includes/snippets/go/create-virtualeventregistration-delegated-go-snippets.md +++ b/api-reference/v1.0/includes/snippets/go/create-virtualeventregistration-delegated-go-snippets.md @@ -16,6 +16,12 @@ import ( ) requestBody := graphmodels.NewVirtualEventRegistration() +externalRegistrationInformation := graphmodels.NewVirtualEventExternalRegistrationInformation() +referrer := "Facebook" +externalRegistrationInformation.SetReferrer(&referrer) +registrationId := "myExternalRegistrationId" +externalRegistrationInformation.SetRegistrationId(®istrationId) +requestBody.SetExternalRegistrationInformation(externalRegistrationInformation) preferredTimezone := "Pacific Standard Time" requestBody.SetPreferredTimezone(&preferredTimezone) preferredLanguage := "en-us" @@ -64,15 +70,6 @@ registrationQuestionAnswers := []graphmodels.VirtualEventRegistrationQuestionAns virtualEventRegistrationQuestionAnswer2, } requestBody.SetRegistrationQuestionAnswers(registrationQuestionAnswers) -additionalData := map[string]interface{}{ -externalRegistrationInformation := graph.New() -referrer := "Facebook" -externalRegistrationInformation.SetReferrer(&referrer) -registrationId := "myExternalRegistrationId" -externalRegistrationInformation.SetRegistrationId(®istrationId) - requestBody.SetExternalRegistrationInformation(externalRegistrationInformation) -} -requestBody.SetAdditionalData(additionalData) // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go registrations, err := graphClient.Solutions().VirtualEvents().Webinars().ByVirtualEventWebinarId("virtualEventWebinar-id").Registrations().Post(context.Background(), requestBody, nil) diff --git a/api-reference/v1.0/includes/snippets/go/delete-page-go-snippets.md b/api-reference/v1.0/includes/snippets/go/delete-page-go-snippets.md index 755f0f8481f..e8f9fc3017f 100644 --- a/api-reference/v1.0/includes/snippets/go/delete-page-go-snippets.md +++ b/api-reference/v1.0/includes/snippets/go/delete-page-go-snippets.md @@ -16,7 +16,7 @@ import ( // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go -graphClient.Sites().BySiteId("site-id").Pages().ByBaseSitePageId("baseSitePage-id").Delete(context.Background(), nil) +graphClient.Me().Onenote().Pages().ByOnenotePageId("onenotePage-id").Delete(context.Background(), nil) ``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/java/create-retentionlabel-from--java-snippets.md b/api-reference/v1.0/includes/snippets/java/create-retentionlabel-from--java-snippets.md index ee37e5fcd79..0881272afa8 100644 --- a/api-reference/v1.0/includes/snippets/java/create-retentionlabel-from--java-snippets.md +++ b/api-reference/v1.0/includes/snippets/java/create-retentionlabel-from--java-snippets.md @@ -8,18 +8,18 @@ description: "Automatically generated file. DO NOT MODIFY" GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); -com.microsoft.graph.beta.models.security.RetentionLabel retentionLabel = new com.microsoft.graph.beta.models.security.RetentionLabel(); +com.microsoft.graph.models.security.RetentionLabel retentionLabel = new com.microsoft.graph.models.security.RetentionLabel(); retentionLabel.setOdataType("#microsoft.graph.security.retentionLabel"); retentionLabel.setDisplayName("Retention Schedule 10005"); -retentionLabel.setBehaviorDuringRetentionPeriod(com.microsoft.graph.beta.models.security.BehaviorDuringRetentionPeriod.Retain); -retentionLabel.setActionAfterRetentionPeriod(com.microsoft.graph.beta.models.security.ActionAfterRetentionPeriod.StartDispositionReview); -retentionLabel.setRetentionTrigger(com.microsoft.graph.beta.models.security.RetentionTrigger.DateOfEvent); -com.microsoft.graph.beta.models.security.RetentionDurationInDays retentionDuration = new com.microsoft.graph.beta.models.security.RetentionDurationInDays(); +retentionLabel.setBehaviorDuringRetentionPeriod(com.microsoft.graph.models.security.BehaviorDuringRetentionPeriod.Retain); +retentionLabel.setActionAfterRetentionPeriod(com.microsoft.graph.models.security.ActionAfterRetentionPeriod.StartDispositionReview); +retentionLabel.setRetentionTrigger(com.microsoft.graph.models.security.RetentionTrigger.DateOfEvent); +com.microsoft.graph.models.security.RetentionDurationInDays retentionDuration = new com.microsoft.graph.models.security.RetentionDurationInDays(); retentionDuration.setOdataType("microsoft.graph.security.retentionDurationInDays"); retentionDuration.setDays(2555); retentionLabel.setRetentionDuration(retentionDuration); -LinkedList dispositionReviewStages = new LinkedList(); -com.microsoft.graph.beta.models.security.DispositionReviewStage dispositionReviewStage = new com.microsoft.graph.beta.models.security.DispositionReviewStage(); +LinkedList dispositionReviewStages = new LinkedList(); +com.microsoft.graph.models.security.DispositionReviewStage dispositionReviewStage = new com.microsoft.graph.models.security.DispositionReviewStage(); dispositionReviewStage.setStageNumber(1); dispositionReviewStage.setName("Stage1"); HashMap additionalData = new HashMap(); @@ -31,7 +31,7 @@ dispositionReviewStages.add(dispositionReviewStage); retentionLabel.setDispositionReviewStages(dispositionReviewStages); retentionLabel.setDescriptionForAdmins("retain for 7 years"); retentionLabel.setDescriptionForUsers("retain for 7 years"); -com.microsoft.graph.beta.models.security.FilePlanDescriptor descriptors = new com.microsoft.graph.beta.models.security.FilePlanDescriptor(); +com.microsoft.graph.models.security.FilePlanDescriptor descriptors = new com.microsoft.graph.models.security.FilePlanDescriptor(); HashMap additionalData1 = new HashMap(); additionalData1.put("authorityTemplate@odata.bind", "https://graph.microsoft.com/beta/security/labels/authorities('fie3f4fc-b966-4c40-94de-fb8a383658e4')"); additionalData1.put("categoryTemplate@odata.bind", "https://graph.microsoft.com/beta/security/labels/categories('0bjk8-b966-4c40-94de-fb8a383658e4')"); @@ -40,7 +40,7 @@ additionalData1.put("departmentTemplate@odata.bind", "https://graph.microsoft.co additionalData1.put("filePlanReferenceTemplate@odata.bind", "https://graph.microsoft.com/beta/security/labels/filePlanReferences('e095f4fc-b966-4c40-94de-fb8a383658e4')"); descriptors.setAdditionalData(additionalData1); retentionLabel.setDescriptors(descriptors); -retentionLabel.setDefaultRecordBehavior(com.microsoft.graph.beta.models.security.DefaultRecordBehavior.StartLocked); +retentionLabel.setDefaultRecordBehavior(com.microsoft.graph.models.security.DefaultRecordBehavior.StartLocked); HashMap additionalData2 = new HashMap(); additionalData2.put("retentionEventType@odata.bind", "https://graph.microsoft.com/beta/security/triggerTypes/retentionEventTypes('e095f4fc-b966-4c40-94de-fb8a383658e4')"); retentionLabel.setAdditionalData(additionalData2); diff --git a/api-reference/v1.0/includes/snippets/java/create-usersource-and-include-sources-java-snippets.md b/api-reference/v1.0/includes/snippets/java/create-usersource-and-include-sources-java-snippets.md index 2014e299f4c..426fad7b7d2 100644 --- a/api-reference/v1.0/includes/snippets/java/create-usersource-and-include-sources-java-snippets.md +++ b/api-reference/v1.0/includes/snippets/java/create-usersource-and-include-sources-java-snippets.md @@ -10,7 +10,7 @@ GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); com.microsoft.graph.beta.models.security.UserSource userSource = new com.microsoft.graph.beta.models.security.UserSource(); userSource.setEmail("admin@contoso.com"); -userSource.setIncludedSources(EnumSet.of(com.microsoft.graph.beta.models.security.SourceType.Mailbox)); +userSource.setIncludedSources(EnumSet.of(com.microsoft.graph.beta.models.security.SourceType.Mailbox, com.microsoft.graph.beta.models.security.SourceType.Site)); com.microsoft.graph.models.security.UserSource result = graphClient.security().cases().ediscoveryCases().byEdiscoveryCaseId("{ediscoveryCase-id}").legalHolds().byEdiscoveryHoldPolicyId("{ediscoveryHoldPolicy-id}").userSources().post(userSource); diff --git a/api-reference/v1.0/includes/snippets/java/create-virtualeventregistration-application-java-snippets.md b/api-reference/v1.0/includes/snippets/java/create-virtualeventregistration-application-java-snippets.md index 888c9e79a9d..7ebfa8a2676 100644 --- a/api-reference/v1.0/includes/snippets/java/create-virtualeventregistration-application-java-snippets.md +++ b/api-reference/v1.0/includes/snippets/java/create-virtualeventregistration-application-java-snippets.md @@ -12,6 +12,10 @@ VirtualEventRegistration virtualEventRegistration = new VirtualEventRegistration virtualEventRegistration.setFirstName("Diane"); virtualEventRegistration.setLastName("Demoss"); virtualEventRegistration.setEmail("DianeDemoss@contoso.com"); +VirtualEventExternalRegistrationInformation externalRegistrationInformation = new VirtualEventExternalRegistrationInformation(); +externalRegistrationInformation.setReferrer("Facebook"); +externalRegistrationInformation.setRegistrationId("myExternalRegistrationId"); +virtualEventRegistration.setExternalRegistrationInformation(externalRegistrationInformation); virtualEventRegistration.setPreferredTimezone("Pacific Standard Time"); virtualEventRegistration.setPreferredLanguage("en-us"); LinkedList registrationQuestionAnswers = new LinkedList(); @@ -40,12 +44,6 @@ multiChoiceValues2.add("New York City"); virtualEventRegistrationQuestionAnswer2.setMultiChoiceValues(multiChoiceValues2); registrationQuestionAnswers.add(virtualEventRegistrationQuestionAnswer2); virtualEventRegistration.setRegistrationQuestionAnswers(registrationQuestionAnswers); -HashMap additionalData = new HashMap(); - externalRegistrationInformation = new (); -externalRegistrationInformation.setReferrer("Facebook"); -externalRegistrationInformation.setRegistrationId("myExternalRegistrationId"); -additionalData.put("externalRegistrationInformation", externalRegistrationInformation); -virtualEventRegistration.setAdditionalData(additionalData); VirtualEventRegistration result = graphClient.solutions().virtualEvents().webinars().byVirtualEventWebinarId("{virtualEventWebinar-id}").registrations().post(virtualEventRegistration); diff --git a/api-reference/v1.0/includes/snippets/java/create-virtualeventregistration-delegated-java-snippets.md b/api-reference/v1.0/includes/snippets/java/create-virtualeventregistration-delegated-java-snippets.md index d74d2177865..a791f6f3415 100644 --- a/api-reference/v1.0/includes/snippets/java/create-virtualeventregistration-delegated-java-snippets.md +++ b/api-reference/v1.0/includes/snippets/java/create-virtualeventregistration-delegated-java-snippets.md @@ -9,6 +9,10 @@ description: "Automatically generated file. DO NOT MODIFY" GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); VirtualEventRegistration virtualEventRegistration = new VirtualEventRegistration(); +VirtualEventExternalRegistrationInformation externalRegistrationInformation = new VirtualEventExternalRegistrationInformation(); +externalRegistrationInformation.setReferrer("Facebook"); +externalRegistrationInformation.setRegistrationId("myExternalRegistrationId"); +virtualEventRegistration.setExternalRegistrationInformation(externalRegistrationInformation); virtualEventRegistration.setPreferredTimezone("Pacific Standard Time"); virtualEventRegistration.setPreferredLanguage("en-us"); LinkedList registrationQuestionAnswers = new LinkedList(); @@ -38,12 +42,6 @@ multiChoiceValues2.add("Beijing"); virtualEventRegistrationQuestionAnswer2.setMultiChoiceValues(multiChoiceValues2); registrationQuestionAnswers.add(virtualEventRegistrationQuestionAnswer2); virtualEventRegistration.setRegistrationQuestionAnswers(registrationQuestionAnswers); -HashMap additionalData = new HashMap(); - externalRegistrationInformation = new (); -externalRegistrationInformation.setReferrer("Facebook"); -externalRegistrationInformation.setRegistrationId("myExternalRegistrationId"); -additionalData.put("externalRegistrationInformation", externalRegistrationInformation); -virtualEventRegistration.setAdditionalData(additionalData); VirtualEventRegistration result = graphClient.solutions().virtualEvents().webinars().byVirtualEventWebinarId("{virtualEventWebinar-id}").registrations().post(virtualEventRegistration); diff --git a/api-reference/v1.0/includes/snippets/java/delete-page-java-snippets.md b/api-reference/v1.0/includes/snippets/java/delete-page-java-snippets.md index a99fef59f27..76ce420f490 100644 --- a/api-reference/v1.0/includes/snippets/java/delete-page-java-snippets.md +++ b/api-reference/v1.0/includes/snippets/java/delete-page-java-snippets.md @@ -8,7 +8,7 @@ description: "Automatically generated file. DO NOT MODIFY" GraphServiceClient graphClient = new GraphServiceClient(requestAdapter); -graphClient.sites().bySiteId("{site-id}").pages().byBaseSitePageId("{baseSitePage-id}").delete(); +graphClient.me().onenote().pages().byOnenotePageId("{onenotePage-id}").delete(); ``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/java/update-gradingcategories-delta-java-snippets.md b/api-reference/v1.0/includes/snippets/java/update-gradingcategories-delta-java-snippets.md index fd4fab99bc9..2428cb3f557 100644 --- a/api-reference/v1.0/includes/snippets/java/update-gradingcategories-delta-java-snippets.md +++ b/api-reference/v1.0/includes/snippets/java/update-gradingcategories-delta-java-snippets.md @@ -12,22 +12,18 @@ EducationAssignmentSettings educationAssignmentSettings = new EducationAssignmen HashMap additionalData = new HashMap(); LinkedList gradingCategoriesDelta = new LinkedList(); property = new (); -property.setId("fb859cd3-943b-4cd6-9bbe-fe1c39eace0e"); -property.setDisplayName("Lab Test"); +property.setId("03bd9196-ce2e-41bd-902f-df9ae02de4db"); +property.setDisplayName("Lab Updated"); gradingCategoriesDelta.add(property); property1 = new (); property1.setOdataContext("https://graph.microsoft.com/beta/$metadata#gradingCategories/$deletedEntity"); -property1.setId("e2a86277-24f9-4f29-8196-8c83fc69d00d"); +property1.setId("109e5d73-3ef7-42a5-88d8-7e30cdb85f06"); property1.setReason("deleted"); gradingCategoriesDelta.add(property1); property2 = new (); -property2.setDisplayName("Lab Practice"); -property2.setPercentageWeight(30); +property2.setDisplayName("New Homework"); +property2.setPercentageWeight(50); gradingCategoriesDelta.add(property2); - property3 = new (); -property3.setDisplayName("Lab Theory"); -property3.setPercentageWeight(10); -gradingCategoriesDelta.add(property3); additionalData.put("gradingCategories@delta", gradingCategoriesDelta); educationAssignmentSettings.setAdditionalData(additionalData); EducationAssignmentSettings result = graphClient.education().classes().byEducationClassId("{educationClass-id}").assignmentSettings().patch(educationAssignmentSettings); diff --git a/api-reference/v1.0/includes/snippets/javascript/create-ediscoveryholdpolicy-from--javascript-snippets.md b/api-reference/v1.0/includes/snippets/javascript/create-ediscoveryholdpolicy-from--javascript-snippets.md index 222307f3bf0..0d0f4f0ac94 100644 --- a/api-reference/v1.0/includes/snippets/javascript/create-ediscoveryholdpolicy-from--javascript-snippets.md +++ b/api-reference/v1.0/includes/snippets/javascript/create-ediscoveryholdpolicy-from--javascript-snippets.md @@ -13,7 +13,7 @@ const client = Client.init(options); const ediscoveryHoldPolicy = { displayName: 'My legalHold with sources', description: 'Created from Graph API', - contentQuery: 'KQL content query', + contentQuery: 'KQL content query' }; await client.api('/security/cases/ediscoveryCases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/legalHolds') diff --git a/api-reference/v1.0/includes/snippets/javascript/create-retentionlabel-from--javascript-snippets.md b/api-reference/v1.0/includes/snippets/javascript/create-retentionlabel-from--javascript-snippets.md index 4125e38d366..9a498f8ec7d 100644 --- a/api-reference/v1.0/includes/snippets/javascript/create-retentionlabel-from--javascript-snippets.md +++ b/api-reference/v1.0/includes/snippets/javascript/create-retentionlabel-from--javascript-snippets.md @@ -43,7 +43,6 @@ const retentionLabel = { }; await client.api('/security/labels/retentionLabels') - .version('beta') .post(retentionLabel); ``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/javascript/create-usersource-and-include-sources-javascript-snippets.md b/api-reference/v1.0/includes/snippets/javascript/create-usersource-and-include-sources-javascript-snippets.md index 553b404b459..9bf8b4468b2 100644 --- a/api-reference/v1.0/includes/snippets/javascript/create-usersource-and-include-sources-javascript-snippets.md +++ b/api-reference/v1.0/includes/snippets/javascript/create-usersource-and-include-sources-javascript-snippets.md @@ -12,7 +12,7 @@ const client = Client.init(options); const userSource = { email: 'admin@contoso.com', - includedSources: 'mailbox' + includedSources: 'mailbox, site' }; await client.api('/security/cases/ediscoveryCases/{ediscoveryCaseId}/legalHolds/{ediscoveryHoldPolicyId}/userSources') diff --git a/api-reference/v1.0/includes/snippets/javascript/delete-page-javascript-snippets.md b/api-reference/v1.0/includes/snippets/javascript/delete-page-javascript-snippets.md index a218d38f229..eee966e41ff 100644 --- a/api-reference/v1.0/includes/snippets/javascript/delete-page-javascript-snippets.md +++ b/api-reference/v1.0/includes/snippets/javascript/delete-page-javascript-snippets.md @@ -10,7 +10,7 @@ const options = { const client = Client.init(options); -await client.api('/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202') +await client.api('/me/onenote/pages/{id}') .delete(); ``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/javascript/post-chatmessage-5-javascript-snippets.md b/api-reference/v1.0/includes/snippets/javascript/post-chatmessage-5-javascript-snippets.md index 5956a348a90..cbda614862d 100644 --- a/api-reference/v1.0/includes/snippets/javascript/post-chatmessage-5-javascript-snippets.md +++ b/api-reference/v1.0/includes/snippets/javascript/post-chatmessage-5-javascript-snippets.md @@ -11,17 +11,17 @@ const options = { const client = Client.init(options); const chatMessage = { - body: { - contentType: 'html', - content: 'Testing with file share link. ' - }, - attachments: [ - { - id: '668f7fa8-8129-4de7-b32b-fe1b442e6ef1', - contentType: 'reference', - contentUrl: 'https://teamsgraph-my.sharepoint.com/:w:/g/personal/test_teamsgraph_onmicrosoft_com/Eah_j2YpgedNsyv-G0QubvEBma6Sd_76UtYkXwoJ-nYVEg?e=0H2Ibm' - } - ] + body: { + contentType: 'html', + content: 'Testing with file share link. ' + }, + attachments: [ + { + id: '668f7fa8-8129-4de7-b32b-fe1b442e6ef1', + contentType: 'reference', + contentUrl: 'https://teamsgraph-my.sharepoint.com/:w:/g/personal/test_teamsgraph_onmicrosoft_com/Eah_j2YpgedNsyv-G0QubvEBma6Sd_76UtYkXwoJ-nYVEg?e=0H2Ibm' + } + ] }; await client.api('/teams/1e769eab-06a8-4b2e-ac42-1f040a4e52a1/channels/19:e28d1f9b354f4de88d2e9e4d8b983763@thread.tacv2/messages') diff --git a/api-reference/v1.0/includes/snippets/javascript/update-gradingcategories-delta-javascript-snippets.md b/api-reference/v1.0/includes/snippets/javascript/update-gradingcategories-delta-javascript-snippets.md index 17c40650b3f..a12c29974a4 100644 --- a/api-reference/v1.0/includes/snippets/javascript/update-gradingcategories-delta-javascript-snippets.md +++ b/api-reference/v1.0/includes/snippets/javascript/update-gradingcategories-delta-javascript-snippets.md @@ -14,29 +14,24 @@ const educationAssignmentSettings = { 'gradingCategories@delta': [ { // Change this grading category\'s name - id: 'fb859cd3-943b-4cd6-9bbe-fe1c39eace0e', - displayName: 'Lab Test' + id: '03bd9196-ce2e-41bd-902f-df9ae02de4db', + displayName: 'Lab Updated' }, { - // Delete this grading category + // Delete this grading category '@odata.context': 'https://graph.microsoft.com/beta/$metadata#gradingCategories/$deletedEntity', - id: 'e2a86277-24f9-4f29-8196-8c83fc69d00d', + id: '109e5d73-3ef7-42a5-88d8-7e30cdb85f06', reason: 'deleted' }, { - // Add a new grading category - displayName: 'Lab Practice', - percentageWeight: 30 - }, - { - displayName: 'Lab Theory', - percentageWeight: 10 + // Add a new grading category + displayName: 'New Homework', + percentageWeight: 50 } ] }; await client.api('/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignmentSettings') - .version('beta') .update(educationAssignmentSettings); ``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/php/create-retentionlabel-from--php-snippets.md b/api-reference/v1.0/includes/snippets/php/create-retentionlabel-from--php-snippets.md index 0b45f8964f1..8fd5f37ee18 100644 --- a/api-reference/v1.0/includes/snippets/php/create-retentionlabel-from--php-snippets.md +++ b/api-reference/v1.0/includes/snippets/php/create-retentionlabel-from--php-snippets.md @@ -5,15 +5,15 @@ description: "Automatically generated file. DO NOT MODIFY" ```php setEmail('admin@contoso.com'); -$requestBody->setIncludedSources(new SourceType('mailbox')); +$requestBody->setIncludedSources(new SourceType('mailbox, site')); $result = $graphServiceClient->security()->cases()->ediscoveryCases()->byEdiscoveryCaseId('ediscoveryCase-id')->legalHolds()->byEdiscoveryHoldPolicyId('ediscoveryHoldPolicy-id')->userSources()->post($requestBody)->wait(); diff --git a/api-reference/v1.0/includes/snippets/php/create-virtualeventregistration-application-php-snippets.md b/api-reference/v1.0/includes/snippets/php/create-virtualeventregistration-application-php-snippets.md index 79fad0544dc..eef9376fce0 100644 --- a/api-reference/v1.0/includes/snippets/php/create-virtualeventregistration-application-php-snippets.md +++ b/api-reference/v1.0/includes/snippets/php/create-virtualeventregistration-application-php-snippets.md @@ -7,6 +7,7 @@ description: "Automatically generated file. DO NOT MODIFY" setFirstName('Diane'); $requestBody->setLastName('Demoss'); $requestBody->setEmail('DianeDemoss@contoso.com'); +$externalRegistrationInformation = new VirtualEventExternalRegistrationInformation(); +$externalRegistrationInformation->setReferrer('Facebook'); +$externalRegistrationInformation->setRegistrationId('myExternalRegistrationId'); +$requestBody->setExternalRegistrationInformation($externalRegistrationInformation); $requestBody->setPreferredTimezone('Pacific Standard Time'); $requestBody->setPreferredLanguage('en-us'); $registrationQuestionAnswersVirtualEventRegistrationQuestionAnswer1 = new VirtualEventRegistrationQuestionAnswer(); @@ -38,13 +43,6 @@ $registrationQuestionAnswersVirtualEventRegistrationQuestionAnswer3->setMultiCho $registrationQuestionAnswersArray []= $registrationQuestionAnswersVirtualEventRegistrationQuestionAnswer3; $requestBody->setRegistrationQuestionAnswers($registrationQuestionAnswersArray); -$additionalData = [ -'externalRegistrationInformation' => [ - 'referrer' => 'Facebook', - 'registrationId' => 'myExternalRegistrationId', -], -]; -$requestBody->setAdditionalData($additionalData); $result = $graphServiceClient->solutions()->virtualEvents()->webinars()->byVirtualEventWebinarId('virtualEventWebinar-id')->registrations()->post($requestBody)->wait(); diff --git a/api-reference/v1.0/includes/snippets/php/create-virtualeventregistration-delegated-php-snippets.md b/api-reference/v1.0/includes/snippets/php/create-virtualeventregistration-delegated-php-snippets.md index 2055c70a468..59d9b077a53 100644 --- a/api-reference/v1.0/includes/snippets/php/create-virtualeventregistration-delegated-php-snippets.md +++ b/api-reference/v1.0/includes/snippets/php/create-virtualeventregistration-delegated-php-snippets.md @@ -7,12 +7,17 @@ description: "Automatically generated file. DO NOT MODIFY" setReferrer('Facebook'); +$externalRegistrationInformation->setRegistrationId('myExternalRegistrationId'); +$requestBody->setExternalRegistrationInformation($externalRegistrationInformation); $requestBody->setPreferredTimezone('Pacific Standard Time'); $requestBody->setPreferredLanguage('en-us'); $registrationQuestionAnswersVirtualEventRegistrationQuestionAnswer1 = new VirtualEventRegistrationQuestionAnswer(); @@ -35,13 +40,6 @@ $registrationQuestionAnswersVirtualEventRegistrationQuestionAnswer3->setMultiCho $registrationQuestionAnswersArray []= $registrationQuestionAnswersVirtualEventRegistrationQuestionAnswer3; $requestBody->setRegistrationQuestionAnswers($registrationQuestionAnswersArray); -$additionalData = [ -'externalRegistrationInformation' => [ - 'referrer' => 'Facebook', - 'registrationId' => 'myExternalRegistrationId', -], -]; -$requestBody->setAdditionalData($additionalData); $result = $graphServiceClient->solutions()->virtualEvents()->webinars()->byVirtualEventWebinarId('virtualEventWebinar-id')->registrations()->post($requestBody)->wait(); diff --git a/api-reference/v1.0/includes/snippets/php/delete-page-php-snippets.md b/api-reference/v1.0/includes/snippets/php/delete-page-php-snippets.md index 39d26821d03..837e923b414 100644 --- a/api-reference/v1.0/includes/snippets/php/delete-page-php-snippets.md +++ b/api-reference/v1.0/includes/snippets/php/delete-page-php-snippets.md @@ -11,6 +11,6 @@ use Microsoft\Graph\GraphServiceClient; $graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes); -$graphServiceClient->sites()->bySiteId('site-id')->pages()->byBaseSitePageId('baseSitePage-id')->delete()->wait(); +$graphServiceClient->me()->onenote()->pages()->byOnenotePageId('onenotePage-id')->delete()->wait(); ``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/php/update-gradingcategories-delta-php-snippets.md b/api-reference/v1.0/includes/snippets/php/update-gradingcategories-delta-php-snippets.md index 2bd9bd2c5f4..cae69b4f23b 100644 --- a/api-reference/v1.0/includes/snippets/php/update-gradingcategories-delta-php-snippets.md +++ b/api-reference/v1.0/includes/snippets/php/update-gradingcategories-delta-php-snippets.md @@ -5,8 +5,8 @@ description: "Automatically generated file. DO NOT MODIFY" ```php [ [ - 'id' => 'fb859cd3-943b-4cd6-9bbe-fe1c39eace0e', - 'displayName' => 'Lab Test', + 'id' => '03bd9196-ce2e-41bd-902f-df9ae02de4db', + 'displayName' => 'Lab Updated', ], [ '@odata.context' => 'https://graph.microsoft.com/beta/$metadata#gradingCategories/$deletedEntity', - 'id' => 'e2a86277-24f9-4f29-8196-8c83fc69d00d', + 'id' => '109e5d73-3ef7-42a5-88d8-7e30cdb85f06', 'reason' => 'deleted', ], [ - 'displayName' => 'Lab Practice', - 'percentageWeight' => 30, - ], - [ - 'displayName' => 'Lab Theory', - 'percentageWeight' => 10, + 'displayName' => 'New Homework', + 'percentageWeight' => 50, ], ], ]; diff --git a/api-reference/v1.0/includes/snippets/powershell/create-usersource-and-include-sources-powershell-snippets.md b/api-reference/v1.0/includes/snippets/powershell/create-usersource-and-include-sources-powershell-snippets.md index b2bf61af083..7512bba1cc5 100644 --- a/api-reference/v1.0/includes/snippets/powershell/create-usersource-and-include-sources-powershell-snippets.md +++ b/api-reference/v1.0/includes/snippets/powershell/create-usersource-and-include-sources-powershell-snippets.md @@ -8,7 +8,7 @@ Import-Module Microsoft.Graph.Beta.Security $params = @{ email = "admin@contoso.com" - includedSources = "mailbox" + includedSources = "mailbox, site" } New-MgBetaSecurityCaseEdiscoveryCaseLegalHoldUserSource -EdiscoveryCaseId $ediscoveryCaseId -EdiscoveryHoldPolicyId $ediscoveryHoldPolicyId -BodyParameter $params diff --git a/api-reference/v1.0/includes/snippets/powershell/delete-page-powershell-snippets.md b/api-reference/v1.0/includes/snippets/powershell/delete-page-powershell-snippets.md index 7297f441861..aa3b8d79baa 100644 --- a/api-reference/v1.0/includes/snippets/powershell/delete-page-powershell-snippets.md +++ b/api-reference/v1.0/includes/snippets/powershell/delete-page-powershell-snippets.md @@ -4,8 +4,9 @@ description: "Automatically generated file. DO NOT MODIFY" ```powershell -Import-Module Microsoft.Graph.Sites +Import-Module Microsoft.Graph.Notes -Remove-MgSitePage -SiteId $siteId -BaseSitePageId $baseSitePageId +# A UPN can also be used as -UserId. +Remove-MgUserOnenotePage -UserId $userId -OnenotePageId $onenotePageId ``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/powershell/update-gradingcategories-delta-powershell-snippets.md b/api-reference/v1.0/includes/snippets/powershell/update-gradingcategories-delta-powershell-snippets.md index a35cae6afca..580258a3c3d 100644 --- a/api-reference/v1.0/includes/snippets/powershell/update-gradingcategories-delta-powershell-snippets.md +++ b/api-reference/v1.0/includes/snippets/powershell/update-gradingcategories-delta-powershell-snippets.md @@ -4,30 +4,26 @@ description: "Automatically generated file. DO NOT MODIFY" ```powershell -Import-Module Microsoft.Graph.Beta.Education +Import-Module Microsoft.Graph.Education $params = @{ "gradingCategories@delta" = @( @{ - id = "fb859cd3-943b-4cd6-9bbe-fe1c39eace0e" - displayName = "Lab Test" + id = "03bd9196-ce2e-41bd-902f-df9ae02de4db" + displayName = "Lab Updated" } @{ "@odata.context" = "https://graph.microsoft.com/beta/$metadata#gradingCategories/$deletedEntity" - id = "e2a86277-24f9-4f29-8196-8c83fc69d00d" + id = "109e5d73-3ef7-42a5-88d8-7e30cdb85f06" reason = "deleted" } @{ - displayName = "Lab Practice" - percentageWeight = - } - @{ - displayName = "Lab Theory" + displayName = "New Homework" percentageWeight = } ) } -Update-MgBetaEducationClassAssignmentSetting -EducationClassId $educationClassId -BodyParameter $params +Update-MgEducationClassAssignmentSetting -EducationClassId $educationClassId -BodyParameter $params ``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/python/create-retentionlabel-from--python-snippets.md b/api-reference/v1.0/includes/snippets/python/create-retentionlabel-from--python-snippets.md index 89ed56aa4ab..d28b398327c 100644 --- a/api-reference/v1.0/includes/snippets/python/create-retentionlabel-from--python-snippets.md +++ b/api-reference/v1.0/includes/snippets/python/create-retentionlabel-from--python-snippets.md @@ -5,15 +5,15 @@ description: "Automatically generated file. DO NOT MODIFY" ```python # Code snippets are only available for the latest version. Current version is 1.x -from msgraph_beta import GraphServiceClient -from msgraph_beta.generated.models.security.retention_label import RetentionLabel -from msgraph_beta.generated.models.behavior_during_retention_period import BehaviorDuringRetentionPeriod -from msgraph_beta.generated.models.action_after_retention_period import ActionAfterRetentionPeriod -from msgraph_beta.generated.models.retention_trigger import RetentionTrigger -from msgraph_beta.generated.models.security.retention_duration_in_days import RetentionDurationInDays -from msgraph_beta.generated.models.security.disposition_review_stage import DispositionReviewStage -from msgraph_beta.generated.models.security.file_plan_descriptor import FilePlanDescriptor -from msgraph_beta.generated.models.default_record_behavior import DefaultRecordBehavior +from msgraph import GraphServiceClient +from msgraph.generated.models.security.retention_label import RetentionLabel +from msgraph.generated.models.behavior_during_retention_period import BehaviorDuringRetentionPeriod +from msgraph.generated.models.action_after_retention_period import ActionAfterRetentionPeriod +from msgraph.generated.models.retention_trigger import RetentionTrigger +from msgraph.generated.models.security.retention_duration_in_days import RetentionDurationInDays +from msgraph.generated.models.security.disposition_review_stage import DispositionReviewStage +from msgraph.generated.models.security.file_plan_descriptor import FilePlanDescriptor +from msgraph.generated.models.default_record_behavior import DefaultRecordBehavior # To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python request_body = RetentionLabel( odata_type = "#microsoft.graph.security.retentionLabel", diff --git a/api-reference/v1.0/includes/snippets/python/create-usersource-and-include-sources-python-snippets.md b/api-reference/v1.0/includes/snippets/python/create-usersource-and-include-sources-python-snippets.md index 74a1a73d34d..065b6294c1c 100644 --- a/api-reference/v1.0/includes/snippets/python/create-usersource-and-include-sources-python-snippets.md +++ b/api-reference/v1.0/includes/snippets/python/create-usersource-and-include-sources-python-snippets.md @@ -11,7 +11,7 @@ from msgraph_beta.generated.models.source_type import SourceType # To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python request_body = UserSource( email = "admin@contoso.com", - included_sources = SourceType.Mailbox, + included_sources = SourceType.Mailbox | SourceType.Site, ) result = await graph_client.security.cases.ediscovery_cases.by_ediscovery_case_id('ediscoveryCase-id').legal_holds.by_ediscovery_hold_policy_id('ediscoveryHoldPolicy-id').user_sources.post(request_body) diff --git a/api-reference/v1.0/includes/snippets/python/create-virtualeventregistration-application-python-snippets.md b/api-reference/v1.0/includes/snippets/python/create-virtualeventregistration-application-python-snippets.md index 796cad7c344..ff3309bd745 100644 --- a/api-reference/v1.0/includes/snippets/python/create-virtualeventregistration-application-python-snippets.md +++ b/api-reference/v1.0/includes/snippets/python/create-virtualeventregistration-application-python-snippets.md @@ -7,12 +7,17 @@ description: "Automatically generated file. DO NOT MODIFY" # Code snippets are only available for the latest version. Current version is 1.x from msgraph import GraphServiceClient from msgraph.generated.models.virtual_event_registration import VirtualEventRegistration +from msgraph.generated.models.virtual_event_external_registration_information import VirtualEventExternalRegistrationInformation from msgraph.generated.models.virtual_event_registration_question_answer import VirtualEventRegistrationQuestionAnswer # To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python request_body = VirtualEventRegistration( first_name = "Diane", last_name = "Demoss", email = "DianeDemoss@contoso.com", + external_registration_information = VirtualEventExternalRegistrationInformation( + referrer = "Facebook", + registration_id = "myExternalRegistrationId", + ), preferred_timezone = "Pacific Standard Time", preferred_language = "en-us", registration_question_answers = [ @@ -41,12 +46,6 @@ request_body = VirtualEventRegistration( ], ), ], - additional_data = { - "external_registration_information" : { - "referrer" : "Facebook", - "registration_id" : "myExternalRegistrationId", - }, - } ) result = await graph_client.solutions.virtual_events.webinars.by_virtual_event_webinar_id('virtualEventWebinar-id').registrations.post(request_body) diff --git a/api-reference/v1.0/includes/snippets/python/create-virtualeventregistration-delegated-python-snippets.md b/api-reference/v1.0/includes/snippets/python/create-virtualeventregistration-delegated-python-snippets.md index 721b98c308e..c6d8ceaf876 100644 --- a/api-reference/v1.0/includes/snippets/python/create-virtualeventregistration-delegated-python-snippets.md +++ b/api-reference/v1.0/includes/snippets/python/create-virtualeventregistration-delegated-python-snippets.md @@ -7,9 +7,14 @@ description: "Automatically generated file. DO NOT MODIFY" # Code snippets are only available for the latest version. Current version is 1.x from msgraph import GraphServiceClient from msgraph.generated.models.virtual_event_registration import VirtualEventRegistration +from msgraph.generated.models.virtual_event_external_registration_information import VirtualEventExternalRegistrationInformation from msgraph.generated.models.virtual_event_registration_question_answer import VirtualEventRegistrationQuestionAnswer # To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python request_body = VirtualEventRegistration( + external_registration_information = VirtualEventExternalRegistrationInformation( + referrer = "Facebook", + registration_id = "myExternalRegistrationId", + ), preferred_timezone = "Pacific Standard Time", preferred_language = "en-us", registration_question_answers = [ @@ -39,12 +44,6 @@ request_body = VirtualEventRegistration( ], ), ], - additional_data = { - "external_registration_information" : { - "referrer" : "Facebook", - "registration_id" : "myExternalRegistrationId", - }, - } ) result = await graph_client.solutions.virtual_events.webinars.by_virtual_event_webinar_id('virtualEventWebinar-id').registrations.post(request_body) diff --git a/api-reference/v1.0/includes/snippets/python/delete-page-python-snippets.md b/api-reference/v1.0/includes/snippets/python/delete-page-python-snippets.md index a46c9ca6ad1..78b88640435 100644 --- a/api-reference/v1.0/includes/snippets/python/delete-page-python-snippets.md +++ b/api-reference/v1.0/includes/snippets/python/delete-page-python-snippets.md @@ -8,7 +8,7 @@ description: "Automatically generated file. DO NOT MODIFY" from msgraph import GraphServiceClient # To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python -await graph_client.sites.by_site_id('site-id').pages.by_base_site_page_id('baseSitePage-id').delete() +await graph_client.me.onenote.pages.by_onenote_page_id('onenotePage-id').delete() ``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/python/update-gradingcategories-delta-python-snippets.md b/api-reference/v1.0/includes/snippets/python/update-gradingcategories-delta-python-snippets.md index b3a0acd3990..050dd74c015 100644 --- a/api-reference/v1.0/includes/snippets/python/update-gradingcategories-delta-python-snippets.md +++ b/api-reference/v1.0/includes/snippets/python/update-gradingcategories-delta-python-snippets.md @@ -5,28 +5,24 @@ description: "Automatically generated file. DO NOT MODIFY" ```python # Code snippets are only available for the latest version. Current version is 1.x -from msgraph_beta import GraphServiceClient -from msgraph_beta.generated.models.education_assignment_settings import EducationAssignmentSettings +from msgraph import GraphServiceClient +from msgraph.generated.models.education_assignment_settings import EducationAssignmentSettings # To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python request_body = EducationAssignmentSettings( additional_data = { "grading_categories@delta" : [ { - "id" : "fb859cd3-943b-4cd6-9bbe-fe1c39eace0e", - "display_name" : "Lab Test", + "id" : "03bd9196-ce2e-41bd-902f-df9ae02de4db", + "display_name" : "Lab Updated", }, { "@odata_context" : "https://graph.microsoft.com/beta/$metadata#gradingCategories/$deletedEntity", - "id" : "e2a86277-24f9-4f29-8196-8c83fc69d00d", + "id" : "109e5d73-3ef7-42a5-88d8-7e30cdb85f06", "reason" : "deleted", }, { - "display_name" : "Lab Practice", - "percentage_weight" : 30, - }, - { - "display_name" : "Lab Theory", - "percentage_weight" : 10, + "display_name" : "New Homework", + "percentage_weight" : 50, }, ], } diff --git a/api-reference/v1.0/resources/calendar-overview.md b/api-reference/v1.0/resources/calendar-overview.md new file mode 100644 index 00000000000..c3cfa633f94 --- /dev/null +++ b/api-reference/v1.0/resources/calendar-overview.md @@ -0,0 +1,94 @@ +--- +title: "Working with calendars and events using the Microsoft Graph API" +description: "Learn how to manage calendars and events with the Calendar API in Microsoft Graph." +ms.localizationpriority: high +author: "mnorman-ms" +doc_type: conceptualPageType +ms.subservice: "outlook" +ms.date: 01/06/2025 +--- + +# Working with calendars and events using the Microsoft Graph API + +The Microsoft Graph Calendar API provides [calendar](./calendar.md), [calendarGroup](./calendargroup.md), [event](./event.md), and other resources that enable you to create events and meetings, find workable meeting times, manage attendees, and more. With the Calendar API, you can build a variety of experiences with calendar data. + +## Manage events and meetings +The [event](./event.md) type represents a scheduled occurrence on a calendar, such as a meeting, holiday, or time block. Meetings, such as team meetings or one-on-ones, are all represented by **event** resources. You can directly manage the event lifecycle by creating, canceling, and deleting events directly, among other actions. Also, you can create draft event messages, send them, forward them, and create draft replies, and more. By working with event messages, you enable the user to take an active role in creating events and meetings. You also enable them to communicate to meeting originators, other recipients, and attendees. + +### Working directly with events +The Microsoft Graph API provides methods for operations such as creating, updating, deleting, and canceling events. The following table lists some common lifecycle event use cases and the APIs that Microsoft Graph provides for working with them. + +| Use case | Verb | Example URL | +|:---------|:-----|:----| +| [Create an event.](../api/user-post-events.md) | POST | /users/{id \| userPrincipalName}/events | +| [Delete an event from a calendar.](../api/event-delete.md)| DELETE | /users/{id \| userPrincipalName}/events/{id} | +| [Cancel an event and send a cancellation message.](../api/event-cancel.md)
**Note**: Specify the optional cancellation message in the request body. | POST | /users/{id \| userPrincipalName}/events/{id}/cancel | +| [Update an event.](../api/event-update.md)
**Note**: Specify the event details to update in the [request body](../api/event-update.md#request-body). | PATCH | /users/{id \| userPrincipalName}/events/{id} | +| [Accept an event.](../api/event-accept.md) | POST | /users/{id \| userPrincipalName}/events/{id}/accept | +| [Tentatively accept an event.](../api/event-tentativelyaccept.md) | POST | /users/{id \| userPrincipalName}/events/{id}/tentativelyAccept | +| [Decline an event.](../api/event-decline.md) | POST | /users/{id \| userPrincipalName}/events/{id}/decline | +| [Dismiss an event reminder.](../api/event-dismissreminder.md) | POST | /users/{id \| userPrincipalName}/events/{id}/dismissReminder | +| [Snooze an event reminder.](../api/event-snoozereminder.md) | POST | /users/{id \| userPrincipalName}/events/{id}/snoozeReminder | + +### Working with event messages +The [eventMessage](./eventmessage.md) resource is an abstract type that represents meeting requests, cancellations, and responses. Responses are generated when the message recipient accepts, tentatively accepts, or declines the request. Handling [eventMessageRequest](./eventmessagerequest.md) and [eventMessageResponse](./eventmessageresponse.md) moves the event through its lifecycle. The messaging APIs in the Calendar API support both MIME and JSON content. + +The following table lists some common event message use cases and the APIs for working with them. + +| Use case | Verb | Example URL | +|:---------|:-----|:----| +| [Send an existing draft message.](../api/message-send.md) | POST | /users/{id \| userPrincipalName}/messages/{id}/send | +| [Create a draft reply.](../api/message-createreply.md) | POST| /users/{id \| userPrincipalName}/messages/{id}/createReply | +| [Reply to an event message.](../api/message-reply.md) | POST | /users/{id \| userPrincipalName}/messages/{id}/reply | +| [Create a draft reply-all message.](../api/message-createreplyall.md) | POST | /users/{id \| userPrincipalName}/messages/{id}/createReplyAll | +| [Reply to all in an event message.](../api/message-replyall.md) | POST | /users/{id \| userPrincipalName}/messages/{id}/replyAll | +| [Create a draft forward.](../api/message-createforward.md) | POST | /users/{id \| userPrincipalName}/messages/{id}/createForward | +| [Forward an event message.](../api/message-forward.md) | POST | /users/{id \| userPrincipalName}/messages/{id}/forward | + +## Adding and removing attachments +The abstract [attachment](./attachment.md) type serves as a base for files, items, and references that are attached to events, messages, and posts. You can view the attachments for an event, for example, with the [List attachments](../api/event-list-attachments.md) method. You can delete an attachment with the [Delete attachment](../api/attachment-delete.md) method. Events in group calendars don't support attachments. + +### Attachment types +The [fileAttachment](./fileattachment.md), [itemAttachment](./itemattachment.md), and [referenceAttatchment](./referenceattachment.md) types represent the three kinds of items that can be attached to calendar items. An **itemAttachment** object represents a contact, event, or message that is directly attached to a user event, message, or post. A **fileAttachment** represents a file that is directly attached. A **referenceAttachment** represents an item, such as a Word document or text file, that is located on a OneDrive for work or school cloud drive or other supported storage location. To see all of the attachments for an [event](./event.md), for example, you can use the [GET /users/{id \| userPrincipalName}/events/{id}/attachments](../api/event-list-attachments.md) endpoint. + +### Uploading attachments +You can directly upload attachments less than 3 MB in size to an event for a user with the [Add attachment](../api/event-post-attachments.md) method. For an attachment that is larger than 3 MB, however, you must use the [attachment: createUploadSession](../api/attachment-createuploadsession.md) method to get an upload URL that you use to iteratively upload the attachment. + +## Work with calendars, calendar groups, and Outlook categories +With the Calendar API, you can create, read, update, and delete calendars, create and view calendar events, get free/busy information for users, and find suggested meeting times. + +The Calendar API provides methods to operate on calendars and calendar groups. The following table shows some use cases with selected URLs. + +> **Note**: Many of the methods shown in the following table have other URLs for related use cases. For example, to update a user's calendar in a specific calendar group, send a PATCH operation with the URL `/users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}`. + +| Use case | Verb | Example URL | +|:---------|:-----|:----| +| [List calendars for a user.](../api/user-list-calendars.md) | GET | /users/{id \| userPrincipalName}/calendars | +| [List a user's calendars in a group.](../api/user-list-calendars.md) | GET | /users/{id \| userPrincipalName}/calendarGroups/{calendarGroupId}/calendars | +| [Create a calendar.](../api/user-post-calendars.md) | POST | /users/{id \| userPrincipalName}/calendars | +| [Get a calendar.](../api/calendar-get.md) | GET | /users/{id \| userPrincipalName}/calendars/{id} | +| [Update a calendar.](../api/calendar-update.md) | PATCH | /users/{id \| userPrincipalName}/calendars/{id} | +| [Delete a calendar.](../api/calendar-delete.md) | DELETE | /users/{id \| userPrincipalName}/calendars/{id} | +| [Create a calendar group.](../api/user-post-calendargroups.md) | POST | /users/{id \| userPrincipalName}/calendarGroups | +| [Get a calendar group.](../api/calendargroup-get.md) | GET | /users/{id \| userPrincipalName}/calendarGroups/{id} | +| [Update a calendar group.](../api/calendargroup-update.md) | PATCH | /users/{id \| userPrincipalName}/calendarGroups/{id} | +| [Delete a calendar group.](../api/calendargroup-delete.md) | DELETE | /users/{id \| userPrincipalName}/calendarGroups/{id} | + +### Free/busy data and meeting times +Two of the core functions of calendaring are to find free/busy information and find meeting times in order to schedule meetings. The Calendar API provides the [Get free/busy schedule](../api/calendar-getschedule.md) method that returns a collection of [scheduleInformation](./scheduleinformation.md) objects for a time period and a collection of users, resources, or distribution lists. You can present this information to the user so that they can manually pick an appropriate time at which to schedule a meeting. Use the [user: findMeetingTimes](../api/user-findmeetingtimes.md) method to get a [meetingTimeSuggestionResult](./meetingtimesuggestionsresult.md) that contains a collection of [meetingTimeSuggestion](./meetingtimesuggestion.md) objects that represent detailed information about proposed meeting times for the participants and constraints that you sent. + +### Outlook categories +A calendar category is a combination of a description and a **categoryColor** that together define a category for an Outlook item and control how Outlook displays the item. Outlook users can group messages and events, for example, by category. For more information, see [outlookCategory](./outlookcategory.md). + +### Calendar permissions +When users share calendars with other users from within Outlook clients, they can control the calendar items that the recipients can view or edit. The [calendarPermissions](../resources/calendar.md#relationships) relationship contains permissions for every user with whom a user shared their calendar. This relationship allows you to, for example, see which users can view free/busy information for the owner, view all calendar information, or edit events on the calendar. + +## Work with open extensions and extended properties +[Open extensions](./opentypeextension.md), formerly known as Office 365 data extensions, represent the preferred way to store and access custom data for resources in a user's mailbox. If an Outlook MAPI property isn't available in the Microsoft Graph API metadata, then you can fall back to Outlook extended properties. For more information, see [Outlook extended properties overview](./extended-properties-overview.md). + +## Next steps + +The Calendar API in Microsoft Graph allows you to build a range of experiences with calendar data. To learn more: + +- Drill down on the methods and properties of the resources most helpful to your scenario. +- Try the API in the [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer). diff --git a/api-reference/v1.0/resources/onlinemeeting.md b/api-reference/v1.0/resources/onlinemeeting.md index 73e925efcf2..c1d7eef828c 100644 --- a/api-reference/v1.0/resources/onlinemeeting.md +++ b/api-reference/v1.0/resources/onlinemeeting.md @@ -39,35 +39,41 @@ Contains information about a meeting, including the URL used to join a meeting, | Property | Type | Description | | :-------------------- | :-------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------- | -| allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values) | Specifies who can be a presenter in a meeting. Possible values are listed in the following table. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowParticipantsToChangeName | Boolean | Specifies if participants are allowed to rename themselves in an instance of the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowBreakoutRooms | Boolean | Indicates whether breakout rooms are enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowedLobbyAdmitters | [allowedLobbyAdmitterRoles](../resources/onlinemeetingbase.md#allowedlobbyadmitterroles-values) | Specifies the users who can admit from the lobby. Possible values are: `organizerAndCoOrganizersAndPresenters`, `organizerAndCoOrganizers`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values) | Specifies who can be a presenter in a meeting. Possible values are listed in the following table. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowLiveShare | [meetingLiveShareOptions](../resources/onlinemeetingbase.md#meetingliveshareoptions-values) | Indicates whether live share is enabled for the meeting. Possible values are: `enabled`, `disabled`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowParticipantsToChangeName | Boolean | Specifies if participants are allowed to rename themselves in an instance of the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowPowerPointSharing | Boolean | Indicates whether PowerPoint live is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | allowRecording | Boolean | Indicates whether recording is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | allowTranscription | Boolean | Indicates whether transcription is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | -| audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for an online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| chatInfo | [chatInfo](chatinfo.md) | The chat information associated with this online meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| allowWhiteboard | Boolean | Indicates whether whiteboard is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for an online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| chatInfo | [chatInfo](chatinfo.md) | The chat information associated with this online meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | chatRestrictions | [chatrestrictions](../resources/chatrestrictions.md) | Specifies the configuration settings for meeting chat restrictions. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | creationDateTime | DateTime | The meeting creation time in UTC. Read-only. | | endDateTime | DateTime | The meeting end time in UTC. Required when you create an online meeting. | joinWebUrl | String | The join URL of the online meeting. The format of the URL may change; therefore, users shouldn't rely on any information extracted from parsing the URL. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | participants | [meetingParticipants](meetingparticipants.md) | The participants associated with the online meeting, including the organizer and the attendees. | | subject | String | The subject of the online meeting. Required when you create an online meeting. | -| id | String | The default ID associated with the online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| isEntryExitAnnounced | Boolean | Indicates whether to announce when callers join or leave. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in the `Accept-Language` request HTTP header. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Once an **onlineMeeting** is created, the **joinMeetingIdSettings** can't be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| lobbyBypassSettings | [lobbyBypassSettings](lobbybypasssettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| id | String | The default ID associated with the online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| isEntryExitAnnounced | Boolean | Indicates whether to announce when callers join or leave. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in the `Accept-Language` request HTTP header. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Once an **onlineMeeting** is created, the **joinMeetingIdSettings** can't be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| lobbyBypassSettings | [lobbyBypassSettings](lobbybypasssettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | meetingTemplateId | String | The ID of the [meeting template](/microsoftteams/create-custom-meeting-template). | -| recordAutomatically | Boolean | Indicates whether to record the meeting automatically. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) | Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| recordAutomatically | Boolean | Indicates whether to record the meeting automatically. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) | Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | startDateTime | DateTime | The meeting start time in UTC. | -| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark a content type. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | attendeeReport (deprecated) | Stream | The content stream of the attendee report of a [Microsoft Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. | -| broadcastSettings (deprecated) | [broadcastMeetingSettings](broadcastMeetingSettings.md) | Settings related to a live event. | +| broadcastSettings (deprecated) | [broadcastMeetingSettings](broadcastmeetingsettings.md) | Settings related to a live event. | | isBroadcast (deprecated) | Boolean | Indicates whether this meeting is a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). | ### onlineMeetingPresenters values @@ -105,7 +111,7 @@ Contains information about a meeting, including the URL used to join a meeting, | Relationship | Type | Description | | ------------ | ---- | ----------- | -| attendanceReports | [meetingAttendanceReport](meetingattendancereport.md) collection | The attendance reports of an online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| attendanceReports | [meetingAttendanceReport](meetingattendancereport.md) collection | The attendance reports of an online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | recordings | [callRecording](callrecording.md) collection | The recordings of an online meeting. Read-only. | | transcripts | [callTranscript](calltranscript.md) collection | The transcripts of an online meeting. Read-only. | @@ -125,15 +131,28 @@ The following JSON representation shows the resource type. { "allowAttendeeToEnableCamera": "Boolean", "allowAttendeeToEnableMic": "Boolean", + "allowBreakoutRooms": "Boolean", "allowMeetingChat": {"@odata.type": "microsoft.graph.meetingChatMode"}, "allowTeamworkReactions": "Boolean", + "allowedLobbyAdmitters": "String", "allowedPresenters": "String", + "allowLiveShare": "String", + "allowMeetingChat": "String", + "allowParticipantsToChangeName": "Boolean", + "allowPowerPointSharing": "Boolean", + "allowRecording": "Boolean", + "allowTeamworkReactions": "Boolean", + "allowTranscription": "Boolean", + "allowWhiteboard": "Boolean", + "attendeeReport": "Stream", "audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"}, + "broadcastSettings": {"@odata.type": "microsoft.graph.broadcastMeetingSettings"}, "chatInfo": {"@odata.type": "microsoft.graph.chatInfo"}, - "chatRestrictions":{"@odata.type": "microsoft.graph.chatRestrictions"}, + "chatRestrictions": {"@odata.type": "microsoft.graph.chatRestrictions"}, "creationDateTime": "String (timestamp)", "endDateTime": "String (timestamp)", "id": "String (identifier)", + "isBroadcast": "Boolean", "isEntryExitAnnounced": "Boolean", "joinInformation": {"@odata.type": "microsoft.graph.itemBody"}, "joinMeetingIdSettings": {"@odata.type": "microsoft.graph.joinMeetingIdSettings"}, @@ -142,8 +161,10 @@ The following JSON representation shows the resource type. "meetingTemplateId": "String", "participants": {"@odata.type": "microsoft.graph.meetingParticipants"}, "recordAutomatically": "Boolean", + "shareMeetingChatHistoryDefault": "String", "startDateTime": "String (timestamp)", "subject": "String", "videoTeleconferenceId": "String", + "watermarkProtection": "String" } ``` diff --git a/api-reference/v1.0/resources/onlinemeetingbase.md b/api-reference/v1.0/resources/onlinemeetingbase.md index ca188b9676c..9b0e10b3851 100644 --- a/api-reference/v1.0/resources/onlinemeetingbase.md +++ b/api-reference/v1.0/resources/onlinemeetingbase.md @@ -25,11 +25,17 @@ Inherits from [entity](../resources/entity.md). | :-------------------- | :-------------------------------------------- | :------------------------------------ | | allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. | | allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. | +| allowBreakoutRooms | Boolean | Indicates whether breakout rooms are enabled for the meeting. | +| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a meeting. | | allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of the meeting chat. | +| allowLiveShare | [meetingLiveShareOptions](#meetingliveshareoptions-values) | Indicates whether live share is enabled for the meeting. Possible values are: `enabled`, `disabled`, `unknownFutureValue`. | | allowParticipantsToChangeName | Boolean | Specifies if participants are allowed to rename themselves in an instance of the meeting. | | allowTeamworkReactions | Boolean | Indicates if Teams reactions are enabled for the meeting. | | allowTranscription | Boolean | Indicates whether transcription is enabled for the meeting. | +| allowPowerPointSharing | Boolean | Indicates whether PowerPoint live is enabled for the meeting. | | allowRecording | Boolean | Indicates whether recording is enabled for the meeting. | +| allowWhiteboard | Boolean | Indicates whether whiteboard is enabled for the meeting. | +| allowedLobbyAdmitters | [allowedLobbyAdmitterRoles](#allowedlobbyadmitterroles-values) | Specifies the users who can admit from the lobby. Possible values are: `organizerAndCoOrganizersAndPresenters`, `organizerAndCoOrganizers`, `unknownFutureValue`. | | allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a meeting. | | anonymizeIdentityForRoles | onlineMeetingRole collection | Specifies whose identity is anonymized in the meeting. Possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added.| | audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for an online meeting. Read-only. | @@ -47,15 +53,13 @@ Inherits from [entity](../resources/entity.md). | videoTeleconferenceId | String | The video teleconferencing ID. Read-only. | | watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark to a content type. | -### onlineMeetingPresenters values +### allowedLobbyAdmitterRoles values -| Value | Description | -| ------------------ | ------------------------------------------------------------- | -| everyone | Everyone is a presenter. Default. | -| organization | Everyone in organizer’s organization is a presenter. | -| roleIsPresenter | Only the participants whose role is presenter are presenters. | -| organizer | Only the organizer is a presenter. | -| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | +| Value | Description | +|---------------------------------------|---------------------------------------------------| +| organizerAndCoOrganizersAndPresenters | Meeting organizer, co-organizers, and presenters. | +| organizerAndCoOrganizers | Meeting organizer and co-organizers. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ### meetingChatMode values @@ -74,6 +78,24 @@ Inherits from [entity](../resources/entity.md). | none | No meeting chat history is shared. | | unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | +### meetingLiveShareOptions values + +| Value | Description | +| ------------------ | ---------------------------------------------------------------------- | +| enabled | Meeting live share is enabled. | +| disabled | Meeting live share is disabled. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | + +### onlineMeetingPresenters values + +| Value | Description | +| ------------------ | ------------------------------------------------------------- | +| everyone | Everyone is a presenter. Default. | +| organization | Everyone in organizer’s organization is a presenter. | +| roleIsPresenter | Only the participants whose role is presenter are presenters. | +| organizer | Only the organizer is a presenter. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | + ## Relationships | Relationship | Type | Description | @@ -96,11 +118,18 @@ The following JSON representation shows the resource type. { "allowAttendeeToEnableCamera": "Boolean", "allowAttendeeToEnableMic": "Boolean", + "allowBreakoutRooms": "Boolean", "allowMeetingChat": {"@odata.type": "microsoft.graph.meetingChatMode"}, "allowTeamworkReactions": "Boolean", + "allowedLobbyAdmitters": "String", "allowedPresenters": "String", + "allowLiveShare": "String", + "allowMeetingChat": {"@odata.type": "microsoft.graph.meetingChatMode"}, + "allowPowerPointSharing": "Boolean", "allowRecording": "Boolean", + "allowTeamworkReactions": "Boolean", "allowTranscription": "Boolean", + "allowWhiteboard": "Boolean", "anonymizeIdentityForRoles": ["String"], "audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"}, "chatInfo": {"@odata.type": "microsoft.graph.chatInfo"}, diff --git a/api-reference/v1.0/resources/security-api-overview.md b/api-reference/v1.0/resources/security-api-overview.md index 17147ab1b9f..43b988addc4 100644 --- a/api-reference/v1.0/resources/security-api-overview.md +++ b/api-reference/v1.0/resources/security-api-overview.md @@ -23,7 +23,7 @@ The Microsoft Graph security API provides a unified interface and schema to inte The Microsoft Graph security API provides key features as described in the following sections. ## Advanced hunting -Advanced hunting is a query-based threat hunting tool that lets you explore up to 30 days of raw data. You can proactively inspect events in your network to locate threat indicators and entities. The flexible access to data enables unconstrained hunting for both known and potential threats. +Advanced hunting is a query-based threat-hunting tool that lets you explore up to 30 days of raw data. You can proactively inspect events in your network to locate threat indicators and entities. The flexible access to data enables unconstrained hunting for both known and potential threats. Use [runHuntingQuery](../api/security-security-runhuntingquery.md) to run a [Kusto Query Language](/azure/data-explorer/kusto/query/) (KQL) query on data stored in Microsoft 365 Defender. Use the returned result set to enrich an existing investigation or to uncover undetected threats in your network. @@ -37,12 +37,12 @@ The following conditions relate to all queries. 3. You can make up to at least 45 calls per minute per tenant. The number of calls varies per tenant based on its size. 4. Each tenant is allocated CPU resources, based on the tenant size. Queries are blocked if the tenant reaches 100% of the allocated resources until after the next 15-minute cycle. To avoid blocked queries due to excess consumption, follow the guidance in [Optimize your queries to avoid hitting CPU quotas](/microsoft-365/security/defender/advanced-hunting-best-practices). 5. If a single request runs for more than three minutes, it times out and returns an error. -6. A `429` HTTP response code indicates that you reached the allocated CPU resources, either by number of requests sent, or by allotted running time. Read the response body to understand the limit you reached. +6. A `429` HTTP response code indicates that you reached the allocated CPU resources, either by the number of requests sent or by allotted running time. Read the response body to understand the limit you reached. ## Alerts Alerts are detailed warnings about suspicious activities in a customer's tenant that Microsoft or partner security providers identified and flagged for action. Attacks typically employ various techniques against different types of entities, such as devices, users, and mailboxes. The result is alerts from multiple security providers for multiple entities in the tenant. Piecing the individual alerts together to gain insight into an attack can be challenging and time-consuming. -The security API offers two types of alerts that aggregate other alerts from security providers and make analyzing attacks and determining response easier: +The security API offers two types of alerts that aggregate other alerts from security providers and make analyzing attacks and determining responses easier: - [Alerts and incidents](#alerts-and-incidents) - these are the latest generation of alerts in the Microsoft Graph security API. They're represented by the [alert](security-alert.md) resource and its collection, [incident](security-incident.md) resource, defined in the `microsoft.graph.security` namespace. - [Legacy alerts](#legacy-alerts) - these are the first generation of alerts in the Microsoft Graph security API. They're represented by the [alert](alert.md) resource defined in the `microsoft.graph` namespace. @@ -58,6 +58,7 @@ Alerts from the following security providers are available via these rich alerts - [Microsoft Defender for Identity](/defender-for-identity/alerts-overview) - [Microsoft Defender for Office 365](/microsoft-365/security/office-365-security/overview?view=o365-worldwide&preserve-view=true) - [Microsoft Purview Data Loss Prevention](/microsoft-365/compliance/dlp-learn-about-dlp?view=o365-worldwide&preserve-view=true) +- [Microsoft Purview Insider Risk Management](/purview/insider-risk-management?view=o365-worldwide&preserve-view=true) ### Legacy alerts @@ -86,7 +87,7 @@ Alerts from the following providers are available via the **alert** resource. Su \*\* Microsoft Defender for Endpoint requires additional [user roles](/windows/security/threat-protection/microsoft-defender-atp/user-roles) to those required by the Microsoft Graph security API. Only the users in both Microsoft Defender for Endpoint and Microsoft Graph security API roles can access the Microsoft Defender for Endpoint data. Because application-only authentication isn't limited by this, we recommend that you use an application-only authentication token. -\*\*\* Microsoft Defender for Identity alerts are available via the Microsoft Defender for Cloud Apps integration. This means you get Microsoft Defender for Identity alerts only if you joined Unified SecOps and connected Microsoft Defender for Identity into Microsoft Defender for Cloud Apps. Learn more about [how to integrate Microsoft Defender for Identity and Microsoft Defender for Cloud Apps](/defender-for-identity/mcas-integration). +\*\*\* Microsoft Defender for Identity alerts are available via the Microsoft Defender for Cloud Apps integration. This means you get Microsoft Defender for Identity alerts only if you joined Unified SecOps and connected Microsoft Defender for Identity to Microsoft Defender for Cloud Apps. Learn more about [how to integrate Microsoft Defender for Identity and Microsoft Defender for Cloud Apps](/defender-for-identity/mcas-integration). ## Attack simulation and training @@ -110,7 +111,7 @@ The Defender for Identity sensors management API allows you to create detailed r ## Incidents -An [incident](security-incident.md) is a collection of correlated  [alerts](security-alert.md) and associated data that make up the story of an attack. Incident management is part of Microsoft 365 Defender, and is available in the Microsoft 365 Defender portal (https://security.microsoft.com/). +An [incident](security-incident.md) is a collection of correlated  [alerts](security-alert.md) and associated data that make up the story of an attack. Incident management is part of Microsoft 365 Defender and is available in the Microsoft 365 Defender portal (https://security.microsoft.com/). Microsoft 365 services and apps create  alerts  when they detect a suspicious or malicious event or activity. Individual alerts provide valuable clues about a completed or ongoing attack. However, attacks typically employ various techniques against different types of entities, such as devices, users, and mailboxes. The result is multiple  alerts for multiple entities in your tenant. @@ -124,17 +125,17 @@ Grouping related alerts into an incident gives you a comprehensive view of an at - The scope of the attack, such as how many devices, users, and mailboxes were impacted. - All of the data associated with the attack. -The  [incident](security-incident.md) resource and its APIs allow you to sort through incidents to create an informed cyber security response. It exposes a collection of incidents, with their related  [alerts](security-alert.md), that were flagged in your network, within the time range you specified in your environment retention policy. +The  [incident](security-incident.md) resource and its APIs allow you to sort through incidents to create an informed cybersecurity response. It exposes a collection of incidents, with their related  [alerts](security-alert.md), that were flagged in your network, within the time range you specified in your environment retention policy. ## Information protection -The Microsoft Graph threat assessment API helps organizations to assess the threat received by any user in a tenant. This empowers customers to report spam emails, phishing URLs, or malware attachments they receive to Microsoft. The policy check result and rescan result can help tenant administrators understand the threat scanning verdict and adjust their organizational policy. +The Microsoft Graph threat assessment API helps organizations assess the threat received by any user in a tenant. This empowers customers to report spam emails, phishing URLs, or malware attachments they receive to Microsoft. The policy check result and rescan result can help tenant administrators understand the threat scanning verdict and adjust their organizational policy. ## Records management -Most organizations need to manage data to proactively comply with industry regulations and internal policies, reduce risk in the event of litigation or a security breach, and let people effectively and agilely share knowledge that is current and relevant to them. You can use the [records management APIs](../resources/security-recordsmanagement-overview.md) to systematically apply [retention labels](security-retentionlabel.md) to different types of content that require different retention settings. For example, you can configure the start of retention period from when the content was created, last modified, labeled or when an event occurs for a particular event type. Further, you can use [file plan descriptors](security-fileplandescriptor.md) to improve the manageability of these retention labels. +Most organizations need to manage data to proactively comply with industry regulations and internal policies, reduce risk in the event of litigation or a security breach, and let people effectively and agilely share knowledge that is current and relevant to them. You can use the [records management APIs](../resources/security-recordsmanagement-overview.md) to systematically apply [retention labels](security-retentionlabel.md) to different types of content that require different retention settings. For example, you can configure the start of the retention period from when the content was created, last modified, labeled, or when an event occurs for a particular event type. Further, you can use [file plan descriptors](security-fileplandescriptor.md) to improve the manageability of these retention labels. ## Secure Score @@ -192,7 +193,7 @@ Engage with the community: ## Next steps -The Microsoft Graph security API can open up new ways for you to engage with different security solutions from Microsoft and partners. Follow these steps to get started: +The Microsoft Graph security API can open up new ways for you to engage with different security solutions from Microsoft and its partners. Follow these steps to get started: - Drill down into [alerts](alert.md), [secureScore](securescore.md), and [secureScoreControlProfiles](securescorecontrolprofile.md). - Try the API in the [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer). Under **Sample Queries**, choose **show more samples** and set the Security category to **on**. diff --git a/api-reference/v1.0/resources/virtualeventsession.md b/api-reference/v1.0/resources/virtualeventsession.md index 2198c17795d..fc0fe2bb561 100644 --- a/api-reference/v1.0/resources/virtualeventsession.md +++ b/api-reference/v1.0/resources/virtualeventsession.md @@ -14,7 +14,7 @@ Namespace: microsoft.graph Represents a session in a [virtualEvent](../resources/virtualevent.md). -Inherits from [onlineMeetingBase](../resources/onlinemeetingBase.md). +Inherits from [onlineMeetingBase](../resources/onlinemeetingbase.md). ## Methods @@ -27,30 +27,35 @@ Inherits from [onlineMeetingBase](../resources/onlinemeetingBase.md). | Property | Type | Description | | :-------------------- | :-------------------------------------------- | :------------------------------------ | -| allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowParticipantsToChangeName | Boolean | Specifies whether participants are allowed to rename themselves in an instance of the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowTranscription | Boolean | Indicates whether transcription is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowRecording | Boolean | Indicates whether recording is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| anonymizeIdentityForRoles | onlineMeetingRole collection | Specifies whose identity is anonymized in the virtual event session. Possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md).| -| audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowBreakoutRooms | Boolean | Indicates whether breakout rooms are enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowLiveShare | [meetingLiveShareOptions](../resources/onlinemeetingbase.md#meetingliveshareoptions-values) | Indicates whether live share is enabled for the virtual event session. Possible values are: `enabled`, `disabled`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowParticipantsToChangeName | Boolean | Specifies whether participants are allowed to rename themselves in an instance of the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowPowerPointSharing | Boolean | Indicates whether PowerPoint live is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowRecording | Boolean | Indicates whether recording is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowTranscription | Boolean | Indicates whether transcription is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowWhiteboard | Boolean | Indicates whether whiteboard is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowedLobbyAdmitters | [allowedLobbyAdmitterRoles](../resources/onlinemeetingbase.md#allowedlobbyadmitterroles-values) | Specifies the users who can admit from the lobby. Possible values are: `organizerAndCoOrganizersAndPresenters`, `organizerAndCoOrganizers`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| anonymizeIdentityForRoles | onlineMeetingRole collection | Specifies whose identity is anonymized in the virtual event session. Possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md).| +| audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | chatRestrictions | [chatrestrictions](../resources/chatrestrictions.md) | Specifies the configuration settings for meeting chat restrictions. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | -| chatInfo | [chatInfo](chatinfo.md) | The chat information associated with the virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| chatInfo | [chatInfo](chatinfo.md) | The chat information associated with the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | endDateTime | [DateTimeTimeZone](../resources/datetimetimezone.md) | The virtual event session end time. | -| id | String | The unique identifier of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| isEntryExitAnnounced | Boolean | Indicates whether to announce when callers join or leave. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| joinInformation | [itemBody](itembody.md) | The join information of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| joinWebUrl | String | The join URL of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| recordAutomatically | Boolean | Indicates whether to record the virtual event session automatically. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| id | String | The unique identifier of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| isEntryExitAnnounced | Boolean | Indicates whether to announce when callers join or leave. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| joinInformation | [itemBody](itembody.md) | The join information of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| joinWebUrl | String | The join URL of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| recordAutomatically | Boolean | Indicates whether to record the virtual event session automatically. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | startDateTime | [DateTimeTimeZone](../resources/datetimetimezone.md) | The virtual event session start time. | -| subject | String | The subject of the virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark to a content type. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| subject | String | The subject of the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark to a content type. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | ### onlineMeetingPresenters values @@ -98,44 +103,33 @@ The following JSON representation shows the resource type. ``` json { "@odata.type": "#microsoft.graph.virtualEventSession", - "id": "String (identifier)", - "joinWebUrl": "String", - "subject": "String", - "audioConferencing": { - "@odata.type": "microsoft.graph.audioConferencing" - }, - "chatInfo": { - "@odata.type": "microsoft.graph.chatInfo" - }, - "videoTeleconferenceId": "String", - "joinMeetingIdSettings": { - "@odata.type": "microsoft.graph.joinMeetingIdSettings" - }, - "joinInformation": { - "@odata.type": "microsoft.graph.itemBody" - }, - "lobbyBypassSettings": { - "@odata.type": "microsoft.graph.lobbyBypassSettings" - }, - "isEntryExitAnnounced": "Boolean", - "allowedPresenters": "String", - "allowAttendeeToEnableMic": "Boolean", "allowAttendeeToEnableCamera": "Boolean", + "allowAttendeeToEnableMic": "Boolean", + "allowBreakoutRooms": "Boolean", + "allowedLobbyAdmitters": "String", + "allowedPresenters": "String", + "allowLiveShare": "String", "allowMeetingChat": "String", + "allowPowerPointSharing": "Boolean", + "allowParticipantsToChangeName": "Boolean", "allowTeamworkReactions": "Boolean", + "allowWhiteboard": "Boolean", + "audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"}, + "chatInfo": {"@odata.type": "microsoft.graph.chatInfo"}, "chatRestrictions":{"@odata.type": "microsoft.graph.chatRestrictions"}, - "shareMeetingChatHistoryDefault": "String", - "allowParticipantsToChangeName": "Boolean", + "endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"}, + "id": "String (identifier)", + "isEntryExitAnnounced": "Boolean", + "joinInformation": {"@odata.type": "microsoft.graph.itemBody"}, + "joinMeetingIdSettings": {"@odata.type": "microsoft.graph.joinMeetingIdSettings"}, + "joinWebUrl": "String", + "lobbyBypassSettings": {"@odata.type": "microsoft.graph.lobbyBypassSettings"}, "recordAutomatically": "Boolean", - "watermarkProtection": { - "@odata.type": "microsoft.graph.watermarkProtectionValues" - }, - "startDateTime": { - "@odata.type": "microsoft.graph.dateTimeTimeZone" - }, - "endDateTime": { - "@odata.type": "microsoft.graph.dateTimeTimeZone" - } + "shareMeetingChatHistoryDefault": "String", + "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"}, + "subject": "String", + "videoTeleconferenceId": "String", + "watermarkProtection": {"@odata.type": "microsoft.graph.watermarkProtectionValues"} } ``` diff --git a/api-reference/v1.0/toc/calendars/toc.yml b/api-reference/v1.0/toc/calendars/toc.yml index b8d97115da7..88d83aa56e1 100644 --- a/api-reference/v1.0/toc/calendars/toc.yml +++ b/api-reference/v1.0/toc/calendars/toc.yml @@ -2,6 +2,8 @@ # GENERATED FILE - DO NOT EDIT # items: +- name: Overview + href: ../../resources/calendar-overview.md - name: Calendar items: - name: Calendar diff --git a/api-reference/v1.0/toc/toc.mapping.json b/api-reference/v1.0/toc/toc.mapping.json index 3b6f883891b..1a2c0289bdb 100644 --- a/api-reference/v1.0/toc/toc.mapping.json +++ b/api-reference/v1.0/toc/toc.mapping.json @@ -182,6 +182,7 @@ "Outlook", "Outlook calendar" ], + "overview": "../../resources/calendar-overview.md", "resources": [ "calendar", "event", diff --git a/changelog/Microsoft.AAD.Reporting.json b/changelog/Microsoft.AAD.Reporting.json index cc8b4c02f42..ac48d8a8b49 100644 --- a/changelog/Microsoft.AAD.Reporting.json +++ b/changelog/Microsoft.AAD.Reporting.json @@ -70,6 +70,32 @@ "CreatedDateTime": "2024-11-13T17:39:15.5745429Z", "WorkloadArea": "Reports", "SubArea": "Identity and access reports" + }, + { + "ChangeList": [ + { + "Id": "da78f1c6-0bfa-4e22-b2c4-b7bb1af5366d", + "ApiChange": "Property", + "ChangedApiName": "appOwnerTenantId", + "ChangeType": "Addition", + "Description": "Added the **appOwnerTenantId** property to the [signIn](https://learn.microsoft.com/en-us/graph/api/resources/signIn?view=graph-rest-beta) resource.", + "Target": "signIn" + }, + { + "Id": "da78f1c6-0bfa-4e22-b2c4-b7bb1af5366d", + "ApiChange": "Property", + "ChangedApiName": "resourceOwnerTenantId", + "ChangeType": "Addition", + "Description": "Added the **resourceOwnerTenantId** property to the [signIn](https://learn.microsoft.com/en-us/graph/api/resources/signIn?view=graph-rest-beta) resource.", + "Target": "signIn" + } + ], + "Id": "da78f1c6-0bfa-4e22-b2c4-b7bb1af5366d", + "Cloud": "Prod", + "Version": "beta", + "CreatedDateTime": "2025-01-28T00:39:45.8184996Z", + "WorkloadArea": "Reports", + "SubArea": "Identity and access reports" }, { "ChangeList": [ diff --git a/changelog/Microsoft.DirectoryServices.json b/changelog/Microsoft.DirectoryServices.json index c6310837e67..621cf650a54 100644 --- a/changelog/Microsoft.DirectoryServices.json +++ b/changelog/Microsoft.DirectoryServices.json @@ -14047,6 +14047,40 @@ "SubArea": "Directory management" }, { + "ChangeList": [ + { + "Id": "e5bc94bb-0909-4bab-95aa-3e90e117a7cc", + "ApiChange": "Property", + "ChangedApiName": "isStateSetByMicrosoft", + "ChangeType": "Addition", + "Description": "Added the **isStateSetByMicrosoft** property to the [identifierUriRestriction](https://learn.microsoft.com/en-us/graph/api/resources/identifierUriRestriction?view=graph-rest-beta) resource.", + "Target": "identifierUriRestriction" + }, + { + "Id": "e5bc94bb-0909-4bab-95aa-3e90e117a7cc", + "ApiChange": "Property", + "ChangedApiName": "isStateSetByMicrosoft", + "ChangeType": "Addition", + "Description": "Added the **isStateSetByMicrosoft** property to the [keyCredentialConfiguration](https://learn.microsoft.com/en-us/graph/api/resources/keyCredentialConfiguration?view=graph-rest-beta) resource.", + "Target": "keyCredentialConfiguration" + }, + { + "Id": "e5bc94bb-0909-4bab-95aa-3e90e117a7cc", + "ApiChange": "Property", + "ChangedApiName": "isStateSetByMicrosoft", + "ChangeType": "Addition", + "Description": "Added the **isStateSetByMicrosoft** property to the [passwordCredentialConfiguration](https://learn.microsoft.com/en-us/graph/api/resources/passwordCredentialConfiguration?view=graph-rest-beta) resource.", + "Target": "passwordCredentialConfiguration" + } + ], + "Id": "e5bc94bb-0909-4bab-95aa-3e90e117a7cc", + "Cloud": "Review", + "Version": "beta", + "CreatedDateTime": "2024-12-13T19:46:07.288016Z", + "WorkloadArea": "Identity and access", + "SubArea": "Directory management" + }, + { "ChangeList": [ { "Id": "8cd03a79-71de-467d-bd73-0b3449a28bfc", diff --git a/changelog/Microsoft.Exchange.json b/changelog/Microsoft.Exchange.json index e6a2033196c..effe8b840a6 100644 --- a/changelog/Microsoft.Exchange.json +++ b/changelog/Microsoft.Exchange.json @@ -1,5 +1,135 @@ { "changelog": [ + { + "ChangeList": [ + { + "Id": "a00ff349-57eb-47d9-8484-17d27853c5ff", + "ApiChange": "Resource", + "ChangedApiName": "exportItemResponse", + "ChangeType": "Addition", + "Description": "Added the [exportItemResponse](https://learn.microsoft.com/en-us/graph/api/resources/exportItemResponse?view=graph-rest-beta) resource type.", + "Target": "exportItemResponse" + }, + { + "Id": "a00ff349-57eb-47d9-8484-17d27853c5ff", + "ApiChange": "Resource", + "ChangedApiName": "mailboxItemImportSession", + "ChangeType": "Addition", + "Description": "Added the [mailboxItemImportSession](https://learn.microsoft.com/en-us/graph/api/resources/mailboxItemImportSession?view=graph-rest-beta) resource type.", + "Target": "mailboxItemImportSession" + }, + { + "Id": "a00ff349-57eb-47d9-8484-17d27853c5ff", + "ApiChange": "Relationship", + "ChangedApiName": "exchange", + "ChangeType": "Addition", + "Description": "Added the **exchange** relationship to the [admin](https://learn.microsoft.com/en-us/graph/api/resources/admin?view=graph-rest-beta) resource.", + "Target": "admin" + }, + { + "Id": "a00ff349-57eb-47d9-8484-17d27853c5ff", + "ApiChange": "Resource", + "ChangedApiName": "exchangeAdmin", + "ChangeType": "Addition", + "Description": "Added the [exchangeAdmin](https://learn.microsoft.com/en-us/graph/api/resources/exchangeAdmin?view=graph-rest-beta) resource type.", + "Target": "exchangeAdmin" + }, + { + "Id": "a00ff349-57eb-47d9-8484-17d27853c5ff", + "ApiChange": "Resource", + "ChangedApiName": "exchangeSettings", + "ChangeType": "Addition", + "Description": "Added the [exchangeSettings](https://learn.microsoft.com/en-us/graph/api/resources/exchangeSettings?view=graph-rest-beta) resource type.", + "Target": "exchangeSettings" + }, + { + "Id": "a00ff349-57eb-47d9-8484-17d27853c5ff", + "ApiChange": "Resource", + "ChangedApiName": "mailbox", + "ChangeType": "Addition", + "Description": "Added the [mailbox](https://learn.microsoft.com/en-us/graph/api/resources/mailbox?view=graph-rest-beta) resource and associated methods.", + "Target": "mailbox" + }, + { + "Id": "a00ff349-57eb-47d9-8484-17d27853c5ff", + "ApiChange": "Resource", + "ChangedApiName": "mailboxFolder", + "ChangeType": "Addition", + "Description": "Added the [mailboxFolder](https://learn.microsoft.com/en-us/graph/api/resources/mailboxFolder?view=graph-rest-beta) resource and associated methods.", + "Target": "mailboxFolder" + }, + { + "Id": "a00ff349-57eb-47d9-8484-17d27853c5ff", + "ApiChange": "Resource", + "ChangedApiName": "mailboxItem", + "ChangeType": "Addition", + "Description": "Added the [mailboxItem](https://learn.microsoft.com/en-us/graph/api/resources/mailboxItem?view=graph-rest-beta) resource and associated methods.", + "Target": "mailboxItem" + }, + { + "Id": "a00ff349-57eb-47d9-8484-17d27853c5ff", + "ApiChange": "Relationship", + "ChangedApiName": "exchange", + "ChangeType": "Addition", + "Description": "Added the **exchange** relationship to the [userSettings](https://learn.microsoft.com/en-us/graph/api/resources/userSettings?view=graph-rest-beta) resource.", + "Target": "userSettings" + }, + { + "Id": "a00ff349-57eb-47d9-8484-17d27853c5ff", + "ApiChange": "Method", + "ChangedApiName": "createImportSession", + "ChangeType": "Addition", + "Description": "Added the [createImportSession](https://learn.microsoft.com/en-us/graph/api/mailbox-createImportSession?view=graph-rest-beta) method to the [mailbox](https://learn.microsoft.com/en-us/graph/api/resources/mailbox?view=graph-rest-beta) resource.", + "Target": "mailbox" + }, + { + "Id": "a00ff349-57eb-47d9-8484-17d27853c5ff", + "ApiChange": "Method", + "ChangedApiName": "exportItems", + "ChangeType": "Addition", + "Description": "Added the [exportItems](https://learn.microsoft.com/en-us/graph/api/mailbox-exportItems?view=graph-rest-beta) method to the [mailbox](https://learn.microsoft.com/en-us/graph/api/resources/mailbox?view=graph-rest-beta) resource.", + "Target": "mailbox" + }, + { + "Id": "a00ff349-57eb-47d9-8484-17d27853c5ff", + "ApiChange": "Method", + "ChangedApiName": "delta", + "ChangeType": "Addition", + "Description": "Added the [delta](https://learn.microsoft.com/en-us/graph/api/mailboxFolder-delta?view=graph-rest-beta) method to the [mailboxFolder](https://learn.microsoft.com/en-us/graph/api/resources/mailboxFolder?view=graph-rest-beta) resource.", + "Target": "mailboxFolder" + }, + { + "Id": "a00ff349-57eb-47d9-8484-17d27853c5ff", + "ApiChange": "Parameter", + "ChangedApiName": "bindingParameter", + "ChangeType": "Addition", + "Description": "Added the **bindingParameter** parameter to the [mailboxFolder: delta](https://learn.microsoft.com/en-us/graph/api/mailboxFolder-delta?view=graph-rest-beta) method.", + "Target": "delta" + }, + { + "Id": "a00ff349-57eb-47d9-8484-17d27853c5ff", + "ApiChange": "Method", + "ChangedApiName": "delta", + "ChangeType": "Addition", + "Description": "Added the [delta](https://learn.microsoft.com/en-us/graph/api/mailboxItem-delta?view=graph-rest-beta) method to the [mailboxItem](https://learn.microsoft.com/en-us/graph/api/resources/mailboxItem?view=graph-rest-beta) resource.", + "Target": "mailboxItem" + }, + { + "Id": "a00ff349-57eb-47d9-8484-17d27853c5ff", + "ApiChange": "Parameter", + "ChangedApiName": "bindingParameter", + "ChangeType": "Addition", + "Description": "Added the **bindingParameter** parameter to the [mailboxItem: delta](https://learn.microsoft.com/en-us/graph/api/mailboxItem-delta?view=graph-rest-beta) method.", + "Target": "delta" + } + ], + "Id": "a00ff349-57eb-47d9-8484-17d27853c5ff", + "Cloud": "Prod", + "Version": "beta", + "CreatedDateTime": "2025-01-09T21:50:39.9393866Z", + "WorkloadArea": "Mailbox import and export", + "SubArea": "" + }, { "ChangeList": [ { diff --git a/changelog/Microsoft.Skype.Calling.json b/changelog/Microsoft.Skype.Calling.json index 54750f7388c..07773fa3310 100644 --- a/changelog/Microsoft.Skype.Calling.json +++ b/changelog/Microsoft.Skype.Calling.json @@ -1,5 +1,161 @@ { "changelog": [ + { + "ChangeList": [ + { + "Id": "2bc95484-74f0-4eef-ab77-f33f13deec20", + "ApiChange": "Enumeration", + "ChangedApiName": "meetingLiveShareOptions", + "ChangeType": "Addition", + "Description": "Added the **meetingLiveShareOptions** enumeration type.", + "Target": "meetingLiveShareOptions" + }, + { + "Id": "2bc95484-74f0-4eef-ab77-f33f13deec20", + "ApiChange": "Property", + "ChangedApiName": "allowBreakoutRooms", + "ChangeType": "Addition", + "Description": "Added the **allowBreakoutRooms** property to the [onlineMeetingBase](https://learn.microsoft.com/en-us/graph/api/resources/onlineMeetingBase?view=graph-rest-1.0) resource.", + "Target": "onlineMeetingBase" + }, + { + "Id": "2bc95484-74f0-4eef-ab77-f33f13deec20", + "ApiChange": "Property", + "ChangedApiName": "allowLiveShare", + "ChangeType": "Addition", + "Description": "Added the **allowLiveShare** property to the [onlineMeetingBase](https://learn.microsoft.com/en-us/graph/api/resources/onlineMeetingBase?view=graph-rest-1.0) resource.", + "Target": "onlineMeetingBase" + }, + { + "Id": "2bc95484-74f0-4eef-ab77-f33f13deec20", + "ApiChange": "Property", + "ChangedApiName": "allowPowerPointSharing", + "ChangeType": "Addition", + "Description": "Added the **allowPowerPointSharing** property to the [onlineMeetingBase](https://learn.microsoft.com/en-us/graph/api/resources/onlineMeetingBase?view=graph-rest-1.0) resource.", + "Target": "onlineMeetingBase" + }, + { + "Id": "2bc95484-74f0-4eef-ab77-f33f13deec20", + "ApiChange": "Property", + "ChangedApiName": "allowWhiteboard", + "ChangeType": "Addition", + "Description": "Added the **allowWhiteboard** property to the [onlineMeetingBase](https://learn.microsoft.com/en-us/graph/api/resources/onlineMeetingBase?view=graph-rest-1.0) resource.", + "Target": "onlineMeetingBase" + }, + { + "Id": "2bc95484-74f0-4eef-ab77-f33f13deec20", + "ApiChange": "Property", + "ChangedApiName": "allowBreakoutRooms", + "ChangeType": "Addition", + "Description": "Added the **allowBreakoutRooms** property to the [onlineMeeting](https://learn.microsoft.com/en-us/graph/api/resources/onlineMeeting?view=graph-rest-1.0) resource.", + "Target": "onlineMeeting" + }, + { + "Id": "2bc95484-74f0-4eef-ab77-f33f13deec20", + "ApiChange": "Property", + "ChangedApiName": "allowLiveShare", + "ChangeType": "Addition", + "Description": "Added the **allowLiveShare** property to the [onlineMeeting](https://learn.microsoft.com/en-us/graph/api/resources/onlineMeeting?view=graph-rest-1.0) resource.", + "Target": "onlineMeeting" + }, + { + "Id": "2bc95484-74f0-4eef-ab77-f33f13deec20", + "ApiChange": "Property", + "ChangedApiName": "allowPowerPointSharing", + "ChangeType": "Addition", + "Description": "Added the **allowPowerPointSharing** property to the [onlineMeeting](https://learn.microsoft.com/en-us/graph/api/resources/onlineMeeting?view=graph-rest-1.0) resource.", + "Target": "onlineMeeting" + }, + { + "Id": "2bc95484-74f0-4eef-ab77-f33f13deec20", + "ApiChange": "Property", + "ChangedApiName": "allowWhiteboard", + "ChangeType": "Addition", + "Description": "Added the **allowWhiteboard** property to the [onlineMeeting](https://learn.microsoft.com/en-us/graph/api/resources/onlineMeeting?view=graph-rest-1.0) resource.", + "Target": "onlineMeeting" + }, + { + "Id": "2bc95484-74f0-4eef-ab77-f33f13deec20", + "ApiChange": "Property", + "ChangedApiName": "allowBreakoutRooms", + "ChangeType": "Addition", + "Description": "Added the **allowBreakoutRooms** property to the [virtualEventSession](https://learn.microsoft.com/en-us/graph/api/resources/virtualEventSession?view=graph-rest-1.0) resource.", + "Target": "virtualEventSession" + }, + { + "Id": "2bc95484-74f0-4eef-ab77-f33f13deec20", + "ApiChange": "Property", + "ChangedApiName": "allowLiveShare", + "ChangeType": "Addition", + "Description": "Added the **allowLiveShare** property to the [virtualEventSession](https://learn.microsoft.com/en-us/graph/api/resources/virtualEventSession?view=graph-rest-1.0) resource.", + "Target": "virtualEventSession" + }, + { + "Id": "2bc95484-74f0-4eef-ab77-f33f13deec20", + "ApiChange": "Property", + "ChangedApiName": "allowPowerPointSharing", + "ChangeType": "Addition", + "Description": "Added the **allowPowerPointSharing** property to the [virtualEventSession](https://learn.microsoft.com/en-us/graph/api/resources/virtualEventSession?view=graph-rest-1.0) resource.", + "Target": "virtualEventSession" + }, + { + "Id": "2bc95484-74f0-4eef-ab77-f33f13deec20", + "ApiChange": "Property", + "ChangedApiName": "allowWhiteboard", + "ChangeType": "Addition", + "Description": "Added the **allowWhiteboard** property to the [virtualEventSession](https://learn.microsoft.com/en-us/graph/api/resources/virtualEventSession?view=graph-rest-1.0) resource.", + "Target": "virtualEventSession" + } + ], + "Id": "2bc95484-74f0-4eef-ab77-f33f13deec20", + "Cloud": "Prod", + "Version": "v1.0", + "CreatedDateTime": "2025-01-28T04:07:42.7434446Z", + "WorkloadArea": "Teamwork and communications", + "SubArea": "Calls and online meetings" + }, + { + "ChangeList": [ + { + "Id": "b38cf417-78db-49da-a2b0-15db5d94e784", + "ApiChange": "Enumeration", + "ChangedApiName": "allowedLobbyAdmitterRoles", + "ChangeType": "Addition", + "Description": "Added the **allowedLobbyAdmitterRoles** enumeration type.", + "Target": "allowedLobbyAdmitterRoles" + }, + { + "Id": "b38cf417-78db-49da-a2b0-15db5d94e784", + "ApiChange": "Property", + "ChangedApiName": "allowedLobbyAdmitters", + "ChangeType": "Addition", + "Description": "Added the **allowedLobbyAdmitters** property to the [onlineMeetingBase](https://learn.microsoft.com/en-us/graph/api/resources/onlineMeetingBase?view=graph-rest-1.0) resource.", + "Target": "onlineMeetingBase" + }, + { + "Id": "b38cf417-78db-49da-a2b0-15db5d94e784", + "ApiChange": "Property", + "ChangedApiName": "allowedLobbyAdmitters", + "ChangeType": "Addition", + "Description": "Added the **allowedLobbyAdmitters** property to the [onlineMeeting](https://learn.microsoft.com/en-us/graph/api/resources/onlineMeeting?view=graph-rest-1.0) resource.", + "Target": "onlineMeeting" + }, + { + "Id": "b38cf417-78db-49da-a2b0-15db5d94e784", + "ApiChange": "Property", + "ChangedApiName": "allowedLobbyAdmitters", + "ChangeType": "Addition", + "Description": "Added the **allowedLobbyAdmitters** property to the [virtualEventSession](https://learn.microsoft.com/en-us/graph/api/resources/virtualEventSession?view=graph-rest-1.0) resource.", + "Target": "virtualEventSession" + } + ], + "Id": "b38cf417-78db-49da-a2b0-15db5d94e784", + "Cloud": "Prod", + "Version": "v1.0", + "CreatedDateTime": "2025-01-28T19:34:07.3297702Z", + "WorkloadArea": "Teamwork and communications", + "SubArea": "Calls and online meetings" + }, { "ChangeList": [ { diff --git a/changelog/Microsoft.Tasks.json b/changelog/Microsoft.Tasks.json index eb649c29eb8..ad04b384325 100644 --- a/changelog/Microsoft.Tasks.json +++ b/changelog/Microsoft.Tasks.json @@ -1,31 +1,5 @@ { "changelog": [ - { - "ChangeList": [ - { - "Id": "3da1192e-9af9-47d4-b32c-1ba82ddabcd1", - "ApiChange": "Relationship", - "ChangedApiName": "planner", - "ChangeType": "Addition", - "Description": "Added the **planner** relationship to the [channel](https://learn.microsoft.com/en-us/graph/api/resources/channel?view=graph-rest-beta) resource.", - "Target": "channel" - }, - { - "Id": "3da1192e-9af9-47d4-b32c-1ba82ddabcd1", - "ApiChange": "Resource", - "ChangedApiName": "teamsChannelPlanner", - "ChangeType": "Addition", - "Description": "Added the [teamsChannelPlanner](https://learn.microsoft.com/en-us/graph/api/resources/teamsChannelPlanner?view=graph-rest-beta) resource and an associated method.", - "Target": "teamsChannelPlanner" - } - ], - "Id": "3da1192e-9af9-47d4-b32c-1ba82ddabcd1", - "Cloud": "Prod", - "Version": "beta", - "CreatedDateTime": "2025-01-22T22:58:43.1666848Z", - "WorkloadArea": "Tasks and plans", - "SubArea": "" - }, { "ChangeList": [ { diff --git a/concepts/delta-query-overview.md b/concepts/delta-query-overview.md index 8703d5cbe69..416387dbb70 100644 --- a/concepts/delta-query-overview.md +++ b/concepts/delta-query-overview.md @@ -127,6 +127,8 @@ Delta query is currently supported for the following resources. Some resources t | [callRecording](/graph/api/resources/callrecording) | [callRecording: delta](/graph/api/callrecording-delta) function | | [callTranscript](/graph/api/resources/calltranscript) | [callTranscript: delta](/graph/api/calltranscript-delta) function | | [chatMessage](/graph/api/resources/chatmessage) | [chatMessage: delta](/graph/api/chatmessage-delta) function | +| [contact](/graph/api/resources/contact) resource | [contact: delta](/graph/api/contact-delta) function | +| [contactFolder](/graph/api/resources/contactfolder) | [contactFolder: delta](/graph/api/contactfolder-delta) function | | [device](/graph/api/resources/device) | [device: delta](/graph/api/device-delta) function | | [directoryRole](/graph/api/resources/directoryrole) | [directoryRole: delta](/graph/api/directoryrole-delta) function | | [directoryObject](/graph/api/resources/directoryObject) | [directoryObject: delta](/graph/api/directoryobject-delta) function | @@ -139,12 +141,12 @@ Delta query is currently supported for the following resources. Some resources t | [event](/graph/api/resources/event) | [event: delta](/graph/api/event-delta) function | | [group](/graph/api/resources/group) | [group: delta](/graph/api/group-delta) function | | [listItem](/graph/api/resources/listitem) 1 | [listItem: delta](/graph/api/listitem-delta) function | +| [mailboxFolder](/graph/api/resources/mailboxfolder) * | [mailboxFolder: delta](/graph/api/mailboxfolder-delta) function | +| [mailboxItem](/graph/api/resources/mailboxitem) * | [mailboxItem: delta](/graph/api/mailboxitem-delta) function | | [mailFolder](/graph/api/resources/mailfolder) | [mailFolder: delta](/graph/api/mailfolder-delta) function | | [message](/graph/api/resources/message) | [message: delta](/graph/api/message-delta) function | | [orgContact](/graph/api/resources/orgcontact) | [orgContact: delta](/graph/api/orgcontact-delta) function | | [oAuth2PermissionGrant](/graph/api/resources/oauth2permissiongrant) | [oAuth2PermissionGrant: delta](/graph/api/oauth2permissiongrant-delta) function | -| [contactFolder](/graph/api/resources/contactfolder) | [contactFolder: delta](/graph/api/contactfolder-delta) function | -| [contact](/graph/api/resources/contact) resource | [contact: delta](/graph/api/contact-delta) function | | [plannerBucket](/graph/api/resources/plannerbucket) * | [plannerBucket: delta](/graph/api/plannerbucket-delta) function | | [plannerUser](/graph/api/resources/planneruser) 2 | [plannerUser: delta](/graph/api/planneruser-list-delta) function | | [sites](/graph/api/resources/site) | [delta](/graph/api/site-delta) function of the [site](/graph/api/resources/site) resource | diff --git a/concepts/import-exchange-mailbox-item.md b/concepts/import-exchange-mailbox-item.md new file mode 100644 index 00000000000..412531747c2 --- /dev/null +++ b/concepts/import-exchange-mailbox-item.md @@ -0,0 +1,189 @@ +--- +title: "Import an Exchange mailbox item using the mailbox import and export APIs" +description: "Learn how to import an Exchange mailbox item using its FastTransfer stream format." +author: "cparker-msft" +ms.localizationpriority: medium +ms.subservice: "outlook" +ms.date: 12/06/2024 +--- + +# Import an Exchange mailbox item using the mailbox import and export APIs + +The mailbox import and export APIs allow you to import an Exchange [mailbox item](/graph/resources/mailboxitem) using the [FastTransfer stream](/openspecs/exchange_server_protocols/ms-oxcfxics/a2648823-0a98-43ee-98e8-590e4f7bcbbe) (FTS) format. Items can be restored to the same mailbox or a different one. + +This article describes the two steps required to perform the import process, with an example provided for each step. After successfully uploading the item, you get a response that contains the **itemId** and **changeKey**, which can be saved for later use. + +## Step 1: Create an import session + +[Create an import session](/graph/api/mailbox-createimportsession) to import an item in a folder in the mailbox. + +A successful operation returns a `HTTP 201 Created` response code and a new [mailboxItemImportSession](/graph/resources/mailboxitemimportsession) object in the response body, which contains an opaque **importUrl** that you can use in subsequent POST operations to upload items into a folder. + +The **mailboxItemImportSession** object in the response also includes the **expirationDateTime** property that indicates the expiration date and time for the auth token embedded in the **importUrl** property value. After this time, the **importUrl** expires and is deleted. + +### Permissions + +Make sure to request the `MailboxItem.ImportExport` delegated permission or `MailboxItem.ImportExport.All` application permission to create a **mailboxItemImportSession**. + +The opaque URL, returned in the **importUrl** property of the new **mailboxItemImportSession**, is preauthenticated and contains the appropriate authorization token for subsequent POST queries in the `https://outlook.office365.com` domain. Don't customize this URL for the POST operations. + +### Example: Create a mailbox item import session + +The following example shows how to create a **mailboxItemImportSession** object. + +#### Request + +The following example shows a request. + + +``` http +POST https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/createImportSession +``` + +#### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-type: application/json +Content-length: 232 + +{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.mailboxItemImportSession", + "importUrl": "https://outlook.office365.com/api/gbeta/Mailboxes('MBX:e0643f21@a7809c93')/importItem?authtoken=eyJhbGciOiJSUzI1NiIsImtpZCI6IjFTeXQ1b", + "expirationDateTime": "2024-10-17T19:00:48.1052906Z" +} +``` + +## Step 2: Use the import URL to upload an item + +To import the item into the mailbox, make a POST request to the URL returned in the previous step in the **importUrl** property of the [mailboxItemImportSession](/graph/resources/mailboxitemimportsession) object. + +Specify the request body as described in the [Request body](#request-body) section. + +### Request headers + +Because the initial opaque URL is preauthenticated and contains the appropriate authorization token for subsequent queries for that import session, don't specify an `Authorization` request header for this operation. + +### Request body + +|Parameter|Type|Description| +|:---|:---|:---| +|FolderId|String|The ID of the folder into which you want to import the item. Required.| +|Mode|String|Specifies that the import mode can be `create` or `update`. Required.

  • `create`: Creates a new item. If you specify **ItemId** or **ChangeKey** in the request body, it results in an error.
  • `update`: Updates an existing item. **ItemId** and **ChangeKey** are required in the request body for updates. The operation fails if the combination of **ItemId** and **ChangeKey** doesn't match with any existing item in the folder.
| +|Data|String|Data that represents an item in a base64 encoded [FTS format](/openspecs/exchange_server_protocols/ms-oxcfxics/ed7d3455-9bdf-40eb-90bd-8dfe6164a250#gt_12daff0e-4241-4498-a93f-212795ab2450). Required.| +|ItemId|String|The unique identifier for the item. Required during `update`.| +|ChangeKey|String|The version of the item. Required during `update`.| + +### Response + +If successful, this action returns a `200 OK` response code and an [importMailboxItemResponse](/graph/resources/importmailboxitemresponse) object in the response body. + +### Examples + +#### Example 1: Create an item in a mailbox using the import operation + +The following example shows how to import a new item into the mailbox in `create` mode. + +##### Request + +The following example shows a request. + + + +``` http +POST https://outlook.office365.com/api/gbeta/Mailboxes('MBX:e0643f21@a7809c93')/importItem?authtoken=eyJhbGciOiJSUzI1NiIsImtpZCI6IjFTeXQ1b + +{ + "FolderId": "EDSVrdi3lRAAEED0yTAAA=", + "Mode": "create", + "Data": "AQAAAAgAAAAAAAAAAQAAAAMAAAAYAAAAAQAAAAcDAgAAAAAAwAAAAAAAAEYAJACABAAAAAYAAAAUD9aRhhcCAAAAwHsAAAMAFwABAAAAsIQaABIAAABJAFAATQAuA" +} +``` + +##### Response + +The following example shows the response. + + +``` http +HTTP/1.1 200 OK +Content-type: application/json +Content-length: 232 + +{ + "@odata.context": "https://outlook.office365.com/api/gbeta/$metadata#microsoft.graph.importMailboxItemResponse", + "itemId": "EDSVrdi3lRAAFSX03NAAA=", + "changeKey": "kNnynYavKEihA0la3Yt5UQABUftGQg==" +} +``` + +#### Example 2: Update an existing item in a mailbox using the import operation + +The following example shows how to import a new version of an existing item into the mailbox in `update` mode. + +##### Request + +The following example shows a request. + + +``` http +POST https://outlook.office365.com/api/gbeta/Mailboxes('MBX:e0643f21@a7809c93')/importItem?authtoken=eyJhbGciOiJSUzI1NiIsImtpZCI6IjFTeXQ1b + +{ + "FolderId": "EDSVrdi3lRAAEED0yTAAA=", + "Mode": "update", + "Data": "AQAAAAgAAAAAAAAAAQAAAAMAAAAYAAAAAQAAAAcDAgAAAAAAwAAAAAAAAEYAJACABAAAAAYAAAAUD9aRhhcCAAAAwHsAAAMAFwABAAAAsIQaABIAAABJAFAATQAuA", + "ItemId" : "EDSVrdi3lRAAFSX03NAAA=", + "ChangeKey": "kNnynYavKEihA0la3Yt5UQABUftGQg==" +} +``` + +##### Response + +The following example shows the response. + + +``` http +HTTP/1.1 200 OK +Content-type: application/json +Content-length: 232 + +{ + "@odata.context": "https://outlook.office365.com/api/gbeta/$metadata#microsoft.graph.importMailboxItemResponse", + "itemId": "EDSVrdi3lRAAFSX03NAAA=", + "changeKey": "kNnynYavKEihA0la3Yt5UQABUftGQf==" +} +``` \ No newline at end of file diff --git a/concepts/mailbox-import-export-concept-overview.md b/concepts/mailbox-import-export-concept-overview.md new file mode 100644 index 00000000000..1cae8ac1023 --- /dev/null +++ b/concepts/mailbox-import-export-concept-overview.md @@ -0,0 +1,41 @@ +--- +title: "Overview of the mailbox import and export APIs in Microsoft Graph (preview)" +description: "Use the mailbox import and export APIs in Microsoft Graph to build solutions that integrate with mailbox resources for data import and export scenarios." +author: "cparker" +ms.localizationpriority: high +ms.subservice: "outlook" +ms.custom: scenarios:getting-started +doc_type: conceptual +ms.date: 12/06/2024 +--- + +# Overview of the mailbox import and export APIs in Microsoft Graph (preview) + +The mailbox import and export APIs in Microsoft Graph let your application import and export contents from Exchange Online mailboxes. Contents within a mailbox can be accessed as a set of [folders](/graph/api/resources/mailboxfolder) and [items](/graph/api/resources/mailboxitem) in a uniform format without having to understand the metadata and structure of each item type separately. These items can be [exported](/graph/api/mailbox-exportitems) in [FastTransfer stream](/openspecs/exchange_server_protocols/ms-oxcfxics/a2648823-0a98-43ee-98e8-590e4f7bcbbe) format in full fidelity. Full-fidelity exports ensure that when you [import](/graph/api/mailbox-createimportsession) an item back, Exchange recreates the item without any loss of information. + +These APIs support access to data in users' primary and [in-place archive](/exchange/clients-and-mobile-in-exchange-online/archive-client-and-compliance-&-security-feature-details?tabs=Archive-features#archive-mailbox) mailboxes on Exchange Online. Items can be imported to the same mailbox or a different one. + +## Why integrate with the mailbox import and export APIs? + +### Backup and restore mailbox items in full fidelity + +Exchange is a gold mine of important information: email, contacts, tasks, and calendars are core to the functions of an organization. Sometimes users and administrators encounter a need to restore an item or a set of items in a mailbox, and also make changes to the folder hierarchy of a mailbox. Many independent software vendors (ISVs) address this scenario by performing item-level backups of mailbox content, and restoring the content back into mailboxes when necessary. When using APIs that don't support the FastTransfer stream format, restoring mailbox content can be a challenge. + +The following are some of the scenarios that the mailbox import and export APIs enable: + +- [Get a list of mailboxes that belong to a user](/graph/api/usersettings-list-exchange) +- [Import or export mailbox items](/graph/api/resources/mailboxitem#methods) + +### Move items from one mailbox to another + +You can use the mailbox import and export APIs to move items between mailboxes, which is common for many workflows. Exchange developers can use these APIs to automate the process. + +## API reference + +Looking for the API reference for this service, see [Mailbox import and export APIs in Microsoft Graph beta](/graph/api/resources/mailbox-import-export-api-overview?view=graph-rest-beta&preserve-view=true). + +## Next steps + +- To learn more about the mailbox import and export APIs, see [Use the mailbox import and export APIs in Microsoft Graph (preview)](/graph/api/resources/mailbox-import-export-api-overview). +- To learn how to import a mailbox item, see [Import an Exchange mailbox item using the mailbox import and export APIs](/graph/import-exchange-mailbox-item). +- Try the mailbox import and export APIs in [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer). diff --git a/concepts/permissions-management-howto.md b/concepts/permissions-management-howto.md index 3350192aa67..03ef7e09c3c 100644 --- a/concepts/permissions-management-howto.md +++ b/concepts/permissions-management-howto.md @@ -2676,7 +2676,6 @@ Content-Type: application/json --- - ::: zone-end diff --git a/concepts/toc.yml b/concepts/toc.yml index ae282b0ccc0..95fda0a55ba 100644 --- a/concepts/toc.yml +++ b/concepts/toc.yml @@ -711,6 +711,12 @@ items: href: outlook-immutable-id.md - name: Subscribe to change notifications href: outlook-change-notifications-overview.md + - name: Mailbox import and export (preview) + items: + - name: Overview + href: mailbox-import-export-concept-overview.md + - name: Import mailbox item + href: import-exchange-mailbox-item.md - name: Notes items: - name: Overview diff --git a/concepts/whats-new-overview.md b/concepts/whats-new-overview.md index 5d126970e72..49e0c02f362 100644 --- a/concepts/whats-new-overview.md +++ b/concepts/whats-new-overview.md @@ -29,7 +29,9 @@ Added riskEventType entry for the Suspicious API Traffic detection for [service ### Teamwork and communications | Calls and online meetings -Microsoft Teams custom meeting templates allow you to specify values for many of the meeting options available to meeting organizers. Use the **meetingTemplateId** property on [onlineMeeting](/graph/api/resources/onlinemeeting) to create an online meeting with a meeting template. +- Microsoft Teams custom meeting templates allow you to specify values for many of the meeting options available to meeting organizers. Use the **meetingTemplateId** property on [onlineMeeting](/graph/api/resources/onlinemeeting) to create an online meeting with a meeting template. +- Use the **allowBreakoutRooms**, **allowLiveShare**, **allowPowerPointSharing**, and **allowWhiteboard** to indicate whether breakout rooms, live share, PowerPoint live, and whiteboard features are enabled in an [onlineMeeting](/graph/api/resources/onlinemeeting) or [virtualEventSession](/graph/api/resources/virtualeventsession). +- Use the **allowedLobbyAdmitters** property on [onlineMeeting](/graph/api/resources/onlinemeeting) to get or set the users who can admit from the lobby. ### Teamwork and communications | Messaging @@ -66,10 +68,13 @@ The functionality also allows you to configure the default fallback option when Use the [start](/graph/api/industrydata-industrydatarun-start?view=graph-rest-beta&preserve-view=true) operation on the [industryDataRun](/graph/api/resources/industrydata-industrydatarun?view=graph-rest-beta&preserve-view=true) resource to perform an on-demand run, with throttling limits of up to five successful runs every 12 hours. +### Mailbox import and export + +Use the new mailbox import and export APIs in Microsoft Graph to build solutions that integrate with mailbox resources for data import and export scenarios. For more information, see [Overview of the mailbox import and export APIs in Microsoft Graph](/graph/mailbox-import-export-concept-overview). + ### Tasks and plans -- Use the [teamsChannel](/graph/api/resources/planner-overview?view=graph-rest-beta&preserve-view=true#container-type-teams-channel) container type to create plans in shared channels in Microsoft Teams. -- [List Planner plans](/graph/api/teamschannelplanner-list-plans?view=graph-rest-beta&preserve-view=true) owned by a shared channel in Teams. +Use the [teamsChannel](/graph/api/resources/planner-overview?view=graph-rest-beta&preserve-view=true#container-type-teams-channel) container type to create plans in shared channels in Microsoft Teams. ## December 2024: New and generally available