Updates from: 08/11/2021 03:15:21
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accessreviewscheduledefinition Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewscheduledefinition-update.md
This is an example of updating the displayName of an existing access review seri
In the request body, supply a JSON representation of the new properties of the [accessReviewScheduleDefinition](../resources/accessreviewscheduledefinition.md) object. - # [HTTP](#tab/http) <!-- { "blockType": "request",
PUT https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
} } ```
+# [C#](#tab/csharp)
+ # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/update-accessreviewscheduledefinition-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
PUT https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/objc/update-accessreviewscheduledefinition-objc-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [C#](#tab/csharp)
- # [Java](#tab/java) [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
PUT https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
--- ### Response <!-- { "blockType": "response",
v1.0 Appmanagementpolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/appManagementPolicy-delete.md
If successful, this method returns `204 No Content` response code. It does not r
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_appManagementPolicy"
The following is an example of the request.
```msgraph-interactive DELETE https://graph.microsoft.com/beta/policies/appManagementPolicies/{id} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Appmanagementpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/appManagementPolicy-get.md
The following is an example of the request. From the response, the app manageme
- Blocks creating of new passwords after 2019-10-19 at 10:37 AM UTC time. - Limits password secrets for apps created after 2019-10-19 at 10:37 AM UTC time to less than 4 days, 12 hours, 30 minutes and 5 seconds. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_appManagementPolicy"
The following is an example of the request. From the response, the app manageme
```msgraph-interactive GET https://graph.microsoft.com/beta/policies/appManagementPolicies/{id} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Appmanagementpolicy List Appliesto https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/appManagementPolicy-list-appliesTo.md
If successful, this method returns a `200 OK` response code and a collection of
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_appManagementPolicyAppliesTo" }-->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}/appliesTo ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
Content-type: application/json
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_appManagementPolicyAppliesTo_select" }-->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}/appliesTo?$select=id,appId,displayName,createdDateTime ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Appmanagementpolicy List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/appManagementPolicy-list.md
If successful, this method returns a `200 OK` response code and a collection of
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_appManagementPolicies"
The following is an example of the request.
```msgraph-interactive GET https://graph.microsoft.com/beta/policies/appManagementPolicies ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Appmanagementpolicy Post Appliesto https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/appManagementPolicy-post-appliesto.md
If successful, this method returns `204 No Content` response code. It does not r
The following is an example of the request to assign an appManagementPolicy to an application. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "assign_appliesTo"
POST https://graph.microsoft.com/beta/applications/{id}/appManagementPolicies/$r
"@odata.id":"https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Appmanagementpolicy Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/appManagementPolicy-post.md
The following is an example of the request. This request created an app manageme
- Blocks creating of new passwords for apps and service principals after 2019-10-19 at 10:37 AM UTC time. - Limits password secrets for apps and service principals created after 2019-10-19 at 10:37 AM UTC time to less than XX days. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_appManagementPolicy"
POST https://graph.microsoft.com/beta/policies/appManagementPolicies
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Appmanagementpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/appManagementPolicy-update.md
If successful, this method returns a `204 No Content` response code.
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_appManagementPolicy"
PATCH https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Application Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-delete.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Deletes an application.
+Deletes an application. When deleted, apps are moved to a temporary container and can be restored within 30 days. After that time, they are permanently 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).
v1.0 Call Keepalive https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/call-keepalive.md
doc_type: apiPageType
Namespace: microsoft.graph + Make a request to this API every 15 to 45 minutes to ensure that an ongoing call remains active. A call that does not receive this request within 45 minutes is considered inactive and will subsequently end. At least one successful request must be made within 45 minutes of the previous request, or the start of the call.
v1.0 Chat Delete Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-delete-members.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)| ChatMember.ReadWrite.All |
+|Delegated (work or school account)| ChatMember.ReadWrite |
|Delegated (personal Microsoft account) | Not supported. | |Application| Chat.Manage.Chat*, ChatMember.ReadWrite.All |
v1.0 Cloudpconpremisesconnection Updateaddomainpassword https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpconpremisesconnection-updateaddomainpassword.md
The following table shows the parameters that can be used with this action.
|Parameter|Type|Description| |:|:|:|
-|adDomainPassword|String|The password associated with adDomainUsername|
+|adDomainPassword|String|The password associated with **adDomainUsername**.|
v1.0 Educationassignment Post Resources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignment-post-resources.md
Content-length: 212
"resource": { "displayName": "Bing", "link": "https://www.bing.com",
- "@odata.type": "#microsoft.education.assignments.api.educationLinkResource"
+ "@odata.type": "#microsoft.graph.educationLinkResource"
} } ```
Content-length: 229
"resource": { "displayName": "Bing", "link": "https://www.bing.com",
- "@odata.type": "#microsoft.education.assignments.api.educationLinkResource"
+ "@odata.type": "#microsoft.graph.educationLinkResource"
} } ```
v1.0 Educationclass Post Assignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationclass-post-assignments.md
If successful, this method returns a `201 Created` response code and an [educati
## Example ##### Request The following is an example of the request.+
+# [HTTP](#tab/http)
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "create_educationassignment_from_educationclass" }--> ```http
-POST https://graph.microsoft.com/beta/education/classes/11019/assignments
+POST https://graph.microsoft.com/beta/education/classes/8b8cec7f-d0d8-4974-982a-e29396ddbe7f/assignments
Content-type: application/json Content-length: 279
Content-length: 279
"content": "Read chapters 1 through 3" }, "grading": {
- "@odata.type": "#microsoft.education.assignments.api.educationAssignmentPointsGradeType",
+ "@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
"maxPoints": 100 }, "assignTo": {
- "@odata.type": "#microsoft.education.assignments.api.educationAssignmentClassRecipient"
+ "@odata.type": "#microsoft.graph.educationAssignmentClassRecipient"
}, "status":"draft", "allowStudentsToAddResourcesToSubmission": true
Content-length: 279
}, "lastModifiedDateTime": "2014-02-01T00:00:00Z", "notificationChannelUrl": null,
- "status": "published"
+ "resourcesFolderUrl": null,
+ "allowStudentsToAddResourcesToSubmission": false,
+ "status": "draft",
+ "notificationChannelUrl": null,
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7b%22subEntityId%22%3a%22%7b%5c%22version%5c%22%3a%5c%221.0%5c%22%2c%5c%22config%5c%22%3a%7b%5c%22classes%5c%22%3a%5b%7b%5c%22id%5c%22%3a%5c%228b8cec7f-d0d8-4974-982a-e29396ddbe7f%5c%22%2c%5c%22displayName%5c%22%3anull%2c%5c%22assignmentIds%5c%22%3a%5b%5c%22107dac08-35a5-4546-b4b5-1736fea56847%5c%22%5d%7d%5d%7d%2c%5c%22action%5c%22%3a%5c%22navigate%5c%22%2c%5c%22view%5c%22%3a%5c%22assignment-viewer%5c%22%7d%22%2c%22channelId%22%3anull%7d",
+ "addToCalendarAction": "none",
+ "addedStudentAction": "none"
} ```
v1.0 Group Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-delete.md
Namespace: microsoft.graph
Deletes a group.
-When deleted, Microsoft 365 groups are moved to a temporary container and can be restored within 30 days. After that time, they are permanently deleted. To learn more, see [deletedItems](../resources/directory.md). This applies only to Microsoft 365 groups.
+When deleted, Microsoft 365 groups are moved to a temporary container and can be restored within 30 days. After that time, they are permanently deleted. This isn't applicable to Security groups and Distribution groups which are permanently deleted immediately. To learn more, see [deletedItems](../resources/directory.md).
## Permissions
v1.0 Group List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-list-members.md
Content-type: text/plain
The following is an example of the request. <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_pr_count" }--> ```msgraph-interactive
Content-type: application/json
The following is an example of the request. <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_a_count" }--> ```msgraph-interactive
v1.0 Group Post Groups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-post-groups.md
Content-type: application/json
#### Request
-The following is an example of the request. The calling user must be assigned the *Directory.AccessAsUser.All* permission to set the **isAssignableToRole** property.
+The following is an example of the request. The calling user or app must be assigned the *RoleManagement.ReadWrite.Directory* permission to set the **isAssignableToRole** property or update the membership of such groups.
# [HTTP](#tab/http)
v1.0 Identityproviderbase Post Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/identityproviderbase-post-identityproviders.md
Content-type: application/json
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_applemanagedidentityprovider_from_identityproviderbase"
Content-length: 154
"certificateData": "******" } ```
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+++ #### Response
v1.0 Cloudpconpremisesconnection https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/cloudpconpremisesconnection.md
Represents a defined collection of Azure resource information that can be used t
|subscriptionName|String|The name of the target Azure subscription. Read-only.| |adDomainName|String|The fully qualified domain name (FQDN) of the Active Directory domain you want to join.| |adDomainUsername|String|The username of an Active Directory account (user or service account) that has permissions to create computer objects in Active Directory. Required format: admin@contoso.com.|
-|adDomainPassword|String|The password associated with adDomainUsername.|
+|adDomainPassword|String|The password associated with **adDomainUsername**.|
|organizationalUnit|String|The organizational unit (OU) in which the computer account is created. If left null, the OU thatΓÇÖs configured as the default (a well-known computer object container) in your Active Directory domain (OU) is used. Optional.| |resourceGroupId|String|The ID of the target resource group. Required format: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}".| |virtualNetworkId|String|The ID of the target virtual network. Required format: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}".|
v1.0 Educationassignmentdefaults https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/educationassignmentdefaults.md
Specifies class-level defaults respected by new assignments created in the class
|Property|Type|Description| |:|:|:| |addedStudentAction|educationAddedStudentAction|Class-level default behavior for handling students who are added after the assignment is published. Possible values are: `none`, `assignIfOpen`.|
-|addToCalendarAction| educationAddToCalendarOptions|Optional field to control the asfor adding assignments to students' and teachers' calendars when the assignment is published. Possible values are: `studentsAndPublisher`, `studentsAndTeamOwners`, `none`. Default value is `none`.|
+|addToCalendarAction| educationAddToCalendarOptions|Optional field to control adding assignments to students' and teachers' calendars when the assignment is published. Possible values are: `studentsAndPublisher` and `studentsAndTeamOwners`. |
|dueTime|TimeOfDay|Class-level default value for due time field. Default value is `23:59:00`.| |notificationChannelUrl|String|Default Teams channel to which notifications will be sent. Default value is `null`.|
v1.0 Group https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/group.md
This resource supports:
|hideFromAddressLists |Boolean |`true` if the group is not displayed in certain parts of the Outlook user interface: in the **Address Book**, in address lists for selecting message recipients, and in the **Browse Groups** dialog for searching groups; false otherwise. Default value is `false`. <br><br>Returned only on `$select`. Supported only on the Get group API (`GET /groups/{ID}`).| |hideFromOutlookClients |Boolean |`true` if the group is not displayed in Outlook clients, such as Outlook for Windows and Outlook on the web, false otherwise. Default value is `false`. <br><br>Returned only on `$select`. Supported only on the Get group API (`GET /groups/{ID}`).| |id|String|The unique identifier for the group. <br><br>Returned by default. Inherited from [directoryObject](directoryobject.md). Key. Not nullable. Read-only. <br><br>Supports `$filter` (`eq`, `ne`, `NOT`, `in`).|
-|isAssignableToRole|Boolean|Indicates whether this group can be assigned to an Azure Active Directory role.<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` and the group cannot be a dynamic group (that is, **groupTypes** cannot contain `DynamicMembership`). Only callers in Global administrator and Privileged role administrator roles can set this property. The caller must also be assigned the *Directory.AccessAsUser.All* permission to set this property. 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`).|
+|isAssignableToRole|Boolean|Indicates whether this group can be assigned to an Azure Active Directory role.<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` and the group cannot be a dynamic group (that is, **groupTypes** cannot contain `DynamicMembership`). Only callers in Global administrator and Privileged role administrator roles can set this property. The caller must 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`).|
|infoCatalogs|String collection|Identifies the info segments assigned to the group. Returned by default. Supports `$filter` (`eq`, `NOT`, `ge`, `le`, `startsWith`).| |isSubscribedByMail|Boolean|Indicates whether the signed-in user is subscribed to receive email conversations. Default value is `true`. <br><br>Returned only on `$select`. Supported only on the Get group API (`GET /groups/{ID}`). | |licenseProcessingState|String|Indicates status of the group license assignment to all members of the group. Possible values: `QueuedForProcessing`, `ProcessingInProgress`, and `ProcessingComplete`. <br><br>Returned only on `$select`. Read-only. |
v1.0 Grouplifecyclepolicy https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/grouplifecyclepolicy.md
Here is a JSON representation of the resource.
"id": "Guid (identifier)", "managedGroupTypes": "String" }- ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
v1.0 Invitation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/invitation.md
Creating an invitation will return a redemption URL in the response (*inviteRede
|invitedUserDisplayName|String|The display name of the user being invited.| |invitedUserEmailAddress|String|The email address of the user being invited. Required. The following special characters are not permitted in the email address:<br><ul><li>Tilde (~)</li><li>Exclamation point (`!`)</li><li>At sign (`@`)</li><li>Number sign (`#`)</li><li>Dollar sign (`$`)</li><li>Percent (`%`)</li><li>Circumflex (`^`)</li><li>Ampersand (`&`)</li><li>Asterisk (`*`)</li><li>Parentheses (`( )`)</li><li>Hyphen (`-`)</li><li>Plus sign (`+`)</li><li>Equal sign (`=`)</li><li>Brackets (`[ ]`)</li><li>Braces (`{ }`)</li><li>Backslash (`\`)</li><li>Slash mark (`/`)</li><li>Pipe (`|`)</li><li>Semicolon (`;`)</li><li>Colon (`:`)</li><li>Quotation marks (`"`)</li><li>Angle brackets (`< >`)</li><li>Question mark (`?`)</li><li>Comma (`,`)</li></ul><br>However, the following exceptions apply:<br><ul><li>A period (`.`) or a hyphen (`-`) is permitted anywhere in the user name, except at the beginning or end of the name.</li><li>An underscore (`_`) is permitted anywhere in the user name. This includes at the beginning or end of the name.</li></ul>| |invitedUserMessageInfo|[invitedUserMessageInfo](invitedusermessageinfo.md)|Additional configuration for the message being sent to the invited user, including customizing message text, language and cc recipient list.|
-|sendInvitationMessage|Boolean|Indicates whether an email should be sent to the user being invited or not. The default is false.|
+|sendInvitationMessage|Boolean|Indicates whether an email should be sent to the user being invited. The default is `false`.|
|inviteRedirectUrl|String|The URL user should be redirected to once the invitation is redeemed. Required.| |inviteRedeemUrl|String|The URL the user can use to redeem their invitation. Read-only.| |invitedUserType|String|The userType of the user being invited. By default, this is `Guest`. You can invite as `Member` if you're are company administrator. |
v1.0 Resourcespecificpermissiongrant https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/resourcespecificpermissiongrant.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-A resourceSpecificPermissionGrant declares the permission that has been granted to a specific AzureAD app for an instance of a resource in Microsoft Graph.
+Declares the permission that has been granted to a specific Azure AD app for an instance of a resource in Microsoft Graph.
For more information about granting apps consent to access a specific instance of a resource, see [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
v1.0 Service Communications Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/service-communications-api-overview.md
For more information on access tokens, app registration, and delegated and appli
### Access service communications API on behalf of signed-in user
-Delegated permissions are needed to access the service communications API on behalf of a signed-in user. Customer-facing canvas applications, such as the [Microsoft 365 admin center](https://admin.microsoft.com/Adminportal/Home?source=applauncher#/homepage) (accessible only to admin roles), can call the service communications API to get the service health and service announcements data for the signed-in user's tenant, _on behalf of the signed-in user_. Users can find out whether their subscribed servies are healthy or have issues. They can also learn about any current service issues affecting their tenants.
+Delegated permissions are needed to access the service communications API on behalf of a signed-in user. Customer-facing canvas applications, such as the [Microsoft 365 admin center](https://admin.microsoft.com/Adminportal/Home?source=applauncher#/homepage) (accessible only to admin roles), can call the service communications API to get the service health and service announcements data for the signed-in user's tenant, _on behalf of the signed-in user_. Users can find out whether their subscribed services are healthy or have issues. They can also learn about any current service issues affecting their tenants.
### Access service communications API without user
v1.0 Accessreviewscheduledefinition Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/accessreviewscheduledefinition-update.md
If successful, this method returns a `204 No Content` response code and no respo
This is an example of updating the displayName of an existing access review series. ### Request+ In the request body, supply a JSON representation of the new properties of the [accessReviewScheduleDefinition](../resources/accessreviewscheduledefinition.md) object.
v1.0 Application Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/application-delete.md
doc_type: apiPageType
Namespace: microsoft.graph
-Delete an [application](../resources/application.md) object.
+Delete an [application](../resources/application.md) object. When deleted, apps are moved to a temporary container and can be restored within 30 days. After that time, they are permanently 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).
v1.0 Attachment Createuploadsession https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/attachment-createuploadsession.md
To create an upload session for attaching a file to an **event**:
<!-- { "blockType": "ignored" } --> ```http POST /me/events/{id}/attachments/createUploadSession
+POST /users/{id | userPrincipalName}/events/{id}/attachments/createUploadSession
``` To create an upload session for attaching a file to a **message**:
To create an upload session for attaching a file to a **message**:
<!-- { "blockType": "ignored" } --> ```http POST /me/messages/{id}/attachments/createUploadSession
+POST /users/{id | userPrincipalName}/messages/{id}/attachments/createUploadSession
``` ## Request headers
v1.0 Chat Delete Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/chat-delete-members.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)| ChatMember.ReadWrite.All |
+|Delegated (work or school account)| ChatMember.ReadWrite |
|Delegated (personal Microsoft account) | Not supported. | |Application| ChatMember.ReadWrite.All |
v1.0 Educationassignment Post Resource https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/educationassignment-post-resource.md
Content-length: 229
"resource": { "displayName": "Bing", "link": "https://www.bing.com",
- "@odata.type": "#microsoft.education.assignments.api.educationLinkResource"
+ "@odata.type": "#microsoft.graph.educationLinkResource"
} }
v1.0 Educationclass Post Assignment https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/educationclass-post-assignment.md
Content-length: 279
"content": "Read chapters 1 through 3" }, "grading": {
- "@odata.type": "educationAssignmentPointsGradeType",
+ "@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
"maxPoints": 100 }, "assignTo": {
- "@odata.type": "educationAssignmentClassRecipient"
+ "@odata.type": "#microsoft.graph.educationAssignmentClassRecipient"
}, "status":"draft", "allowStudentsToAddResourcesToSubmission": true
Content-length: 279
}, "lastModifiedDateTime": "2014-02-01T00:00:00Z", "notificationChannelUrl": null,
- "status": "published"
+ "resourcesFolderUrl": null,
+ "allowStudentsToAddResourcesToSubmission": false,
+ "status": "draft",
+ "notificationChannelUrl": null,
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7b%22subEntityId%22%3a%22%7b%5c%22version%5c%22%3a%5c%221.0%5c%22%2c%5c%22config%5c%22%3a%7b%5c%22classes%5c%22%3a%5b%7b%5c%22id%5c%22%3a%5c%228b8cec7f-d0d8-4974-982a-e29396ddbe7f%5c%22%2c%5c%22displayName%5c%22%3anull%2c%5c%22assignmentIds%5c%22%3a%5b%5c%22107dac08-35a5-4546-b4b5-1736fea56847%5c%22%5d%7d%5d%7d%2c%5c%22action%5c%22%3a%5c%22navigate%5c%22%2c%5c%22view%5c%22%3a%5c%22assignment-viewer%5c%22%7d%22%2c%22channelId%22%3anull%7d",
+ "addedStudentAction": "none"
} ```
v1.0 Group Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-delete.md
Namespace: microsoft.graph
Delete group.
-When deleted, Microsoft 365 groups are moved to a temporary container and can be restored within 30 days. After that time, they are permanently deleted. To learn more, see [deletedItems](../resources/directory.md). This applies only to Microsoft 365 groups.
-
+When deleted, Microsoft 365 groups are moved to a temporary container and can be restored within 30 days. After that time, they're permanently deleted. This isn't applicable to Security groups and Distribution groups which are permanently deleted immediately. To learn more, see [deletedItems](../resources/directory.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).
v1.0 Group List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-list-members.md
Content-type: text/plain
The following is an example of the request. <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_pr_count" }--> ```msgraph-interactive
Content-type: application/json
The following is an example of the request. <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_a_count" }--> ```msgraph-interactive
v1.0 Group Post Groups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-post-groups.md
Content-type: application/json
#### Request
-The following is an example of the request. The calling user must be assigned the *Directory.AccessAsUser.All* permission to set the **isAssignableToRole** property.
+The following is an example of the request. The calling user or app must be assigned the *RoleManagement.ReadWrite.Directory* permission to set the **isAssignableToRole** property or update the membership of such groups.
# [HTTP](#tab/http)
v1.0 Serviceannouncement List Healthoverviews https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceannouncement-list-healthoverviews.md
If successful, this method returns a `200 OK` response code and a collection of
#### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_healthoverviews"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/healthOverviews ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
#### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_healthoverviews_with_issues"
Content-Type: application/json
``` http GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/healthOverviews?$expand=issues ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Serviceannouncement List Issues https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceannouncement-list-issues.md
If successful, this method returns a `200 OK` response code and a collection of
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_servicehealthissue"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/issues ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Serviceannouncement List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceannouncement-list-messages.md
If successful, this method returns a `200 OK` response code and a collection of
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_serviceupdatemessage"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/messages ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Servicehealth Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/servicehealth-get.md
If successful, this method returns a `200 OK` response code and a [serviceHealth
#### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["Microsoft 365 suite"],
If successful, this method returns a `200 OK` response code and a [serviceHealth
``` http GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/healthOverviews/Microsoft 365 suite ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response <!-- {
Content-Type: application/json
#### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["Microsoft 365 suite"],
Content-Type: application/json
``` http GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/healthOverviews/Microsoft 365 suite?$expand=issues ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Servicehealthissue Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/servicehealthissue-get.md
If successful, this method returns a `200 OK` response code and a [serviceHealth
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["MO226784"],
If successful, this method returns a `200 OK` response code and a [serviceHealth
``` http GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/issues/MO226784 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Servicehealthissue Incidentreport https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/servicehealthissue-incidentreport.md
If successful, this function returns a `200 OK` response code and a file stream
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["MO248163"],
If successful, this function returns a `200 OK` response code and a file stream
``` http GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/issues/MO248163/incidentReport ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Serviceupdatemessage Archive https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceupdatemessage-archive.md
If successful, this action returns a `200 OK` response code and a Boolean value
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceupdatemessage_archive"
Content-Type: application/json
"messageIds": ["MC172851", "MC167983"] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response <!-- {
v1.0 Serviceupdatemessage Favorite https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceupdatemessage-favorite.md
If successful, this action returns a `200 OK` response code and a Boolean value
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceupdatemessage_favorite"
Content-Type: application/json
"messageIds": ["MC172851", "MC167983"] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response <!-- {
v1.0 Serviceupdatemessage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceupdatemessage-get.md
If successful, this method returns a `200 OK` response code and a [serviceUpdate
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["MC172851"],
If successful, this method returns a `200 OK` response code and a [serviceUpdate
``` http GET https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/messages/MC172851 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Serviceupdatemessage Markread https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceupdatemessage-markread.md
If successful, this action returns a `200 OK` response code and a Boolean value
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceupdatemessage_markread"
Content-Type: application/json
"messageIds": ["MC172851", "MC167983"] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response <!-- {
v1.0 Serviceupdatemessage Markunread https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceupdatemessage-markunread.md
If successful, this action returns a `200 OK` response code and a Boolean value
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceupdatemessage_markunread"
Content-Type: application/json
"messageIds": ["MC172851", "MC167983"] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response <!-- {
v1.0 Serviceupdatemessage Unarchive https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceupdatemessage-unarchive.md
If successful, this action returns a `200 OK` response code and a Boolean value
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceupdatemessage_unarchive"
Content-Type: application/json
"messageIds": ["MC172851", "MC167983"] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response <!-- {
v1.0 Serviceupdatemessage Unfavorite https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceupdatemessage-unfavorite.md
If successful, this action returns a `200 OK` response code and a Boolean value
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceupdatemessage_unfavorite"
Content-Type: application/json
"messageIds": ["MC172851", "MC167983"] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response <!-- {
v1.0 User Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-update.md
In the request body, supply the values for relevant fields that should be update
|userType|String|A string value that can be used to classify user types in your directory, such as `Member` and `Guest`. | > [!NOTE]
-> The follow properties cannot be updated using an application-only context: **aboutMe**, **birthday**, **hireDate**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, and **skills**.
+> The following properties cannot be updated using an application-only context: **aboutMe**, **birthday**, **hireDate**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, and **skills**.
## Response
v1.0 Group https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/group.md
This resource supports:
|hideFromAddressLists |Boolean |True if the group is not displayed in certain parts of the Outlook UI: the **Address Book**, address lists for selecting message recipients, and the **Browse Groups** dialog for searching groups; otherwise, false. Default value is `false`. <br><br>Returned only on `$select`. Supported only on the Get group API (`GET /groups/{ID}`).| |hideFromOutlookClients |Boolean |True if the group is not displayed in Outlook clients, such as Outlook for Windows and Outlook on the web; otherwise, false. Default value is `false`. <br><br>Returned only on `$select`. Supported only on the Get group API (`GET /groups/{ID}`).| |id|String|The unique identifier for the group. <br><br>Returned by default. Inherited from [directoryObject](directoryobject.md). Key. Not nullable. Read-only.<br><br>Supports `$filter` (`eq`, `ne`, `NOT`, `in`).|
-|isAssignableToRole|Boolean|Indicates whether this group can be assigned to an Azure Active Directory role or not.<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` and the group cannot be a dynamic group (that is, **groupTypes** cannot contain `DynamicMembership`). Only callers in Global administrator and Privileged role administrator roles can set this property. The caller must also be assigned the *Directory.AccessAsUser.All* permission to set this property. 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`).|
+|isAssignableToRole|Boolean|Indicates whether this group can be assigned to an Azure Active Directory role or not.<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` and the group cannot be a dynamic group (that is, **groupTypes** cannot contain `DynamicMembership`). Only callers in Global administrator and Privileged role administrator roles can set this property. The caller must be assigned the *RoleManagement.ReadWrite.Directory* permission to set this property or update the memership 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`).|
|isSubscribedByMail|Boolean|Indicates whether the signed-in user is subscribed to receive email conversations. Default value is `true`. <br><br>Returned only on `$select`. Supported only on the Get group API (`GET /groups/{ID}`). | |licenseProcessingState|String|Indicates status of the group license assignment to all members of the group. Default value is `false`. Read-only. Possible values: `QueuedForProcessing`, `ProcessingInProgress`, and `ProcessingComplete`.<br><br>Returned only on `$select`. Read-only.| |mail|String|The SMTP address for the group, for example, "serviceadmins@contoso.onmicrosoft.com". <br><br>Returned by default. Read-only. Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`, `in`, `startsWith`).|
v1.0 Invitation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/invitation.md
Creating an invitation will return a redemption URL in the response (*inviteRede
|:|:|:| |invitedUserDisplayName|String|The display name of the user being invited.| |invitedUserEmailAddress|String|The email address of the user being invited. Required. The following special characters are not permitted in the email address:<br><ul><li>Tilde (`~`)</li><li>Exclamation point (`!`)</li><li>Number sign (`#`)</li><li>Dollar sign (`$`)</li><li>Percent (`%`)</li><li>Circumflex (`^`)</li><li>Ampersand (`&`)</li><li>Asterisk (`*`)</li><li>Parentheses (`( )`)</li><li>Plus sign (`+`)</li><li>Equal sign (`=`)</li><li>Brackets (`[ ]`)</li><li>Braces (`{ }`)</li><li>Backslash (`\`)</li><li>Slash mark (`/`)</li><li>Pipe (`\|`)</li><li>Semicolon (`;`)</li><li>Colon (`:`)</li><li>Quotation marks (`"`)</li><li>Angle brackets (`< >`)</li><li>Question mark (`?`)</li><li>Comma (`,`)</li></ul><br>However, the following exceptions apply:<br><ul><li>A period (`.`) or a hyphen (`-`) is permitted anywhere in the user name, except at the beginning or end of the name.</li><li>An underscore (`_`) is permitted anywhere in the user name. This includes at the beginning or end of the name.</li></ul>|
-|invitedUserMessageInfo|[invitedUserMessageInfo](invitedusermessageinfo.md|Additional configuration for the message being sent to the invited user, including customizing message text, language and cc recipient list.|
-|sendInvitationMessage|Boolean|Indicates whether an email should be sent to the user being invited or not. The default is false.|
+|invitedUserMessageInfo|[invitedUserMessageInfo](invitedusermessageinfo.md)|Additional configuration for the message being sent to the invited user, including customizing message text, language and cc recipient list.|
+|sendInvitationMessage|Boolean|Indicates whether an email should be sent to the user being invited. The default is `false`.|
|inviteRedirectUrl|String|The URL the user should be redirected to once the invitation is redeemed. Required.| |inviteRedeemUrl|String|The URL the user can use to redeem their invitation. Read-only.| |invitedUserType|String|The userType of the user being invited. By default, this is `Guest`. You can invite as `Member` if you are a company administrator. |
v1.0 Resourcespecificpermissiongrant https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/resourcespecificpermissiongrant.md
doc_type: resourcePageType
Namespace: microsoft.graph
-A resourceSpecificPermissionGrant declares the permission that has been granted to a specific AzureAD app for an instance of a resource in Microsoft Graph.
+Declares the permission that has been granted to a specific Azure AD app for an instance of a resource in Microsoft Graph.
For more information about granting apps consent to access a specific instance of a resource, see [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
The following is a JSON representation of the resource.
"permissionType": "string", "permission": "string" }
-```
+```
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/onenote-list-notebooks.md - name: Create notebook href: api/onenote-post-notebooks.md
+ - name: Resource-specific permission grants
+ href: resources/resourcespecificpermissiongrant.md
+ items:
+ - name: List for group
+ href: api/group-list-permissiongrants.md
- name: To-do tasks displayName: Microsoft To Do items: