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

+# [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)

+# [HTTP](#tab/http)

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

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

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

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [PowerShell](#tab/powershell)

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

+ Title: "Get attackSimulationOperation"

+description: "Get an attack simulation operation to track a long-running operation request for a tenant."

+ms.localizationpriority: medium

+# Get attackSimulationOperation

+Namespace: microsoft.graph

+Get an attack simulation operation to track a long-running operation request for a 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) | AttackSimulation.Read.All |

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

+| Application | AttackSimulation.Read.All |

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /security/attackSimulation/operations/{operationsId}

+```

+## Optional query parameters

+This method does not currently support the [OData query parameters](/graph/query-parameters) to customize the response.

+## 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 an [attackSimulationOperation](../resources/attacksimulationoperation.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "get_attackSimulationOperation",

+ "sampleKeys": ["f1b13829-3829-f1b1-2938-b1f12938b1a"]

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/security/attackSimulation/operations/f1b13829-3829-f1b1-2938-b1f12938b1a

+```

+# [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.attackSimulationOperation"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "id": "2f5548d1-0dd8-4cc8-9de0-e0d6ec7ea3dc",

+ "tenantId": "2f5548d1-0dd8-4cc8-9de0-e0d6ec7ea3ss",

+ "statusDetail": "Creating new simulation",

+ "createdDateTime": "2022-01-12T05:27:18.7957961Z",

+ "lastActionDateTime": "2022-01-12T05:27:18.7957961Z",

+ "type": "createSimulation",

+ "status": "notStarted",

+ "percentageCompleted": 0

+}

+```

+GET /security/attackSimulation/simulations/{simulationId}/excludedAccountTarget

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

+ "type": "addressBook",

+ "accountTargetEmails": [

+ "john@contoso.com"

+ ]

+GET /security/attackSimulation/simulations/{simulationId}/includedAccountTarget

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

+ "type": "addressBook",

+ "accountTargetEmails": [

+ "john@contoso.com"

+ ]

+This method supports the `$count`, `$filter`, `$orderby`, `$skipToken`, `$top`, and `$select` [OData query parameters](/graph/query-parameters) to help customize the response. You can use the `$filter` and `$orderby` query parameters on the **technique**, **simulationAttackType**, **completionDateTime**, **displayName**, **isAutomated**, **launchDateTime**, and **status** properties.

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

+ "simulationAttackType": "social",

+ "technique": "credentialHarvesting",

+ Title: "Create simulation"

+description: "Create an attack simulation campaign for a tenant."

+ms.localizationpriority: medium

+# Create simulation

+Namespace: microsoft.graph

+Create an attack simulation campaign for a 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) | AttackSimulation.ReadWrite.All |

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

+| Application | AttackSimulation.ReadWrite.All |

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+```http

+POST /security/attackSimulation/simulations

+```

+## Request headers

+|Header |Value |

+||-|

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

+|Content-Type |application/json |

+## Request body

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

+The following table shows the properties that are required when you create the simulation.

+| Property | Type | Description |

+|:-|:|:|

+|attackTechnique|[simulationAttackTechnique](../resources/simulation.md#simulationattacktechnique-values)|The social engineering technique used in the attack simulation and training campaign. Supports `$filter` and `$orderby`. Possible values are: `unknown`, `credentialHarvesting`, `attachmentMalware`, `driveByUrl`, `linkInAttachment`, `linkToMalwareFile`, `unknownFutureValue`. For more information on the types of social engineering attack techniques, see [simulations](/microsoft-365/security/office-365-security/attack-simulation-training-get-started?view=o365-worldwide&preserve-view=true#simulations).|

+|attackType|[simulationAttackType](../resources/simulation.md#simulationattacktype-values)|Attack type of the attack simulation and training campaign. Supports `$filter` and `$orderby`. Possible values are: `unknown`, `social`, `cloud`, `endpoint`, `unknownFutureValue`.|

+|completionDateTime|DateTimeOffset|Date and time of completion of the attack simulation and training campaign. Supports `$filter` and `$orderby`.|

+|createdBy|[emailIdentity](../resources/emailidentity.md)|Identity of the user who created the attack simulation and training campaign.|

+|createdDateTime|DateTimeOffset|Date and time of creation of the attack simulation and training campaign.|

+|displayName|String|Display name of the attack simulation and training campaign. Supports `$filter` and `$orderby`.|

+|durationInDays|Int32|Simulation duration in days.|

+|includedAccountTarget|[accountTargetContent](../resources/accounttargetcontent.md)|Users targeted in the simulation.|

+|lastModifiedBy|[emailIdentity](../resources/emailidentity.md)|Identity of the user who most recently modified the attack simulation and training campaign.|

+|launchDateTime|DateTimeOffset|Date and time of the launch/start of the attack simulation and training campaign. Supports `$filter` and `$orderby`.|

+|payloadDeliveryPlatform|payloadDeliveryPlatform|Method of delivery of the phishing payload used in the attack simulation and training campaign. Possible values are: `unknown`, `sms`, `email`, `teams`, `unknownFutureValue`.|

+|status|[simulationStatus](../resources/simulation.md#simulationstatus-values)|Status of the attack simulation and training campaign. Supports `$filter` and `$orderby`. Possible values are: `unknown`, `draft`, `running`, `scheduled`, `succeeded`, `failed`, `cancelled`, `excluded`, `unknownFutureValue`.|

+## Response

+If successful, this method returns a `202 Accepted` response code and a tracking header named `location` in the response.

+## Examples

+### Request

+The following is an example of a request.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "create_simulation"

+}

+-->

+```http

