Updates from: 08/20/2021 03:28:28
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Bookingbusiness Publish https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/bookingbusiness-publish.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http POST /bookingBusinesses/{id}/publish- ``` ## Request headers | Name | Description|
v1.0 Chat List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-list.md
Content-type: application/json
"id": "1622853091207", "createdDateTime": "2021-06-05T00:31:31.207Z", "isDeleted": false,
+ "messageType": "message",
+ "eventDetail": null,
"body": { "contentType": "text", "content": "Testing unread read status"
Content-type: application/json
"id": "1622707540293", "createdDateTime": "2021-06-03T08:05:40.293Z", "isDeleted": false,
+ "messageType": "message",
+ "eventDetail": null,
"body": { "contentType": "html", "content": "<attachment id=\"ee8d34acd36d4dfe87ca6ad4e060b7be\"></attachment>"
Content-type: application/json
} } },
+ {
+ "id": "19:7b5c1643d8d74a03afa0af9c02dd0ef2@thread.v2",
+ "topic": "Group chat",
+ "createdDateTime": "2021-07-18T22:12:17.231Z",
+ "lastUpdatedDateTime": "2021-06-04T05:34:23.980Z",
+ "chatType": "group",
+ "webUrl": "https://teams.microsoft.com/l/chat/19%3A7b5c1643d8d74a03afa0af9c02dd0ef2%40thread.v2/0?tenantId=df81db53-c7e2-418a-8803-0e68d4b88607",
+ "viewpoint": {
+ "lastMessageReadDateTime": "2021-06-04T05:34:23.712Z"
+ },
+ "lastMessagePreview@odata.context": "https://graph.microsoft.com/beta/$metadata#chats('19%3A7b5c1643d8d74a03afa0af9c02dd0ef2%40thread.v2')/lastMessagePreview/$entity",
+ "lastMessagePreview": {
+ "id": "1622784857324",
+ "createdDateTime": "2021-06-04T05:34:17.324Z",
+ "isDeleted": false,
+ "messageType": "systemEventMessage",
+ "from": null,
+ "body": {
+ "contentType": "html",
+ "content": "<systemEventMessage/>"
+ },
+ "eventDetail": {
+ "@odata.type": "#microsoft.graph.membersAddedEventMessageDetail",
+ "visibleHistoryStartDateTime": "0001-01-01T00:00:00Z",
+ "members": [
+ {
+ "id": "d9a2f9a8-6ca9-4c92-9a1c-ceca33b91762",
+ "displayName": null,
+ "userIdentityType": "aadUser"
+ }
+ ],
+ "initiator": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "1fb8890f-423e-4154-8fbf-db6809bc8756",
+ "displayName": null,
+ "userIdentityType": "aadUser"
+ }
+ }
+ }
+ }
+ },
{ "id": "19:a6bac1f4daaf4db3bc6ac7536721331f@thread.v2", "topic": null,
Content-type: application/json
"id": "1621533401696", "createdDateTime": "2021-05-20T17:56:41.696Z", "isDeleted": false,
+ "messageType": "message",
+ "eventDetail": null,
"body": { "contentType": "text", "content": "sup"
v1.0 Cloudpc Endgraceperiod https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpc-endgraceperiod.md
+
+ Title: "cloudPC: endGracePeriod"
+description: "End the grace period for a specific Cloud PC."
+
+localization_priority: Normal
++
+# cloudPC: endGracePeriod
+
+Namespace: microsoft.graph
++
+End the grace period for a specific Cloud PC. The grace period is triggered when the Cloud PC license is removed or the provisioning policy is unassigned. It allows users to access Cloud PCs for up to seven days before de-provisioning occurs. Ending the grace period immediately deprovisions the Cloud PC without waiting the seven days.
++
+## 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.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|CloudPC.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/endGracePeriod
+```
+
+## 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
++
+<!-- {
+ "blockType": "request",
+ "name": "endgraceperiod_cloudpc"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/endGracePeriod
+```
++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Group Delete Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-delete-members.md
The following is an example of the response.
HTTP/1.1 204 No Content ```
+## See also
+- [Add member to team](team-post-members.md)
+- [Update member's role in team](team-update-members.md)
+- [Remove member from team](team-delete-members.md)
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!--
v1.0 Group Delete Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-delete-owners.md
Namespace: microsoft.graph
Use this API to remove an owner from a Microsoft 365 group, a security group, or a mail-enabled security group through the owners navigation property. When owners are assigned to a group, the last owner of the group cannot be removed.
-> **Note:** When this API is called, the user is also removed from the /groups/{id}/members list. To work around this, remove the user from both owners and members, then wait 10 seconds, then add them back to members. See [Known issues](/graph/known-issues#removing-a-group-owner-also-removes-the-user-as-a-group-member).
+> **Note:** For issues encountered when removing owner of a group associated with a [team](/graph/api/resources/team.md), see [Known Issues](/graph/known-issues#removing-a-group-owner-also-removes-the-user-as-a-group-member).
## 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).
The following is an example of the response.
HTTP/1.1 204 No Content ```
+## See also
+- [Add member to team](team-post-members.md)
+- [Update member's role in team](team-update-members.md)
+- [Remove member from team](team-delete-members.md)
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!--
v1.0 Group Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-post-members.md
The following is an example of the response.
HTTP/1.1 204 No Content ```
+## See also
+- [Add member to team](team-post-members.md)
+- [Update member's role in team](team-update-members.md)
+- [Remove member from team](team-delete-members.md)
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!--
v1.0 Group Post Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-post-owners.md
The following is an example of the response.
HTTP/1.1 204 No Content ```
+## See also
+- [Add member to team](team-post-members.md)
+- [Update member's role in team](team-update-members.md)
+- [Remove member from team](team-delete-members.md)
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!--
v1.0 Group Update Event https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-update-event.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Calendars.ReadWrite, Group.ReadWrite.All |
+|Delegated (work or school account) | Group.ReadWrite.All |
|Delegated (personal Microsoft account) | Not supported. | |Application | Not supported. |
v1.0 Presence Setpresence https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/presence-setpresence.md
In the request body, provide a JSON object with the following parameters.
| sessionId | string | The ID of the application's presence session. | | availability | string | The base presence information. | | activity | string | The supplemental information to availability. |
-| expirationDuration | duration | The expiration of the app presence session. The value is represented in ISO 8601 format for durations. |
+| expirationDuration | duration | The expiration of the app presence session. The value is represented in ISO 8601 format for durations.</p>If not provided, a default expiration of 5 minutes will be applied. |
> [!IMPORTANT] >
v1.0 Accesspackageassignmentrequest https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accesspackageassignmentrequest.md
In [Azure AD Entitlement Management](entitlementmanagement-root.md), an access p
|requestStatus|String|More information on the request processing status. Read-only.| |requestType|String|One of `UserAdd`, `UserRemove`, `AdminAdd`, `AdminRemove` or `SystemRemove`. A request from the user themselves would have requestType of `UserAdd` or `UserRemove`. Read-only.| |schedule|[requestSchedule](requestschedule.md)| The range of dates that access is to be assigned to the requestor. Read-only.|
-|accessPackageAssignment|[accessPackageAssignment](accesspackageassignment.md)| For a requestType of `UserAdd` or `AdminAdd`, this is an access package assignment requested to be created. For a requestType of `UserRemove`, `AdminRemove` or `SystemRemove`, this has the `id` property of an existing assignment to be removed.|
|answers|[accessPackageAnswer](accesspackageanswer.md) collection|Answers provided by the requestor to [accessPackageQuestions](accesspackagequestion.md) asked of them at the time of request.| ## Relationships | Relationship | Type | Description | |:-|:|:|
-|accessPackage|[accessPackage](../resources/accesspackage.md)|The access package associated with the accessPackageAssignmentRequest. An access package defines the collections of resource roles and the policies for how one or more users can get access to those resources. Read-only. Nullable.|
-|requestor|[accessPackageSubject](accesspackagesubject.md)| The subject who requested or, if a direct assignment, was assigned. Read-only. Nullable.|
+|accessPackage|[accessPackage](../resources/accesspackage.md)|The access package associated with the accessPackageAssignmentRequest. An access package defines the collections of resource roles and the policies for how one or more users can get access to those resources. Read-only. Nullable. <br/><br/> Supports `$expand`.|
+|accessPackageAssignment|[accessPackageAssignment](accesspackageassignment.md)| For a **requestType** of `UserAdd` or `AdminAdd`, this is an access package assignment requested to be created. For a **requestType** of `UserRemove`, `AdminRemove` or `SystemRemove`, this has the `id` property of an existing assignment to be removed. <br/><br/> Supports `$expand`.|
+|requestor|[accessPackageSubject](accesspackagesubject.md)| The subject who requested or, if a direct assignment, was assigned. Read-only. Nullable. Supports `$expand`.|
## JSON representation
v1.0 Chatmessageinfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/chatmessageinfo.md
Represents a preview of a [chatMessage](../resources/chatmessage.md) resource. T
|from|[chatMessageFromIdentitySet](../resources/chatmessagefromidentityset.md)|Information about the sender of the message.| |id|String|ID of the [chatMessage](../resources/chatmessage.md).| |isDeleted|Boolean|If set to `true`, the original message has been deleted.|
+|messageType|chatMessageType|The type of chat message. The possible values are: `message`, `unknownFutureValue`, `systemEventMessage`.|
+|eventDetail|[eventMessageDetail](../resources/eventmessagedetail.md)|Read-only. If present, represents details of an event that happened in a chat, a channel, or a team, for example, members were added, and so on. For event messages, the **messageType** property will be set to `systemEventMessage`.|
## Relationships None.
The following is a JSON representation of the resource.
"@odata.type": "microsoft.graph.chatMessageFromIdentitySet" }, "createdDateTime": "String (timestamp)",
- "isDeleted": "Boolean"
+ "isDeleted": "Boolean",
+ "messageType": "String",
+ "eventDetail": {
+ "@odata.type": "microsoft.graph.eventMessageDetail"
+ }
} ```
v1.0 Cloudpc https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/cloudpc.md
Represents a cloud-managed virtual desktop.
|[List cloudPCs](../api/virtualendpoint-list-cloudpcs.md)|[cloudPC](../resources/cloudpc.md) collection|List properties and relationships of the [cloudPC](../resources/cloudpc.md) objects.| |[Get cloudPC](../api/cloudpc-get.md)|[cloudPC](../resources/cloudpc.md)|Read the properties and relationships of a [cloudPC](../resources/cloudpc.md) object.| |[Reprovision](../api/cloudpc-reprovision.md)|None|Reprovision a [cloudPC](../resources/cloudpc.md) object.|
+|[endGracePeriod](../api/cloudpc-endgraceperiod.md)|None|End the grace period for a [cloudPC](../resources/cloudpc.md) object.|
## Properties
v1.0 Countrynamedlocation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/countrynamedlocation.md
Inherits from [namedLocation](../resources/namedLocation.md)
| Property | Type | Description | |:-|:|:| |countriesAndRegions|String collection|List of countries and/or regions in two-letter format specified by ISO 3166-2.|
-|countryLookupMethod|countryLookupMethodType|Determines what method is used to decide which country the user is located in. Possible values are `clientIpAddress` and `authenticatorAppGps`.|
+|countryLookupMethod|countryLookupMethodType|Determines what method is used to decide which country the user is located in. Possible values are `clientIpAddress` and `authenticatorAppGps`. Note: `authenticatorAppGps` is not yet supported in the Microsoft Cloud for US Government.|
|createdDateTime|DateTimeOffset|The Timestamp type represents creation date and time of the location using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. Inherited from [namedLocation](../resources/namedLocation.md).| |displayName|String|Human-readable name of the location. Inherited from [namedLocation](../resources/namedLocation.md).| |id|String|Identifier of a namedLocation object. Read-only. Inherited from [namedLocation](../resources/namedLocation.md).|
v1.0 Membersaddedeventmessagedetail https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/membersaddedeventmessagedetail.md
Namespace: microsoft.graph
Represents the details of an event message about members added. This message is generated when members are added to a chat, a channel, or a team.
+The **visibleHistoryStartDateTime** property for a members added event in a channel is always set to `0001-01-01T00:00:00Z`, which indicates that all history is shared.
+
+> **Note**: For a chat, when the selected share history time for members is earlier than the initator's visible history time, the
+**visibleHistoryStartDateTime** property for [conversationMember](conversationmember.md) and the **membersAddedEventMessageDetail** message might have different values. [conversationMember](conversationmember.md) has the effective visible history time for the member based on initiator's visible history time.
Inherits from [eventMessageDetail](../resources/eventmessagedetail.md).
Inherits from [eventMessageDetail](../resources/eventmessagedetail.md).
|:|:|:| |initiator|[identitySet](../resources/identityset.md)|Initiator of the event.| |members|[teamworkUserIdentity](../resources/teamworkuseridentity.md) collection|List of members added.|
+|visibleHistoryStartDateTime|DateTimeOffset|The timestamp denoting how far back a conversation's history is shared with the conversation members.|
## JSON representation The following is a JSON representation of the resource.
The following is a JSON representation of the resource.
], "initiator": { "@odata.type": "microsoft.graph.identitySet"
- }
+ },
+ "visibleHistoryStartDateTime": "String (timestamp)"
} ``` ## See also - [Example response for an event message about members added](/graph/system-messages/#members-added)-- For more information about other types of events, see [System messages](/graph/system-messages).
+- For more information about other types of events, see [System messages](/graph/system-messages).
v1.0 Onlinemeeting https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/onlinemeeting.md
Contains information about a meeting, including the URL used to join a meeting,
| allowTeamworkReactions | Boolean | Indicates if Teams reactions are enabled for the meeting. | | alternativeRecording | Stream | The content stream of the alternative recording of a live event. Read-only. | | attendeeReport | Stream | The content stream of the attendee report of a live event. Read-only. |
-| autoAdmittedUsers (deprecated) | String | The setting that specifies the type of participants that will automatically be allowed into the online meeting. Possible values are: `everyone`, `everyoneInSameAndFederatedCompany`, `everyoneInCompany`, `invitedUsersInCompany`, `organizer`. Read-only. |
| audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for an online meeting. Read-only. | | broadcastSettings | [broadcastMeetingSettings](broadcastMeetingSettings.md) | Settings related to a live event* | | chatInfo | [chatInfo](chatinfo.md) | The chat information associated with this online meeting. | | creationDateTime | DateTime | The meeting creation time in UTC. Read-only. |
-| capabilities (deprecated) | meetingCapabilities collection | The list of meeting capabilities. Possible values are: `questionAndAnswer`,`unknownFutureValue`. |
| endDateTime | DateTime | The meeting end time in UTC. | | externalId | String | The external ID. A custom ID. Optional. | | id | String | The default ID associated with the online meeting. Read-only. |
Contains information about a meeting, including the URL used to join a meeting,
| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. | | meetingAttendanceReport | [meetingAttendanceReport](meetingAttendanceReport.md) | The attendance report of a scheduled meeting. Read-only. | | participants | [meetingParticipants](meetingparticipants.md) | The participants associated with the online meeting. This includes the organizer and the attendees. |
+| recordAutomatically | Boolean | Indicates whether to record the meeting automatically. |
| recording | Stream | The content stream of the recording of a live event. Read-only. | | startDateTime | DateTime | The meeting start time in UTC. | | subject | String | The subject of the online meeting. | | videoTeleconferenceId | String | The video teleconferencing ID. Read-only. |
+| autoAdmittedUsers (deprecated) | String | The setting that specifies the type of participants that will automatically be allowed into the online meeting. Possible values are: `everyone`, `everyoneInSameAndFederatedCompany`, `everyoneInCompany`, `invitedUsersInCompany`, `organizer`. Read-only. |
+| capabilities (deprecated) | meetingCapabilities collection | The list of meeting capabilities. Possible values are: `questionAndAnswer`,`unknownFutureValue`. |
> [!CAUTION] >
->- The **autoAdmittedUsers** property is deprecated. Use **scope** property of [lobbyBypassSettings](lobbyBypassSettings.md) instead.
->- The **capabilities** property is deprecated. Use **isQuestionAndAnswerEnabled** property of [broadcastMeetingSettings](broadcastMeetingSettings.md) instead.
->- \* Creating live events with the **broadcastSettings** property is in Beta, with important limitations. Please refer to
-> [broadcastSettings](broadcastMeetingSettings.md) for more details.
+>- The **autoAdmittedUsers** property is deprecated. Use the **scope** property of [lobbyBypassSettings](lobbyBypassSettings.md) instead.
+>- The **capabilities** property is deprecated. Use the **isQuestionAndAnswerEnabled** property of [broadcastMeetingSettings](broadcastMeetingSettings.md) instead.
+>- \* Creating live events with the **broadcastSettings** property is in beta, with important limitations. For details, see
+> [broadcastSettings](broadcastMeetingSettings.md).
### onlineMeetingPresenters values
v1.0 Teams Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/teams-api-overview.md
The following are the differences at the API level between teams and groups:
| Use case | Verb | URL | | - | | |
-| [Add member](../api/team-post-members.md) | POST | /teams/{id}/members |
-| [Remove member](../api/team-delete-members.md) | DELETE | /teams/{id}/members/{userId} |
-| [Update member's role](../api/team-update-members.md) | PATCH | /teams/{id}/members/{userId} |
-| [Update team](../api/team-update.md) | PATCH | /teams/{id} |
-
-When adding and removing members and owners, don't put braces { } around the ID.
-
-| Speed | Syntax |
-| | -- |
-| Fast | https://graph.microsoft.com/beta/groups/02bd9fd6-8f93-4758-87c3-1fb73740a315/members/48d31887-5fad-4d73-a9f5-3c356e68a038/$ref |
-| Slow | https://graph.microsoft.com/beta/groups/{02bd9fd6-8f93-4758-87c3-1fb73740a315}/members/{48d31887-5fad-4d73-a9f5-3c356e68a038}/$ref |
-
-Similarly, if the `userId` in the URL or payload is expressed as a UPN rather than as a GUID, the performance will be slower.
-
-| Speed | Syntax |
-| | -- |
-| Fast | 48d31887-5fad-4d73-a9f5-3c356e68a038 |
-| Slow | john@example.com |
-
-When the slower path is taken, if a current team member or owner is signed in to the Microsoft Teams application/website, the change will be reflected within an hour.
-If none of those users are signed in to the Microsoft Teams application/website, the change will not be reflected until an hour after one of them signs in.
-
-> [!Note]
-> Tenant guests are always processed via the slow path.
+| [Add member](../api/team-post-members.md) | POST | /teams/{team-id}/members |
+| [Remove member](../api/team-delete-members.md) | DELETE | /teams/{team-id}/members/{membership-id} |
+| [Update member's role](../api/team-update-members.md) | PATCH | /teams/{team-id}/members/{membership-id} |
+| [Update team](../api/team-update.md) | PATCH | /teams/{team-id} |
## Polling requirements
v1.0 Termstore Term https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/termstore-term.md
Inherits from [entity](../resources/entity.md).
## Properties |Property|Type|Description| |:|:|:|
-|createdDateTime|DateTimeOffset|Date and time of term creation. Read-only|
-|descriptions|[microsoft.graph.termStore.localizedDescription](../resources/termstore-localizeddescription.md) collection|Description about term that is dependent on the languageTag|
-|id|String|Unique identifier of term. Read-Only|
-|labels|[microsoft.graph.termStore.localizedLabel](../resources/termstore-localizedlabel.md) collection|Label metadata for a term|
-|lastModifiedDateTime|DateTimeOffset|Last date and time of term modification. Read-only|
-|properties|[microsoft.graph.keyValue](../resources/keyvalue.md) collection|Collection of properties on the term|
+|createdDateTime|DateTimeOffset|Date and time of term creation. Read-only.|
+|descriptions|[microsoft.graph.termStore.localizedDescription](../resources/termstore-localizeddescription.md) collection|Description about term that is dependent on the languageTag.|
+|id|String|Unique identifier of term. Read-Only.|
+|labels|[microsoft.graph.termStore.localizedLabel](../resources/termstore-localizedlabel.md) collection|Label metadata for a term.|
+|lastModifiedDateTime|DateTimeOffset|Last date and time of term modification. Read-only.|
+|properties|[microsoft.graph.keyValue](../resources/keyvalue.md) collection|Collection of properties on the term.|
## Relationships |Relationship|Type|Description| |:|:|:|
-|children|[microsoft.graph.termStore.term](../resources/termstore-term.md) collection|Children of current term|
-|relations|[microsoft.graph.termStore.relation](../resources/termstore-relation.md) collection|To indicate which terms are related to the current term as either pinned or reused|
-|set|[microsoft.graph.termStore.set](../resources/termstore-set.md)|The [set] in which the term is created|
+|children|[microsoft.graph.termStore.term](../resources/termstore-term.md) collection|Children of current term.|
+|relations|[microsoft.graph.termStore.relation](../resources/termstore-relation.md) collection|To indicate which terms are related to the current term as either pinned or reused.|
+|set|[microsoft.graph.termStore.set](../resources/termstore-set.md)|The [set] in which the term is created.|
## JSON representation The following is a JSON representation of the resource.
v1.0 Group Delete Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-delete-members.md
The following is an example of the response.
HTTP/1.1 204 No Content ```
+## See also
+- [Add member to team](team-post-members.md)
+- [Update member's role in team](team-update-members.md)
+- [Remove member from team](team-delete-members.md)
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- {
v1.0 Group Delete Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-delete-owners.md
Namespace: microsoft.graph
Use this API to remove an owner from a Microsoft 365 group, a security group, or a mail-enabled security group through the owners navigation property. Once owners are assigned to a group, the last owner of the group cannot be removed.
-> **Note:** When this API is called, the user is also removed from the /groups/{id}/members list. To work around this, remove the user from both owners and members, then wait 10 seconds, then add them back to members. See [Known issues](/graph/known-issues#removing-a-group-owner-also-removes-the-user-as-a-group-member).
+> **Note:** For issues encountered when removing owner of a group associated with a [team](/graph/api/resources/team.md), see [Known Issues](/graph/known-issues#removing-a-group-owner-also-removes-the-user-as-a-group-member).
## 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).
The following is an example of the response.
HTTP/1.1 204 No Content ```
+## See also
+- [Add member to team](team-post-members.md)
+- [Update member's role in team](team-update-members.md)
+- [Remove member from team](team-delete-members.md)
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- {
v1.0 Group Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-post-members.md
The following is an example of the response.
HTTP/1.1 204 No Content ```
+## See also
+- [Add member to team](team-post-members.md)
+- [Update member's role in team](team-update-members.md)
+- [Remove member from team](team-delete-members.md)
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- {
v1.0 Group Post Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-post-owners.md
The following is an example of the response.
HTTP/1.1 204 No Content ```
+## See also
+- [Add member to team](team-post-members.md)
+- [Update member's role in team](team-update-members.md)
+- [Remove member from team](team-delete-members.md)
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- {
v1.0 Group Update Event https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-update-event.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Calendars.ReadWrite, Group.ReadWrite.All |
+|Delegated (work or school account) | Group.ReadWrite.All |
|Delegated (personal Microsoft account) | Not supported. | |Application | Not supported. |
v1.0 Presence Clearpresence https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/presence-clearpresence.md
+
+ Title: "presence: clearPresence"
+description: "Clear the presence information for a user's application presence session."
+
+localization_priority: Normal
++
+# presence: clearPresence
+
+Namespace: microsoft.graph
++
+Clear the application's presence session for a user. If it is the user's only presence session, the user's presence will change to `Offline/Offline`.
+
+For details about presences sessions, see [presence: setPresence](presence-setpresence.md#presence-sessions).
+
+## 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) | Not Supported. |
+| Delegated (personal Microsoft account) | Not Supported. |
+| Application | Presence.ReadWrite.All |
+
+## HTTP Request
+<!-- { "blockType": "ignored" } -->
+```http
+POST /users/{userId}/presence/clearPresence
+```
+
+## 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 |
+| :-- | :-- | :-- |
+| sessionId | string | The ID of the application's presence session. |
++
+> [!IMPORTANT]
+>
+> Provide the ID of the application as `sessionId` in the request.
+
+## Response
+If successful, this method returns a `200 OK` response code.
+
+If the presence session doesn't exist, this method returns a `404 NotFound` response code.
+
+## Examples
+The following request shows the application with ID `22553876-f5ab-4529-bffb-cfe50aa89f87` that clears its presence session for user `fa8bf3dc-eca7-46b7-bad1-db199b62afc3`.
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "clear--presence"
+}-->
+
+```msgraph-interactive
+POST https://graph.microsoft.com/beta/users/fa8bf3dc-eca7-46b7-bad1-db199b62afc3/presence/clearPresence
+Content-Type: application/json
+
+{
+ "sessionId": "22553876-f5ab-4529-bffb-cfe50aa89f87"
+}
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+} -->
+```http
+HTTP/1.1 200 OK
+```
v1.0 Presence Setpresence https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/presence-setpresence.md
+
+ Title: "presence: setPresence"
+description: "Set the presence information for a user's application presence session."
+
+localization_priority: Normal
++
+# presence: setPresence
+
+Namespace: microsoft.graph
++
+Set the state of a user's presence session as an application.
+
+### Presence sessions
+A user can have multiple presence sessions because the user can be on multiple Teams clients (desktop, mobile, and web). Each Teams client has an independent presence session and the user's presence is an aggregated state from all the sessions behind.
+
+Similarly, an application can have its own presence session for a user and be able to update the state.
+
+The following is the precedence for how session states are aggregated:
+* User-configured > app-configured (user-configured state overrides others)
+* Among app-configured: DoNotDisturb (currently not supported for set presence) > Busy > Available > Away
+
+### Timeout, expiration, and keep alive
+A presence session may **time out** and **expire**, so the application needs to call this API before the **timeout**, to maintain the state for the session; or before the **expiration**, to keep the session alive.
+
+A presence session can time out if the availability is `Available` and the timeout is 5 minutes. When it times out, the presence state fades in stages. For example, if an application sets the presence session as `Available/Available`, the state would change to `Available/AvailableInactive` in 5 minutes with the first timeout, then `Away/Away` in another 5 minutes with the second timeout.
+
+The expiration of a presence session is configurable with the `expirationDuration` parameter. When a session expires it becomes `Offline`.
+
+## 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) | Not Supported. |
+| Delegated (personal Microsoft account) | Not Supported. |
+| Application | Presence.ReadWrite.All |
+
+## HTTP Request
+<!-- { "blockType": "ignored" } -->
+```http
+POST /users/{userId}/presence/setPresence
+```
+## 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 |
+| :-- | :- | :-- |
+| sessionId | string | The ID of the application's presence session. |
+| availability | string | The base presence information. |
+| activity | string | The supplemental information to availability. |
+| expirationDuration | duration | The expiration of the app presence session. The value is represented in ISO 8601 format for durations.</p>If not provided, a default expiration of 5 minutes will be applied. |
+
+> [!IMPORTANT]
+>
+> Provide the ID of the application as `sessionId` in the request.
+
+Supported combinations of `availability` and `activity` are:
+
+| availability | activity | Description |
+| :-- | :- | :- |
+| Available | Available | Updates the presence session as Available. |
+| Busy | InACall | Updates the presence session as Busy, InACall. |
+| Busy | InAConferenceCall | Updates the presence session as Busy, InAConferenceCall. |
+| Away | Away | Updates the presence session as Away. |
+
+## Response
+If successful, this method returns a `200 OK` response code.
+
+## Examples
+The following request shows the application with ID `22553876-f5ab-4529-bffb-cfe50aa89f87` that sets its presence session for user `fa8bf3dc-eca7-46b7-bad1-db199b62afc3`.
+
+### Request
++
+<!-- {
+ "blockType": "request",
+ "name": "set-presence"
+}-->
+
+```msgraph-interactive
+POST https://graph.microsoft.com/beta/users/fa8bf3dc-eca7-46b7-bad1-db199b62afc3/presence/setPresence
+Content-Type: application/json
+
+{
+ "sessionId": "22553876-f5ab-4529-bffb-cfe50aa89f87",
+ "availability": "Available",
+ "activity": "Available",
+ "expirationDuration": "PT1H"
+}
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+} -->
+```http
+HTTP/1.1 200 OK
+```
v1.0 User Checkmembergroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-checkmembergroups.md
One of the following permissions is required to call this API. To learn more, in
| Delegated (personal Microsoft account) | Not supported. | | Application | User.ReadBasic.All, User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All |
+> **Note:** To list the members of a group with hidden membership, the Member.Read.Hidden permission is required.
+ ## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 User List Memberof https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-list-memberof.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Directory.Read.All, Directory.ReadWrite.All |
+> **Note:** To list the members of a group with hidden membership, the Member.Read.Hidden permission is required.
+ [!INCLUDE [limited-info](../../includes/limited-info.md)] ## HTTP request
v1.0 Call https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/call.md
Title: "call resource type"
-description: "The **call** resource is created when there is an incoming call for the application or the application creates a new outgoing call via a `POST` on `app/calls`."
+description: "The **call** resource is created when there is an incoming call for the application or the application creates a new outgoing call via a `POST` on `communications/calls`."
localization_priority: Priority ms.prod: "cloud-communications"
doc_type: resourcePageType
Namespace: microsoft.graph
-The **call** resource is created when there is an incoming call for the application or the application creates a new outgoing call via a `POST` on `app/calls`.
+The **call** resource is created when there is an incoming call for the application or the application creates a new outgoing call via a `POST` on `communications/calls`.
Calls can be set up as a peer-to-peer or as a group call. For creating or joining a group call, supply the `chatInfo` and `meetingInfo`. If these are not supplied, a new group call is created automatically. For an incoming call, record these values in a highly available store so that your application can rejoin the call in the event that your application crashes.
v1.0 Countrynamedlocation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/countrynamedlocation.md
Inherits from [namedLocation](../resources/namedLocation.md)
| Property | Type | Description | |:-|:|:| |countriesAndRegions|String collection|List of countries and/or regions in two-letter format specified by ISO 3166-2.|
-|countryLookupMethod|countryLookupMethodType|Determines what method is used to decide which country the user is located in. Possible values are `clientIpAddress` and `authenticatorAppGps`.|
+|countryLookupMethod|countryLookupMethodType|Determines what method is used to decide which country the user is located in. Possible values are `clientIpAddress` and `authenticatorAppGps`. Note: `authenticatorAppGps` is not yet supported in the Microsoft Cloud for US Government.|
|createdDateTime|DateTimeOffset|The Timestamp type represents creation date and time of the location using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. Inherited from [namedLocation](../resources/namedLocation.md).| |displayName|String|Human-readable name of the location. Inherited from [namedLocation](../resources/namedLocation.md).| |id|String|Identifier of a namedLocation object. Read-only. Inherited from [namedLocation](../resources/namedLocation.md).|
v1.0 Presence https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/presence.md
This resource supports subscribing to [change notifications](/graph/webhooks).
## Methods
-| Method | Return Type | Description |
-|:|:--|:|
-| [Get presence](../api/presence-get.md) | [presence](../resources/presence.md) | Get a user's presence information.
-| [Get presence of multiple users](../api/cloudcommunications-getpresencesbyuserid.md) | [presence](../resources/presence.md) collection | Get the presence information for multiple users. |
-
+| Method | Return Type | Description |
+| :-- | :- | :-- |
+| [Get presence](../api/presence-get.md) | [presence](../resources/presence.md) | Get a user's presence information. |
+| [Get presence of multiple users](../api/cloudcommunications-getpresencesbyuserid.md) | [presence](../resources/presence.md) collection | Get the presence information for multiple users. |
+| [Set presence](../api/presence-setpresence.md) | | Set an application's presence session for a user. |
+| [Clear presence](../api/presence-clearpresence.md) | | Clear an application's presence session for a user. |
## Properties
-| Relationship | Type | Description |
-|:--|:--|:--|
-|id | string | The user object id |
-|availability | string collection | The base presence information for a user. Possible values are `Available`, `AvailableIdle`, `Away`, `BeRightBack`, `Busy`, `BusyIdle`, `DoNotDisturb`, `Offline`, `PresenceUnknown` |
-|activity | string collection | The supplemental information to a user's availability. Possible values are `Available`, `Away`, `BeRightBack`, `Busy`, `DoNotDisturb`, `InACall`, `InAConferenceCall`, `Inactive`, `InAMeeting`, `Offline`, `OffWork`, `OutOfOffice`, `PresenceUnknown`, `Presenting`, `UrgentInterruptionsOnly`. |
+| Relationship | Type | Description |
+| :-- | :- | : |
+| id | string | The user object id |
+| availability | string collection | The base presence information for a user. Possible values are `Available`, `AvailableIdle`, `Away`, `BeRightBack`, `Busy`, `BusyIdle`, `DoNotDisturb`, `Offline`, `PresenceUnknown` |
+| activity | string collection | The supplemental information to a user's availability. Possible values are `Available`, `Away`, `BeRightBack`, `Busy`, `DoNotDisturb`, `InACall`, `InAConferenceCall`, `Inactive`, `InAMeeting`, `Offline`, `OffWork`, `OutOfOffice`, `PresenceUnknown`, `Presenting`, `UrgentInterruptionsOnly`. |
>**Note:** To learn more about the different presence states, see [User presence in Teams](/microsoftteams/presence-admins).
v1.0 Teams Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/teams-api-overview.md
The following are the differences at the API level between teams and groups:
| Use case | Verb | URL | | - | | |
-| [Add member](../api/team-post-members.md) | POST | /teams/{id}/members |
-| [Remove member](../api/team-delete-members.md) | DELETE | /teams/{id}/members/{userId} |
-| [Update member's role](../api/team-update-members.md) | PATCH | /teams/{id}/members/{userId} |
-| [Update team](../api/team-update.md) | PATCH | /teams/{id} |
-
-When adding and removing members and owners, don't put braces { } around the ID.
-
-| Speed | Syntax |
-| | -- |
-| Fast | `https://graph.microsoft.com/beta/groups/02bd9fd6-8f93-4758-87c3-1fb73740a315/members/48d31887-5fad-4d73-a9f5-3c356e68a038/$ref` |
-| Slow | `https://graph.microsoft.com/beta/groups/{02bd9fd6-8f93-4758-87c3-1fb73740a315}/members/{48d31887-5fad-4d73-a9f5-3c356e68a038}/$ref` |
-
-Similarly, if the `userId` in the URL or payload is expressed as a UPN rather than as a GUID, the performance will be slower.
-
-| Speed | Syntax |
-| | -- |
-| Fast | 48d31887-5fad-4d73-a9f5-3c356e68a038 |
-| Slow | john@example.com |
-
-When the slower path is taken, if a current team member or owner is signed in to the Microsoft Teams application/website, the change will be reflected within an hour.
-If none of those users are signed in to the Microsoft Teams application/website, the change will not be reflected until an hour after one of them signs in.
-
-> [!Note]
-> Tenant guests are always processed via the slow path.
+| [Add member](../api/team-post-members.md) | POST | /teams/{team-id}/members |
+| [Remove member](../api/team-delete-members.md) | DELETE | /teams/{team-id}/members/{membership-id} |
+| [Update member's role](../api/team-update-members.md) | PATCH | /teams/{team-id}/members/{membership-id} |
+| [Update team](../api/team-update.md) | PATCH | /teams/{team-id} |
## Polling requirements
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/toc.yml a/api-reference/v1.0/toc.yml
items:
href: api/presence-get.md - name: Get presence for multiple users href: api/cloudcommunications-getpresencesbyuserid.md
+ - name: Set presence
+ href: api/presence-setpresence.md
+ - name: Clear presence
+ href: api/presence-clearpresence.md
- name: Cross-device experiences displayName: Project Rome items: