+The following table shows the properties of the [group](../resources/group.md) resource to specify when you create a group in the administrative unit.

+When creating a new group (without `$ref`), this method returns a `201 Created` response code and a [group](../resources/group.md) object in the response body. The response includes only the default properties of the group. You must supply the `"@odata.type" : "#microsoft.graph.group"` line in the request body to explicitly identify the new member as a group. A request body without the correct @odata.type returns a `400 Bad Request` error message.

+The following example creates a new group in the administrative unit. You must supply the `"@odata.type" : "#microsoft.graph.group"` line in the request body to explicitly identify the new member as a group. A request body without the correct @odata.type returns a `400 Bad Request` error message.

+ "@odata.type": "#microsoft.graph.group",

+> [!NOTE]

+> In general, the `id` of a **teamsApp** resource is generated by the server. It is not the same as the `id` specified in a Teams app manifest, unless its `distributionMethod` is *store*. For other cases, the `id` provided by the developer as part of the Teams app manifest is stamped as the `externalId` in the teamsApp resource.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "create-online-meeting-with-passcode"

+}-->

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+ "blockType": "response",

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "create-online-meeting-without-passcode"

+}-->

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+ "blockType": "response",

+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79

+2015-10-25 14:57:30 UTC -->

+<!--

+{

+ "type": "#page.annotation",

+ "description": "Create onlineMeeting",

+ "keywords": "",

+ "section": "documentation",

+ "tocPath": "",

+ "suppressions": [

+ ]

+}

+-->

+ Title: "Get businessScenario"

+description: "Read the properties and relationships of a businessScenario object."

+ms.localizationpriority: medium

+# Get businessScenario

+Namespace: microsoft.graph

+Read the properties and relationships of a [businessScenario](../resources/businessscenario.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.Read.All, BusinessScenarioConfig.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+For a specific business scenario based on its ID (primary key):

+``` http

+GET /solutions/businessScenarios/{businessScenarioId}

+```

+For a specific business scenario based on its unique name:

+``` http

+GET /solutions/businessScenarios(uniqueName='{uniqueName}')

+```

+## 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.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a [businessScenario](../resources/businessscenario.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "get_businessscenario",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d

+```

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.businessScenario"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.businessScenario",

+ "id": "c5d514e6c6864911ac46c720affb6e4d",

+ "displayName": "Contoso Order Tracking",

+ "uniqueName": "com.contoso.apps.ordertracking",

+ "ownerAppIds": [

+ "44109254-4b2b-7a33-76ee-c890a167b295"

+ ]

+}

+```

+ Title: "Update businessScenario"

+description: "Update the properties of a businessScenario object."

+ms.localizationpriority: medium

+# Update businessScenario

+Namespace: microsoft.graph

+Update the properties of a [businessScenario](../resources/businessscenario.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|BusinessScenarioConfig.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+For a specific business scenario based on its ID (primary key):

+``` http

+PATCH /solutions/businessScenarios/{businessScenarioId}

+```

+For a specific business scenario based on its unique name:

+``` http

+PATCH /solutions/businessScenarios(uniqueName='{uniqueName}')

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+|Content-Type|application/json. Required.|

+## Request body

+|Property|Type|Description|

+|:|:|:|

+|displayName|String|Display name of the scenario. Required.|

+|ownerAppIds|String collection|Identifiers of applications that are authorized to work with this scenario. The application that creates the scenario will be automatically added to the list. Optional.|

+## Response

+If successful, this method returns a `200 OK` response code and an updated [businessScenario](../resources/businessscenario.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "update_businessscenario",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]

+}

+-->

+``` http

+PATCH https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d

+Content-Type: application/json

+{

+ "ownerAppIds": [

+ "44109254-4b2b-7a33-76ee-c890a167b295", "13eb9d8b-1d63-4153-9417-3a69ab200a78"

+ ]

+}

+```

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.businessScenario"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.businessScenario",

+ "id": "c5d514e6c6864911ac46c720affb6e4d",

+ "displayName": "Contoso Order Tracking",

+ "uniqueName": "com.contoso.apps.ordertracking",

+ "ownerAppIds": [

+ "44109254-4b2b-7a33-76ee-c890a167b295", "13eb9d8b-1d63-4153-9417-3a69ab200a78"

+ ]

+}

+```

+ Title: "Delete businessScenarioTask"

+description: "Delete a businessScenarioTask object."

+ms.localizationpriority: medium

+# Delete businessScenarioTask

+Namespace: microsoft.graph

+Delete a [businessScenarioTask](../resources/businessscenariotask.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioData.ReadWrite.OwnedBy|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application| BusinessScenarioData.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+DELETE /solutions/businessScenarios/{businessScenarioId}/planner/tasks/{businessScenarioTaskId}

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `204 No Content` response code.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "delete_businessscenariotask",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d", "pmc1rS1Io0C3rXQhyXIsNmUAOeIi"]

+}

+-->

+``` http

+DELETE https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks/pmc1rS1Io0C3rXQhyXIsNmUAOeIi

+```

+### Response

+The following is an example of the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+ Title: "Get businessScenarioPlanner"

+description: "Read the properties and relationships of a businessScenarioPlanner object."

+ms.localizationpriority: medium

+# Get businessScenarioPlanner

+Namespace: microsoft.graph

+Read the properties and relationships of a [businessScenarioPlanner](../resources/businessscenarioplanner.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.Read.All, BusinessScenarioConfig.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /solutions/businessScenarios/{businessScenarioId}/planner

+```

+## 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.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a [businessScenarioPlanner](../resources/businessscenarioplanner.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "get_businessscenarioplanner",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner

+```

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.businessScenarioPlanner"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.businessScenarioPlanner",

+ "id": "54379e10-f935-5776-7a30-445837f15655"

+}

+```

+ Title: "businessScenarioPlanner: getPlan"

+description: "Get information about the plannerPlan mapped to a given target."

+ms.localizationpriority: medium

+# businessScenarioPlanner: getPlan

+Namespace: microsoft.graph

+Get information about the [plannerPlan](../resources/plannerplan.md) mapped to a given target. If a **plannerPlan** doesn't exist for the specified target at the time of the request, a new plan will be created for the [businessScenario](../resources/businessscenario.md).

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioData.Read.OwnedBy, BusinessScenarioData.ReadWrite.OwnedBy|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|BusinessScenarioData.Read.OwnedBy, BusinessScenarioData.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /solutions/businessScenarios/{businessScenarioId}/planner/getPlan

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+|Content-Type|application/json. Required.|

+## Request body

+In the request body, supply a JSON representation of the parameters.

+The following table shows the parameter that can be used with this action.

+|Parameter|Type|Description|

+|:|:|:|

+|target|[businessScenarioTaskTargetBase](../resources/businessscenariotasktargetbase.md)|Target for which to get the plan information.|

+## Response

+If successful, this action returns a `200 OK` response code and a [businessScenarioPlanReference](../resources/businessscenarioplanreference.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "businessscenarioplannerthis.getplan",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]

+}

+-->

+``` http

+POST https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/getPlan

+Content-Type: application/json

+{

+ "target": {

+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget",

+ "taskTargetKind": "group",

+ "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"

+ }

+}

+```

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.businessScenarioPlanReference"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.businessScenarioPlanReference",

+ "id": "pmc1rS1Io0C3rXQhyXIsNmUAOeIi",

+ "title": "Order Tracking"

+}

+```

+ Title: "List businessScenarioTasks"

+description: "Get a list of the businessScenarioTask objects and their properties."

+ms.localizationpriority: medium

+# List businessScenarioTasks

+Namespace: microsoft.graph

+Get a list of the [businessScenarioTask](../resources/businessscenariotask.md) objects and their properties.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioData.Read.OwnedBy, BusinessScenarioData.ReadWrite.OwnedBy|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|BusinessScenarioData.Read.OwnedBy, BusinessScenarioData.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /solutions/businessScenarios/{businessScenarioId}/planner/tasks

+```

+## 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). You can query tasks with their context ID or location as filters.

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a collection of [businessScenarioTask](../resources/businessscenariotask.md) objects in the response body.

+## Examples

+### Example 1: Get all tasks for a scenario

+The following example shows a request that gets all tasks related to a scenario.

+#### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "list_businessscenariotask",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks

+```

+#### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "Collection(microsoft.graph.businessScenarioTask)"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "value": [

+ {

+ "@odata.type": "#microsoft.graph.businessScenarioTask",

+ "title": "Customer order #12010",

+ "percentComplete": 0,

+ "priority": 5,

+ "id": "pmc1rS1Io0C3rXQhyXIsNmUAOeIi",

+ "target": {

+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget",

+ "taskTargetKind": "group",

+ "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"

+ },

+ "businessScenarioProperties": {

+ "externalObjectId": "Order#12010",

+ "externalContextId": "Warehouse-CA-36",

+ "externalObjectVersion": "000001",

+ "webUrl": "https://ordertracking.contoso.com/view?id=12010",

+ "externalBucketId": "deliveryBucket"

+ }

+ }

+ ]

+}

+```

+### Example 2: Get tasks associated with a specific externalContextId

+The following example shows a request that gets all tasks associated with a specific context.

+#### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "list_businessscenariotask",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks?$filter=businessScenarioProperties/externalContextId eq 'Warehouse-CA-36'

+```

+#### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "Collection(microsoft.graph.businessScenarioTask)"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "value": [

+ {

+ "@odata.type": "#microsoft.graph.businessScenarioTask",

+ "title": "Customer order #12010",

+ "percentComplete": 0,

+ "priority": 5,

+ "id": "pmc1rS1Io0C3rXQhyXIsNmUAOeIi",

+ "target": {

+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget",

+ "taskTargetKind": "group",

+ "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"

+ },

+ "businessScenarioProperties": {

+ "externalObjectId": "Order#12010",

+ "externalContextId": "Warehouse-CA-36",

+ "externalObjectVersion": "000001",

+ "webUrl": "https://ordertracking.contoso.com/view?id=12010",

+ "externalBucketId": "deliveryBucket"

+ }

+ }

+ ]

+}

+```

+### Example 3: Get scenario tasks created in a specific group

+The following example shows a request that gets all tasks created in a specific [group](../resources/group.md).

+#### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "list_businessscenariotask",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks?$filter=location/microsoft.graph.businessScenarioGroupTarget/groupId eq '7a339254-4b2b-4410-b295-c890a16776ee'

+```

+#### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "Collection(microsoft.graph.businessScenarioTask)"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "value": [

+ {

+ "@odata.type": "#microsoft.graph.businessScenarioTask",

+ "title": "Customer order #12010",

+ "percentComplete": 0,

+ "priority": 5,

+ "id": "pmc1rS1Io0C3rXQhyXIsNmUAOeIi",

+ "target": {

+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget",

+ "taskTargetKind": "group",

+ "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"

+ },

+ "businessScenarioProperties": {

+ "externalObjectId": "Order#12010",

+ "externalContextId": "Warehouse-CA-36",

+ "externalObjectVersion": "000001",

+ "webUrl": "https://ordertracking.contoso.com/view?id=12010",

+ "externalBucketId": "deliveryBucket"

+ }

+ }

+ ]

+}

+```

+ Title: "Create businessScenarioTask"

+description: "Create a new businessScenarioTask object."

+ms.localizationpriority: medium

+# Create businessScenarioTask

+Namespace: microsoft.graph

+Create a new [businessScenarioTask](../resources/businessscenariotask.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioData.ReadWrite.OwnedBy|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application| BusinessScenarioData.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /solutions/businessScenarios/{businessScenarioId}/planner/tasks

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+|Content-Type|application/json. Required.|

+## Request body

+In the request body, supply a JSON representation of the [businessScenarioTask](../resources/businessscenariotask.md) object.

+You can specify the following properties when you create a **businessScenarioTask**.

+|Property|Type|Description|

+|:|:|:|

+|appliedCategories|[plannerAppliedCategories](../resources/plannerappliedcategories.md)|The categories to which the task has been applied. For possible values, see [plannerAppliedCategories](../resources/plannerappliedcategories.md). Inherited from [plannerTask](../resources/plannertask.md).|

+|assigneePriority|String|Hint used to order items of this type in a list view. For details about the supported format, see [Using order hints in Planner](../resources/planner-order-hint-format.md). Inherited from [plannerTask](../resources/plannertask.md).|

+|assignments|[plannerAssignments](../resources/plannerassignments.md)|The set of assignees the task is assigned to. Inherited from [plannerTask](../resources/plannertask.md).|

+|bucketId|String|Bucket ID to which the task belongs. The bucket needs to be in the plan that the task is in. It is 28 characters long and case-sensitive. The [format validation](../resources/tasks-identifiers-disclaimer.md) is done on the service. Inherited from [plannerTask](../resources/plannertask.md).|

+|businessScenarioProperties|[businessScenarioProperties](../resources/businessscenarioproperties.md)|Scenario-specific properties of the task. **externalObjectId** and **externalBucketId** properties must be specified when creating a task. Required.|

+|conversationThreadId|String|Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the **group**. Inherited from [plannerTask](../resources/plannertask.md).|

+|dueDateTime|DateTimeOffset|Date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [plannerTask](../resources/plannertask.md).|

+|orderHint|String|Hint used to order items of this type in a list view. For details about the supported format, see [Using order hints in Planner](../resources/planner-order-hint-format.md). Inherited from [plannerTask](../resources/plannertask.md).|

+|percentComplete|Int32|Percentage of task completion. When set to `100`, the task is considered completed. Inherited from [plannerTask](../resources/plannertask.md).|

+|planId|String|Identifier of the plan to which the task belongs. Inherited from [plannerTask](../resources/plannertask.md).|

+|priority|Int32|Priority of the task. Valid range of values is between `0` and `10` (inclusive), with increasing value being lower priority (`0` has the highest priority and `10` has the lowest priority). Currently, Planner interprets values `0` and `1` as "urgent", `2`, `3`, and `4` as "important", `5`, `6`, and `7` as "medium", and `8`, `9`, and `10` as "low". Currently, Planner sets the value `1` for "urgent", `3` for "important", `5` for "medium", and `9` for "low". Inherited from [plannerTask](../resources/plannertask.md).|

+|startDateTime|DateTimeOffset|Date and time at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [plannerTask](../resources/plannertask.md).|

+|target|[businessScenarioTaskTargetBase](../resources/businessscenariotasktargetbase.md)|Target of the task that specifies where the task should be placed. Required.|

+|title|String|Title of the task. Inherited from [plannerTask](../resources/plannertask.md).|

+## Response

+If successful, this method returns a `201 Created` response code and a [businessScenarioTask](../resources/businessscenariotask.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "create_businessscenariotask_from_",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]

+}

+-->

+``` http

+POST https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.businessScenarioTask",

+ "title": "Customer order #12010",

+ "percentComplete": 0,

+ "priority": 5,

+ "target": {

+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget",

+ "taskTargetKind": "group",

+ "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"

+ },

+ "businessScenarioProperties": {

+ "externalObjectId": "Order#12010",

+ "externalContextId": "Warehouse-CA-36",

+ "externalObjectVersion": "000001",

+ "webUrl": "https://ordertracking.contoso.com/view?id=12010",

+ "externalBucketId": "deliveryBucket"

+ }

+}

+```

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.businessScenarioTask"

+}

+-->

+``` http

+HTTP/1.1 201 Created

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.businessScenarioTask",

+ "title": "Customer order #12010",

+ "percentComplete": 0,

+ "priority": 5,

+ "id": "pmc1rS1Io0C3rXQhyXIsNmUAOeIi",

+ "target": {

+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget",

+ "taskTargetKind": "group",

+ "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"

+ },

+ "businessScenarioProperties": {

+ "externalObjectId": "Order#12010",

+ "externalContextId": "Warehouse-CA-36",

+ "externalObjectVersion": "000001",

+ "webUrl": "https://ordertracking.contoso.com/view?id=12010",

+ "externalBucketId": "deliveryBucket"

+ }

+}

+```

+ Title: "Get businessScenarioTask"

+description: "Read the properties and relationships of a businessScenarioTask object."

+ms.localizationpriority: medium

+# Get businessScenarioTask

+Namespace: microsoft.graph

+Read the properties and relationships of a [businessScenarioTask](../resources/businessscenariotask.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioData.Read.OwnedBy, BusinessScenarioData.ReadWrite.OwnedBy|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|BusinessScenarioData.Read.OwnedBy, BusinessScenarioData.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /solutions/businessScenarios/{businessScenarioId}/planner/tasks/{businessScenarioTaskId}

+```

+## 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.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a [businessScenarioTask](../resources/businessscenariotask.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "get_businessscenariotask",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d", "pmc1rS1Io0C3rXQhyXIsNmUAOeIi"]

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks/pmc1rS1Io0C3rXQhyXIsNmUAOeIi

+```

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.businessScenarioTask"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "title": "Customer order #12010",

+ "percentComplete": 0,

+ "priority": 5,

+ "id": "pmc1rS1Io0C3rXQhyXIsNmUAOeIi",

+ "target": {

+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget",

+ "taskTargetKind": "group",

+ "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"

+ },

+ "businessScenarioProperties": {

+ "externalObjectId": "Order#12010",

+ "externalContextId": "Warehouse-CA-36",

+ "externalObjectVersion": "000001",

+ "webUrl": "https://ordertracking.contoso.com/view?id=12010",

+ "externalBucketId": "deliveryBucket"

+ }

+}

+```

+ Title: "Update businessScenarioTask"

+description: "Update the properties of a businessScenarioTask object."

+ms.localizationpriority: medium

+# Update businessScenarioTask

+Namespace: microsoft.graph

+Update the properties of a [businessScenarioTask](../resources/businessscenariotask.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioData.ReadWrite.OwnedBy|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application| BusinessScenarioData.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+PATCH /solutions/businessScenarios/{businessScenarioId}/planner/tasks/{businessScenarioTaskId}

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+|Content-Type|application/json. Required.|

+## Request body

+|Property|Type|Description|

+|:|:|:|

+|appliedCategories|[plannerAppliedCategories](../resources/plannerappliedcategories.md)|The categories to which the task has been applied. For possible values, see [plannerAppliedCategories](../resources/plannerappliedcategories.md). Inherited from [plannerTask](../resources/plannertask.md).|

+|assigneePriority|String|Hint used to order items of this type in a list view. For details about the supported format, see [Using order hints in Planner](../resources/planner-order-hint-format.md). Inherited from [plannerTask](../resources/plannertask.md).|

+|assignments|[plannerAssignments](../resources/plannerassignments.md)|The set of assignees the task is assigned to. Inherited from [plannerTask](../resources/plannertask.md).|

+|bucketId|String|Bucket ID to which the task belongs. The bucket needs to be in the plan that the task is in. It is 28 characters long and case-sensitive. The [format validation](../resources/tasks-identifiers-disclaimer.md) is done on the service. Inherited from [plannerTask](../resources/plannertask.md). |

+|businessScenarioProperties|[businessScenarioProperties](../resources/businessscenarioproperties.md)|Scenario-specific properties of the task. Optional.|

+|conversationThreadId|String|Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the **group**. Inherited from [plannerTask](../resources/plannertask.md).|

+|dueDateTime|DateTimeOffset|Date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [plannerTask](../resources/plannertask.md).|

+|orderHint|String|Hint used to order items of this type in a list view. For details about the supported format, see [Using order hints in Planner](../resources/planner-order-hint-format.md). Inherited from [plannerTask](../resources/plannertask.md).|

+|percentComplete|Int32|Percentage of task completion. When set to `100`, the task is considered completed. Inherited from [plannerTask](../resources/plannertask.md). |

+|planId|String|Identifier of the plan to which the task belongs. Inherited from [plannerTask](../resources/plannertask.md).|

+|priority|Int32|Priority of the task. Valid range of values is between `0` and `10` (inclusive), with increasing value being lower priority (`0` has the highest priority and `10` has the lowest priority). Currently, Planner interprets values `0` and `1` as "urgent", `2`, `3`, and `4` as "important", `5`, `6`, and `7` as "medium", and `8`, `9`, and `10` as "low". Currently, Planner sets the value `1` for "urgent", `3` for "important", `5` for "medium", and `9` for "low". Inherited from [plannerTask](../resources/plannertask.md).|

+|startDateTime|DateTimeOffset|Date and time at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [plannerTask](../resources/plannertask.md).|

+|target|[businessScenarioTaskTargetBase](../resources/businessscenariotasktargetbase.md)|Target of the task that specifies where the task should be placed. Optional.|

+|title|String|Title of the task. Inherited from [plannerTask](../resources/plannertask.md).|

+## Response

+If successful, this method returns a `200 OK` response code and an updated [businessScenarioTask](../resources/businessscenariotask.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "update_businessscenariotask",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d", "pmc1rS1Io0C3rXQhyXIsNmUAOeIi"]

+}

+-->

+``` http

+PATCH https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks/pmc1rS1Io0C3rXQhyXIsNmUAOeIi

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.businessScenarioTask",

+ "title": "Customer order #12010",

+ "percentComplete": 20,

+ "priority": 1,

+ "businessScenarioProperties": {

+ "externalObjectVersion": "000003"

+ }

+}

+```

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.businessScenarioTask"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.businessScenarioTask",

+ "title": "Customer order #12010",

+ "percentComplete": 20,

+ "priority": 1,

+ "id": "pmc1rS1Io0C3rXQhyXIsNmUAOeIi",

+ "target": {

+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget",

+ "taskTargetKind": "group",

+ "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"

+ },

+ "businessScenarioProperties": {

+ "externalObjectId": "Order#12010",

+ "externalContextId": "Warehouse-CA-36",

+ "externalObjectVersion": "000003",

+ "webUrl": "https://ordertracking.contoso.com/view?id=12010",

+ "externalBucketId": "deliveryBucket"

+ }

+}

+```

+## See also

+* [Update the task details associated with a scenario task](plannertaskdetails-update.md).

+For delegated scenarios, the calling user must have the *Global Administrator* [Azure AD role](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles).

+> [!NOTE]

+> Some special characters in the channel name will cause this API to return an error. For details, see [Known issues](/graph/known-issues#create-channel).

+This method supports the `$filter` and `$select` [OData query parameters](/graph/query-parameters) to help customize the response.

+>**Note:** Guest users can't see private or shared channels that they aren't members of in the response for this API.

+This method supports the `$filter` and `$select` [OData query parameters](/graph/query-parameters) to help customize the response.

+| Application | Teamwork.Migrate.All |

+Create a new [channel](../resources/channel.md) in a team, as specified in the request body. When you create a channel, the maximum length of the channel's `displayName` is 50 characters. This is the name that appears to the user in Microsoft Teams.

+You can add a maximum of 200 members when you create a private channel.

+> [!NOTE]

+> Some special characters in the channel name will cause the [Get filesFolder](/graph/api/channel-get-filesfolder) API to return an error. For details, see [Known issues](/graph/known-issues#create-channel).

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+ Title: "cloudPcReports: getSharedUseLicenseUsageReport"

+description: "Get the shared use license usage reports, such as servicePlanId, licenseCount, and claimedLicenseCount, for real-time, 7 days, or 28 days trend."

+ms.localizationpriority: medium

+# cloudPcReports: getSharedUseLicenseUsageReport

+Namespace: microsoft.graph

+Get the shared use license usage reports, such as **servicePlanId**, **licenseCount**, and **claimedLicenseCount**, for real-time, 7 days, or 28 days trend.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+| Permission type | Permissions (from least to most privileged) |

+| :- | : |

+| Delegated (work or school account) | CloudPC.Read.All, CloudPC.ReadWrite.All |

+| Delegated (personal Microsoft account) | Not supported. |

+| Application | CloudPC.Read.All, CloudPC.ReadWrite.All |

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /deviceManagement/virtualEndpoint/reports/getSharedUseLicenseUsageReport

+```

+## Request headers

+| Name | Description |

+| : | :-- |

+| Authorization | Bearer {token}. Required. |

+| Content-Type | application/json. Required. |

+## Request body

+In the request body, supply a JSON representation of the parameters.

+The following table shows the parameters that can be used with this action.

+| Parameter | Type | Description |

+| : | :- | :- |

+| reportName | String | Specifies the report name. |

+| filter | String | OData filter syntax. Supported filters include `and`, `or`, `lt`, `le`, `gt`, `ge`, and `eq`. |

+| select | String collection | OData select syntax. Represents the selected columns of the reports. |

+| search | String | Specifies a string to search. |

+| groupBy | String collection | Specifies how to group the reports. If used, must have the same content as the **select** parameter. |

+| orderBy | String collection | Specifies how to sort the reports. |

+| skip | Int32 | The number of records to skip. |

+| top | Int32 | The number of top records to return. |

+## Response

+If successful, this action returns a `200 OK` response code and a Stream in the response body.

+## Examples

+### Request

+The following is an example of a request.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "cloudpcreportsthis.getSharedUseLicenseUsageReport"

+}

+-->

+``` http

+POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/getSharedUseLicenseUsageReport

+Content-Type: application/json

+Content-length: 199

+{

+ "reportName": "SharedUseLicenseUsageReport",

+ "filter": "ServicePlanId eq '2d1d344e-d10c-41bb-953b-b3a47521dca0' and DateTimeUTC gt datetime'2022-11-30'",

+ "select":["ServicePlanId", "LicenseCount", "ClaimedLicenseCount", "DateTimeUTC"],

+ "skip": 0,

+ "top": 100

+}

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+### Response

+The following is an example of the response

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "Edm.Stream"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/octet-stream

+{

+ "TotalRowCount": 2,

+ "Schema": [

+ {

+ "name": "ServicePlanId",

+ "type": "String"

+ },

+ {

+ "name": "LicenseCount",

+ "type": "Int32"

+ },

+ {

+ "name": "ClaimedLicenseCount",

+ "type": "Int32"

+ },

+ {

+ "name": "DateTimeUTC",

+ "type": "DateTime"

+ }

+ ],

+ "Values": [

+ [

+ "2d1d344e-d10c-41bb-953b-b3a47521dca0", 100, 10, "2022-12-02T00:00:00"

+ ],

+ [

+ "2d1d344e-d10c-41bb-953b-b3a47521dca0", 100, 11, "2022-12-01T00:00:00"

+ ]

+ ]

+}

+```

+Get a list of all notifications that one or more users can access, from the Microsoft Endpoint Manager admin center.

+Set the status of the specified notification on the Microsoft EndPoint Manager admin center as sent, by modifying the **isPortalNotificationSent** property to `true`.

+ Title: "Delete customers"

+description: "Delete a customers object from Dynamics 365 Business Central."

+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.

+### Request

+The following is an example of the request.

+### Response

+The following is an example of the response.

+This method does not delete the rubric itself and can only be performed by teachers.

+Get the [educationRubric](../resources/educationrubric.md) object attached to an [educationAssignment](../resources/educationassignment.md), if one exists. Only teachers, students, and applications with application permissions can perform this operation.

+Get the properties and relationships of an [assignment](../resources/educationassignment.md). Only teachers, students, and applications with application permissions can perform this operation.

+List all the categories associated with an [assignment](../resources/educationassignment.md). Only teachers, students, and applications with application permissions can perform this operation.

+Get all the [educationAssignmentResource](../resources/educationassignmentresource.md) objects associated with an [assignment](../resources/educationassignment.md). Only teachers, students, and applications with application permissions can perform this operation.

+List all the [submissions](../resources/educationsubmission.md) associated with an [assignment](../resources/educationassignment.md). Only teachers, students, and applications with application permissions can perform this operation.

+Add one or more existing [educationCategory](../resources/educationcategory.md) objects to this [educationAssignment](../resources/educationassignment.md). Only teachers and students can perform this operation.

+Create an [assignment resource](../resources/educationassignmentresource.md). Only teachers can perform this operation.

+You can create the following types of assignment resources:

+Every resource has an **@odata.type** property to indicate which type of resource is being created.

+ "@odata.type": "microsoft.graph.educationTeamsAppResource"

+Attach an existing [educationRubric](../resources/educationrubric.md) object to an [educationAssignment](../resources/educationassignment.md). Only teachers can perform this operation.

+Remove an [educationCategory](../resources/educationcategory.md) from an [educationAssignment](../resources/educationassignment.md). Only teachers can perform this operation.

+Create a SharePoint folder to upload feedback files for a given [educationSubmission](../resources/educationsubmission.md). Only teachers can perform this operation.

+Create a SharePoint folder to upload files for a given [educationAssignment](../resources/educationassignment.md). Only teachers can perform this operation.

+The teacher determines the resources to upload in the assignment's folder.

+These are the class-level assignment defaults respected by new [assignments](../resources/educationassignment.md) created in the class. Callers can continue to specify custom values on each **assignment** creation if they don't want the default behaviors. Only teachers can perform this operation.

+Get the properties of an [education assignment resource](../resources/educationassignmentresource.md) associated with an [assignment](../resources/educationassignment.md). Only teachers, students, and applications with application permissions can perform this operation.

+Read the properties and relationships of an [educationAssignmentSettings](../resources/educationassignmentsettings.md) object. Only teachers can perform this operation.

+Delete an existing category. Only teachers can perform this operation.

+Retrieve an [educationCategory](../resources/educationcategory.md) object. Only teachers, students, and applications with application permissions can perform this operation.

+Retrieve a list of assignment objects. Only teachers, students, and applications with application permissions can perform this operation.

+Retrieve a list of [educationCategory](../resources/educationcategory.md) objects. Only teachers can perform this operation.

+Create a new assignment.

+Creates a new [educationCategory](../resources/educationcategory.md) on an [educationClass](../resources/educationclass.md). Only teachers can perform this operation.

+Update the properties of an [educationOutcome](../resources/educationoutcome.md) object. Only teachers can perform this operation.

+Delete an [educationRubric](../resources/educationrubric.md) object. Only teachers can perform this operation.

+Retrieve the properties and relationships of an [educationRubric](../resources/educationrubric.md) object. Only teachers and students can perform this operation.

+Update the properties of an [educationRubric](../resources/educationrubric.md) object. Only teachers can perform this operation.

+Retrieve a particular [submission](../resources/educationsubmission.md). Only teachers, students, and applications with application permissions can perform this operation.

+Retrieve a list of [educationOutcome](../resources/educationoutcome.md) objects. There are four types of outcomes: **educationPointsOutcome**, **educationFeedbackOutcome**, **educationRubricOutcome**, and **educationFeedbackResourceOutcome**. Only teachers, students, and applications with application permissions can perform this operation.

+List the resources associated with a submission. Only teachers, students, and applications with application permissions can perform this operation.

+List the [educationSubmissionResource](../resources/educationsubmissionresource.md) objects that have officially been submitted for grading. Only teachers, students, and applications with application permissions can perform this operation.

+The student who owns the submission cannot change the submitted list without resubmitting the assignment. This is a wrapper around the real resource and can contain a pointer back to the actual assignment resource if this resource was copied from the assignment.

+Only teachers and students can perform this operation.

+The operation will not succeed if the **allowStudentsToAddResources** flag is not set to `true`.

+Trigger the creation of the SharePoint resource folder where all file-based resources (Word, Excel, and so on) should be uploaded for a given submission. Only teachers and students can perform this operation.

+Indicate that a student is done with the work and is ready to hand in the assignment. Only teachers, students, and applications with application permissions can perform this operation.

+Indicate that a student wants to work on the submitted assignment after it was turned in. Only teachers, students, and applications with application permissions can perform this operation.

+Delete an [educationSubmissionResource](../resources/educationsubmissionresource.md) from the submission. Only teachers and students can perform this operation.

+If the resource was copied from the assignment, a new copy of the resource will be created after the current copy is deleted. This allows you to "reset" the resource to its original state. If the resource was not copied from the assignment but was added from the student, the resource is simply deleted.

+Retrieve the properties of a specific resource associated with a [submission](../resources/educationsubmissionresource.md). Only teachers, students, and applications with application permissions can perform this operation.

+Retrieve a [submitted resource](../resources/educationsubmissionresource.md). Only teachers, students, and applications with application permissions can perform this operation.

+Returns a list of assignments assigned to a user for all classes. Only teachers, students, and applications with application permissions can perform this operation.

+ "includeTargets": [],

+ "excludeTargets": []

+In the following example, the pre-defined **customAccessPackageWorkflowExtension** object is triggered when an access package assigned request is created and when it's granted. The identifier provided within the **customExtension** field is the **customAccessPackageWorkflowExtension** object's ID.

+ "id": "219f57b6-7983-45a1-be01-2c228b7a43f8"

+ ],

+ "excludeTargets": []

+An attempt to filter by an OData cast that represents an unsupported member type returns a `400 Bad Request` error with the `Request_UnsupportedQuery` code.

+An attempt to filter by an OData cast that represents an unsupported member type returns a `400 Bad Request` error with the `Request_UnsupportedQuery` code. For example, `/groups/{id}}/members/microsoft.graph.group` when the group is a Microsoft 365 group will return this error, because Microsoft 365 groups cannot have other groups as members.

+Get a list of the group's members. A group can different object types as members. For more information about supported member types for different groups, see [Group membership](../resources/groups-overview.md#group-membership).

+This operation is transitive and returns a flat list of all nested members. An attempt to filter by an OData cast that represents an unsupported member type returns a `400 Bad Request` error with the `Request_UnsupportedQuery` code.

+ An attempt to filter by an OData cast that represents an unsupported member type returns a `400 Bad Request` error with the `Request_UnsupportedQuery` code. For example, `/groups/{id}}/transitiveMembers/microsoft.graph.group` when the group is a Microsoft 365 group will return this error, because Microsoft 365 groups cannot have other groups as members.

+ "blockType": "response"

+A group with **isAssignableToRole** property set to `true` cannot be of dynamic membership type, its **securityEnabled** must be set to `true`, and **visibility** can only be `Private`.

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+|displayName|String|A unique string that identifies the `customTaskExtension`.|

+>- The **attendanceRecords** property does not return information about a breakout room.

+ "excludeTargets": [],

+ "isSoftwareOathEnabled": true,

+You can retrieve meeting information via JoinWebUrl by using either a user or application token. This option is available to support use cases where the meeting ID isn't known but the JoinWebUrl is, such as when a user creates a meeting (for example in the Microsoft Teams client), and a separate application needs to retrieve meeting details as a follow-up action.

+The following is an example of a request that uses a user (delegated) token.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "get-an-online-meeting-by-joinmeetingid"

+} -->

+```msgraph-interactive

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+> **Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.onlineMeeting"

+} -->

+```http

+HTTP/1.1 200 OK

+Content-Type: application/json

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+POST /users/{userId|userPrincipalName}/contacts/{contactId}/extensions

+| Delegated (work or school account) | Tasks.ReadWrite, Group.ReadWrite.All |

+The following table shows the properties that are required when you create a [plannerPlan](../resources/plannerplan.md).

+|Property|Type|Description|

+|:|:|:|

+|container|[plannerPlanContainer](../resources/plannerplancontainer.md)|Identifies the container of the plan. Specify only the **url**, the **containerId** and **type**, or all properties. After it is set, this property canΓÇÖt be updated.|

+|title|String|The title of the plan.|

+If successful, this method returns a `201 Created` response code and a [plannerPlan](../resources/plannerplan.md) object 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 400, 403, and 404 responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions).

+The following is an example of the request.

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+If successful, this method returns a `200 OK` response code and a [plannerAssignedToTaskBoardTaskFormat](../resources/plannerassignedtotaskboardtaskformat.md) object in the response body.

+### Request

+The following is an example of the request.

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+ Title: "Delete plannerPlanConfigurationLocalization"

+description: "Delete a plannerPlanConfigurationLocalization object."

+ms.localizationpriority: medium

+# Delete plannerPlanConfigurationLocalization

+Namespace: microsoft.graph

+Delete a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application| BusinessScenarioConfig.ReadWrite.OwnedBy |

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+For a specific localization based on a business scenario ID and a localization ID:

+``` http

+DELETE /solutions/businessScenarios/{businessScenarioId}/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId}

+```

+For a specific localization based on the unique name of a business scenario and a localization ID:

+``` http

+DELETE /solutions/businessScenarios(uniqueName='{uniqueName}')/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId}

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `204 No Content` response code.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "delete_plannerplanconfigurationlocalization",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d", "en-us"]

+}

+-->

+``` http

+DELETE https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/planConfiguration/localizations/en-us

+```

+### Response

+The following is an example of the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+ Title: "Get plannerPlanConfiguration"

+description: "Read the properties and relationships of a plannerPlanConfiguration object."

+ms.localizationpriority: medium

+# Get plannerPlanConfiguration

+Namespace: microsoft.graph

+Read the properties and relationships of a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.Read.All, BusinessScenarioConfig.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /solutions/businessScenarios/{businessScenarioId}/planner/planConfiguration

+```

+## 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.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "get_plannerplanconfiguration",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/planConfiguration

+```

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.plannerPlanConfiguration"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.plannerPlanConfiguration",

+ "id": "afdd911ee3db44b69cc28373a6192e94",

+ "defaultLanguage": "en-us",

+ "buckets": [

+ {

+ "externalBucketId": "deliveryBucket"

+ },

+ {

+ "externalBucketId": "storePickupBucket"

+ },

+ {

+ "externalBucketId": "specialOrdersBucket"

+ },

+ {

+ "externalBucketId": "returnProcessingBucket"

+ }

+ ]

+}

+```

+ Title: "List plannerPlanConfigurationLocalizations"

+description: "Get a list of the plannerPlanConfigurationLocalization objects and their properties."

+ms.localizationpriority: medium

+# List plannerPlanConfigurationLocalizations

+Namespace: microsoft.graph

+Get a list of the [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) objects and their properties.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.Read.All, BusinessScenarioConfig.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+For localizations based on a business scenario ID:

+``` http

+GET /solutions/businessScenarios/{businessScenarioId}/planner/planConfiguration/localizations

+```

+For localizations based on the unique name of a business scenario:

+``` http

+GET /solutions/businessScenarios(uniqueName='{uniqueName}')/planner/planConfiguration/localizations

+```

+## 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.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a collection of [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) objects in the response body.

+## Examples

+### Example 1: Get all localizations

+The following example shows a request that gets all localized names for a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md).

+#### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "list_plannerplanconfigurationlocalization",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/planConfiguration/localizations

+```

+#### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "Collection(microsoft.graph.plannerPlanConfigurationLocalization)"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "value": [

+ {

+ "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization",

+ "id": "en-us",

+ "languageTag": "en-us",

+ "planTitle": "Order Tracking",

+ "buckets": [

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "deliveryBucket",

+ "name": "Deliveries"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "storePickupBucket",

+ "name": "Pickup"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "specialOrdersBucket",

+ "name": "Special Orders"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "returnProcessingBucket",

+ "name": "Customer Returns"

+ }

+ ]

+ },

+ {

+ "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization",

+ "id": "pt-br",

+ "languageTag": "pt-br",

+ "planTitle": "Acompanhamento de pedidos",

+ "buckets": [

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "deliveryBucket",

+ "name": "Entregas"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "storePickupBucket",

+ "name": "Retirada na loja"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "specialOrdersBucket",

+ "name": "Pedidos especiais"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "returnProcessingBucket",

+ "name": "Devoluções"

+ }

+ ]

+ }

+ ]

+}

+```

+### Example 2: Get localization for a specific language tag

+The following example shows a request that gets all localized names for a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) for a specific language.

+#### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "list_plannerplanconfigurationlocalization",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/planConfiguration/localizations?$filter=languageTag eq 'en-us'

+```

+#### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "Collection(microsoft.graph.plannerPlanConfigurationLocalization)"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "value": [

+ {

+ "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization",

+ "id": "en-us",

+ "languageTag": "en-us",

+ "planTitle": "Order Tracking",

+ "buckets": [

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "deliveryBucket",

+ "name": "Deliveries"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "storePickupBucket",

+ "name": "Pickup"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "specialOrdersBucket",

+ "name": "Special Orders"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "returnProcessingBucket",

+ "name": "Customer Returns"

+ }

+ ]

+ }

+ ]

+}

+```

+ Title: "Create plannerPlanConfigurationLocalization"

+description: "Create a new plannerPlanConfigurationLocalization object."

+ms.localizationpriority: medium

+# Create plannerPlanConfigurationLocalization

+Namespace: microsoft.graph

+Create a new [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application| BusinessScenarioConfig.ReadWrite.OwnedBy |

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+For a specific localization based on a business scenario ID:

+``` http

+POST /solutions/businessScenarios/{businessScenarioId}/planner/planConfiguration/localizations

+```

+For a specific localization based on the unique name of a business scenario:

+``` http

+POST /solutions/businessScenarios(uniqueName='{uniqueName}')/planner/planConfiguration/localizations

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+|Content-Type|application/json. Required.|

+## Request body

+In the request body, supply a JSON representation of the [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.

+You can specify the following properties when you create a **plannerPlanConfigurationLocalization**.

+|Property|Type|Description|

+|:|:|:|

+|buckets|[plannerPlanConfigurationBucketLocalization](../resources/plannerplanconfigurationbucketlocalization.md) collection|Localizations for buckets specified in the [plannerPlanConfiguration](../resources/plannerplanconfiguration.md). Required.|

+|languageTag|String|The code for the language the localized data is intended for. Required.|

+|planTitle|String|Localized title of the plan. Required.|

+## Response

+If successful, this method returns a `201 Created` response code and a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "create_plannerplanconfigurationlocalization_from_",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]

+}

+-->

+``` http

+POST https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/planConfiguration/localizations

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization",

+ "languageTag": "en-us",

+ "planTitle": "Order Tracking",

+ "buckets": [

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "deliveryBucket",

+ "name": "Deliveries"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "storePickupBucket",

+ "name": "Pickup"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "specialOrdersBucket",

+ "name": "Special Orders"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "returnProcessingBucket",

+ "name": "Customer Returns"

+ }

+ ]

+}

+```

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationLocalization"

+}

+-->

+``` http

+HTTP/1.1 201 Created

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization",

+ "id": "en-us",

+ "languageTag": "en-us",

+ "planTitle": "Order Tracking",

+ "buckets": [

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "deliveryBucket",

+ "name": "Deliveries"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "storePickupBucket",

+ "name": "Pickup"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "specialOrdersBucket",

+ "name": "Special Orders"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "returnProcessingBucket",

+ "name": "Customer Returns"

+ }

+ ]

+}

+```

+ Title: "Update plannerPlanConfiguration"

+description: "Update the properties of a plannerPlanConfiguration object for a businessScenario."

+ms.localizationpriority: medium

+# Update plannerPlanConfiguration

+Namespace: microsoft.graph

+Update the properties of a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) object for a [businessScenario](../resources/businessscenario.md).

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|BusinessScenarioConfig.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+For the plan configuration based on a business scenario ID:

+``` http

+PATCH /solutions/businessScenarios/{businessScenarioId}/planner/planConfiguration

+```

+For the plan configuration based on the unique name of a business scenario:

+``` http

+PATCH /solutions/businessScenarios(uniqueName='{uniqueName}')/planner/planConfiguration

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+|Content-Type|application/json. Required.|

+## Request body

+|Property|Type|Description|

+|:|:|:|

+|defaultLanguage|String|The language that should be used for creating plans when no language has been specified. Required.|

+|buckets|[plannerPlanConfigurationBucketDefinition](../resources/plannerplanconfigurationbucketdefinition.md) collection|Buckets that will be available in the plan. Required.|

+## Response

+If successful, this method returns a `200 OK` response code and an updated [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "update_plannerplanconfiguration",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]

+}

+-->

+``` http

+PATCH https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/planConfiguration

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.plannerPlanConfiguration",

+ "defaultLanguage": "en-us",

+ "buckets": [

+ {

+ "externalBucketId": "deliveryBucket"

+ },

+ {

+ "externalBucketId": "storePickupBucket"

+ },

+ {

+ "externalBucketId": "specialOrdersBucket"

+ },

+ {

+ "externalBucketId": "returnProcessingBucket"

+ }

+ ]

+}

+```

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.plannerPlanConfiguration"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.plannerPlanConfiguration",

+ "id": "afdd911ee3db44b69cc28373a6192e94",

+ "defaultLanguage": "en-us",

+ "buckets": [

+ {

+ "externalBucketId": "deliveryBucket"

+ },

+ {

+ "externalBucketId": "storePickupBucket"

+ },

+ {

+ "externalBucketId": "specialOrdersBucket"

+ },

+ {

+ "externalBucketId": "returnProcessingBucket"

+ }

+ ]

+}

+```

+ Title: "Get plannerPlanConfigurationLocalization"

+description: "Read the properties and relationships of a plannerPlanConfigurationLocalization object."

+ms.localizationpriority: medium

+# Get plannerPlanConfigurationLocalization

+Namespace: microsoft.graph

+Read the properties and relationships of a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.Read.All, BusinessScenarioConfig.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+For a specific localization based on a business scenario ID and a localization ID:

+``` http

+GET /solutions/businessScenarios/{businessScenarioId}/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId}

+```

+For a specific localization based on the unique name of a business scenario and a localization ID:

+``` http

+GET /solutions/businessScenarios(uniqueName='{uniqueName}')/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId}

+```

+## 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.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "get_plannerplanconfigurationlocalization",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d", "en-us"]

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/planConfiguration/localizations/en-us

+```

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationLocalization"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization",

+ "id": "en-us",

+ "languageTag": "en-us",

+ "planTitle": "Order Tracking",

+ "buckets": [

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "deliveryBucket",

+ "name": "Deliveries"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "storePickupBucket",

+ "name": "Pickup"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "specialOrdersBucket",

+ "name": "Special Orders"

+ },

+ {

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "returnProcessingBucket",

+ "name": "Customer Returns"

+ }

+ ]

+}

+```

+ Title: "Update plannerPlanConfigurationLocalization"

+description: "Update the properties of a plannerPlanConfigurationLocalization object."

+ms.localizationpriority: medium

+# Update plannerPlanConfigurationLocalization

+Namespace: microsoft.graph

+Update the properties of a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|BusinessScenarioConfig.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+For a specific localization based on a business scenario ID and a localization ID:

+``` http

+PATCH /solutions/businessScenarios/{businessScenarioId}/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId}

+```

+For a specific localization based on the unique name of a business scenario and a localization ID:

+``` http

+PATCH /solutions/businessScenarios(uniqueName='{uniqueName}')/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId}

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+|Content-Type|application/json. Required.|

+## Request body

+|Property|Type|Description|

+|:|:|:|

+|buckets|[plannerPlanConfigurationBucketLocalization](../resources/plannerplanconfigurationbucketlocalization.md) collection|Localizations for buckets specified in the [plannerPlanConfiguration](../resources/plannerplanconfiguration.md). Optional.|

+|planTitle|String|Localized title of the plan. Optional.|

+## Response

+If successful, this method returns a `200 OK` response code and an updated [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "update_plannerplanconfigurationlocalization",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d", "en-us"]

+}

+-->

+``` http

+PATCH https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/planConfiguration/localizations/en-us

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization",

+ "planTitle": "Order Tracking",

+ "buckets": [

+ {

+ "externalBucketId": "deliveryBucket",

+ "name": "Deliveries"

+ },

+ {

+ "externalBucketId": "storePickupBucket",

+ "name": "Pickup"

+ },

+ {

+ "externalBucketId": "specialOrdersBucket",

+ "name": "Special Orders"

+ },

+ {

+ "externalBucketId": "returnProcessingBucket",

+ "name": "Customer Returns"

+ }

+ ]

+}

+```

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationLocalization"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization",

+ "id": "en-us",

+ "languageTag": "en-us",

+ "planTitle": "Order Tracking",

+ "buckets": [

+ {

+ "externalBucketId": "deliveryBucket",

+ "name": "Deliveries"

+ },

+ {

+ "externalBucketId": "storePickupBucket",

+ "name": "Pickup"

+ },

+ {

+ "externalBucketId": "specialOrdersBucket",

+ "name": "Special Orders"

+ },

+ {

+ "externalBucketId": "returnProcessingBucket",

+ "name": "Customer Returns"

+ }

+ ]

+}

+```

+ Title: "Get plannerTaskConfiguration"

+description: "Read the properties and relationships of a plannerTaskConfiguration object."

+ms.localizationpriority: medium

+# Get plannerTaskConfiguration

+Namespace: microsoft.graph

+Read the properties and relationships of a [plannerTaskConfiguration](../resources/plannertaskconfiguration.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.Read.All, BusinessScenarioConfig.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /solutions/businessScenarios/{businessScenarioId}/planner/taskConfiguration

+```

+## 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.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a [plannerTaskConfiguration](../resources/plannertaskconfiguration.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "get_plannertaskconfiguration",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/taskConfiguration

+```

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.plannerTaskConfiguration"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.plannerTaskConfiguration",

+ "id": "52be01e6291f403aa49f2b9f5288ab48",

+ "editPolicy": {

+ "rules": [

+ {

+ "defaultRule": "block",

+ "role": {

+ "@odata.type": "#microsoft.graph.plannerRelationshipBasedUserType",

+ "roleKind": "relationship",

+ "role": "defaultRules"

+ },

+ "propertyRule": {

+ "move": [],

+ "delete": [],

+ "title": [],

+ "notes": [],

+ "priority": [],

+ "startDate": [],

+ "dueDate": [],

+ "percentComplete": ["allow"],

+ "order": [],

+ "previewType": [],

+ "ruleKind": "taskRule",

+ "references": null,

+ "checkLists": null,

+ "assignments": {

+ "defaultRules": ["addSelf"],

+ "overrides": []

+ },

+ "appliedCategories": null

+ }

+ },

+ {

+ "defaultRule": "block",

+ "role": {

+ "@odata.type": "#microsoft.graph.plannerRelationshipBasedUserType",

+ "roleKind": "relationship",

+ "role": "taskAssignees"

+ },

+ "propertyRule": {

+ "move": [],

+ "delete": [],

+ "title": [],

+ "notes": [],

+ "priority": [],

+ "startDate": ["allow"],

+ "dueDate": ["allow"],

+ "percentComplete": ["allow"],

+ "order": ["allow"],

+ "previewType": [],

+ "ruleKind": "taskRule",

+ "references": {

+ "defaultRules": ["allow"],

+ "overrides": [

+ {

+ "name": "userCreated",

+ "rules": ["allow"]

+ },

+ {

+ "name": "applicationCreated",

+ "rules": ["block"]

+ }

+ ]

+ },

+ "checkLists": {

+ "defaultRules": ["allow"],

+ "overrides": [

+ {

+ "name": "userCreated",

+ "rules": ["allow"]

+ },

+ {

+ "name": "applicationCreated",

+ "rules": ["check"]

+ }

+ ]

+ },

+ "assignments": {

+ "defaultRules": ["block"],

+ "overrides": [

+ {

+ "name": "userCreated",

+ "rules": ["removeSelf"]

+ },

+ {

+ "name": "applicationCreated",

+ "rules": ["check"]

+ }

+ ]

+ },

+ "appliedCategories": {

+ "defaultRules": [

+ "allow"

+ ],

+ "overrides": []

+ }

+ }

+ }

+ ]

+ }

+}

+```

+ Title: "Update plannerTaskConfiguration"

+description: "Update the properties of a plannerTaskConfiguration object."

+ms.localizationpriority: medium

+# Update plannerTaskConfiguration

+Namespace: microsoft.graph

+Update the properties of a [plannerTaskConfiguration](../resources/plannertaskconfiguration.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|BusinessScenarioConfig.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+PATCH /solutions/businessScenarios/{businessScenarioId}/planner/taskConfiguration

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+|Content-Type|application/json. Required.|

+## Request body

+|Property|Type|Description|

+|:|:|:|

+|editPolicy|[plannerTaskPolicy](../resources/plannertaskpolicy.md)|Policy configuration for tasks created for a [businessScenario](../resources/businessscenario.md) when they are being changed outside of the scenario. Optional.|

+## Response

+If successful, this method returns a `200 OK` response code and an updated [plannerTaskConfiguration](../resources/plannertaskconfiguration.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "update_plannertaskconfiguration",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]

+}

+-->

+``` http

+PATCH https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/taskConfiguration

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.plannerTaskConfiguration",

+ "editPolicy": {

+ "rules": [

+ {

+ "defaultRule": "block",

+ "role": {

+ "@odata.type": "#microsoft.graph.plannerRelationshipBasedUserType",

+ "roleKind": "relationship",

+ "role": "defaultRules"

+ },

+ "propertyRule": {

+ "percentComplete": ["allow"],

+ "ruleKind": "taskRule",

+ "assignments": {

+ "defaultRules": ["addSelf"],

+ "overrides": []

+ }

+ }

+ },

+ {

+ "defaultRule": "block",

+ "role": {

+ "@odata.type": "#microsoft.graph.plannerRelationshipBasedUserType",

+ "roleKind": "relationship",

+ "role": "taskAssignees"

+ },

+ "propertyRule": {

+ "startDate": ["allow"],

+ "dueDate": ["allow"],

+ "percentComplete": ["allow"],

+ "order": ["allow"],

+ "ruleKind": "taskRule",

+ "references": {

+ "defaultRules": ["allow"],

+ "overrides": [

+ {

+ "name": "userCreated",

+ "rules": ["allow"]

+ },

+ {

+ "name": "applicationCreated",

+ "rules": ["block"]

+ }

+ ]

+ },

+ "checkLists": {

+ "defaultRules": ["allow"],

+ "overrides": [

+ {

+ "name": "userCreated",

+ "rules": ["allow"]

+ },

+ {

+ "name": "applicationCreated",

+ "rules": ["check"]

+ }

+ ]

+ },

+ "assignments": {

+ "defaultRules": ["block"],

+ "overrides": [

+ {

+ "name": "userCreated",

+ "rules": ["removeSelf"]

+ },

+ {

+ "name": "applicationCreated",

+ "rules": ["check"]

+ }

+ ]

+ },

+ "appliedCategories": {

+ "defaultRules": [

+ "allow"

+ ],

+ "overrides": []

+ }

+ }

+ }

+ ]

+ }

+}

+```

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.plannerTaskConfiguration"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.plannerTaskConfiguration",

+ "id": "52be01e6291f403aa49f2b9f5288ab48",

+ "editPolicy": {

+ "rules": [

+ {

+ "defaultRule": "block",

+ "role": {

+ "@odata.type": "#microsoft.graph.plannerRelationshipBasedUserType",

+ "roleKind": "relationship",

+ "role": "defaultRules"

+ },

+ "propertyRule": {

+ "move": [],

+ "delete": [],

+ "title": [],

+ "notes": [],

+ "priority": [],

+ "startDate": [],

+ "dueDate": [],

+ "percentComplete": ["allow"],

+ "order": [],

+ "previewType": [],

+ "ruleKind": "taskRule",

+ "references": null,

+ "checkLists": null,

+ "assignments": {

+ "defaultRules": ["addSelf"],

+ "overrides": []

+ },

+ "appliedCategories": null

+ }

+ },

+ {

+ "defaultRule": "block",

+ "role": {

+ "@odata.type": "#microsoft.graph.plannerRelationshipBasedUserType",

+ "roleKind": "relationship",

+ "role": "taskAssignees"

+ },

+ "propertyRule": {

+ "move": [],

+ "delete": [],

+ "title": [],

+ "notes": [],

+ "priority": [],

+ "startDate": ["allow"],

+ "dueDate": ["allow"],

+ "percentComplete": ["allow"],

+ "order": ["allow"],

+ "previewType": [],

+ "ruleKind": "taskRule",

+ "references": {

+ "defaultRules": ["allow"],

+ "overrides": [

+ {

+ "name": "userCreated",

+ "rules": ["allow"]

+ },

+ {

+ "name": "applicationCreated",

+ "rules": ["block"]

+ }

+ ]

+ },

+ "checkLists": {

+ "defaultRules": ["allow"],

+ "overrides": [

+ {

+ "name": "userCreated",

+ "rules": ["allow"]

+ },

+ {

+ "name": "applicationCreated",

+ "rules": ["check"]

+ }

+ ]

+ },

+ "assignments": {

+ "defaultRules": ["block"],

+ "overrides": [

+ {

+ "name": "userCreated",

+ "rules": ["removeSelf"]

+ },

+ {

+ "name": "applicationCreated",

+ "rules": ["check"]

+ }

+ ]

+ },

+ "appliedCategories": {

+ "defaultRules": [

+ "allow"

+ ],

+ "overrides": []

+ }

+ }

+ }

+ ]

+ }

+}

+```

+ Title: "presence: setStatusMessage"

+description: "Set a presence status message for a user."

+ms.localizationpriority: medium

+# presence: setStatusMessage

+Namespace: microsoft.graph

+Set a presence status message for a user. An optional expiration date and time can be supplied.

+## Permissions

+The following permission is required to call the API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+| Permission type | Permissions (from least to most privileged) |

+| :- | : |

+| Delegated (work or school account) | Presence.ReadWrite |

+| Delegated (personal Microsoft account) | Not supported. |

+| Application | Not supported. |

+## HTTP Request

+<!-- { "blockType": "ignored" } -->

+```http

+POST /users/{userId}/presence/setStatusMessage

+```

+## Request headers

+| Name | Description |

+| : | :-- |

+| Authorization | Bearer {token}. Required. |

+| Content-Type | application/json. Required. |

+## Request body

+In the request body, provide a JSON object with the following parameters.

+| Parameter | Type | Description |

+| | |- |

+| `statusMessage` | [microsoft.graph.presenceStatusMessage](../resources/presencestatusmessage.md) |It can be set to display the presence status message of a user. |

+## Response

+If successful, this method returns a `200 OK` response code.

+## Examples

+### Example 1: Set status message with expiry date

+The following request sets the presence status message as "Hey I'm currently in a meeting." for user `fa8bf3dc-eca7-46b7-bad1-db199b62afc3`, with the expiration on `2022-10-18 at 17:05:33.2079781 Pacific Standard Time`.

+#### Request

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "setstatusmessage"

+}-->

+```http

+POST https://graph.microsoft.com/beta/users/fa8bf3dc-eca7-46b7-bad1-db199b62afc3/presence/setStatusMessage

+Content-Type: application/json

+{

+ "statusMessage": {

+ "message": {

+ "content": "Hey I'm currently in a meeting.",

+ "contentType": "text"

+ },

+ "expiryDateTime": {

+ "dateTime": "2022-10-18T17:05:33.2079781",

+ "timeZone": "Pacific Standard Time"

+ }

+ }

+}

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+#### Response

+<!-- {

+ "blockType": "response",

+ "name": "setstatusmessage",

+ "truncated": true

+} -->

+```http

+HTTP/1.1 200 OK

+```

+### Example 2: Get status message of another user

+The following request sets the presence status message as "Hey I'm currently in a meeting." for user `fa8bf3dc-eca7-46b7-bad1-db199b62afc3`. Then presence for user `fa8bf3dc-eca7-46b7-bad1-db199b62afc3` is obtained on behalf of other user via a [getPresence](presence-get.md) request.

+#### Set status message: request

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "setstatusmessage-another-user"

+}-->

+```http

+POST https://graph.microsoft.com/beta/users/fa8bf3dc-eca7-46b7-bad1-db199b62afc3/presence/setStatusMessage

+Content-Type: application/json

+{

+ "statusMessage": {

+ "message": {

+ "content": "Hey I am available now",

+ "contentType": "text"

+ }

+ }

+}

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+#### Set status message: response

+<!-- {

+ "blockType": "response",

+ "name": "setstatusmessage-another-user",

+ "truncated": true

+} -->

+```http

+HTTP/1.1 200 OK

+```

+#### Get another user presence: request

+This request should be executed on behalf of another user.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "setstatusmessage-another-user-get-presence"

+}-->

+```msgraph-interactive

+GET https://graph.microsoft.com/beta/users/fa8bf3dc-eca7-46b7-bad1-db199b62afc3/presence

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+#### Get another user presence: response

+Since this presence request does not qualify as a [self presence](presence-get.md#example-1-get-your-own-presence-information) request, `statusMessage.expiryDateTime` and `statusMessage.publishedDateTime` properties are not included in the response body.

+<!-- {

+ "blockType": "response",

+ "name": "setstatusmessage-another-user-get-presence",

+ "@odata.type": "microsoft.graph.presence",

+ "truncated":"true"

+} -->

+```http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "id": "fa8bf3dc-eca7-46b7-bad1-db199b62afc3",

+ "availability": "Available",

+ "activity": "Available",

+ "outOfOfficeSettings": {

+ "message": null,

+ "isOutOfOffice": false

+ },

+ "statusMessage": {

+ "message": {

+ "content": "Hey I am available now",

+ "contentType": "text"

+ }

+ }

+}

+```

+ Title: "List printConnectors"

+description: "Retrieve a list of connectors."

+|Delegated (personal Microsoft account)|Not supported.|

+|Application| Not supported. |

+The following operators are not supported: `$count`, `$search`, `$filter`.

+If successful, this method returns a `200 OK` response code and a collection of [printConnector](../resources/printconnector.md) objects in the response body.

+| Delegated (work or school account) | Mail.Read, Calendars.Read, Files.Read.All, Sites.Read.All, ExternalItem.Read.All, Acronym.Read.All, Bookmark.Read.All, ChannelMessage.Read.All, Chat.Read, QnA.Read.All |

+Delete Microsoft Teams messages contained in a [eDiscovery search](../resources/security-ediscoverysearch.md).

+ "customTags": [

+# Create comment

+|customTags|String collection|Array of custom tags associated with an incident.|

+ "customTags": [

+ "customTags": [

+#### Request

+#### Response

+ "customTags": [

+### Example 2: List all incidents with their alerts

+#### Request

+#### Response

+This is the method for advanced hunting in Microsoft 365 Defender. This method includes a query in Kusto Query Language (KQL). It specifies a data table in the [advanced hunting schema](/microsoft-365/security/defender/advanced-hunting-schema-tables?view=o365-worldwide&preserve-view=true) and a piped sequence of operators to filter or search that data, and format the query output in specific ways.

+Find out more about [hunting for threats across devices, emails, apps, and identities](/microsoft-365/security/defender/advanced-hunting-query-emails-devices?view=o365-worldwide&preserve-view=true). Learn about [KQL](/azure/data-explorer/kusto/query/).

+For information on using advanced hunting in the [Microsoft 365 Defender portal](/microsoft-365/security/defender/microsoft-365-defender-portal?view=o365-worldwide&preserve-view=true), see [Proactively hunt for threats with advanced hunting in Microsoft 365 Defender](/microsoft-365/security/defender/advanced-hunting-overview?view=o365-worldwide&preserve-view=true).

+- Looks into the [DeviceProcessEvents](/microsoft-365/security/defender/advanced-hunting-deviceprocessevents-table?view=o365-worldwide&preserve-view=true) table in the advanced hunting schema.

+Add an owner for the [servicePrincipal](../resources/serviceprincipal.md). Service principal owners can be users, the service principal itself, or other service principals.

+ Title: "sitepage: getWebPartsByPosition"

+description: "Get a collection of webParts by position information"

+# sitepage: getWebPartsByPosition

+ ],

+ "excludeTargets": []

+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.

+The following is an example of the response

+ "truncated": true

+HTTP/1.1 204 No Content

+ Title: "Delete softwareOathAuthenticationMethodConfiguration"

+description: "Delete a softwareOathAuthenticationMethodConfiguration object."

+ms.localizationpriority: medium

+# Delete softwareOathAuthenticationMethodConfiguration

+Namespace: microsoft.graph

+Revert the [third-party software Oath authentication method policy](../resources/softwareoathauthenticationmethodconfiguration.md) to its default configuration.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|Policy.ReadWrite.AuthenticationMethod|

+For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):

+* Authentication Policy Administrator

+* Global Administrator

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+DELETE /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/softwareOath

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `204 No Content` response code.

+## Examples

+### Request

+The following is an example of a request.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "delete_softwareoathauthenticationmethodconfiguration"

+}

+-->

+``` http

+DELETE https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/softwareOath

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+### Response

+The following is an example of the response

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+ Title: "Get softwareOathAuthenticationMethodConfiguration"

+description: "Read the properties and relationships of a softwareOathAuthenticationMethodConfiguration object."

+ms.localizationpriority: medium

+# Get softwareOathAuthenticationMethodConfiguration

+Namespace: microsoft.graph

+Read the properties and relationships of a [softwareOathAuthenticationMethodConfiguration](../resources/softwareoathauthenticationmethodconfiguration.md) object, which represents the third-party software OATH authentication method policy for the Azure AD tenant.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod|

+For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):

+* Global Reader

+* Authentication Policy Administrator

+* Global Administrator

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/softwareOath

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a [softwareOathAuthenticationMethodConfiguration](../resources/softwareoathauthenticationmethodconfiguration.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "get_softwareoathauthenticationmethodconfiguration"

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/softwareOath

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+### Response

+The following is an example of the response

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.softwareOathAuthenticationMethodConfiguration"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "value": {

+ "@odata.type": "#microsoft.graph.softwareOathAuthenticationMethodConfiguration",

+ "id": "SoftwareOath",

+ "state": "enabled",

+ "includeTargets": [

+ {

+ "targetType": "group",

+ "id": "all_users",

+ "isRegistrationRequired": false

+ }

+ ],

+ "excludeTargets": []

+ }

+}

+```

+ Title: "Update softwareOathAuthenticationMethodConfiguration"

+description: "Update the properties of a softwareOathAuthenticationMethodConfiguration object."

+ms.localizationpriority: medium

+# Update softwareOathAuthenticationMethodConfiguration

+Namespace: microsoft.graph

+Update the properties of a [softwareOathAuthenticationMethodConfiguration](../resources/softwareoathauthenticationmethodconfiguration.md) object, which represents the third-party software OATH authentication method policy for the Azure AD tenant.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|Policy.ReadWrite.AuthenticationMethod|

+For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):

+* Authentication Policy Administrator

+* Global Administrator

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+PATCH /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/softwareOath

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+|Content-Type|application/json. Required.|

+## Request body

+In the request body, supply a JSON representation of the [softwareOathAuthenticationMethodConfiguration](../resources/softwareoathauthenticationmethodconfiguration.md) object with the values of fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+For the list of properties, see [softwareOathAuthenticationMethodConfiguration](../resources/softwareoathauthenticationmethodconfiguration.md).

+>**Note:** The `@odata.type` property with a value of `#microsoft.graph.softwareOathAuthenticationMethodConfiguration` must be included in the body.

+## Response

+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.

+## Examples

+### Request

+The following is an example of a request.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "update_softwareoathauthenticationmethodconfiguration"

+}

+-->

+``` http

+PATCH https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/softwareOath

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.softwareOathAuthenticationMethodConfiguration",

+ "state": "disabled"

+}

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+### Response

+The following is an example of the response

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+ Title: "Delete businessScenario"

+description: "Delete a businessScenario object."

+ms.localizationpriority: medium

+# Delete businessScenario

+Namespace: microsoft.graph

+Delete a [businessScenario](../resources/businessscenario.md) object. The deletion of a scenario causes all data associated with the scenario to be deleted.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application| BusinessScenarioConfig.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+DELETE /solutions/businessScenarios/{businessScenarioId}

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `204 No Content` response code.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "delete_businessscenario",

+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]

+}

+-->

+``` http

+DELETE https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d

+```

+### Response

+The following is an example of the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+ Title: "List businessScenarios"

+description: "Get a list of all businessScenario objects in an organization."

+ms.localizationpriority: medium

+# List businessScenarios

+Namespace: microsoft.graph

+Get a list of all [businessScenario](../resources/businessscenario.md) objects in an organization.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.Read.All, BusinessScenarioConfig.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /solutions/businessScenarios

+```

+## 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.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a collection of [businessScenario](../resources/businessscenario.md) objects in the response body.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "list_businessscenario"

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/solutions/businessScenarios

+```

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "Collection(microsoft.graph.businessScenario)"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "value": [

+ {

+ "@odata.type": "#microsoft.graph.businessScenario",

+ "id": "c5d514e6c6864911ac46c720affb6e4d",

+ "displayName": "Contoso Order Tracking",

+ "uniqueName": "com.contoso.apps.ordertracking",

+ "ownerAppIds": [

+ "44109254-4b2b-7a33-76ee-c890a167b295"

+ ]

+ }

+ ]

+}

+```

+ Title: "Create businessScenario"

+description: "Create a new businessScenario object."

+ms.localizationpriority: medium

+# Create businessScenario

+Namespace: microsoft.graph

+Create a new [businessScenario](../resources/businessscenario.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application| BusinessScenarioConfig.ReadWrite.OwnedBy |

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /solutions/businessScenarios

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+|Content-Type|application/json. Required.|

+## Request body

+In the request body, supply a JSON representation of the [businessScenario](../resources/businessscenario.md) object.

+You can specify the following properties when you create a **businessScenario**.

+|Property|Type|Description|

+|:|:|:|

+|displayName|String|Display name of the scenario. Required.|

+|uniqueName|String|Unique name of the scenario. To avoid conflicts, the recommended value for the unique name is a reverse domain name format, owned by the author of the scenario. For example, a scenario authored by *Contoso.com* would have a unique name that starts with `com.contoso`. Required.|

+|ownerAppIds|String collection|Identifiers of applications that are authorized to work with this scenario. The application that creates the scenario will be automatically added to the list. Optional.|

+## Response

+If successful, this method returns a `201 Created` response code and a [businessScenario](../resources/businessscenario.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+<!-- {

+ "blockType": "request",

+ "name": "create_businessscenario_from_"

+}

+-->

+``` http

+POST https://graph.microsoft.com/beta/solutions/businessScenarios

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.businessScenario",

+ "displayName": "Contoso Order Tracking",

+ "uniqueName": "com.contoso.apps.ordertracking"

+}

+```

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.businessScenario"

+}

+-->

+``` http

+HTTP/1.1 201 Created

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.businessScenario",

+ "id": "c5d514e6c6864911ac46c720affb6e4d",

+ "displayName": "Contoso Order Tracking",

+ "uniqueName": "com.contoso.apps.ordertracking",

+ "ownerAppIds": [

+ "44109254-4b2b-7a33-76ee-c890a167b295"

+ ]

+}

+```

+The following is an example of a request.

+### Response

+The following is an example of the response.

+The following is an example of a request.

+The following is an example of the response.

+ ],