+POST https://graph.microsoft.com/beta/security/attackSimulation/simulations

+Content-type: application/json

+{

+ "displayName": "Graph Simulation",

+ "payload@odata.bind":"https://graph.microsoft.com/beta/security/attacksimulation/payloads/12345678-9abc-def0-123456789a",

+ "durationInDays": 7,

+ "attackTechnique": "credentialHarvesting",

+ "status": "scheduled",

+ "durationInDays": "3",

+ "includedAccountTarget": {

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

+ "type" : "addressBook",

+ "accountTargetEmails" : [

+ "john@contoso.com"

+ ]

+ },

+}

+```

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

+}

+-->

+```http

+HTTP/1.1 202 Accepted

+```

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

+In the request body, pass the list of staff IDs along with two other parameters of [dateTimeTimeZone resource type](/graph/api/resources/datetimetimezone) called **startDateTime** and **endDateTime**. These correspond to the two timestamps between which the staff availability will be returned.

+# [HTTP](#tab/http)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [HTTP](#tab/http)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

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

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

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

+| user calendar | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |

+|Delegated (work or school account) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |

+|Application | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |

+| user calendar | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |

+|Delegated (work or school account) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |

+|Delegated (personal Microsoft account) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |

+|Application | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |

+| user calendar | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite |

+Retrieve the properties and relationships of a [calendar group](../resources/calendargroup.md) object.

+| Delegated (work or school account) | Calendars.ReadBasic, Calendars.Read |

+| Delegated (personal Microsoft account) | Calendars.ReadBasic, Calendars.Read |

+| Application | Calendars.ReadBasic, Calendars.Read |

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

+If successful, this method returns a `200 OK` response code and a [calendarGroup](../resources/calendargroup.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.

+| Delegated (work or school account) | Calendars.ReadBasic, Calendars.Read |

+| Delegated (personal Microsoft account) | Calendars.ReadBasic, Calendars.Read |

+| Application | Calendars.ReadBasic, Calendars.Read |

+| user calendar | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | Calendars.ReadBasic,Calendars.Read, Calendars.ReadWrite | Calendars.Read, Calendars.ReadWrite |

+For details about how to identify a large gallery view participant in a roster so that you can retrieve the relevant data to subscribe to the video feed, see [Identify large gallery view participants in a roster](/graph/cloud-communications-identifylargegalleryview).

+> **Notes:**

+> - In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data accessed through the API.

+> - This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).

+> This API works for a meeting only if the meeting has not expired. For more details, see [Limits and specifications for Microsoft Teams](/microsoftteams/limits-specifications-teams#meeting-expiration).

+GET /me/onlineMeetings/{meetingId}/transcripts/{transcriptId}

+GET /users/{userId}/onlineMeetings/{meetingId}/transcripts/{transcriptId}

+GET me/onlineMeetings/{meetingId}/transcripts/{transcriptId}/content

+GET users/{userId}/onlineMeetings/{meetingId}/transcripts/{transcriptId}/content

+ "sampleKeys": ["19:ebe3857aa388434bab0cad9d2e09f4de@thread.v2"]

+> **Notes**:

+> - This API supports subscribing to changes (create, update, and delete) using [change notifications](../resources/webhooks.md). This allows callers to subscribe and get changes in real time. For details, see [Get notifications for messages](/graph/teams-changenotifications-chatmessage).

+> - This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).

+>**Note:** This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).

+> [!NOTE]

+> The `$top` query parameter might not return all chats within a single response object. If the result set for all chats spans multiple pages, the response object includes an **@odata.nextLink** property that contains a URL to the next page of results. If that property is present, continue making additional requests with the **@odata.nextLink** URL in each response, until all the results are returned.

+## See also

+- [Pinned message C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-pinned-messages/csharp)

+- [Pinned message Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-pinned-messages/nodejs)

+## See also

+- [Activity feed notification C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-activity-feed/csharp)

+- [Activity feed notification Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-activity-feed/nodejs)

+| Application | Teamwork.Migrate.All |

+### Example 11: Send a message that contains an announcement

+#### Request

+The following is an example of the request.

+> **Note:** The Base64-encoded value for the **contentBytes** property is shortened for readability.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "post_chatmessage_11",

+ "sampleKeys": ["5c884e2f-83f8-4cff-af8e-0177f260b9f8", "19:81f49626414645c99469ee65a1a7e1a4@thread.tacv2"]

+}-->

+```http

+POST https://graph.microsoft.com/beta/teams/5c884e2f-83f8-4cff-af8e-0177f260b9f8/channels/19:81f49626414645c99469ee65a1a7e1a4@thread.tacv2/messages

+Content-type: application/json

+{

+ "subject": "Announcement Subheading",

+ "body": {

+ "contentType": "text",

+ "content": "<attachment id=\"d7ddbf876ae340c3a03bada395ec7da7\"></attachment>Announcement text"

+ },

+ "attachments": [

+ {

+ "id": "d7ddbf876ae340c3a03bada395ec7da7",

+ "contentType": "application/vnd.microsoft.teams.messaging-announcementBanner",

+ "contentUrl": null,

+ "content": "{\"title\":\"Announcement heading\",\"cardImageType\":\"uploadedImage\",\"cardImageDetails\":{\"uploadedImageDetail\":{\"originalImage\":{\"source\":\"../hostedContents/1/$value\",\"width\":1379,\"height\":268,\"croppedWidth\":918.0,\"croppedHeight\":178.4075416968818,\"leftMargin\":0.0,\"topMargin\":90.7962291515591,\"imageContentType\":\"image/png\"},\"croppedImage\":{\"source\":\"../hostedContents/2/$value\"}}}}",

+ "name": null,

+ "thumbnailUrl": null

+ }

+ ],

+ "hostedContents": [

+ {

+ "@microsoft.graph.temporaryId": "1",

+ "contentBytes": "iVBORw0KGgoAAAANSUhEUgAABWMAAAEMCAYAAAChuaTsAAAAAXNSR0IArs4c6QAAAARnQU1BA",

+ "contentType": "image/png"

+ },

+ {

+ "@microsoft.graph.temporaryId": "2",

+ "contentBytes": "iVBORw0KGgoAAAANSUhEUgAAA5YAAAB4CAYAAACJrW0RAAAAAXNSR0IArs4c6QAAIABJREFUe",

+ "contentType": "image/png"

+ }

+ ]

+}

+```

+# [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,

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

+} -->

+```http

+HTTP/1.1 201 Created

+Content-type: application/json