+ "excludeTargets": []

+If the caller does not have the permission to read properties for some of the objects included in the result set, the response will follow the [limited information returned for inaccessible member objects](/graph/permissions-overview#limited-information-returned-for-inaccessible-member-objects) pattern.

+ Title: "Get user"

+# Get user

+### Example 5: Use `$filter` to retrieve specific users based on a property value

+This example shows how to use the `$filter` query parameter along with the `endswith` clause to retrieve a user with a specific value in the **mail** attribute. This request filters and returns all users with a mail address ending with contoso.com.

+#### Request

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "get_user_filter"

+} -->

+```msgraph-interactive

+GET https://graph.microsoft.com/beta/users?$count=true&ConsistencyLevel=eventual&$filter=endsWith(mail,'@contoso.com')

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+#### Response

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.user",

+ "name": "get_user_filter"

+} -->

+```http

+HTTP/1.1 200 OK

+Content-type: application/json

+{

+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#users",

+ "@odata.count": 1350,

+ "@odata.nextLink": "https://graph.microsoft.com/v1.0/users?$count=true&$filter=endsWith(mail,'@contoso.com')&ConsistencyLevel=eventual&$skiptoken=m~AQAnOzEyN2NjN2I3NTQzYzQ0YzA4NjlhYjU5MzUzYmNhNGI2OzswOzA7",

+ "value": [

+ {

+ "businessPhones": [],

+ "displayName": "Phantom Space",

+ "givenName": "Space",

+ "jobTitle": null,

+ "mail": "Space.Phantom@cloudezzy.com",

+ "mobilePhone": null,

+ "officeLocation": null,

+ "preferredLanguage": null,

+ "surname": "Phantom",

+ "userPrincipalName": "Space.Phantom@contoso.com",

+ "id": "00111916-c5c5-4dd2-9e31-aab96af7511e"

+ }

+ ]

+}

+```

+### Example 6: Get the value of a schema extension for a user

+The following is an example of the request.

+The following is an example of the response.

+The following is an example of the response.

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+# [Go](#tab/go)

+# [PHP](#tab/php)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+ "supportedSolution": "windows365",

+ "regionGroup": "usCentral"

+ Title: "Delete voiceAuthenticationMethodConfiguration"

+description: "Delete a voiceAuthenticationMethodConfiguration object."

+ms.localizationpriority: medium

+# Delete voiceAuthenticationMethodConfiguration

+Namespace: microsoft.graph

+Revert the [voice call authentication method policy](../resources/voiceauthenticationmethodconfiguration.md) to its default configuration.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|Policy.ReadWrite.AuthenticationMethod|

+For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):

+* Authentication Policy Administrator

+* Global Administrator

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+DELETE /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/voice

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `204 No Content` response code.

+## Examples

+### Request

+The following is an example of a request.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "delete_voiceauthenticationmethodconfiguration"

+}

+-->

+``` http

+DELETE https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/voice

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+### Response

+The following is an example of the response

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+ Title: "Get voiceAuthenticationMethodConfiguration"

+description: "Read the properties and relationships of a voiceAuthenticationMethodConfiguration object."

+ms.localizationpriority: medium

+# Get voiceAuthenticationMethodConfiguration

+Namespace: microsoft.graph

+Read the properties and relationships of a [voiceAuthenticationMethodConfiguration](../resources/voiceauthenticationmethodconfiguration.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod|

+For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):

+* Global Reader

+* Authentication Policy Administrator

+* Global Administrator

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/voice

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a [voiceAuthenticationMethodConfiguration](../resources/voiceauthenticationmethodconfiguration.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "get_voiceauthenticationmethodconfiguration"

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/voice

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+### Response

+The following is an example of the response

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.voiceAuthenticationMethodConfiguration"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "value": {

+ "@odata.type": "#microsoft.graph.voiceAuthenticationMethodConfiguration",

+ "id": "Voice",

+ "state": "enabled",

+ "includeTargets": [

+ {

+ "targetType": "group",

+ "id": "all_users",

+ "isRegistrationRequired": false

+ }

+ ],

+ "excludeTargets": [],

+ "isOfficePhoneAllowed": "true"

+ }

+}

+```

+ Title: "Update voiceAuthenticationMethodConfiguration"

+description: "Update the properties of a voiceAuthenticationMethodConfiguration object."

+ms.localizationpriority: medium

+# Update voiceAuthenticationMethodConfiguration

+Namespace: microsoft.graph

+Update the properties of a [voiceAuthenticationMethodConfiguration](../resources/voiceauthenticationmethodconfiguration.md) object, which represents the voice call authentication method policy for the Azure AD tenant.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|Policy.ReadWrite.AuthenticationMethod|

+For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):

+* Authentication Policy Administrator

+* Global Administrator

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+PATCH /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/voice

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+|Content-Type|application/json. Required.|

+## Request body

+In the request body, supply a JSON representation of the [voiceAuthenticationMethodConfiguration](../resources/softwareoathauthenticationmethodconfiguration.md) object with the values of fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

+For the list of properties, see [voiceAuthenticationMethodConfiguration](../resources/softwareoathauthenticationmethodconfiguration.md).

+>**Note:** The `@odata.type` property with a value of `#microsoft.graph.voiceAuthenticationMethodConfiguration` must be included in the body.

+## Response

+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.

+## Examples

+### Request

+The following is an example of a request.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "update_voiceauthenticationmethodconfiguration"

+}

+-->

+``` http

+PATCH https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/voice

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.voiceAuthenticationMethodConfiguration",

+ "isOfficePhoneAllowed": "false"

+}

+```

+# [JavaScript](#tab/javascript)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+### Response

+The following is an example of the response

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+# [HTTP](#tab/http)

+```msgraph-interactive

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+```msgraph-interactive

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+The following table shows the properties that can be set when you update a [deployment](../resources/windowsupdates-deployment.md).

+### Example 1: Pause a deployment

+In this example, the deployment is paused by updating the **requestedValue** of the deployment **state**.

+The following is an example of a request.

+The following is an example of the response.

+### Example 2: Update deployment settings to add a monitoring rule

+In this example, the **settings** property of the deployment is updated to add a monitoring rule.

+The following is an example of a request.

+The following is an example of the response.

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+ ],

+ "excludeTargets": []

+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.

+|excludeTargets|[excludeTarget](../resources/excludetarget.md) collection|Groups of users that are excluded from a policy.|

+|policyMigrationState|authenticationMethodsPolicyMigrationState|The state of migration of the authentication methods policy from the legacy multifactor authentication and self-service password reset (SSPR) policies. The possible values are: <br/><li>`premigration` - means the authentication methods policy is used for authentication only, legacy policies are respected. <li>`migrationInProgress` - means the authentication methods policy is used for both authenication and SSPR, legacy policies are respected. <li>`migrationComplete` - means the authentication methods policy is used for authentication and SSPR, legacy policies are ignored. <li>`unknownFutureValue` - Evolvable enumeration sentinel value. Do not use. |

+|reconfirmationInDays|Int32|Days before the user will be asked to reconfirm their method. |

+description: "A collection of groups that are enabled to use an authentication method as part of an authentication method policy."

+A collection of groups that are enabled to use an authentication method as part of an authentication method policy in Azure AD. Inherits from [entity](entity.md).

+|targetType|authenticationMethodTargetType| Possible values are: `group`, and `unknownFutureValue`. From December 2022, targeting individual users using `user` is no longer recommended. Existing targets will remain but we recommend to move the individual users to a targeted group.|

+| Manage devices registered in the organization. Devices are registered to users and include items like laptops, desktops, tablets, and mobile phones. Devices are typically created in the cloud using the Device Registration Service or by Microsoft Intune. They're used by conditional access policies for multifactor authentication. | [device](../resources/device.md) | [Getting started with Azure Active Directory device registration](/mem/intune/enrollment/).<br/><br/>[What is Intune?](/mem/intune/fundamentals/what-is-intune)<br/><br/>[Enroll devices for management in Intune](/mem/intune/enrollment/) |

+ Title: "Use the business scenarios API in Microsoft Graph (preview)"

+description: "The business scenarios API allows for the creation and management of business scenarios that configure and manage the integration of data into Microsoft Graph."

+ms.localizationpriority: medium

+# Use the business scenarios API in Microsoft Graph (preview)

+The business scenarios API allows for the creation and management of business scenarios that configure and manage the integration of data into Microsoft Graph.

+## Structure of a business scenario

+A business scenario is represented by the [businessScenario](businessscenario.md) entity. A **businessScenario** resource specifies general information about the scenario, the apps that use that scenario, and configurations for entities that apps can manage to support the scenario. Apps can identify the instance of **businessScenario** by the **uniqueName** property using a reverse domain name format.

+### Entities available in business scenarios

+The business scenarios API is designed to allow Microsoft Graph services to extend it to support service-specific scenarios that are specific to customers.

+Currently, [Planner](businessscenario-planner-overview.md) has extended the API. The API supports custom scenario data for Planner in the [businessScenarioTask](businessscenariotask.md) entity.

+## Creating a business scenario

+Business scenarios can be created by applications using the delegated permission `BusinessScenarioConfig.ReadWrite.OwnedBy`. Creating a business scenario requires specifying a display name and a unique name. The unique name should be in the reverse DNS format to prevent conflict between independent scenarios. The reverse DNS format takes the domain name the scenario creator owns and reverses it. For example, if a developer who owns `apps.contoso.com` creates a scenario, the unique name of the scenario should start with `com.contoso.apps`. Then further segments can be added to differentiate scenarios or groups of scenarios; for example, `com.contoso.apps.customerSupport.ticketManagement`. The unique name of the scenario must be distinct from every other scenario deployed in a tenant.

+For more information, see [Create businessScenario](../api/solutionsroot-post-businessscenarios.md).

+## Configuring behaviors for entities

+Each service supported through business scenarios provides configurations in the scenario. Applications need to have the `BusinessScenarioConfig.Read.OwnedBy` permission to be able to access these configurations, and the `BusinessScenarioConfig.ReadWrite.OwnedBy` permission to be able to change them. Each configuration is specific for the service. For more details, see the following service-specific topics:

+* [Planner](businessscenario-planner-overview.md) provides the following configurations:

+ * [plannerPlanConfiguration](plannerplanconfiguration.md)

+ * [plannerTaskConfiguration](plannertaskconfiguration.md)

+## Creating and managing data for a business scenario

+Each service supported through business scenarios provides access to data within a scenario. Applications need to be listed as an owner in a scenario to work with the data in the scenario. Applications also need to have the `BusinessScenarioData.Read.OwnedBy` permission to be able to read the data, and the `BusinessScenarioData.ReadWrite.OwnedBy` permission to be able to create new data, or to modify previously created data. For more details, see the following service-specific topics:

+* [Planner](businessscenario-planner-overview.md), with the following supported entities:

+ * [businessScenarioTask](businessscenariotask.md)

+## Deleting a business scenario

+Applications that own a business scenario can delete the scenario if they have the `BusinessScenarioConfig.ReadWrite.OwnedBy` permission. Deleting the scenario removes all the data associated with the scenario as well.

+For more information, see [Delete businessScenario](../api/solutionsroot-delete-businessscenarios.md).

+## Common use cases

+| Use cases | REST resources | See also |

+|:-|:|:|

+|Create, read, update, and delete business scenarios|[businessScenario](businessscenario.md)|[Methods of businessScenario](businessscenario.md#methods)|

+|Configure business scenarios for Planner| [plannerPlanConfiguration](plannerplanconfiguration.md) [plannerTaskConfiguration](plannertaskconfiguration.md)|[Methods of plannerPlanConfiguration](plannerplanconfiguration.md#methods) [Methods of plannerTaskConfiguration](plannertaskconfiguration.md#methods)|

+|Create, read, update, and delete business scenario tasks in Planner| [businessScenarioTask](businessscenariotask.md)| [businessScenarioTask](businessscenariotask.md#methods)|

+## What's new

+Find out about the [latest new features and updates](/graph/whats-new-overview) for this API set.

+## Next steps

+The business scenarios API allows apps to model and integrate real work business processes with a Microsoft 365 service over Microsoft Graph. 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).

+Need more ideas? See [how some of our partners are using Microsoft Graph](https://developer.microsoft.com/graph/partners).

+ Title: "Use the business scenarios API in Microsoft Graph to integrate with Planner (preview)"

+description: "Learn how to use the business scenarios in Microsoft Graph to integrate with Planner."

+ms.localizationpriority: medium

+# Use the business scenarios API in Microsoft Graph to integrate with Planner (preview)

+The [business scenarios API](businessscenario-overview.md) allows creating Planner tasks with scenario-controlled policies, in a specified target.

+## Planner configuration

+Using the business scenarios API, apps can configure Planner entities in two ways. First is the plan configuration which defines the elements of the plans created to host scenario tasks. Second is the task configuration which controls how created tasks behave for users and applications.

+### Plan configuration

+Plan configuration is represented by the [plannerPlanConfiguration](plannerplanconfiguration.md) entity. In plan configuration, the application can configure the buckets that appear in the plan, the order of these buckets, as well as the title of the plan and the name of the buckets. Each bucket is identified by an external ID, which can be used when creating tasks or updating the tasks to put them in the correct bucket. The buckets configured in the plan configuration do not specify any names to be used, instead this information is part of the localized names. Plan configuration also specifies localized names for the plan and the buckets as well as the default language code. Currently, created items will use the default language.

+### Task configuration

+Task configuration is represented by the [plannerTaskConfiguration](plannertaskconfiguration.md) entity. In task configuration, the application can configure the policies that restrict the access to the applications and users that will use the tasks managed by the scenario. The policies are grouped by [roles](plannerrelationshipbasedusertype.md). Each role identifies a group of callers, and each group can have different rules specified for them. The rules that apply to a specific call are picked in the following order. Only the first specified rules will apply, and the rules only apply when the request is modifying a task.

+- `taskAssignees`: Applies if the target task is assigned to the user making the call.

+- `groupOwners`: Applies if the user making the call is an owner of the container that the plan of the target task is in.

+- `groupMembers`: Applies if the user making the call is a member of the container that the plan of the task is in.

+- `applications`: Applies if the caller is application permissions, therefore the call isn't associated with a user.

+- `defaultRules`: Applies when none of the other conditions match.

+>**Note:** These rules restrict what the caller can do, but they cannot allow the caller to perform operations that they would otherwise not be permitted to.

+Each role specifies a default rule, and rules for specific actions and fields on task. The default rule must be either `allow` or `block`. If an action or field doesn't have a rule defined for it, the default rule is used to either keep it unrestricted for `allow`, or blocked from getting used for `block`. Keep in mind that this applies when new properties and actions are available to be configured, but the scenario configuration is not yet updated to specify rules for these.

+For more information about using rules, see [Configuring task rules in Planner](/graph/planner-task-rules-overview).

+## Targeting tasks

+Created tasks are placed in plans based on the specified target when they are created. In the current version, a [group](group.md) can be targeted. The task will be placed in the [plan](plannerplan.md) associated with the scenario in that group. If the group doesn't have a plan for the scenario, a new plan is going to be created based on the plan configuration.

+## Task metadata and behavior

+As part of the tasks, [scenario properties](businessscenarioproperties.md) are required. These properties include the external ID of the task, which is required to be specified for each task. This value must be unique within the tenant. If you create a second task with the same external ID, it causes the first task to be returned without any modifications. You can also use the external ID as an alternate key when working with tasks. Additionally, a context ID can be specified for each task. This value can be used to query the tasks with the same context ID, allowing the applications to group tasks across plans.

+ Title: "businessScenario resource type"

+description: "Represents a scenario that collects relevant data and configuration for a specific problem domain."

+ms.localizationpriority: medium

+# businessScenario resource type

+Namespace: microsoft.graph

+Represents a scenario that collects relevant data and configuration for a specific problem domain. For more details about business scenarios, see [Business scenarios API overview](/graph/businessscenarios-concept-overview).

+Inherits from [entity](../resources/entity.md).

+## Methods

+|Method|Return type|Description|

+|:|:|:|

+|[List businessScenarios](../api/solutionsroot-list-businessscenarios.md)|[businessScenario](../resources/businessscenario.md) collection|Get a list of all [businessScenario](../resources/businessscenario.md) objects in an organization.|

+|[Create businessScenario](../api/solutionsroot-post-businessscenarios.md)|[businessScenario](../resources/businessscenario.md)|Create a new [businessScenario](../resources/businessscenario.md) object.|

+|[Get businessScenario](../api/businessscenario-get.md)|[businessScenario](../resources/businessscenario.md)|Read the properties and relationships of a [businessScenario](../resources/businessscenario.md) object.|

+|[Update businessScenario](../api/businessscenario-update.md)|[businessScenario](../resources/businessscenario.md)|Update the properties of a [businessScenario](../resources/businessscenario.md) object.|

+|[Delete businessScenario](../api/solutionsroot-delete-businessscenarios.md)|None|Delete a [businessScenario](../resources/businessscenario.md) object. The deletion of a scenario causes all data associated with the scenario to be deleted.|

+|[Get businessScenarioPlanner](../api/businessscenarioplanner-get.md)|[businessScenarioPlanner](../resources/businessscenarioplanner.md)|Read the properties and relationships of a [businessScenarioPlanner](../resources/businessscenarioplanner.md) object.|

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|createdBy|[identitySet](../resources/identityset.md)|The identity of the user who created the scenario.|

+|createdDateTime|DateTimeOffset|The date and time when the scenario was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|

+|displayName|String|Display name of the scenario.|

+|id|String|The unique identifier for the scenario. Inherited from [entity](../resources/entity.md).|

+|lastModifiedBy|[identitySet](../resources/identityset.md)|The identity of the user who last modified the scenario.|

+|lastModifiedDateTime|DateTimeOffset|The date and time when the scenario was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|

+|ownerAppIds|String collection|Identifiers of applications that are authorized to work with this scenario.|

+|uniqueName|String|Unique name of the scenario. To avoid conflicts, the recommended value for the unique name is a reverse domain name format, owned by the author of the scenario. For example, a scenario authored by *Contoso.com* would have a unique name that starts with `com.contoso`.|

+## Relationships

+|Relationship|Type|Description|

+|:|:|:|

+|planner|[businessScenarioPlanner](../resources/businessscenarioplanner.md)|Planner content related to the scenario.|

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

+ "@odata.type": "microsoft.graph.businessScenario",

+ "baseType": "microsoft.graph.entity",

+ "openType": false

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.businessScenario",

+ "createdBy": {"@odata.type": "microsoft.graph.identitySet"},

+ "createdDateTime": "String (timestamp)",

+ "displayName": "String",

+ "id": "String (identifier)",

+ "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},

+ "lastModifiedDateTime": "String (timestamp)",

+ "ownerAppIds": ["String"],

+ "uniqueName": "String"

+}

+```

+ Title: "businessScenarioGroupTarget resource type"

+description: "Represents a [group](../resources/group.md) which will be used as the target when creating tasks in a [businessScenario](businessscenario.md)."

+ms.localizationpriority: medium

+# businessScenarioGroupTarget resource type

+Namespace: microsoft.graph

+Represents a [group](../resources/group.md) which will be used as the target when creating tasks in a [businessScenario](businessscenario.md).

+Inherits from [businessScenarioTaskTargetBase](../resources/businessscenariotasktargetbase.md).

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|groupId|String|The unique identifier for the group. |

+|taskTargetKind|plannerTaskTargetKind|Represents the kind of the target. The possible values are: `group`, `unknownFutureValue`. The value of this property will be `group`. Inherited from [businessScenarioTaskTargetBase](../resources/businessscenariotasktargetbase.md).|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget"

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.businessScenarioGroupTarget",

+ "groupId": "String",

+ "taskTargetKind": "String"

+}

+```

+ Title: "businessScenarioPlanner resource type"

+description: "Contains Microsoft Planner-related content for the scenario, allowing both configuration of Planner behavior and accessing the scenario data in Planner."

+ms.localizationpriority: medium

+# businessScenarioPlanner resource type

+Namespace: microsoft.graph

+Contains Microsoft Planner-related content for the scenario, allowing both configuration of Planner behavior and accessing the scenario data in Planner.

+Inherits from [entity](../resources/entity.md).

+## Methods

+|Method|Return type|Description|

+|:|:|:|

+|[Get businessScenarioPlanner](../api/businessscenarioplanner-get.md)|[businessScenarioPlanner](../resources/businessscenarioplanner.md)|Read the properties and relationships of a [businessScenarioPlanner](../resources/businessscenarioplanner.md) object.|

+|[getPlan](../api/businessscenarioplanner-getplan.md)|[businessScenarioPlanReference](../resources/businessscenarioplanreference.md)|Get information about the [plannerPlan](../resources/plannerplan.md) mapped to a given target.|

+|[Get plannerPlanConfiguration](../api/plannerplanconfiguration-get.md)|[plannerPlanConfiguration](../resources/plannerplanconfiguration.md)|Get the **plannerPlanConfiguration** from the **planConfiguration** navigation property.|

+|[Get plannerTaskConfiguration](../api/plannertaskconfiguration-get.md)|[plannerTaskConfiguration](../resources/plannertaskconfiguration.md)|Get the **plannerTaskConfiguration** from the **taskConfiguration** navigation property.|

+|[List tasks](../api/businessscenarioplanner-list-tasks.md)|[businessScenarioTask](../resources/businessscenariotask.md) collection|Get the **businessScenarioTasks** from the **tasks** navigation property.|

+|[Create businessScenarioTask](../api/businessscenarioplanner-post-tasks.md)|[businessScenarioTask](../resources/businessscenariotask.md)|Create a new **businessScenarioTask** object.|

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|id|String|The unique identifier for the **businessScenarioPlanner** object. Inherited from [entity](../resources/entity.md). Read-only.|

+## Relationships

+|Relationship|Type|Description|

+|:|:|:|

+|planConfiguration|[plannerPlanConfiguration](../resources/plannerplanconfiguration.md)|The configuration of Planner plans that will be created for the scenario.|

+|taskConfiguration|[plannerTaskConfiguration](../resources/plannertaskconfiguration.md)|The configuration of Planner tasks that will be created for the scenario.|

+|tasks|[businessScenarioTask](../resources/businessscenariotask.md) collection|The Planner tasks for the scenario.|

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

+ "@odata.type": "microsoft.graph.businessScenarioPlanner",

+ "baseType": "microsoft.graph.entity",

+ "openType": false

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.businessScenarioPlanner",

+ "id": "String (identifier)"

+}

+```

+ Title: "businessScenarioPlanReference resource type"

+description: "Represents a reference to a plannerPlan object."

+ms.localizationpriority: medium

+# businessScenarioPlanReference resource type

+Namespace: microsoft.graph

+Represents a reference to a [plannerPlan](../resources/plannerplan.md) object.

+Inherits from [entity](../resources/entity.md).

+## Methods

+|Method|Return type|Description|

+|:|:|:|

+|[getPlan](../api/businessscenarioplanner-getplan.md)|[businessScenarioPlanReference](../resources/businessscenarioplanreference.md)|Get information about the [plannerPlan](../resources/plannerplan.md) mapped to a given target.|

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|id|String|The unique identifier for the **plannerPlan**. Inherited from [entity](../resources/entity.md). Read-only.|

+|title|String|The title property of the **plannerPlan**.|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

+ "@odata.type": "microsoft.graph.businessScenarioPlanReference",

+ "baseType": "microsoft.graph.entity",

+ "openType": false

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.businessScenarioPlanReference",

+ "id": "String (identifier)",

+ "title": "String"

+}

+```

+ Title: "businessScenarioProperties resource type"

+description: "Represents scenario metadata for a businessScenarioTask object."

+ms.localizationpriority: medium

+# businessScenarioProperties resource type

+Namespace: microsoft.graph

+Represents scenario metadata for a [businessScenarioTask](../resources/businessscenariotask.md) object.

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|externalBucketId|String|The identifier for the [bucketDefinition](../resources/plannerplanconfigurationbucketdefinition.md) configured in the [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) for the scenario. The task will be placed in the corresponding [plannerBucket](../resources/plannerbucket.md) in the target plan. Required.|

+|externalContextId|String|The identifier for the context of the task. Context is an application controlled value, and tasks can be queried by their **externalContextId**. Optional.|

+|externalObjectId|String|Application-specific identifier for the task. Every task for the same scenario must have a unique identifier specified for this property. Required.|

+|externalObjectVersion|String|Application-specific version of the task. Optional.|

+|webUrl|String|The URL to the application-specific experience for this task. Optional.|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.businessScenarioProperties"

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.businessScenarioProperties",

+ "externalBucketId": "String",

+ "externalContextId": "String",

+ "externalObjectId": "String",

+ "externalObjectVersion": "String",

+ "webUrl": "String"

+}

+```

+ Title: "businessScenarioTask resource type"

+description: "Represents a plannerTask that is associated with a businessScenario and contains additional scenario data."

+ms.localizationpriority: medium

+# businessScenarioTask resource type

+Namespace: microsoft.graph

+Represents a [plannerTask](../resources/plannertask.md) that is associated with a [businessScenario](../resources/businessscenario.md) and contains additional scenario data.

+Inherits from [plannerTask](../resources/plannertask.md).

+## Methods

+|Method|Return type|Description|

+|:|:|:|

+|[List businessScenarioTasks](../api/businessscenarioplanner-list-tasks.md)|[businessScenarioTask](../resources/businessscenariotask.md) collection|Get a list of the [businessScenarioTask](../resources/businessscenariotask.md) objects and their properties.|

+|[Create businessScenarioTask](../api/businessscenarioplanner-post-tasks.md)|[businessScenarioTask](../resources/businessscenariotask.md)|Create a new [businessScenarioTask](../resources/businessscenariotask.md) object.|

+|[Get businessScenarioTask](../api/businessscenariotask-get.md)|[businessScenarioTask](../resources/businessscenariotask.md)|Read the properties and relationships of a [businessScenarioTask](../resources/businessscenariotask.md) object.|

+|[Update businessScenarioTask](../api/businessscenariotask-update.md)|[businessScenarioTask](../resources/businessscenariotask.md)|Update the properties of a [businessScenarioTask](../resources/businessscenariotask.md) object.|

+|[Delete businessScenarioTask](../api/businessscenarioplanner-delete-tasks.md)|None|Delete a [businessScenarioTask](../resources/businessscenariotask.md) object.|

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|activeChecklistItemCount|Int32|Number of checklist items with value set to `false`, representing incomplete items. Inherited from [plannerTask](../resources/plannertask.md).|

+|appliedCategories|[plannerAppliedCategories](../resources/plannerappliedcategories.md)|The categories to which the task has been applied. For possible values, see [plannerAppliedCategories](plannerappliedcategories.md). Inherited from [plannerTask](../resources/plannertask.md).|

+|assigneePriority|String|Hint used to order items of this type in a list view. For details about the supported format, see [Using order hints in Planner](planner-order-hint-format.md). Inherited from [plannerTask](../resources/plannertask.md).|

+|assignments|[plannerAssignments](../resources/plannerassignments.md)|The set of assignees the task is assigned to. Inherited from [plannerTask](../resources/plannertask.md).|

+|bucketId|String|Bucket ID to which the task belongs. Inherited from [plannerTask](../resources/plannertask.md).|

+|businessScenarioProperties|[businessScenarioProperties](../resources/businessscenarioproperties.md)|Scenario-specific properties of the task. **externalObjectId** and **externalBucketId** properties must be specified when creating a task.|

+|checklistItemCount|Int32|Number of checklist items that are present on the task. Inherited from [plannerTask](../resources/plannertask.md).|

+|completedBy|[identitySet](../resources/identityset.md)|Identity of the user who completed the task. Inherited from [plannerTask](../resources/plannertask.md). Read-Only.|

+|completedDateTime|DateTimeOffset|Date and time at which the **percentComplete** of the task is set to `100`. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [plannerTask](../resources/plannertask.md). Read-only.|

+|conversationThreadId|String|Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the **group**. Inherited from [plannerTask](../resources/plannertask.md).|

+|createdBy|[identitySet](../resources/identityset.md)|Identity of the user who created the task. Inherited from [plannerTask](../resources/plannertask.md). Read-Only.|

+|createdDateTime|DateTimeOffset|Date and time at which the task is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z` Inherited from [plannerTask](../resources/plannertask.md). Read-only.|

+|creationSource|[plannerTaskCreation](../resources/plannertaskcreation.md)|Contains information about the origin of the task. Inherited from [plannerTask](../resources/plannertask.md).|

+|dueDateTime|DateTimeOffset|Date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [plannerTask](../resources/plannertask.md).|

+|hasDescription|Boolean|`True` indicates that the details object of the task has a non-empty description; otherwise, `false`. Inherited from [plannerTask](../resources/plannertask.md). Read-only.|

+|id|String|The unique identifier for the task. Inherited from [entity](../resources/entity.md). Read-only.|

+|orderHint|String|Hint used to order items of this type in a list view. For details about the supported format, see [Using order hints in Planner](planner-order-hint-format.md). Inherited from [plannerTask](../resources/plannertask.md).|

+|percentComplete|Int32|Percentage of task completion. When set to `100`, the task is considered completed. Inherited from [plannerTask](../resources/plannertask.md).|

+|planId|String|Identifier of the plan to which the task belongs. Inherited from [plannerTask](../resources/plannertask.md).|

+|previewType|plannerPreviewType|This sets the type of preview that shows up on the task. Possible values are: `automatic`, `noPreview`, `checklist`, `description`, `reference`. Inherited from [plannerTask](../resources/plannertask.md).|

+|priority|Int32|Priority of the task. Valid range of values is between `0` and `10` (inclusive), with increasing value being lower priority (`0` has the highest priority and `10` has the lowest priority). Currently, Planner interprets values `0` and `1` as "urgent", `2`, `3`, and `4` as "important", `5`, `6`, and `7` as "medium", and `8`, `9`, and `10` as "low". Currently, Planner sets the value `1` for "urgent", `3` for "important", `5` for "medium", and `9` for "low". Inherited from [plannerTask](../resources/plannertask.md).|

+|referenceCount|Int32|Number of external references that exist on the task. Inherited from [plannerTask](../resources/plannertask.md).|

+|startDateTime|DateTimeOffset|Date and time at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [plannerTask](../resources/plannertask.md).|

+|target|[businessScenarioTaskTargetBase](../resources/businessscenariotasktargetbase.md)|Target of the task that specifies where the task should be placed. Must be specified when creating a task.|

+|title|String|Title of the task. Inherited from [plannerTask](../resources/plannertask.md).|

+## Relationships

+|Relationship|Type|Description|

+|:|:|:|

+|assignedToTaskBoardFormat|[plannerAssignedToTaskBoardTaskFormat](../resources/plannerassignedtotaskboardtaskformat.md)|Used to render the task correctly in the task board view when grouped by **assignedTo**. Inherited from [plannerTask](../resources/plannertask.md).|

+|bucketTaskBoardFormat|[plannerBucketTaskBoardTaskFormat](../resources/plannerbuckettaskboardtaskformat.md)|Used to render the task correctly in the task board view when grouped by **bucket**. Inherited from [plannerTask](../resources/plannertask.md).|

+|details|[plannerTaskDetails](../resources/plannertaskdetails.md)|Additional details about the task. Inherited from [plannerTask](../resources/plannertask.md).|

+|progressTaskBoardFormat|[plannerProgressTaskBoardTaskFormat](../resources/plannerprogresstaskboardtaskformat.md)|Used to render the task correctly in the task board view when grouped by **progress**. Inherited from [plannerTask](../resources/plannertask.md).|

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

+ "@odata.type": "microsoft.graph.businessScenarioTask",

+ "baseType": "microsoft.graph.plannerTask",

+ "openType": false

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.businessScenarioTask",

+ "activeChecklistItemCount": "Int32",

+ "appliedCategories": {"@odata.type": "microsoft.graph.plannerAppliedCategories"},

+ "assigneePriority": "String",

+ "assignments": {"@odata.type": "microsoft.graph.plannerAssignments"},

+ "bucketId": "String",

+ "businessScenarioProperties": {"@odata.type": "microsoft.graph.businessScenarioProperties"},

+ "checklistItemCount": "Int32",

+ "completedBy": {"@odata.type": "microsoft.graph.identitySet"},

+ "completedDateTime": "String (timestamp)",

+ "conversationThreadId": "String",

+ "createdBy": {"@odata.type": "microsoft.graph.identitySet"},

+ "createdDateTime": "String (timestamp)",

+ "creationSource": {"@odata.type": "microsoft.graph.plannerTaskCreation"},

+ "dueDateTime": "String (timestamp)",

+ "hasDescription": "Boolean",

+ "id": "String (identifier)",

+ "orderHint": "String",

+ "percentComplete": "Int32",

+ "planId": "String",

+ "previewType": "String",

+ "priority": "Int32",

+ "referenceCount": "Int32",

+ "startDateTime": "String (timestamp)",

+ "target": {"@odata.type": "microsoft.graph.businessScenarioTaskTargetBase"},

+ "title": "String"

+}

+```

+ Title: "businessScenarioTaskTargetBase resource type"

+description: "An abstract type that represents a base object for all targets that can be specified for creating tasks for a scenario."

+ms.localizationpriority: medium

+# businessScenarioTaskTargetBase resource type

+Namespace: microsoft.graph

+An abstract type that represents a base object for all targets that can be specified for creating tasks for a scenario.

+Base type of [businessScenarioGroupTarget](businessscenariogrouptarget.md).

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|taskTargetKind|plannerTaskTargetKind|Represents the kind of the target. The possible values are: `group`, `unknownFutureValue`.|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.businessScenarioTaskTargetBase"

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.businessScenarioTaskTargetBase",

+ "taskTargetKind": "String"

+}

+```

+|Set up rules to alert issues on the Microsoft Endpoint Manager admin center with provisioning Cloud PCs, uploading Cloud PC images, and checking Azure network connections. |[alertRecord](devicemanagement-alertrecord.md), [alertRule](devicemanagement-alertrule.md) | [Alert monitoring API](devicemanagement-monitoring.md) |

+| Method | Return type | Description |

+| : | : | : |

+| [Create cloudPcExportJob](../api/cloudpcreports-post-exportjobs.md) | [cloudPcExportJob](../resources/cloudpcexportjob.md) | Create a new [cloudPcExportJob](../resources/cloudpcexportjob.md) object. |

+| [Get cloudPcExportJob](../api/cloudpcexportjob-get.md) | [cloudPcExportJob](../resources/cloudpcexportjob.md) | Read the properties and relationships of a [cloudPcExportJob](../resources/cloudpcexportjob.md) object. |

+| Property | Type | Description |

+| :-- | :- | :-- |

+| expirationDateTime | DateTimeOffset | The date and time when the export job expires. |