+{

+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams('5c884e2f-83f8-4cff-af8e-0177f260b9f8')/channels('19%3A81f49626414645c99469ee65a1a7e1a4%40thread.tacv2')/messages/$entity",

+ "id": "1675104302171",

+ "replyToId": null,

+ "etag": "1675104302171",

+ "messageType": "message",

+ "createdDateTime": "2023-01-30T18:45:02.171Z",

+ "lastModifiedDateTime": "2023-01-30T18:45:02.171Z",

+ "lastEditedDateTime": null,

+ "deletedDateTime": null,

+ "subject": "Announcement Subheading",

+ "summary": null,

+ "chatId": null,

+ "importance": "normal",

+ "locale": "en-us",

+ "webUrl": "https://teams.microsoft.com/l/message/19%3A81f49626414645c99469ee65a1a7e1a4%40thread.tacv2/1675104302171?groupId=5c884e2f-83f8-4cff-af8e-0177f260b9f8&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1675104302171&parentMessageId=1675104302171",

+ "onBehalfOf": null,

+ "policyViolation": null,

+ "eventDetail": null,

+ "from": {

+ "application": null,

+ "device": null,

+ "user": {

+ "id": "28c10244-4bad-4fda-993c-f332faef94f0",

+ "displayName": "Test user",

+ "userIdentityType": "aadUser"

+ }

+ },

+ "body": {

+ "contentType": "text",

+ "content": "<attachment id=\"d7ddbf876ae340c3a03bada395ec7da7\"></attachment>Announcement text"

+ },

+ "channelIdentity": {

+ "teamId": "5c884e2f-83f8-4cff-af8e-0177f260b9f8",

+ "channelId": "19:81f49626414645c99469ee65a1a7e1a4@thread.tacv2"

+ },

+ "attachments": [

+ {

+ "id": "d7ddbf876ae340c3a03bada395ec7da7",

+ "contentType": "application/vnd.microsoft.teams.messaging-announcementBanner",

+ "contentUrl": null,

+ "content": "{\"title\":\"Announcement heading\",\"cardImageType\":\"uploadedImage\",\"cardImageDetails\":{\"uploadedImageDetail\":{\"originalImage\":{\"source\":\"https://graph.microsoft.com/beta/teams/5c884e2f-83f8-4cff-af8e-0177f260b9f8/channels/19:81f49626414645c99469ee65a1a7e1a4@thread.tacv2/messages/1675104302171/hostedContents/aWQ9LHR5cGU9MSx1cmw9aHR0cHM6Ly91cy1hcGkuYXNtLnNreXBlLmNvbS92MS9vYmplY3RzLzAtd3VzLWQyLTY3OTJlM2ExMzFmNzc4YjY5NWMwYTE5ZGRkZmIwYWNiL3ZpZXdzL2ltZ28=/$value\",\"width\":1379,\"height\":268,\"croppedWidth\":918.0,\"croppedHeight\":178.4075416968818,\"leftMargin\":0.0,\"topMargin\":90.7962291515591,\"imageContentType\":\"image/png\"},\"croppedImage\":{\"source\":\"https://graph.microsoft.com/beta/teams/5c884e2f-83f8-4cff-af8e-0177f260b9f8/channels/19:81f49626414645c99469ee65a1a7e1a4@thread.tacv2/messages/1675104302171/hostedContents/aWQ9LHR5cGU9MSx1cmw9aHR0cHM6Ly91cy1hcGkuYXNtLnNreXBlLmNvbS92MS9vYmplY3RzLzAtd3VzLWQzLTAwYjhhNWZiZTA0MGRmY2MzMWZkNzM1ZDE4Yjk4NTM5L3ZpZXdzL2ltZ28=/$value\"}}}}",

+ "name": null,

+ "thumbnailUrl": null,

+ "teamsAppId": null

+ }

+ ],

+ "mentions": [],

+ "reactions": []

+}

+```

+### Example 12: Send a message with an emoji

+#### Request

+The following is an example of the request.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "post_chatmessage_12",

+ "sampleKeys": ["19:7fb82b685f9c457296a0ab6a1d98b4c1@thread.v2"]

+}-->

+```http

+POST https://graph.microsoft.com/beta/chats/19:7fb82b685f9c457296a0ab6a1d98b4c1@thread.v2/messages

+Content-type: application/json

+{

+ "body": {

+ "contentType": "html",

+ "content": "<emoji alt=\"😶‍🌫️\"></emoji>"

+ }

+}

+```

+# [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,

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

+} -->

+```http

+HTTP/1.1 201 Created

+Content-type: application/json