+| exportJobStatus | [cloudPcExportJobStatus](#cloudpcexportjobstatus-values) | The status of the export job. The possible values are: `notStarted`, `inProgress`, `completed`, `unknownFutureValue`. Read-only. |

+| exportUrl | String | The storage account URL of the exported report. It can be used to download the file. |

+| filter | String | The filter applied on the report. |

+| format | String | The format of the exported report. |

+| id | String | The unique identifier for the report. Read-only. |

+| reportName | [cloudPcReportName](#cloudpcreportname-values) | The report name. The possible values are: `remoteConnectionHistoricalReports`, `dailyAggregatedRemoteConnectionReports`, `totalAggregatedRemoteConnectionReports`, `unknownFutureValue`. |

+| requestDateTime | DateTimeOffset | The date and time when the export job was requested. |

+| select | String collection | The selected columns of the report. |

+| Member | Description |

+| :-- | :- |

+| notStarted | The export job doesn't start yet. |

+| inProgress | The export job is in progress. |

+| completed | The export job is completed with export URL returned. |

+| failed | The export job has failed. |

+| unknownFutureValue | Evolvable enumeration sentinel value. Do not use. |

+| Member | Description |

+| :- | : |

+| remoteConnectionHistoricalReports | The historical remote connections report. |

+| dailyAggregatedRemoteConnectionReports | The daily aggregated remote connections report. |

+| totalAggregatedRemoteConnectionReports | The total aggregated remote connections report. |

+| sharedUseLicenseUsageReport | Indicates daily/hourly aggregated shared use license usage report. |

+| sharedUseLicenseUsageRealTimeReport | Indicates real-time data for shared use license usage. |

+| unknownFutureValue | Evolvable enumeration sentinel value. Do not use. |

+## Relationships

+None.

+ "expirationDateTime": "String (timestamp)",

+ "exportJobStatus": "String",

+ "exportUrl": "String",

+ "filter": "String",

+ "format": "String",

+ "requestDateTime": "String (timestamp)",

+ ]

+|managedBy|[cloudPcManagementService](#cloudpcmanagementservice-values)|Specifies which services manage the Azure network connection. Possible values are: `windows365`, `devBox`, `rpaBox`, `unknownFutureValue`. Read-only.|

+| Member | Description |

+|:-|:|

+| windows365 | Azure network connection was successfully created through Windows365. |

+| devBox | Azure network connection was successfully created through Project Fidalgo. |

+| unknownFutureValue | Evolvable enumeration sentinel value. Do not use. |

+| rpaBox | The Azure network connection was successfully created through the Power Automate project. |

+|managedBy|[cloudPcManagementService](../resources/cloudpconpremisesconnection.md#cloudpcmanagementservice-values)|Specifies which services manage the Azure network connection. Possible values are: `windows365`, `devBox`, `rpaBox`, `unknownFutureValue`. Read-only.|

+|[getSharedUseLicenseUsageReport](../api/cloudpcreports-getshareduselicenseusagereport.md)|Stream|Get the shared use license usage reports, such as **servicePlanId**, **licenseCount**, and **claimedLicenseCount**, for real-time, 7 days, or 28 days trend.|

+| Property | Type | Description |

+|: |: |: |

+|regionGroup|[cloudPcRegionGroup](#cloudpcregiongroup-values)|The geographic group this region belongs to. Multiple regions can belong to one region group. For example, the `europeUnion` region group contains the Northern Europe and Western Europe regions. A customer can select a region group when provisioning a Cloud PC; however, the Cloud PC will be put under one of the regions under the group based on resource capacity. The region with more quota will be chosen. Possible values are: `default`, `australia`, `canada`, `usCentral`, `usEast`, `usWest`, `france`, `germany`, `europeUnion`, `unitedKingdom`, `japan`, `asia`, `india`, `southAmerica`, `euap`, `usGovernment`, `usGovernmentDOD`, `norway`, `switzerland`，`southKorea`, `unknownFutureValue`. Read-only.|

+|supportedSolution|[cloudPcManagementService](../resources/cloudpconpremisesconnection.md#cloudpcmanagementservice-values)|The supported service or solution for the region. The possible values are: `windows365`, `devBox`, `rpaBox`, `unknownFutureValue`. Read-only.|

+### cloudPcRegionGroup values

+| Member | Description |

+|:-|:--|

+| default | The region belongs to the default region group. |

+| australia | The region belongs to the region group: Australia. |

+| canada | The region belongs to the region group: Canada. |

+| usCentral | The region belongs to the region group: Central US. |

+| usEast | The region belongs to the region group: East US. |

+| usWest | The region belongs to the region group: West US. |

+| france | The region belongs to the region group: France. |

+| germany | The region belongs to the region group: Germany. |

+| europeUnion | The region belongs to the region group: European Union. |

+| unitedKingdom | The region belongs to the region group: United Kingdom. |

+| japan | The region belongs to the region group: Japan. |

+| asia | The region belongs to the region group: Asia. |

+| india | The region belongs to the region group: India. |

+| southAmerica | The region belongs to the region group: South America. |

+| euap | The region belongs to the region group: Early Update Access Program. |

+| usGovernment | The region belongs to the region group: US Government. |

+| usGovernmentDOD | The region belongs to the region group: US Government Department of Defense (DOD). |

+| unknownFutureValue | Evolvable enumeration sentinel value. Do not use. |

+| norway | The region belongs to the region group: Norway. |

+| switzerland | The region belongs to the region group: Switzerland. |

+| southKorea | The region belongs to the region group: South Korea. |

+ "regionGroup": "String",

+|aggregationType|[microsoft.graph.deviceManagement.aggregationType](../resources/devicemanagement-ruleThreshold.md#aggregationtype-values)|The aggregation type of the impact. The possible values are: `count`, `percentage`, `affectedCloudPcCount`, `affectedCloudPcPercentage`, `unknownFutureValue`. |

+|value|Int32|The number value of the impact. For the aggregation types of `count` and `affectedCloudPcCount`, the value indicates the number of affected instances. For example, `6 affectedCloudPcCount` means that 6 Cloud PCs are affected. For the aggregation types of `percentage` and `affectedCloudPcPercentage`, the value indicates the percent of affected instances. For example, `12 affectedCloudPcPercentage` means that 12% of Cloud PCs are affected. |

+Represents the record of an alert event in the Microsoft Endpoint Manager admin center triggered by an [alertRule](devicemanagement-alertrule.md).

+When the threshold of an **alertRule** is reached, an **alertRecord** is generated and stored, and administrators receive notifications via defined notification channels.

+For more information, see the [monitoring](devicemanagement-monitoring.md) resource.

+|[getPortalNotifications](../api/devicemanagement-alertrecord-getportalnotifications.md)|[microsoft.graph.deviceManagement.portalNotification](../resources/devicemanagement-portalnotification.md) collection|Get a list of all portal notifications that one or more users can access, from the Microsoft Endpoint Manager admin center.|

+|[setPortalNotificationAsSent](../api/devicemanagement-alertrecord-setportalnotificationassent.md)|None|Set the status of the specified notification on the Microsoft EndPoint Manager admin center as sent.|

+|alertImpact|[microsoft.graph.deviceManagement.alertImpact](../resources/devicemanagement-alertimpact.md)|The impact of the alert event. Consists of a number followed by the aggregation type. For example, `6 affectedCloudPcCount` means that 6 Cloud PCs are affected. `12 affectedCloudPcPercentage` means 12% of Cloud PCs are affected.|

+Represents a rule that an IT administrator with the appropriate roles can configure to monitor issues and trigger alerts on the Microsoft Endpoint Manager admin center.

+When the threshold of an **alertRule** is reached, an [alertRecord](devicemanagement-alertrecord.md) is generated and stored, and administrators receive notifications via defined notification channels.

+For more information, see the [monitoring](devicemanagement-monitoring.md) resource.

+|isSystemRule|Boolean|Indicates whether the rule is a system rule. If `true`, the rule is a system rule; otherwise, the rule is a custom defined rule and can be edited. System rules are built-in and only a few properties can be edited.|

+|threshold|[microsoft.graph.deviceManagement.ruleThreshold](../resources/devicemanagement-rulethreshold.md)|The conditions to send alerts. For example, send alert when provisioning has failed for greater than or equal to 6 Cloud PCs.|

+description: "Represents the entry point entity type to access all resources related to alerts in the Microsoft Endpoint Manager admin center."

+Represents the entry point to access all resources related to alerts in the [Microsoft Endpoint Manager admin center](https://endpoint.microsoft.com).

+The alert monitoring API provide a programmatic alert experience in the Microsoft Endpoint Manager admin center. A Microsoft Endpoint Manager admin can create an [alert rule](devicemanagement-alertrule.md) with preferred notification channels, and receive alerts when conditions set as thresholds in alert rules are met. Notification channels may include email and Microsoft Endpoint Manager admin center notifications. Each alert is recorded as an [alert record](devicemanagement-alertrecord.md). Admins can review alert records to learn about alert impact, severity, status, and more.

+Only the role of Windows 365 admin has access to the alert monitoring API. Admins also need a role of global admin, Intune admin, or Cloud PC admin to successfully make API calls.

+> [!Note]

+> Currently this API set supports only [Windows 365](/windows-365/overview) and Cloud PC scenarios. It allows admins to set up rules to alert issues with provisioning Cloud PCs, uploading Cloud PC images, and checking Azure network connections.

+>

+> Have a different scenario that can use additional programmatic alert support on the Microsoft Endpoint Manager admin center? [Suggest the feature or vote for existing feature requests](https://developer.microsoft.com/en-us/graph/support).

+Represents the portal notification associated with the [alert record](devicemanagement-alertrecord.md) of a user.

+|isPortalNotificationSent|Boolean|`true` if the portal notification has already been sent to the user; `false` otherwise.|

+Represents details about the threshold settings of an [alert rule](devicemanagement-alertrule.md).

+ Title: "accounts resource type"

+description: "Represents an account object in Dynamics 365 Business Central."

+|blocked|Boolean|Specifies that entries cannot be posted to the G/L account. `True` indicates that the account is blocked and posting is not allowed.|

+|category|String|Specifies the category of the G/L account. Maximum size is 20.|

+|displayName|String|Specifies the name of the G/L account. Maximum size is 50.|

+|id|GUID|The unique identifier for the account.|

+|lastModifiedDateTime|Datetime|The date and time when the account was last modified.|

+|number|String |Specifies the number of the G/L account. Maximum size is 20.|

+|subCategory|String|Specifies the subcategory of the account category of the G/L account. Maximum size is 80.|

+None.

+The following is a JSON representation of the resource.

+ "blocked": "Boolean",

+ "category": "String",

+ "displayName": "String",

+ "lastModifiedDateTime": "Datetime"

+ "number": "String",

+ "subCategory": "String"

+Represents a [payment term](../resources/dynamics-paymentterms.md) in Dynamics 365 Business Central.

+|[Get paymentTerms](../api/dynamics-paymentterms-get.md) |**paymentTerms**|Get a payment terms object. |

+|[Post paymentTerms](../api/dynamics-create-paymentterms.md) |**paymentTerms**|Create a payment terms object.|

+|[Patch paymentTerms](../api/dynamics-paymentterms-update.md) |**paymentTerms**|Update a payment terms object.|

+|[Delete paymentTerms](../api/dynamics-paymentterms-delete.md)|none |Delete a payment terms object.|

+|calculateDiscountOnCreditMemos|Boolean |Specifies whether the discount should be applied to credit memos. `True` indicates a discount will be given; `false`* indicates a discount will not be given.|

+|displayName |string |Specifies the payment term display name. |

+|dueDateCalculation |string |Specifies the formula that is used to calculate the date that a payment must be made.|

+|id |GUID |The unique identifier for the **paymentTerms**. Non-editable. |

+|lastModifiedDateTime |datetime|The date and time when the **paymentTerms** were last modified. Read-Only.|

+None.

+The following is a JSON representation of the resource.

+ "calculateDiscountOnCreditMemos": "boolean",

+ "displayName": "string",

+ "dueDateCalculation": "string",

+ "id": "GUID",

+description: "An abstract type that represents the base class for all education-related resource objects in a system."

+An abstract type that represents the base class for all education-related resource objects in a system.

+Base type of [educationExcelResource](../resources/educationexcelresource.md), [educationFileResource](../resources/educationfileresource.md), [educationLinkResource](../resources/educationlinkresource.md), [educationPowerPointResource](../resources/educationpowerpointresource.md), [educationWordResource](../resources/educationwordresource.md), [educationMediaResource](../resources/educationmediaresource.md), [educationExternalResource](../resources/educationexternalresource.md), and [educationTeamsAppResource](../resources/educationteamsappresource.md).

+description: "Corresponds to an installed Microsoft Teams app."

+Corresponds to an [installed Microsoft Teams app](teamsappinstallation.md). This allows education service users to create and share assignments with embedded Teams applications, such as YouTube or Flip.

+For information about using Flip for education on Microsoft Teams, see [introduction to Flip](/training/educator-center/product-guides/flip).

+Inherits from [educationResource](educationresource.md).

+| Property | Type | Description |

+|:|:|:--|

+| appIconWebUrl | String | URL that points to the icon of the app. |

+| appId | String | Teams app ID of the application. |

+| createdBy | [identitySet](identityset.md) | Identity of the user who created this resource. Inherited from **educationResource**. |

+| createdDateTime | DateTimeOffset | The date and time when the resource was added. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from **educationResource**. |

+| displayName | String | The display name of the resource. Inherited from **educationResource**. |

+| lastModifiedBy | [identitySet](identityset.md) | Identity of the user who last modified the resource. Inherited from **educationResource**. |

+| lastModifiedDateTime | DateTimeOffset | The date and time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from **educationResource**. |

+| teamsEmbeddedContentUrl | String | URL for the app resource that will be opened by Teams. |

+| webUrl | String | URL for the app resource that can be opened in the browser. |

+ "appIconWebUrl": "String",

+ "appId": "String",

+ "displayName": "String",

+ "lastModifiedDateTime": "String (timestamp)",

+ "teamsEmbeddedContentUrl": "String",

+ "webUrl": "String"

+ "description": "educationTeamsAppResource resource",

+|[Update emailAuthenticationMethodConfiguration](../api/emailauthenticationmethodconfiguration-update.md)|None|Update the properties of an emailAuthenticationMethodConfiguration object.|

+|[Delete emailAuthenticationMethodConfiguration](../api/emailauthenticationmethodconfiguration-delete.md)|None|Reverts the emailAuthenticationMethodConfiguration object to its default configuration.|

+|excludeTargets|[excludeTarget](../resources/excludetarget.md) collection|Groups of users that are excluded from the policy.|

+|includeTargets|[authenticationMethodTarget](../resources/authenticationmethodtarget.md) collection|A collection of groups that are enabled to use the authentication method.|

+ "excludeTargets": [

+ {

+ "@odata.type": "microsoft.graph.excludeTarget"

+ }

+ ],

+### plannerRelationshipUserRoles values

+|Member|

+|:|

+|defaultRules|

+|groupOwners|

+|groupMembers|

+|taskAssignees|

+|applications|

+|unknownFutureValue|

+### plannerRuleKind values

+|Member|

+|:|

+|taskRule|

+|bucketRule|

+|planRule|

+|unknownFutureValue|

+### plannerUserRoleKind values

+|Member|

+|:|

+|relationship|

+|unknownFutureValue|

+### plannerTaskTargetKind values

+|Member|

+|:|

+|group|

+|unknownFutureValue|

+|enabledForPercentage|

+### authenticationMethodTargetType values

+|Member|

+|:--|

+|group|

+|unknownFutureValue|

+### authenticationMethodsPolicyMigrationState values

+|Member|

+|:--|

+|premigration|

+|migrationInProgress|

+|migrationComplete|

+|id|String|The object identifier of an Azure AD group.|

+|targetType|authenticationMethodTargetType|The type of the authentication method target. Possible values are: `group` and `unknownFutureValue`.|

+|[Update](../api/fido2authenticationmethodconfiguration-update.md)|None|Update the properties of a fido2AuthenticationMethodConfiguration object.|

+|excludeTargets|[excludeTarget](../resources/excludetarget.md) collection|Groups of users that are excluded from the policy.|

+|includeTargets|[authenticationMethodTarget](../resources/authenticationmethodtarget.md) collection|A collection of groups that are enabled to use the authentication method.|

+ "excludeTargets": [

+ {

+ "@odata.type": "microsoft.graph.excludeTarget"

+ }

+ ],

+| isAssignableToRole | Boolean | Indicates whether this group can be assigned to an Azure Active Directory role. Optional. <br><br>This property can only be set while creating the group and is immutable. If set to `true`, the **securityEnabled** property must also be set to `true`, **visibility** must be `Hidden`, and the group cannot be a dynamic group (that is, **groupTypes** cannot contain `DynamicMembership`). <br/><br/>Only callers in Global Administrator and Privileged Role Administrator roles can set this property. The caller must also be assigned the _RoleManagement.ReadWrite.Directory_ permission to set this property or update the membership of such groups. For more, see [Using a group to manage Azure AD role assignments](https://go.microsoft.com/fwlink/?linkid=2103037)<br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`). |

+## Group membership

+Not all object types can be members of both Microsoft 365 and security groups.

+Microsoft 365 groups in Yammer are used to facilitate user collaboration through Yammer posts. This type of group can be returned through a read request, but their posts can't be accessed through the API. When Yammer posts and conversation feeds are enabled on a group, default Microsoft 365 group conversations are disabled. To learn more, see [Yammer developer API docs](/rest/api/yammer/).

+- Organizations are limited to a maximum of 10 connections (reach out if you need more).

+- You can create up to 25 `externalItem` resources items per second.

+- An application is limited to 25 concurrent operations on a connection.

+- Connections have a capacity limit of 5,000,000 items or ~350 GB of data.

+description: "An abstract class that contains meeting-specific information."

+An abstract class that contains meeting-specific information.

+Base type of [organizerMeetingInfo](organizermeetinginfo.md), [tokenMeetingInfo](tokenmeetinginfo.md), and [joinMeetingIdMeetingInfo](joinmeetingidmeetinginfo.md).

+## Properties

+None.

+|[Update](../api/microsoftauthenticatorauthenticationmethodconfiguration-update.md)|None|Update the properties of a microsoftAuthenticatorAuthenticationMethodConfiguration object.|

+|excludeTargets|[excludeTarget](../resources/excludetarget.md) collection|Groups of users that are excluded from the policy.|

+|isSoftwareOathEnabled|Boolean|`true` if users can use the OTP code generated by the Microsoft Authenticator app, `false` otherwise.|

+|includeTargets|[microsoftAuthenticatorAuthenticationMethodTarget](../resources/microsoftauthenticatorauthenticationmethodtarget.md) collection|A collection of groups that are enabled to use the authentication method. Expanded by default.|

+ "state": "String",

+ "excludeTargets": [

+ {

+ "@odata.type": "microsoft.graph.excludeTarget"

+ }

+ ],

+ "isSoftwareOathEnabled": "Boolean",

+ "featureSettings": {

+ "@odata.type": "microsoft.graph.microsoftAuthenticatorFeatureSettings"

+ }

+description: "A collection of groups enabled to use Microsoft Authenticator authentication methods policy."

+A collection of groups enabled to use [Microsoft Authenticator authentication methods policy](../resources/microsoftAuthenticatorAuthenticationMethodConfiguration.md) in Azure AD. Inherits from [authenticationMethodTarget](authenticationMethodTarget.md).

+|isRegistrationRequired|Boolean|Determines whether the user is enforced to register the authentication method. Inherited from [authenticationMethodTarget](authenticationmethodtarget.md). **Not supported**. |

+|targetType|authenticationMethodTargetType| Possible values are: `group`, and `unknownFutureValue`. From December 2022, targeting individual users using `user` is no longer recommended. Existing targets will remain but we recommend to move the individual users to a targeted group. Inherited from [authenticationMethodTarget](authenticationMethodTarget.md).|

+| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a meeting. |

+| joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Once an **onlineMeeting** is created, the **joinMeetingIdSettings** cannot be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created. |

+| joinWebUrl | String | The join URL of the online meeting. Read-only. |

+ "allowedPresenters": "String",

+ "alternativeRecording": "Stream",

+ "attendeeReport": "Stream",

+ "joinInformation": {"@odata.type": "microsoft.graph.itemBody"},

+ "recordAutomatically": "Boolean",

+ "recording": "Stream",

+|includeTargets|[passwordlessMicrosoftAuthenticatorAuthenticationMethodTarget](../resources/passwordlessmicrosoftauthenticatorauthenticationmethodtarget.md) collection|A collection of groups that are enabled to use the authentication method.|

+description: "A collection of groups enabled to use Microsoft Authenticator Passwordless Phone Sign-in authentication methods policy."

+A collection of groups enabled to use Microsoft Authenticator Passwordless Phone Sign-in authentication methods policy](../resources/passwordlessMicrosoftAuthenticatorAuthenticationMethodConfiguration.md) in Azure AD.

+Contains information about the relationship of a [plannerBucket](plannerbucket.md) to a user experience outside of Planner. This allows surfacing or syncing buckets in Planner with other experiences to track work in the context of that experience.

+You can display data in a **plannerExternalBucketSource** in a user interface to sync information for an external service, or to simply point to where a task was created in the external service.

+The combination of the **contextScenarioId** and **externalObjectId** properties is unique within a tenant. If creation is called with existing **contextScenarioId** and **externalObjectId** values, the existing object is returned with no modifications.

+This type is derived from [plannerBucketCreation](plannerBucketCreation.md).

+Contains information about the relationship of a [plannerPlan](plannerplan.md) to a user experience outside of Planner. This allows surfacing or syncing plans in Planner with other experiences to track work in the context of that experience.

+You can display data in a **plannerExternalPlanSource** in a user interface to sync information for an external service, or to simply point to where a plan was created in the external service.

+The combination of the **contextScenarioId** and **externalObjectId** properties is unique within a tenant. If creation is called with existing **contextScenarioId** and **externalObjectId** values, the existing object is returned with no modifications.

+This type is derived from [plannerPlanCreation](plannerPlanCreation.md).

+Contains information about the relationship of a [plannerTask](plannerTask.md) to a user experience outside of Planner. This allows surfacing or syncing tasks in Planner with other experiences to track work in the context of that experience.

+You can display data in a **plannerExternalTaskSource** in a user interface to sync information for an external service, or to simply point to where a task was created in the external service.

+The combination of the **contextScenarioId** and **externalObjectId** properties is unique within a tenant. If creation is called with existing **contextScenarioId** and **externalObjectId** values, the existing object is returned with no modifications.

+This type is derived from [plannerTaskCreation](plannerTaskCreation.md).

+ Title: "plannerFieldRules resource type"

+description: "Represents the rules and permissions that apply to a property as part of a plannerTaskPropertyRule."

+ms.localizationpriority: medium

+# plannerFieldRules resource type

+Namespace: microsoft.graph

+Represents the rules and permissions that apply to a property as part of a [plannerTaskPropertyRule](../resources/plannertaskpropertyrule.md).

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|defaultRules|String collection|The default rules that apply if no override matches to the current data.|

+|overrides|[plannerRuleOverride](../resources/plannerruleoverride.md) collection|Overrides that specify different rules for specific data associated with the field.|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.plannerFieldRules"

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.plannerFieldRules",

+ "defaultRules": ["String"],

+ "overrides": [{"@odata.type": "microsoft.graph.plannerRuleOverride"}]

+}

+```

+|container|[plannerPlanContainer](../resources/plannerplancontainer.md)|Identifies the container of the plan. Specify only the **url**, the **containerId** and **type**, or all properties. After it is set, this property canΓÇÖt be updated. Required.|

+ Title: "plannerPlanConfiguration resource type"

+description: "Represents the configuration of plannerPlan resources created for a businessScenario."

+ms.localizationpriority: medium

+# plannerPlanConfiguration resource type

+Namespace: microsoft.graph

+Represents the configuration of [plannerPlan](../resources/plannerplan.md) resources created for a [businessScenario](../resources/businessscenario.md).

+Inherits from [entity](../resources/entity.md).

+## Methods

+|Method|Return type|Description|

+|:|:|:|

+|[Get plannerPlanConfiguration](../api/plannerplanconfiguration-get.md)|[plannerPlanConfiguration](../resources/plannerplanconfiguration.md)|Read the properties and relationships of a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) object.|

+|[Update plannerPlanConfiguration](../api/plannerplanconfiguration-update.md)|[plannerPlanConfiguration](../resources/plannerplanconfiguration.md)|Update the properties of a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) object for a [businessScenario](../resources/businessscenario.md). |

+|[List localizations](../api/plannerplanconfiguration-list-localizations.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) collection|Get the plannerPlanConfigurationLocalization resources from the localizations navigation property.|

+|[Create plannerPlanConfigurationLocalization](../api/plannerplanconfiguration-post-localizations.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md)|Create a new plannerPlanConfigurationLocalization object.|

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|buckets|[plannerPlanConfigurationBucketDefinition](../resources/plannerplanconfigurationbucketdefinition.md) collection|List the buckets that should be created in the plan.|

+|createdBy|[identitySet](../resources/identityset.md)|The identity of the creator of the plan configuration.|

+|createdDateTime|DateTimeOffset|The date and time when the plan configuration was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. |

+|defaultLanguage|String|The language code for the default language to be used for the names of the objects created for the plan.|

+|id|String|The unique identifier for the plan configuration. Inherited from [entity](../resources/entity.md). |

+|lastModifiedBy|[identitySet](../resources/identityset.md)|The identity of the user who last modified the plan configuration. |

+|lastModifiedDateTime|DateTimeOffset|The date and time when the plan configuration was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. |

+## Relationships

+|Relationship|Type|Description|

+|:|:|:|

+|localizations|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) collection|Localized names for the plan configuration.|

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

+ "@odata.type": "microsoft.graph.plannerPlanConfiguration",

+ "baseType": "microsoft.graph.entity",

+ "openType": false

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.plannerPlanConfiguration",

+ "buckets": [{"@odata.type": "microsoft.graph.plannerPlanConfigurationBucketDefinition"}],

+ "createdBy": {"@odata.type": "microsoft.graph.identitySet"},

+ "createdDateTime": "String (timestamp)",

+ "defaultLanguage": "String",

+ "id": "String (identifier)",

+ "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},

+ "lastModifiedDateTime": "String (timestamp)"

+}

+```

+ Title: "plannerPlanConfigurationBucketDefinition resource type"

+description: "Represents a bucket in a plannerPlanConfiguration."

+ms.localizationpriority: medium

+# plannerPlanConfigurationBucketDefinition resource type

+Namespace: microsoft.graph

+Represents a bucket in a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md).

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|externalBucketId|String|Application-specified identifier of the bucket. |

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketDefinition"

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.plannerPlanConfigurationBucketDefinition",

+ "externalBucketId": "String"

+}

+```

+ Title: "plannerPlanConfigurationBucketLocalization resource type"

+description: "Represents the localized name of a bucket in a plannerPlanConfigurationLocalization."

+ms.localizationpriority: medium

+# plannerPlanConfigurationBucketLocalization resource type

+Namespace: microsoft.graph

+Represents the localized name of a bucket in a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md).

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|externalBucketId|String|Application-specified identifier of the bucket.|

+|name|String|Name of the bucket.|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization"

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.plannerPlanConfigurationBucketLocalization",

+ "externalBucketId": "String",

+ "name": "String"

+}

+```

+ Title: "plannerPlanConfigurationLocalization resource type"

+description: "Represents the localized names for a plannerPlanConfiguration for a specific language."

+ms.localizationpriority: medium

+# plannerPlanConfigurationLocalization resource type

+Namespace: microsoft.graph

+Represents the localized names for a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) for a specific language.

+Inherits from [entity](../resources/entity.md).

+## Methods

+|Method|Return type|Description|

+|:|:|:|

+|[List plannerPlanConfigurationLocalizations](../api/plannerplanconfiguration-list-localizations.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) collection|Get a list of the [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) objects and their properties.|

+|[Create plannerPlanConfigurationLocalization](../api/plannerplanconfiguration-post-localizations.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md)|Create a new [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.|

+|[Get plannerPlanConfigurationLocalization](../api/plannerplanconfigurationlocalization-get.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md)|Read the properties and relationships of a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.|

+|[Update plannerPlanConfigurationLocalization](../api/plannerplanconfigurationlocalization-update.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md)|Update the properties of a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.|

+|[Delete plannerPlanConfigurationLocalization](../api/plannerplanconfiguration-delete-localizations.md)|None|Delete a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.|

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|buckets|[plannerPlanConfigurationBucketLocalization](../resources/plannerplanconfigurationbucketlocalization.md) collection|Localized names for configured buckets in the plan configuration.|

+|id|String|The unique identifier for the plan configuration location. Inherited from [entity](../resources/entity.md).|

+|languageTag|String|The language code associated with the localized names in this object.|

+|planTitle|String|Localized title of the plan.|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

+ "@odata.type": "microsoft.graph.plannerPlanConfigurationLocalization",

+ "baseType": "microsoft.graph.entity",

+ "openType": false

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization",

+ "buckets": [{"@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization"}],

+ "id": "String (identifier)",

+ "languageTag": "String",

+ "planTitle": "String"

+

+}

+```

+|containerId|String|The identifier of the resource that contains the plan. Optional.|

+|type|plannerContainerType|The type of the resource that contains the plan. For supported types, see the previous table. Possible values are: `group`, `unknownFutureValue`, `roster`, and `project`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `roster`, `project`. Optional.|

+|url|String|The full canonical URL of the container. Optional.|

+ Title: "plannerPropertyRule resource type"

+description: "An abstract base type of all entity rule definitions for Microsoft Planner."

+ms.localizationpriority: medium

+# plannerPropertyRule resource type

+Namespace: microsoft.graph

+An abstract base type of all entity rule definitions for Microsoft Planner.

+Base type of [plannerTaskPropertyRule](plannertaskpropertyrule.md).

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|ruleKind|plannerRuleKind|Identifies which type of property rules is represented by this instance. The possible values are: `taskRule`, `bucketRule`, `planRule`, `unknownFutureValue`.|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.plannerPropertyRule"

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.plannerPropertyRule",

+ "ruleKind": "String"

+}

+```

+ Title: "plannerRelationshipBasedUserType resource type"

+description: "Represents a role based on the caller's relationship to the businessScenarioTask that a plannerTaskRoleBasedRule can be applied to."

+ms.localizationpriority: medium

+# plannerRelationshipBasedUserType resource type

+Namespace: microsoft.graph

+Represents a role based on the caller's relationship to the [businessScenarioTask](../resources/businessscenariotask.md) that a [plannerTaskRoleBasedRule](../resources/plannertaskrolebasedrule.md) can be applied to.

+Inherits from [plannerTaskConfigurationRoleBase](../resources/plannertaskconfigurationrolebase.md).

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|role|plannerRelationshipUserRoles|Identifies the relationship of the caller to the task. The possible values are: `defaultRules`, `groupOwners`, `groupMembers`, `taskAssignees`, `applications`, `unknownFutureValue`.|

+|roleKind|plannerUserRoleKind|The kind of the rule. The value must be `relationship`. The possible values are: `relationship`, `unknownFutureValue`. Inherited from [plannerTaskConfigurationRoleBase](../resources/plannertaskconfigurationrolebase.md).|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.plannerRelationshipBasedUserType"

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.plannerRelationshipBasedUserType",

+ "role": "String",

+ "roleKind": "String"

+}

+```

+ Title: "plannerRuleOverride resource type"

+description: "Represents an overridden rule as part of plannerFieldRules."

+ms.localizationpriority: medium

+# plannerRuleOverride resource type

+Namespace: microsoft.graph

+Represents an overridden rule as part of [plannerFieldRules](../resources/plannerfieldrules.md).

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|name|String|Name of the override. Allowed override values will be dependent on the property affected by the rule.|

+|rules|String collection|Overridden rules. These are used as rules for the override instead of the default rules.|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.plannerRuleOverride"

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.plannerRuleOverride",

+ "name": "String",

+ "rules": ["String"]

+}

+```

+ Title: "plannerTaskConfiguration resource type"

+description: "Represents the configuration of plannerTasks created for a businessScenario."

+ms.localizationpriority: medium

+# plannerTaskConfiguration resource type

+Namespace: microsoft.graph

+Represents the configuration of [plannerTasks](../resources/plannertask.md) created for a [businessScenario](../resources/businessscenario.md).

+Inherits from [entity](../resources/entity.md).

+## Methods

+|Method|Return type|Description|

+|:|:|:|

+|[Get plannerTaskConfiguration](../api/plannertaskconfiguration-get.md)|[plannerTaskConfiguration](../resources/plannertaskconfiguration.md)|Read the properties and relationships of a [plannerTaskConfiguration](../resources/plannertaskconfiguration.md) object.|

+|[Update plannerTaskConfiguration](../api/plannertaskconfiguration-update.md)|[plannerTaskConfiguration](../resources/plannertaskconfiguration.md)|Update the properties of a [plannerTaskConfiguration](../resources/plannertaskconfiguration.md) object.|

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|editPolicy|[plannerTaskPolicy](../resources/plannertaskpolicy.md)|Policy configuration for tasks created for the businessScenario when they are being changed outside of the scenario.|

+|id|String|The unique identifier for the task configuration. Inherited from [entity](../resources/entity.md).|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

+ "@odata.type": "microsoft.graph.plannerTaskConfiguration",

+ "baseType": "microsoft.graph.entity",

+ "openType": false

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.plannerTaskConfiguration",

+ "editPolicy": {"@odata.type": "microsoft.graph.plannerTaskPolicy"},

+ "id": "String (identifier)"

+}

+```

+ Title: "plannerTaskConfigurationRoleBase resource type"

+description: "An abstract type that represents a role that a plannerTaskRoleBasedRule can be applied to."

+ms.localizationpriority: medium

+# plannerTaskConfigurationRoleBase resource type

+Namespace: microsoft.graph

+An abstract type that represents a role that a [plannerTaskRoleBasedRule](../resources/plannertaskrolebasedrule.md) can be applied to.

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|roleKind|plannerUserRoleKind|Type of the role. The possible values are: `relationship`, `unknownFutureValue`.|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.plannerTaskConfigurationRoleBase"

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.plannerTaskConfigurationRoleBase",

+ "roleKind": "String"

+}

+```

+ Title: "plannerTaskPolicy resource type"

+description: "Represents the policy configuration for tasks created for a businessScenario when they are being changed outside of the scenario."

+ms.localizationpriority: medium

+# plannerTaskPolicy resource type

+Namespace: microsoft.graph

+Represents the policy configuration for [tasks](../resources/businessscenariotask.md) created for a [businessScenario](../resources/businessscenario.md) when they are being changed outside of the scenario.

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|rules|[plannerTaskRoleBasedRule](../resources/plannertaskrolebasedrule.md) collection|The rules that should be enforced on the tasks when they are being changed outside of the scenario, based on the role of the caller.|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.plannerTaskPolicy"

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.plannerTaskPolicy",

+ "rules": [{"@odata.type": "microsoft.graph.plannerTaskRoleBasedRule"}]

+}

+```

+ Title: "plannerTaskPropertyRule resource type"

+description: "Represents specific restrictions that apply to editing a plannerTask."

+ms.localizationpriority: medium

+# plannerTaskPropertyRule resource type

+Namespace: microsoft.graph

+Represents specific restrictions that apply to editing a [plannerTask](../resources/plannertask.md). For more details, see [Configuring task rules in Planner](/graph/planner-task-rules-overview).

+Inherits from [plannerPropertyRule](../resources/plannerpropertyrule.md).

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|appliedCategories|[plannerFieldRules](../resources/plannerfieldrules.md)|Rules and restrictions for applied categories. This value does not currently support overrides. Accepted values for the default rule and individual overrides are `allow`, `block`.|

+|assignments|[plannerFieldRules](../resources/plannerfieldrules.md)|Rules and restrictions for assignments. Allowed overrides are `userCreated` and `applicationCreated`. Accepted values for the default rule and individual overrides are `allow`, `add`, `addSelf`, `addOther`, `remove`, `removeSelf`, `removeOther`, `block`.|

+|checkLists|[plannerFieldRules](../resources/plannerfieldrules.md)|Rules and restrictions for checklist. Allowed overrides are `userCreated` and `applicationCreated`. Accepted values for the default rule and individual overrides are `allow`, `add`, `remove`, `update`, `check`, `reorder`, `block`.|

+|delete|String collection|Rules and restrictions for deleting the task. Accepted values are `allow` and `block`.|

+|dueDate|String collection|Rules and restrictions for changing the due date of the task. Accepted values are `allow` and `block`.|

+|move|String collection|Rules and restrictions for moving the task between buckets or plans. Accepted values are `allow`, `moveBetweenPlans`, `moveBetweenBuckets`, and `block`.|

+|notes|String collection|Rules and restrictions for changing the notes of the task. Accepted values are `allow` and `block`.|

+|order|String collection|Rules and restrictions for changing the order of the task. Accepted values are `allow` and `block`.|

+|percentComplete|String collection|Rules and restrictions for changing the completion percentage of the task. Accepted values are `allow`, `setToComplete`, `setToNotStarted`, `setToInProgress`, and `block`.|

+|previewType|String collection|Rules and restrictions for changing the preview type of the task. Accepted values are `allow` and `block`.|

+|priority|String collection|Rules and restrictions for changing the priority of the task. Accepted values are `allow` and `block`.|

+|references|[plannerFieldRules](../resources/plannerfieldrules.md)|Rules and restrictions for references. Allowed overrides are `userCreated` and `applicationCreated`. Accepted values for the default rule and individual overrides are `allow`, `add`, `remove`, `block`.|

+|ruleKind|plannerRuleKind|Identifies which type of property rules is represented by this instance. Must be set to `taskRule`. The possible values are: `taskRule`, `bucketRule`, `planRule`, `unknownFutureValue`. Inherited from [plannerPropertyRule](../resources/plannerpropertyrule.md).|

+|startDate|String collection|Rules and restrictions for changing the start date of the task. Accepted values are `allow` and `block`.|

+|title|String collection|Rules and restrictions for changing the title of the task. Accepted values are `allow` and `block`.|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.plannerTaskPropertyRule"

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.plannerTaskPropertyRule",

+ "appliedCategories": {"@odata.type": "microsoft.graph.plannerFieldRules"},

+ "assignments": {"@odata.type": "microsoft.graph.plannerFieldRules"},

+ "checkLists": {"@odata.type": "microsoft.graph.plannerFieldRules"},

+ "delete": ["String"],

+ "dueDate": ["String"],

+ "move": ["String"],

+ "notes": ["String"],

+ "order": ["String"],

+ "percentComplete": ["String"],

+ "previewType": ["String"],

+ "priority": ["String"],

+ "references": {"@odata.type": "microsoft.graph.plannerFieldRules"},

+ "ruleKind": "String",

+ "startDate": ["String"],

+ "title": ["String"]

+}

+```

+ Title: "plannerTaskRoleBasedRule resource type"

+description: "Represents the rules for editing tasks created for a scenario."

+ms.localizationpriority: medium

+# plannerTaskRoleBasedRule resource type

+Namespace: microsoft.graph

+Represents the rules for editing [tasks](../resources/businessscenariotask.md) created for a [scenario](../resources/businessscenario.md).

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|defaultRule|String|Default rule that applies when a property or action-specific rule is not provided. Possible values are: `Allow`, `Block`|

+|propertyRule|[plannerTaskPropertyRule](../resources/plannertaskpropertyrule.md)|Rules for specific properties and actions.|

+|role|[plannerTaskConfigurationRoleBase](../resources/plannertaskconfigurationrolebase.md)|The role these rules apply to.|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.plannerTaskRoleBasedRule"

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.plannerTaskRoleBasedRule",

+ "defaultRule": "String",

+ "propertyRule": {"@odata.type": "microsoft.graph.plannerTaskPropertyRule"},

+ "role": {"@odata.type": "microsoft.graph.plannerTaskConfigurationRoleBase"}

+}

+```

+| [Set user status message](../api/presence-setstatusmessage.md) | | Set a presence status message for a user. |

+| outOfOfficeSettings | [outOfOfficeSettings](outOfOfficeSettings.md) | The out of office settings for a user. |

+| statusMessage | [microsoft.graph.presenceStatusMessage](presencestatusmessage.md) | The presence status message of a user. |

+ "outOfOfficeSettings":{"@odata.type": "#microsoft.graph.outOfOfficeSettings"},

+ "statusMessage":{"@odata.type": "#microsoft.graph.presenceStatusMessage"}

+ Title: "presenceStatusMessage resource type"

+description: "Represents a presence status message related to the presence of a user in Microsoft Teams."

+ms.localizationpriority: medium

+# presenceStatusMessage resource type

+Namespace: microsoft.graph

+Represents a presence status message related to the [presence](presence.md) of a user in Microsoft Teams.

+## Properties

+| Property | Type | Description |

+| -- | -- | - |

+| expiryDateTime | [microsoft.graph.dateTimeTimeZone](datetimetimezone.md) | Time in which the status message expires.<br/>If not provided, the status message does not expire.<br/><br/>**expiryDateTime.dateTime** should not include time zone.<br/><br/>**expiryDateTime** is not available when requesting presence of another user. |

+| message | [microsoft.graph.itemBody](itembody.md) | Status message item.<br/><br/> The only supported format currently is `message.contentType = 'text'`. |

+| publishedDateTime | DateTimeOffset |Time in which the status message was published.<br/>Read-only.<br/><br/>**publishedDateTime** is not available when requesting presence of another user. |

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "optionalProperties": [

+ "publishedDateTime",

+ "expiryDateTime"

+ ],

+ "@odata.type": "microsoft.graph.presenceStatusMessage"

+}-->

+```json

+{

+ "expiryDateTime": {"@odata.type": "#microsoft.graph.dateTimeTimeZone"},

+ "message": {"@odata.type": "#microsoft.graph.itemBody"},

+ "publishedDateTime": "String"

+}

+```

+Note that collapsing results is currently supported on the following entity types: [driveItem](driveitem.md), [listItem](listitem.md), [drive](drive.md), [list](list.md), [site](site.md), [externalItem](externalconnectors-externalitem.md).

+The properties on which the collapse clause are applied need to be queryable and either sortable or refinable. For multi-level collapse, each subsequent property limit size specified in a multi-level request should be less than or equal to the previous; otherwise, the response will return an `HTTP 400 Bad Request` error.

+Inherits from [searchAnswer](../resources/search-searchanswer.md).

+|[Delete qna](../api/search-qna-delete.md)|None|Delete a [qna](../resources/search-qna.md) object.|

+|availabilityStartDateTime|DateTimeOffset|Timestamp of when the qna will start to appear as a search result. Set as `null` for always available.|

+|description|String|Answer displayed in search results. Inherited from [searchAnswer](../resources/search-searchanswer.md).|

+|displayName|String|Question displayed in search results. Inherited from [searchAnswer](../resources/search-searchanswer.md).|

+|groupIds|String collection|List of security groups able to view this qna.|

+|id|String|The unique identifier (GUID) for the qna. Inherited from [entity](../resources/entity.md).|

+|isSuggested|Boolean| True if this qna was suggested to the admin by a user or was mined and suggested by Microsoft. Read-only.|

+|keywords|[microsoft.graph.search.answerKeyword](../resources/search-answerkeyword.md)|Keywords that trigger this qna to appear in search results.|

+|languageTags|String collection|A list of language names that are geographically specific and that this QnA can be viewed in. Each language tag value follows the pattern {language}-{region}. As an example, `en-us` is English as used in the United States. For the list of possible values, see [supported language tags](search-api-answers-overview.md#supported-language-tags). |

+|lastModifiedBy|[microsoft.graph.identitySet](../resources/identityset.md)|Details of the user that created or last modified the qna. Inherited from [searchAnswer](../resources/search-searchanswer.md). Read-only. |

+|lastModifiedDateTime|DateTimeOffset| Timestamp of when the qna is created or edited. Inherited from [searchAnswer](../resources/search-searchanswer.md). Read-only.|

+|targetedVariations|[microsoft.graph.search.answerVariant](../resources/search-answervariant.md) collection|Variations of a qna for different countries or devices. Use when you need to show different content to users based on their device, country/region, or both. The date and group settings will apply to all variations.|

+|webUrl|String|Qna URL link. When users click this qna in search results, they will go to this URL. Inherited from [searchAnswer](../resources/search-searchanswer.md).|

+ "availabilityEndDateTime": "String (timestamp)",

+ "availabilityStartDateTime": "String (timestamp)",

+ "displayName": "String",

+ "groupIds": [

+ "String"

+ ],

+ "id": "String (identifier)",

+ "isSuggested": "Boolean",

+ "keywords": {

+ "@odata.type": "microsoft.graph.search.answerKeyword"

+ "lastModifiedBy": {

+ "@odata.type": "microsoft.graph.identitySet"

+ },

+ "lastModifiedDateTime": "String (timestamp)",

+ "state": "String",

+ "webUrl": "String"

+|remediationStatus|[microsoft.graph.security.evidenceRemediationStatus](#evidenceremediationstatus-values)|Status of the remediation action taken. The possible values are: `none`, `remediated`, `prevented`, `blocked`, `notFound`, `unknownFutureValue`.|

+| notFound | The evidence was not found. |

+description: "The Microsoft Graph security API provides a unified interface and schema to integrate with security solutions from Microsoft and ecosystem partners."

+## Advanced hunting

+Alerts are detailed warnings about suspicious activities in a customer's tenant that Microsoft or partner security providers have 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.

+- [Alerts and incidents](#alerts-and-incidents) - these are the latest generation of alerts in the Microsoft Graph security API. They are represented by the [alert](security-alert.md) resource and its collection, [incident](security-incident.md) resource, defined in the `microsoft.graph.security` namespace.

+### Alerts and incidents

+## Incidents

+| **Alerts and incidents**|||

+| **Attack simulation and training**|||

+description: "An abstract entity that represents a long-running eDiscovery process."

+An abstract entity that represents a long-running eDiscovery process. It contains a common set of properties that are shared among inheriting entities. Entities that derive from **caseOperation** include:

+Inherits from [entity](../resources/entity.md).

+| estimateStatistics | The operation represents searching against Microsoft 365 services such as Exchange, SharePoint, and OneDrive for Business. |

+| partiallySucceeded | The operation completed, but there were errors. For error details, see [resultInfo](../resources/resultinfo.md). |

+| failed | The operation failed. For error details, see [resultInfo](../resources/resultinfo.md). |

+ "completedDateTime": "String (timestamp)",

+ "createdDateTime": "String (timestamp)",

+ "id": "String (identifier)",

+ "percentProgress": "Int32",

+ },

+ "status": "String"

+```

+|customTags|String collection|Array of custom tags associated with an incident.|

+ "customTags": [

+|countryLetterCode|String|The two-letter country code according to ISO 3166 format, for example: `US`, `UK`, `CA`, etc..).|

+ "ipAddress": "String",

+ "countryLetterCode": "String"

+|[Update](../api/smsauthenticationmethodconfiguration-update.md)|None|Update the properties of a smsAuthenticationMethodConfiguration object.|

+|excludeTargets|[excludeTarget](../resources/excludetarget.md) collection|Groups of users that are excluded from the policy.|

+|includeTargets|[smsAuthenticationMethodTarget](../resources/smsauthenticationmethodtarget.md) collection|A collection of groups that are enabled to use the authentication method.|

+ "state": "String",

+ "excludeTargets": [

+ {

+ "@odata.type": "microsoft.graph.excludeTarget"

+ }

+ ]

+description: "A collection of groups enabled to use Text Message authentication methods policy."

+A collection of groups enabled to use [Text Message authentication methods policy](../resources/smsAuthenticationMethodConfiguration.md) in Azure AD.

+|isUsableForSignIn|Boolean|Determines if users can use this authentication method to sign in to Azure AD. `true` if users can use this method for primary authentication, otherwise `false`.|

+|targetType|authenticationMethodTargetType|Possible values are: `group`, and `unknownFutureValue`. From December 2022, targeting individual users using `user` is no longer recommended. Existing targets will remain but we recommend to move the individual users to a targeted group. Inherited from [authenticationMethodTarget](authenticationMethodTarget.md).|

+ Title: "softwareOathAuthenticationMethodConfiguration resource type"

+description: "Represents the authentication policy for a third-party software OATH authentication method."

+ms.localizationpriority: medium

+# softwareOathAuthenticationMethodConfiguration resource type

+Namespace: microsoft.graph

+Represents the authentication policy for a third-party software OATH authentication method. Authentication methods policies define configuration settings and users or groups that are enabled to use the authentication method.

+## Methods

+|Method|Return type|Description|

+|:|:|:|

+|[Get softwareOathAuthenticationMethodConfiguration](../api/softwareoathauthenticationmethodconfiguration-get.md)|[softwareOathAuthenticationMethodConfiguration](../resources/softwareoathauthenticationmethodconfiguration.md)|Read the properties and relationships of a [softwareOathAuthenticationMethodConfiguration](../resources/softwareoathauthenticationmethodconfiguration.md) object.|

+|[Update softwareOathAuthenticationMethodConfiguration](../api/softwareoathauthenticationmethodconfiguration-update.md)|None|Update the properties of a [softwareOathAuthenticationMethodConfiguration](../resources/softwareoathauthenticationmethodconfiguration.md) object.|

+|[Delete softwareOathAuthenticationMethodConfiguration](../api/softwareoathauthenticationmethodconfiguration-delete.md)|None|Reverts the [softwareOathAuthenticationMethodConfiguration](../resources/softwareoathauthenticationmethodconfiguration.md) object to its default configuration.|

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|excludeTargets|[excludeTarget](../resources/excludetarget.md) collection|Groups of users that are excluded from the policy.|

+|id|String|The authentication method policy identifier.|

+|state|authenticationMethodState|Represents whether users can register this authentication method. The possible values are: `enabled`, `disabled`.|

+## Relationships

+|Relationship|Type|Description|

+|:|:|:|

+|includeTargets|[authenticationMethodTarget](../resources/authenticationmethodtarget.md) collection| A collection of groups that are enabled to use the authentication method. Expanded by default.|

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

+ "@odata.type": "microsoft.graph.softwareOathAuthenticationMethodConfiguration",

+ "baseType": "microsoft.graph.authenticationMethodConfiguration",

+ "openType": false

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.softwareOathAuthenticationMethodConfiguration",

+ "id": "String (identifier)",

+ "state": "String",

+ "excludeTargets": [

+ {

+ "@odata.type": "microsoft.graph.excludeTarget"

+ }

+ ]

+}

+```

+| Property | Type | Description |

+||||

+| applicationId | String | Optional. Identifier of the application used to create the subscription. Read-only. |

+| changeType | String | Required. Indicates the type of change in the subscribed resource that will raise a change notification. The supported values are: `created`, `updated`, `deleted`. Multiple values can be combined using a comma-separated list. <br><br>**Note:** <li> Drive root item and list change notifications support only the `updated` changeType. <li>[User](../resources/user.md) and [group](../resources/user.md) change notifications support `updated` and `deleted` changeType. Use `updated` to receive notifications when user or group is created, updated or soft deleted. Use `deleted` to receive notifications when user or group is permanently deleted. |

+| clientState | String | Optional. Specifies the value of the **clientState** property sent by the service in each change notification. The maximum length is 255 characters. The client can check that the change notification came from the service by comparing the value of the **clientState** property sent with the subscription with the value of the **clientState** property received with each change notification. |

+| creatorId | String | Optional. Identifier of the user or service principal that created the subscription. If the app used delegated permissions to create the subscription, this field contains the ID of the signed-in user the app called on behalf of. If the app used application permissions, this field contains the ID of the service principal corresponding to the app. Read-only. |

+| encryptionCertificate | String | Optional. A base64-encoded representation of a certificate with a public key used to encrypt resource data in change notifications. Optional but required when **includeResourceData** is `true`. |

+| encryptionCertificateId | String | Optional. A custom app-provided identifier to help identify the certificate needed to decrypt resource data. Required when **includeResourceData** is `true`. |

+| expirationDateTime | DateTimeOffset | Required. Specifies the date and time when the webhook subscription expires. The time is in UTC, and can be an amount of time from subscription creation that varies for the resource subscribed to. For the maximum supported subscription length of time, see [the table below](#maximum-length-of-subscription-per-resource-type). |

+| id | String | Optional. Unique identifier for the subscription. Read-only. |

+| includeResourceData | Boolean | Optional. When set to `true`, change notifications [include resource data](/graph/webhooks-with-resource-data) (such as content of a chat message). |

+| latestSupportedTlsVersion | String | Optional. Specifies the latest version of Transport Layer Security (TLS) that the notification endpoint, specified by **notificationUrl**, supports. The possible values are: `v1_0`, `v1_1`, `v1_2`, `v1_3`. </br></br>For subscribers whose notification endpoint supports a version lower than the currently recommended version (TLS 1.2), specifying this property by a set [timeline](https://developer.microsoft.com/graph/blogs/microsoft-graph-subscriptions-deprecating-tls-1-0-and-1-1/) allows them to temporarily use their deprecated version of TLS before completing their upgrade to TLS 1.2. For these subscribers, not setting this property per the timeline would result in subscription operations failing. </br></br>For subscribers whose notification endpoint already supports TLS 1.2, setting this property is optional. In such cases, Microsoft Graph defaults the property to `v1_2`. |

+| lifecycleNotificationUrl | String | Optional. The URL of the endpoint that receives lifecycle notifications, including `subscriptionRemoved`, `reauthorizationRequired`, and `missed` notifications. This URL must make use of the HTTPS protocol. |

+| notificationContentType | String | Optional. Desired **content-type** for Microsoft Graph change notifications for supported resource types. The default content-type is `application/json`. |

+| notificationQueryOptions | String | Optional. OData query options for specifying the value for the targeting resource. Clients receive notifications when the resource reaches the state matching the query options provided here. With this new property in the subscription creation payload along with all existing properties, Webhooks will deliver notifications whenever a resource reaches the desired state mentioned in the **notificationQueryOptions** property. For example, when the print job is completed or when a print job resource `isFetchable` property value becomes `true` etc. <br/><br/> Supported only for Universal Print Service. For more information, see [Subscribe to change notifications from cloud printing APIs using Microsoft Graph](/graph/universal-print-webhook-notifications). |

+| notificationUrl | String | Required. The URL of the endpoint that receives the change notifications. This URL must make use of the HTTPS protocol. |

+| notificationUrlAppId | String | Optional. The app ID that the subscription service can use to generate the validation token. This allows the client to validate the authenticity of the notification received. |

+| resource | String | Required. Specifies the resource that will be monitored for changes. Do not include the base URL (`https://graph.microsoft.com/bet) for each supported resource. |

+| id | string | The unique identifier of the team. The group has the same ID as the team. This property is read-only, and is inherited from the base entity type. |

+- [App catalog sample (C#)](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/graph-appcatalog-lifecycle/csharp)

+- [App catalog sample (Node.JS)](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/graph-appcatalog-lifecycle/nodejs)

+|hiddenMembership|2|Only the administrators (global, company, user, and helpdesk) can view the members of a team.<br>Owner permissions are required to join a team.|

+|excludeTargets|[excludeTarget](../resources/excludetarget.md) collection|Groups of users that are excluded from the policy.|

+|includeTargets|[authenticationMethodTarget](../resources/authenticationmethodtarget.md) collection|A collection of groups that are enabled to use the authentication method.|

+ "excludeTargets": [

+ {

+ "@odata.type": "microsoft.graph.excludeTarget"

+ }

+ ],

+ Title: "voiceAuthenticationMethodConfiguration resource type"

+description: "Represents a voice call authenticaiton methods policy"

+ms.localizationpriority: medium

+# voiceAuthenticationMethodConfiguration resource type

+Namespace: microsoft.graph

+Represents a voice call authentication methods policy. Authentication methods policies define configuration settings and users or groups that are enabled to use the authentication method.

+Inherits from [authenticationMethodConfiguration](../resources/authenticationmethodconfiguration.md).

+## Methods

+|Method|Return type|Description|

+|:|:|:|

+|[Get voiceAuthenticationMethodConfiguration](../api/voiceauthenticationmethodconfiguration-get.md)|[voiceAuthenticationMethodConfiguration](../resources/voiceauthenticationmethodconfiguration.md)|Read the properties and relationships of a [voiceAuthenticationMethodConfiguration](../resources/voiceauthenticationmethodconfiguration.md) object.|

+|[Update voiceAuthenticationMethodConfiguration](../api/voiceauthenticationmethodconfiguration-update.md)|None|Update the properties of a [voiceAuthenticationMethodConfiguration](../resources/voiceauthenticationmethodconfiguration.md) object.|

+|[Delete voiceAuthenticationMethodConfiguration](../api/voiceauthenticationmethodconfiguration-delete.md)|None|Revert the [voiceAuthenticationMethodConfiguration](../resources/voiceauthenticationmethodconfiguration.md) object to its default configuration.|

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|excludeTargets|[excludeTarget](../resources/excludetarget.md) collection|Groups of users that are excluded from the policy.|

+|id|String|The authentication method policy identifier.|

+|isOfficePhoneAllowed|Boolean|`true` if users can register office phones, otherwise, `false`. |

+|state|authenticationMethodState|Represents whether users can register this authentication method. The possible values are: `enabled`, `disabled`.|

+## Relationships

+|Relationship|Type|Description|

+|:|:|:|

+|includeTargets|[voiceAuthenticationMethodTarget](../resources/voiceauthenticationmethodtarget.md) collection|A collection of groups that are enabled to use the authentication method. Expanded by default.|

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

+ "@odata.type": "microsoft.graph.voiceAuthenticationMethodConfiguration",

+ "baseType": "microsoft.graph.authenticationMethodConfiguration",

+ "openType": false

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.voiceAuthenticationMethodConfiguration",

+ "id": "String (identifier)",

+ "state": "String",

+ "excludeTargets": [

+ {

+ "@odata.type": "microsoft.graph.excludeTarget"

+ }

+ ],

+ "isOfficePhoneAllowed": "Boolean"

+}

+```

+ Title: "voiceAuthenticationMethodTarget resource type"

+description: "A collection of groups enabled to use voice call authentication method via policy."

+ms.localizationpriority: medium

+# voiceAuthenticationMethodTarget resource type

+Namespace: microsoft.graph

+A collection of groups enabled to use voice call authentication via the [voice call authentication methods policy](../resources/voiceAuthenticationMethodConfiguration.md) in Azure AD.

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|id|String|Object ID of an Azure AD group.|

+|isRegistrationRequired|Boolean|Determines whether the user is enforced to register the authentication method. **Not supported**.|

+|targetType|authenticationMethodTargetType|Possible values are: `group`, and `unknownFutureValue`. From December 2022, targeting individual users using `user` is no longer recommended. Existing targets will remain but we recommend to move the individual users to a targeted group. Inherited from [authenticationMethodTarget](authenticationMethodTarget.md).|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

+ "@odata.type": "microsoft.graph.voiceAuthenticationMethodTarget",

+ "baseType": "microsoft.graph.authenticationMethodTarget",

+ "openType": false

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.voiceAuthenticationMethodTarget",

+ "id": "String (identifier)",

+ "targetType": "String",

+ "isRegistrationRequired": "Boolean"

+}

+```

+- [subscription resource type](subscription.md)

+- [Training module: Use change notifications and track changes with Microsoft Graph](/training/modules/msgraph-changenotifications-trackchanges)

+- [Lifecycle notifications](/graph/webhooks-lifecycle)

+<!-- Links -->

+|[Update x509CertificateAuthenticationMethodConfiguration](../api/x509certificateauthenticationmethodconfiguration-update.md)|None|Update the properties of a x509CertificateAuthenticationMethodConfiguration object.|

+|excludeTargets|[excludeTarget](../resources/excludetarget.md) collection|Groups of users that are excluded from the policy.|

+|includeTargets|[authenticationMethodTarget](../resources/authenticationmethodtarget.md) collection|A collection of groups that are enabled to use the authentication method.|

+ "excludeTargets": [

+ {

+ "@odata.type": "microsoft.graph.excludeTarget"

+ }

+ ],

+When creating a new group (without `$ref`), this method returns a `201 Created` response code and a [group](../resources/group.md) object in the response body. The response includes only the default properties of the group. You must supply the `"@odata.type" : "#microsoft.graph.group"` line in the request body to explicitly identify the new member as a group. A request body without the correct @odata.type returns a `400 Bad Request` error message.

+The following example creates a new group in the administrative unit. You must supply the `"@odata.type" : "#microsoft.graph.group"` line in the request body to explicitly identify the new member as a group. A request body without the correct @odata.type returns a `400 Bad Request` error message.

+ "@odata.type": "#microsoft.graph.group",

+> In general, the `id` of a **teamsApp** resource is generated by the server. It is not the same as the `id` specified in a Teams app manifest, unless its `distributionMethod` is *store*. For other cases, the `id` provided by the developer as part of the Teams app manifest is stamped as the `externalId` in the teamsApp resource.

+| Delegated (work or school account) | Not supported. |

+| Delegated (personal Microsoft account) | Not supported. |

+| Application | Calls.JoinGroupCalls.Chat*, Calls.JoinGroupCallAsGuest.All, Calls.JoinGroupCall.All, Calls.Initiate.All, Calls.InitiateGroupCall.All |

+>

+> Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).