+{

+ "@odata.context": "https://canary.graph.microsoft.com/testprodbetateamsgraphsumanach/$metadata#chats('19%3A7fb82b685f9c457296a0ab6a1d98b4c1%40thread.v2')/messages/$entity",

+ "id": "1675459162626",

+ "replyToId": null,

+ "etag": "1675459162626",

+ "messageType": "message",

+ "createdDateTime": "2023-02-03T21:19:22.626Z",

+ "lastModifiedDateTime": "2023-02-03T21:19:22.626Z",

+ "lastEditedDateTime": null,

+ "deletedDateTime": null,

+ "subject": null,

+ "summary": null,

+ "chatId": "19:7fb82b685f9c457296a0ab6a1d98b4c1@thread.v2",

+ "importance": "normal",

+ "locale": "en-us",

+ "webUrl": null,

+ "channelIdentity": null,

+ "onBehalfOf": null,

+ "policyViolation": null,

+ "eventDetail": null,

+ "from": {

+ "application": null,

+ "device": null,

+ "user": {

+ "id": "28c10244-4bad-4fda-993c-f332faef94f0",

+ "displayName": "Test User",

+ "userIdentityType": "aadUser"

+ }

+ },

+ "body": {

+ "contentType": "html",

+ "content": "<emoji id=\"faceinclouds\" alt=\"😶‍🌫️\" title=\"Face in clouds\"></emoji>"

+ },

+ "attachments": [],

+ "mentions": [],

+ "reactions": []

+}

+```

+* [Cards reference](/microsoftteams/platform/concepts/cards/cards-reference)

+>**Note:** This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).

+Update a [chatMessage](../resources/chatMessage.md) object.

+You can update all the properties of **chatMessage** in delegated permissions scenarios, except for the **policyViolation** property and read-only properties. The **policyViolation** property is the only property that can be updated in application permissions scenarios.

+Updating works only for chats where conversation members are Microsoft Teams users. If one of the members is using Skype, the operation fails.

+| Application | ChannelMessage.UpdatePolicyViolation.All, Group.ReadWrite.All** |

+If no `model` is specified, [evaluation mode](/graph/teams-licenses#evaluation-mode-default-requirements) will be used.

+| Name | Description |

+|:--|:-|

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

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

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

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

+## Response

+### Errors

+This method supportsΓÇ»[date range parameters](/graph/query-parameters) to customize the response, as shown in the following example.

+GET /users/{id}/chats/getAllMessages?$top=50&$filter=lastModifiedDateTime gt 2020-06-04T18:03:11.591Z and lastModifiedDateTime lt 2020-06-05T21:00:09.413Z

+Use the `model` query parameter to specify the [payment model](/graph/teams-licenses) that applies to your scenario, as shown in the following examples.

+GET /users/{id | user-principal-name}/chats/getAllMessages?model=A

+GET /users/{id | user-principal-name}/chats/getAllMessages?model=B

+>**Note:** If you don't specify a payment model in your query, the default [evaluation mode](/graph/teams-licenses#evaluation-mode-default-requirements) will be used.

+ "provisioningType": "shared",

+ "provisioningType": "shared",

+ "enableSingleSignOn": true,

+|enableSingleSignOn|Boolean|`True` if the provisioned Cloud PC can be accessed by single sign-on. `False` indicates that the provisioned Cloud PC doesn't support this feature. Default value is `false`. Windows 365 users can use single sign-on to authenticate to Azure Active Directory (Azure AD) with passwordless options (for example, FIDO keys) to access their Cloud PC. Optional.|

+The following is an example of a request.

+### Response

+The following is an example of the response.

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

+ "enableSingleSignOn": true,

+ "managedBy": "windows365",

+ "provisioningType": "dedicated"

+ "enableSingleSignOn": true,

+ "managedBy": "windows365",

+ "provisioningType": "dedicated"

+ "enableSingleSignOn": true,

+ },

+ "provisioningType": "dedicated"

+|displayName|String|The display name for the provisioning policy. |

+|enableSingleSignOn|Boolean|`True` if the provisioned Cloud PC can be accessed by single sign-on. `False` indicates that the provisioned Cloud PC doesn't support this feature. Default value is `false`. Windows 365 users can use single sign-on to authenticate to Azure Active Directory (Azure AD) with passwordless options (for example, FIDO keys) to access their Cloud PC. Optional.|

+|imageDisplayName|String|The display name for the OS image you're provisioning.|

+|onPremisesConnectionId|String|The ID of the cloudPcOnPremisesConnection. To ensure that Cloud PCs have network connectivity and that they domain join, choose a connection with a virtual network thatΓÇÖs validated by the Cloud PC service.|

+The following is an example of a request.

+The following is an example of the response.

+ Title: "Get cloudPcSharedUseServicePlan"

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

+ms.localizationpriority: medium

+# Get cloudPcSharedUseServicePlan

+Namespace: microsoft.graph

+Read the properties and relationships of a [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.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) | CloudPC.Read.All, CloudPC.ReadWrite.All |

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

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

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /deviceManagement/virtualEndpoint/sharedUseServicePlans/{cloudPcSharedUseServicePlanId}

+```

+## Optional query parameters

+This method supports the `$select` OData query parameter 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 [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) object in the response body.

+## Examples

+### Request

+The following is an example of a request.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "get_cloudpcshareduseserviceplan"

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/sharedUseServicePlans/613a8d85-6c33-1268-9f55-b96a6540017c

+```

+# [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.cloudPcSharedUseServicePlan"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "value": {

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

+ "id": "613a8d85-6c33-1268-9f55-b96a6540017c",

+ "displayName": "Display Name Value",

+ "usedCount": "10",

+ "totalCount": "20"

+ }

+}

+```

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

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

+The calling user must also be in one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference): *Global Administrator*, *Intune Administrator*, or *Windows 365 Administrator*.

+ Title: "device: delta"

+description: "Get created, updated, or deleted devices without performing a full read of the entire resource collection."

+ms.localizationpriority: medium

+# device: delta

+Namespace: microsoft.graph

+Get newly created, updated, or deleted devices without performing a full read of the entire resource collection. For more information, see [Using delta query](/graph/delta-query-overview).

+## 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) | Device.Read.All |

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

+|Application | Device.Read.All |

+## HTTP request

+To begin tracking changes, you make a request including the delta function on the **device** resource.

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

+```http

+GET /devices/delta

+```

+## Query parameters

+Tracking changes incurs a round of one or more **delta** function calls. To use any query parameter other than `$deltatoken` and `$skiptoken`, you must specify it in the initial **delta** request and Microsoft Graph automatically encodes any specified parameters into the `$deltatoken` portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response.

+| Query parameter | Type |Description|

+|:|:--|:-|

+| $deltatoken | string | A [state token](/graph/delta-query-overview) returned in the `@odata.deltaLink` URL of the previous **delta** function call for the same resource collection, indicating the completion of that round of change tracking. Save and apply the entire `@odata.deltaLink` URL including this token in the first request of the next round of change tracking for that collection.|

+| $skiptoken | string | A [state token](/graph/delta-query-overview) returned in the `@odata.nextLink` URL of the previous **delta** function call, indicating that there are further changes to be tracked in the same resource collection. |

+### Optional query parameters

+This method supports OData query parameters to help customize the response.

+- You can use the `$select` query parameter to specify only the properties your need for best performance. The **id** property is always returned.

+- There is limited support for `$filter`. The only supported `$filter` expression is for tracking changes for specific resources, by their ID: `$filter=id+eq+'{value}'` or `$filter=id+eq+'{value1}'+or+id+eq+'{value2}'`. The number of IDs you can specify is limited by the maximum URL length.

+## Request headers

+| Name | Description|

+|:|:-|

+| Authorization | Bearer &lt;token&gt;. 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 [device](../resources/device.md) objects in the response body. The response also includes a `@odata.nextLink` URL or a `@odata.deltaLink` URL.

+- If a `@odata.nextLink` URL is returned, there are additional pages of data to be retrieved in the session. The device continues making requests using the `@odata.nextLink` URL until a `@odata.deltaLink` URL is included in the response.

+- If a `@odata.deltaLink` URL is returned, there is no more data about the existing state of the resource to be returned. Persist and use the `@odata.deltaLink` URL to learn about changes to the resource in the future.

+For more informantion, see [Using delta query](/graph/delta-query-overview). For example requests, see [Get incremental changes for users](/graph/delta-query-users).

+## Example

+### Request

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "device_delta"

+}-->

+```msgraph-interactive

+GET https://graph.microsoft.com/beta/devices/delta

+```

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

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+### Response

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