+The following example shows a request that makes a peer-to-peer call between the bot and the specified user. In this example, the media is hosted by the service. The values of authorization token, callback URL, application ID, application name, user ID, user name, and tenant ID must be replaced with actual values to make the example work.

+ "name": "create-call-service-hosted-media-1",

+}-->

+The following example shows a request that makes a peer-to-peer call between the bot and the specified user. In this example, the media is hosted locally by the application. The values of authorization token, callback URL, application ID, application name, user ID, user name, and tenant ID must be replaced with actual values to make the example work.

+ "name": "create-call-app-hosted-media",

+# [HTTP](#tab/http)

+ "blockType": "request",

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+#### Response

+> **Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "name": "create-group-call-service-hosted-media",

+ "@odata.type": "microsoft.graph.call"

+}-->

+```http

+HTTP/1.1 201 Created

+Location: https://graph.microsoft.com/v1.0/communications/calls/2f1a1100-b174-40a0-aba7-0b405e01ed92

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.call",

+ "state": "establishing",

+ "direction": "outgoing",

+ "subject": "Create a group call with service hosted media",

+ "callbackUri": "https://bot.contoso.com/callback",

+ "callChainId": "d17646-3110-40b1-bae6-e9ac6c3f74",

+ "callRoutes": [],

+ "source": {

+ "@odata.type": "#microsoft.graph.participantInfo",

+ "identity": {

+ "@odata.type": "#microsoft.graph.identitySet",

+ "application": {

+ "@odata.type": "#microsoft.graph.identity",

+ "displayName": "TestBot",

+ "id": "dd3885da-f9ab-486b-bfae-85de3d445555"

+ }

+ },

+ "region": null,

+ "languageId": null

+ },

+ "targets": [

+ {

+ "@odata.type": "#microsoft.graph.invitationParticipantInfo",

+ "identity": {

+ "@odata.type": "#microsoft.graph.identitySet",

+ "user": {

+ "@odata.type": "#microsoft.graph.identity",

+ "displayName": "user1",

+ "id": "98da8a1a-1b87-452c-a713-65d3f10b5555"

+ }

+ }

+ },

+ {

+ "@odata.type": "#microsoft.graph.invitationParticipantInfo",

+ "identity": {

+ "@odata.type": "#microsoft.graph.identitySet",

+ "user": {

+ "@odata.type": "#microsoft.graph.identity",

+ "displayName": "user2",

+ "id": "bf5aae9a-d11d-47a8-93b1-782504c95555"

+ }

+ }

+ }

+ ],

+ "requestedModalities": [

+ "audio"

+ ],

+ "activeModalities": [],

+ "mediaConfig": {

+ "@odata.type": "#microsoft.graph.serviceHostedMediaConfig",

+ },

+ "routingPolicies": [],

+ "tenantId": "aa67bd4c-8475-432d-bd41-39f255720e0a",

+ "id": "2f1a1100-b174-40a0-aba7-0b405e01ed92",

+ "myParticipantId": "c9a65b85-a223-44ae-8cdb-29395458323f",

+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#app/calls/$entity",

+}

+```

+# [HTTP](#tab/http)

+ "blockType": "request",

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+#### Response

+> **Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "name": "create-group-call-app-hosted-media",

+ "@odata.type": "microsoft.graph.call"

+}-->

+```http

+HTTP/1.1 201 Created

+Location: https://graph.microsoft.com/v1.0/communications/calls/2f1a1100-b174-40a0-aba7-0b405e01ed92

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.call",

+ "state": "establishing",

+ "direction": "outgoing",

+ "subject": "Create a group call with app hosted media",

+ "callbackUri": "https://bot.contoso.com/callback",

+ "callChainId": "d8217646-3110-40b1-bae6-e9ac6c3a9f74",

+ "callRoutes": [],

+ "source": {

+ "@odata.type": "#microsoft.graph.participantInfo",

+ "identity": {

+ "@odata.type": "#microsoft.graph.identitySet",

+ "application": {

+ "@odata.type": "#microsoft.graph.identity",

+ "displayName": "TestBot",

+ "id": "dd3885da-f9ab-486b-bfae-85de3d445555"

+ }

+ },

+ "region": null,

+ "languageId": null

+ },

+ "targets": [

+ {

+ "@odata.type": "#microsoft.graph.invitationParticipantInfo",

+ "identity": {

+ "@odata.type": "#microsoft.graph.identitySet",

+ "user": {

+ "@odata.type": "#microsoft.graph.identity",

+ "displayName": "user1",

+ "id": "98da8a1a-1b87-452c-a713-65d3f10b5555"

+ }

+ }

+ },

+ {

+ "@odata.type": "#microsoft.graph.invitationParticipantInfo",

+ "identity": {

+ "@odata.type": "#microsoft.graph.identitySet",

+ "user": {

+ "@odata.type": "#microsoft.graph.identity",

+ "displayName": "user2",

+ "id": "bf5aae9a-d11d-47a8-93b1-782504c95555"

+ }

+ }

+ }

+ ],

+ "requestedModalities": [

+ "audio"

+ ],

+ "activeModalities": [],

+ "mediaConfig": {

+ "@odata.type": "#microsoft.graph.appHostedMediaConfig",

+ "blob": "<Media Session Configuration>",

+ "removeFromDefaultAudioGroup": false

+ },

+ "routingPolicies": [],

+ "tenantId": "aa67bd4c-8475-432d-bd41-39f255720e0a",

+ "id": "2f1a1100-b174-40a0-aba7-0b405e01ed92",

+ "myParticipantId": "c9a65b85-a223-44ae-8cdb-29395458323f",

+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#app/calls/$entity",

+}

+```

+To join the scheduled meeting, you need to get the thread ID, message ID, organizer ID, and the tenant ID in which the meeting is scheduled.

+You can get this information by using the [Get onlineMeeting](../api/onlinemeeting-get.md) API.

+The values of authorization token, callback URL, application ID, application name, user ID, user name, and tenant ID must be replaced along with the details obtained from the [Get onlineMeeting](../api/onlinemeeting-get.md) API with actual values to make the example work.

+# [HTTP](#tab/http)

+ "blockType": "request",

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+Update the media config with the [appHostedMediaConfig](../resources/apphostedmediaconfig.md) as shown in the following example.

+#### Request

+# [HTTP](#tab/http)

+ "blockType": "request",

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+#### Response

+<!-- {

+ "blockType": "response",

+ "@odata.type": "microsoft.graph.call",

+ "truncated": "true"

+}-->

+```http

+HTTP/1.1 201 Created

+Location: https://graph.microsoft.com/v1.0/communications/calls/2f1a1100-b174-40a0-aba7-0b405e01ed92

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.call",

+ "state": "establishing",

+ "direction": "outgoing",

+ "callbackUri": "https://bot.contoso.com/callback",

+ "callChainId": "d8217646-3110-40b1-bae6-e9ac6c3a9f74",

+ "callRoutes": [],

+ "source": {

+ "@odata.type": "#microsoft.graph.participantInfo",

+ "identity": {

+ "@odata.type": "#microsoft.graph.identitySet",

+ "application": {

+ "@odata.type": "#microsoft.graph.identity",

+ "displayName": "Calling Bot",

+ "id": "2891555a-92ff-42e6-80fa-6e1300c6b5c6"

+ }

+ },

+ "region": null,

+ "languageId": null

+ },

+ "targets": [],

+ "requestedModalities": [

+ "audio"

+ ],

+ "activeModalities": [],

+ "mediaConfig": {

+ "@odata.type": "#microsoft.graph.appHostedMediaConfig",

+ "blob": "<Media Session Configuration>",

+ },

+ "chatInfo": {

+ "@odata.type": "#microsoft.graph.chatInfo",

+ "threadId": "19:meeting_Win6Ydo4wsMijFjZS00ZGVjLTk5MGUtOTRjNWY2NmNkYTFm@thread.v2",

+ "messageId": "0",

+ "replyChainMessageId": null

+ },

+ "meetingInfo": {

+ "@odata.type": "#microsoft.graph.organizerMeetingInfo",

+ "organizer": {

+ "@odata.type": "#microsoft.graph.identitySet",

+ "user": {

+ "@odata.type": "#microsoft.graph.identity",

+ "id": "5810cede-f3cc-42eb-b2c1-e9bd5d53ec96",

+ "tenantId": "aa67bd4c-8475-432d-bd41-39f255720e0a",

+ "displayName": "Bob"

+ }

+ },

+ "allowConversationWithoutHost": true

+ },

+ "transcription": null,

+ "routingPolicies": [],

+ "tenantId": "aa67bd4c-8475-432d-bd41-39f255720e0a",

+ "myParticipantId": "05491616-385f-44a8-9974-18cc5f9933c1",

+ "id": "2f1a1100-b174-40a0-aba7-0b405e01ed92",

+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#app/calls/$entity",

+ "terminationReason": null,

+ "ringingTimeoutInSeconds": null,

+ "mediaState": null,

+ "subject": null,

+ "resultInfo": null,

+ "answeredBy": null,

+ "meetingCapability": null,

+ "toneInfo": null

+}

+```

+### Example 7: Join a scheduled meeting with joinMeetingId and passcode

+The following shows an example that requires a **joinMeetingId** and a **passcode** to join an existing meeting. You can retrieve these properties from the [Get onlineMeeting](../api/onlinemeeting-get.md) API.

+#### Request

+The following is an example of a request.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "join-meeting-with-join-meeting-id-and-passcode",

+ "@odata.type": "microsoft.graph.call"

+}-->

+```http

+POST https://graph.microsoft.com/v1.0/communications/calls

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.call",

+ "callbackUri": "https://bot.contoso.com/callback",

+ "requestedModalities": [

+ "audio"

+ ],

+ "mediaConfig": {

+ "@odata.type": "#microsoft.graph.serviceHostedMediaConfig",

+ "preFetchMedia": [

+ {

+ "uri": "https://cdn.contoso.com/beep.wav",

+ "resourceId": "f8971b04-b53e-418c-9222-c82ce681a582"

+ },

+ {

+ "uri": "https://cdn.contoso.com/cool.wav",

+ "resourceId": "86dc814b-c172-4428-9112-60f8ecae1edb"

+ }

+ ]

+ },

+ "meetingInfo": {

+ "@odata.type": "#microsoft.graph.joinMeetingIdMeetingInfo",

+ "joinMeetingId": "1234567",

+ "passcode": "psw123"

+ },

+ "tenantId": "86dc81db-c112-4228-9222-63f3esaa1edb"

+}

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+#### Response

+The following is an example of the response.

+<!-- {

+ "blockType": "response",

+ "name": "join-meeting-with-join-meeting-id-and-passcode",

+ "@odata.type": "microsoft.graph.call"

+}-->

+```http

+HTTP/1.1 201 Created

+Location: https://graph.microsoft.com/v1.0/communications/calls/2f1a1100-b174-40a0-aba7-0b405e01ed92

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.call",

+ "state": "establishing",

+ "direction": "outgoing",

+ "callbackUri": "https://bot.contoso.com/callback",

+ "callChainId": "d8217646-3110-40b1-bae6-e9ac6c3a9f74",

+ "callRoutes": [],

+ "source": {

+ "@odata.type": "#microsoft.graph.participantInfo",

+ "identity": {

+ "@odata.type": "#microsoft.graph.identitySet",

+ "application": {

+ "@odata.type": "#microsoft.graph.identity",

+ "displayName": "Calling Bot",

+ "id": "2891555a-92ff-42e6-80fa-6e1300c6b5c6"

+ }

+ },

+ "region": null,

+ "languageId": null

+ },

+ "targets": [],

+ "requestedModalities": [

+ "audio"

+ ],

+ "activeModalities": [],

+ "mediaConfig": {

+ "@odata.type": "#microsoft.graph.serviceHostedMediaConfig",

+ "preFetchMedia": [

+ {

+ "uri": "https://cdn.contoso.com/beep.wav",

+ "resourceId": "f8971b04-b53e-418c-9222-c82ce681a582"

+ },

+ {

+ "uri": "https://cdn.contoso.com/cool.wav",

+ "resourceId": "86dc814b-c172-4428-9112-60f8ecae1edb"

+ }

+ ],

+ },

+ "chatInfo": {

+ "@odata.type": "#microsoft.graph.chatInfo",

+ "threadId": "19:meeting_Win6Ydo4wsMijFjZS00ZGVjLTk5MGUtOTRjNNkYTFm@thread.v2",

+ "messageId": "0",

+ "replyChainMessageId": null

+ },

+ "meetingInfo": {

+ "@odata.type": "#microsoft.graph.joinMeetingIdMeetingInfo",

+ "joinMeetingId": "1234567",

+ "passcode": "psw123"

+ },

+ "transcription": null,

+ "routingPolicies": [],

+ "tenantId": "86dc81db-c112-4228-9222-63f3esaa1edb",

+ "myParticipantId": "05491616-385f-44a8-9974-18cc5f9933c1",

+ "id": "2f1a1100-b174-40a0-aba7-0b405e01ed92",

+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#app/calls/$entity",

+ "terminationReason": null,

+ "ringingTimeoutInSeconds": null,

+ "mediaState": null,

+ "subject": null,

+ "resultInfo": null,

+ "answeredBy": null,

+ "meetingCapability": null,

+ "toneInfo": null

+}

+```

+### Example 8: Join a scheduled meeting with joinMeetingId

+The following shows an example that requires a **joinMeetingId** but doesn't require a **passcode** to join an existing meeting. You can retrieve the **joinMeetingId** property from the [Get onlineMeeting](../api/onlinemeeting-get.md) API.

+#### Request

+The following is an example of a request.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "join-meeting-with-join-meeting-id-and-without-passcode",

+ "@odata.type": "microsoft.graph.call"

+}-->

+```http

+POST https://graph.microsoft.com/v1.0/communications/calls

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.call",

+ "callbackUri": "https://bot.contoso.com/callback",

+ "requestedModalities": [

+ "audio"

+ ],

+ "mediaConfig": {

+ "@odata.type": "#microsoft.graph.serviceHostedMediaConfig",

+ "preFetchMedia": [

+ {

+ "uri": "https://cdn.contoso.com/beep.wav",

+ "resourceId": "f8971b04-b53e-418c-9222-c82ce681a582"

+ },

+ {

+ "uri": "https://cdn.contoso.com/cool.wav",

+ "resourceId": "86dc814b-c172-4428-9112-60f8ecae1edb"

+ }

+ ]

+ },

+ "meetingInfo": {

+ "@odata.type": "#microsoft.graph.joinMeetingIdMeetingInfo",

+ "joinMeetingId": "1234567",

+ "passcode": null

+ },

+ "tenantId": "86dc81db-c112-4228-9222-63f3esaa1edb"

+}

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+#### Response

+The following is an example of the response.

+<!-- {

+ "blockType": "response",

+ "name": "join-meeting-with-join-meeting-id-and-without-passcode",

+ "@odata.type": "microsoft.graph.call"

+}-->

+```http

+HTTP/1.1 201 Created

+Location: https://graph.microsoft.com/v1.0/communications/calls/2f1a1100-b174-40a0-aba7-0b405e01ed92

+Content-Type: application/json

+{

+ "@odata.type": "#microsoft.graph.call",

+ "state": "establishing",

+ "direction": "outgoing",

+ "callbackUri": "https://bot.contoso.com/callback",

+ "callChainId": "d8217646-3110-40b1-bae6-e9ac6c3a9f74",

+ "callRoutes": [],

+ "source": {

+ "@odata.type": "#microsoft.graph.participantInfo",

+ "identity": {

+ "@odata.type": "#microsoft.graph.identitySet",

+ "application": {

+ "@odata.type": "#microsoft.graph.identity",

+ "displayName": "Calling Bot",

+ "id": "2891555a-92ff-42e6-80fa-6e1300c6b5c6"

+ }

+ },

+ "region": null,

+ "languageId": null

+ },

+ "targets": [],

+ "requestedModalities": [

+ "audio"

+ ],

+ "activeModalities": [],

+ "mediaConfig": {

+ "@odata.type": "#microsoft.graph.serviceHostedMediaConfig",

+ "preFetchMedia": [

+ {

+ "uri": "https://cdn.contoso.com/beep.wav",

+ "resourceId": "f8971b04-b53e-418c-9222-c82ce681a582"

+ },

+ {

+ "uri": "https://cdn.contoso.com/cool.wav",

+ "resourceId": "86dc814b-c172-4428-9112-60f8ecae1edb"

+ }

+ ],

+ },

+ "chatInfo": {

+ "@odata.type": "#microsoft.graph.chatInfo",

+ "threadId": "19:meeting_Win6Ydo4wsMijFjZS00ZGVjLTk5MGUtOTRjNNkYTFm@thread.v2",

+ "messageId": "0",

+ "replyChainMessageId": null

+ },

+ "meetingInfo": {

+ "@odata.type": "#microsoft.graph.joinMeetingIdMeetingInfo",

+ "joinMeetingId": "1234567",

+ "passcode": null

+ },

+ "transcription": null,

+ "routingPolicies": [],

+ "tenantId": "86dc81db-c112-4228-9222-63f3esaa1edb",

+ "myParticipantId": "05491616-385f-44a8-9974-18cc5f9933c1",

+ "id": "2f1a1100-b174-40a0-aba7-0b405e01ed92",

+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#app/calls/$entity",

+ "terminationReason": null,

+ "ringingTimeoutInSeconds": null,

+ "mediaState": null,

+ "subject": null,

+ "resultInfo": null,

+ "answeredBy": null,

+ "meetingCapability": null,

+ "toneInfo": null

+}

+```

+### Example 9: Create peer-to-peer PSTN call with service hosted media

+> **Note:** This call requires the Calls.Initiate.All permission.

+This call requires an application instance with a PSTN number assigned. For details, see [Assign a phone number to your bot](/graph/cloud-communications-phone-number#assign-a-phone-number-to-your-bot).

+#### Request

+The following example shows the request to make a peer-to-peer call between the bot and a PSTN number. In this example, the media is hosted by the service. The values of authorization token, callback URL, application instance ID, application instance display name, phone ID and tenant ID must be replaced with actual values to make the example work.

+> **Note:** Application instance ID is the object ID of application instance. The application ID that application instance links to should match the one in authorization token. Phone ID is the phone number in E.164 format.

+# [HTTP](#tab/http)

+<!-- {

+ "name": "create-call-service-hosted-media-2",

+}-->

+### Example 10: Create peer-to-peer PSTN call with application hosted media

+> **Note:** The response object shown here might be shortened for readability.

+ "name": "create-call-service-hosted-media-3",

+}-->

+>- `userId` is the object ID of a user in [Azure user management portal](https://portal.azure.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [Allow applications to access online meetings on behalf of a user](/graph/cloud-communication-online-meeting-application-access-policy).

+The following is an example of a request.

+The following is an example of the response.

+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('f4053e7-85f4-f0389ac980d6')/onlineMeetings/$entity",

+ "tollNumber": "+1252578",

+ "tollFreeNumber": "+18588",

+ "ConferenceId": "24999",

+ "dialinUrl": "https://dialin.teams.microsoft.com/22f12faf--bc69-b8de580ba330?id=24299"

+ "threadId": "19:meeting_M2IzYzczNTItYzUtYmFiMjNlOTY4MGEz@thread.skype",

+ "id": "MSpkYzE3NjctYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy",

+ "joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_M2IzYzczNTItYmY3OC00MDlmLWJjMzUtYmFiMjNlOTY4MGEz%40thread.skype/0?context=%7b%22Tid%22%3a%2272f988bf-87cd011db47%22%2c%22Oid%22%3a%22550fae72-d251-43ec-868c-373732c2704f%22%7d",

+ "id": "550fae72-d25-868c-373732c2704f",

+ "subject": "User Token Meeting",

+ "joinMeetingIdSettings": {

+ "isPasscodeRequired": false,

+ "joinMeetingId": "1234567890",

+ "passcode": null

+ }

+The following is an example of a request.

+The following is an example of the response.

+ "id": "dc17674c-81d9-4ada442e4622",

+ "tenantId": "909c6581-5130cb3582cde38",

+ "id": "dc17674c-81d9--8f6a442e4622",

+ "tenantId": "909c6581-51f3-fcb3582cde38",

+ "id": "dc17674c-81d9-4adf6a442e4622",

+ "tenantId": "909c6581-5f3-fcb3582cde38",

+ "joinMeetingIdSettings": {

+ "isPasscodeRequired": false,

+ "joinMeetingId": "1234567890",

+ "passcode": null

+ },

+### Example 3: Create an online meeting that requires a passcode

+The following example shows how to add a passcode to a meeting. The passcode is used when you join a meeting with a **joinMeetingId**. For more details, see [joinMeetingIdSettings](../resources/joinmeetingidsettings.md).