+<!-- {

+ "blockType": "response",

+ "truncated": true,

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

+ "isCollection": true

+} -->

+```http

+HTTP/1.1 200 OK

+Content-type: application/json

+{

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

+ "@odata.nextLink":"https://graph.microsoft.com/beta/devices/delta?$skiptoken=pqwSUjGYvb3jQpbwVAwEL7yuI3dU1LecfkkfLPtnIjsXoYQp_dpA3cNJWc",

+ "value": [

+ {

+ "accountEnabled": false,

+ "createdDateTime": "2022-05-05T20:56:06Z",

+ "deviceId": "4c299165-6e8f-4b45-a5ba-c5d250a707ff",

+ "displayName": "Test device",

+ "operatingSystem": "linux",

+ "operatingSystemVersion": "1",

+ "id": "c9d9f9b3-0c91-4080-b392-78f775903b3a",

+ "alternativeSecurityIds": [

+ {

+ "type": 2,

+ "identityProvider": null,

+ "key": "base64Y3YxN2E1MWFlYw=="

+ }

+ ]

+ }

+ ]

+}

+```

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

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

+<!--

+{

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

+ "description": "device: delta",

+ "keywords": "",

+ "section": "documentation",

+ "tocPath": "",

+ "suppressions": [

+ ]

+}

+-->

+The calling user must also be in one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):

+* Global Administrator

+* Users

+* Directory Readers

+* Directory Writers

+* Compliance Administrator

+* Device Managers

+* Application Administrator

+* Security Reader

+* Security Administrator

+* Privileged Role Administrator

+* Cloud Application Administrator

+* Customer LockBox Access Approver

+* Dynamics 365 Administrator

+* Power BI Administrator

+* Desktop Analytics Administrator

+* Microsoft Managed Desktop Administrator

+* Teams Communications Administrator

+* Teams Communications Support Engineer

+* Teams Communications Support Specialist

+* Teams Administrator

+* Compliance Data Administrator

+* Security Operator

+* Kaizala Administrator

+* Global Reader

+* Directory Reviewer

+* Windows 365 Administrator

+The calling user must also be in one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):

+* Global Administrator

+* Users

+* Directory Readers

+* Directory Writers

+* Compliance Administrator

+* Device Managers

+* Application Administrator

+* Security Reader

+* Security Administrator

+* Privileged Role Administrator

+* Cloud Application Administrator

+* Customer LockBox Access Approver

+* Dynamics 365 Administrator

+* Power BI Administrator

+* Desktop Analytics Administrator

+* Microsoft Managed Desktop Administrator

+* Teams Communications Administrator

+* Teams Communications Support Engineer

+* Teams Communications Support Specialist

+* Teams Administrator

+* Compliance Data Administrator

+* Security Operator

+* Kaizala Administrator

+* Global Reader

+* Directory Reviewer

+* Windows 365 Administrator

+The calling user must also be in one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):

+* Global Administrator

+* Users

+* Directory Readers

+* Directory Writers

+* Compliance Administrator

+* Device Managers

+* Application Administrator

+* Security Reader

+* Security Administrator

+* Privileged Role Administrator

+* Cloud Application Administrator

+* Customer LockBox Access Approver

+* Dynamics 365 Administrator

+* Power BI Administrator

+* Desktop Analytics Administrator

+* Microsoft Managed Desktop Administrator

+* Teams Communications Administrator

+* Teams Communications Support Engineer

+* Teams Communications Support Specialist

+* Teams Administrator

+* Compliance Data Administrator

+* Security Operator

+* Kaizala Administrator

+* Global Reader

+* Directory Reviewer

+* Windows 365 Administrator

+The calling user must also be in one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference): *Global Administrator*, *Intune Administrator*, or *Windows 365 Administrator*.

+ "name": "delete_directory_deleteditem"

+ "name": "get_directory_deleteditem"

+### Request

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "get_directory_deleteditem_getuserownedobjects"

+}-->

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

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+### Response

+Here 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.directoryObject",

+ "isCollection": true

+} -->

+HTTP/1.1 200 OK

+ "value": [

+ {

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

+ "id": "bfa7033a-7367-4644-85f5-95aaf385cbd7",

+ "deletedDateTime": "2018-04-01T12:39:16Z",

+ "classification": null,

+ "createdDateTime": "2017-03-22T12:39:16Z",

+ "description": null,

+ "displayName": "Test",

+ "groupTypes": [

+ "Unified"

+ ],

+ "mail": "Test@contoso.com",

+ "mailEnabled": true,

+ "mailNickname": "Test",

+ "membershipRule": null,

+ "membershipRuleProcessingState": null,

+ "preferredDataLocation": null,

+ "preferredLanguage": null,

+ "proxyAddresses": [

+ "SMTP:Test@contoso.com"

+ ],

+ "renewedDateTime": "2017-09-22T22:30:39Z",

+ "securityEnabled": false,

+ "theme": null,

+ "visibility": "Public"

+ }

+ ]

+}

+ "name": "list_directory_deleteditems"

+ "name": "list_directory_deleteditems_count"

+To restore users with privileged administrator roles in delegated scenarios, the app must be assigned with *Directory.AccessAsUser.All* delegated permission, and the calling user must also be assigned a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions).

+In app-only scenarios, the *User.ReadWrite.All* application permission isn't enough privilege to restore deleted users with privileged administrator roles. The app must be assigned a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions).

+ "name": "restore_directory_deleteditem"

+# [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)

+# [HTTP](#tab/http)

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

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |

+The calling user must be assigned one of the following [Azure AD roles](/azure/active-directory/roles/permissions-reference):

+- Security Administrator

+- External Identity Provider Administrator

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+This API is part of Microsoft SharePoint and OneDrive APIs that perform advanced premium administrative functions and is considered a protected API. Protected APIs require you to have additional validation, beyond permission and consent, before you can use them. Before you call this API with application permissions, you must [request access](https://aka.ms/PreviewSPOPremiumAPI).

+> This is a metered API and some charges for use may apply. For details, see [Overview of metered Microsoft 365 APIs in Microsoft Graph](/graph/metered-api-overview).

+# [HTTP](#tab/http)

+# [JavaScript](#tab/javascript)

+| retainInheritedPermissions | Boolean | Optional. If `true` (default), any existing inherited permissions are retained on the shared item when sharing this item for the first time. If `false`, all existing permissions are removed when sharing for the first time. |

+|sendNotification|Boolean|If `true`, this method sends a [sharing link](../resources/permission.md#sharing-links) in an email to users specified in `recipients`. Applicable to OneDrive for Business or SharePoint. The default value is `false`. Optional.|

+For OneDrive for Business and SharePoint users, use the `sendNotification` parameter to create a sharing link. The sharing link is then sent to recipients via email.

+All existing permissions are removed when sharing for the first time if `retainInheritedPermissions` is false.

+ ],

+ "sendNotification": true,

+ "retainInheritedPermissions": false

+When an embed link is created, the `webHtml` property contains the HTML code for an `<iframe>` to host the content.

+# [HTTP](#tab/http)

+# [JavaScript](#tab/javascript)

+| roles | Collection(String) | Specifies the roles that are be granted to the recipients of the sharing invitation. |

+| expirationDateTime | DateTimeOffset | Specifies the **dateTime** after which the permission expires. For OneDrive for Business and SharePoint, **xpirationDateTime** is only applicable for **sharingLink** permissions. Available on OneDrive for Business, SharePoint, and premium personal OneDrive accounts.

+| retainInheritedPermissions | Boolean | Optional. If `true` (default), any existing inherited permissions are retained on the shared item when sharing this item for the first time. If `false`, all existing permissions are removed when sharing for the first time.

+ Title: "Get items"

+description: "Gets an item object in Dynamics 365 Business Central."

+documentationcenter: ""

+```http

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

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

+### Request

+The following is an example of the request.

+### Response

+The following is an example of the response.

+ Title: "Get paymentTerms"

+description: "Retrieve the properties and relationships of a paymentTerms object for Dynamics 365 Business Central."

+documentationcenter: ""

+Retrieve the properties and relationships of a [paymentTerms](../resources/dynamics-paymentterms.md) object for Dynamics 365 Business Central.

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

+## Examples

+### Request

+The following is an example of the request.

+### Response

+The following is an example of the response.

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

+ "sampleKeys": ["2003c52e-807a-4186-9b49-60c573095461","2be08d97-b140-4eec-8cbd-88238d571060"],