Updates from: 02/03/2021 04:10:06
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 https://docs.microsoft.com/en-us/graph/api/attachment-delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/attachment-delete.md
@@ -19,12 +19,15 @@ Delete an attachment from a user calendar [event](../resources/event.md), [messa
## 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).
+Depending on the resource (**event**, **message**, **outlookTask**, or **post**) that the attachment is attached to and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
+
+| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application |
+|:--|:--|:--|:--|
+| [event](../resources/event.md) | Calendars.ReadWrite | Calendars.ReadWrite | Calendars.ReadWrite |
+| [message](../resources/message.md) | Mail.ReadWrite | Mail.ReadWrite | Mail.ReadWrite |
+| [outlookTask](../resources/outlooktask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
+| [post](../resources/post.md) | Group.ReadWrite.All | Not supported | Not supported |
-* If accessing attachments in messages: Mail.ReadWrite
-* If accessing attachments in events: Calendars.ReadWrite
-* If accessing attachments in Outlook tasks: Tasks.ReadWrite
-* If accessing attachments in group posts: Group.ReadWrite.All
<!-- * If accessing attachments in Group Events or Posts: Group.ReadWrite.All
v1.0 https://docs.microsoft.com/en-us/graph/api/attachment-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/attachment-get.md
@@ -15,16 +15,15 @@ Namespace: microsoft.graph
[!INCLUDE [outlooktask-deprecate-sharedfeature](../../includes/outlooktask-deprecate-sharedfeature.md)]
-Read the properties, relationships, or raw contents of an attachment, attached to a user [event](../resources/event.md), [message](../resources/message.md), [Outlook task](../resources/outlooktask.md), or [post](../resources/post.md).
+Read the properties, relationships, or raw contents of an attachment that is attached to a user [event](../resources/event.md), [message](../resources/message.md), [Outlook task](../resources/outlooktask.md), or group [post](../resources/post.md).
An attachment can be one of the following types:
-* A file ([fileAttachment](../resources/fileattachment.md) resource).
-* An item (contact, event or message, represented by an [itemAttachment](../resources/itemattachment.md) resource). You can use `$expand` to further get the properties of that item. See an [example](#example-3-expand-and-get-the-properties-of-the-item-attached-to-a-message).
-* A link to a file ([referenceAttachment](../resources/referenceattachment.md) resource).
+* A file. Programmatically, this is a [fileAttachment](../resources/fileattachment.md) resource.
+* An Outlook item (contact, event or message). Programmatically, an item attachment is an [itemAttachment](../resources/itemattachment.md) resource. You can use `$expand` to further get the properties of that item. See an [example](#request-2) below.
+* A link to a file stored in the cloud. Programmatically, this is a [referenceAttachment](../resources/referenceattachment.md) resource.
-All these types of attachment resources are derived from the [attachment](../resources/attachment.md)
-resource.
+All these types of attachments are derived from the [attachment](../resources/attachment.md) resource.
### Get the raw contents of a file or item attachment You can append the path segment `/$value` to get the raw contents of a file or item attachment.
@@ -43,12 +42,15 @@ Attempting to get the `$value` of a reference attachment returns HTTP 405.
## 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).
+Depending on the resource (**event**, **message**, **outlookTask**, or **post**) that the attachment is attached to and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
+
+| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application |
+|:--|:--|:--|:--|
+| [event](../resources/event.md) | Calendars.Read | Calendars.Read | Calendars.Read |
+| [message](../resources/message.md) | Mail.Read | Mail.Read | Mail.Read |
+| [outlookTask](../resources/outlooktask.md) | Tasks.Read | Tasks.Read | Not supported |
+| [post](../resources/post.md) | Group.Read.All | Not supported | Not supported |
-* If accessing attachments in messages: Mail.Read
-* If accessing attachments in events: Calendars.Read
-* If accessing attachments in Outlook tasks: Tasks.Read
-* If accessing attachments in group posts: Group.Read.All
<!-- * If accessing attachments in group events or posts: Group.Read.All
v1.0 https://docs.microsoft.com/en-us/graph/api/opentypeextension-delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/opentypeextension-delete.md
@@ -15,9 +15,11 @@ Namespace: microsoft.graph
Delete an open extension ([openTypeExtension](../resources/opentypeextension.md) object) from the specified instance of a resource.
+See the table in the [Permissions](#permissions) section for the list of resources that support open extensions.
+ ## Permissions
-Depending on the resource you're deleting the extension from and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+Depending on the resource you're deleting the extension from and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
v1.0 https://docs.microsoft.com/en-us/graph/api/opentypeextension-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/opentypeextension-get.md
@@ -15,6 +15,8 @@ Namespace: microsoft.graph
Get an open extension ([openTypeExtension](../resources/opentypeextension.md) object) identified by name or fully qualified name.
+The table in the [Permissions](#permissions) section lists the resources that support open extensions.
+ The following table lists the three scenarios where you can get an open extension from a supported resource instance. |**GET scenario**|**Supported resources**|**Response body**|
@@ -25,7 +27,7 @@ The following table lists the three scenarios where you can get an open extensio
## Permissions
-Depending on the resource that contains the extension and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+Depending on the resource that contains the extension and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
v1.0 https://docs.microsoft.com/en-us/graph/api/opentypeextension-post-opentypeextension https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/opentypeextension-post-opentypeextension.md
@@ -16,11 +16,13 @@ Namespace: microsoft.graph
Create an open extension ([openTypeExtension](../resources/opentypeextension.md) object) and add custom properties in a new or existing instance of a supported resource.
+The table in the [Permissions](#permissions) section lists the resources that support open extensions.
+ > **Note:** If you're creating open extensions on Outlook resources, see **Outlook-specific considerations** in [openTypeExtension resource type](../resources/opentypeextension.md#outlook-specific-considerations). ## Permissions
-Depending on the resource you're creating the extension in and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+Depending on the resource you're creating the extension in and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
v1.0 https://docs.microsoft.com/en-us/graph/api/opentypeextension-update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/opentypeextension-update.md
@@ -21,9 +21,11 @@ extension is updated.
The data in an extension can be primitive types, or arrays of primitive types.
+See the table in the [Permissions](#permissions) section for the list of resources that support open extensions.
+ ## Permissions
-Depending on the resource that the extension was created in and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+Depending on the resource that the extension was created in and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
v1.0 https://docs.microsoft.com/en-us/graph/api/subscription-delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/subscription-delete.md
@@ -15,9 +15,11 @@ Namespace: microsoft.graph
Delete a subscription.
+See the table in the [Permissions](#permissions) section for the list of resources that support subscribing to change notifications.
+ ## Permissions
-Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
@@ -43,7 +45,7 @@ Depending on the resource and the permission type (delegated or application) req
> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc). ### driveItem
v1.0 https://docs.microsoft.com/en-us/graph/api/subscription-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/subscription-get.md
@@ -15,9 +15,11 @@ Namespace: microsoft.graph
Retrieve the properties and relationships of a subscription.
+See the table in the [Permissions](#permissions) section for the list of resources that support subscribing to change notifications.
+ ## Permissions
-Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
@@ -43,7 +45,7 @@ Depending on the resource and the permission type (delegated or application) req
> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc). ### driveItem
v1.0 https://docs.microsoft.com/en-us/graph/api/subscription-post-subscriptions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/subscription-post-subscriptions.md
@@ -15,11 +15,13 @@ Namespace: microsoft.graph
Subscribes a listener application to receive change notifications when the requested type of changes occur to the specified resource in Microsoft Graph.
+See the table in the [Permissions](#permissions) section for the list of resources that support subscribing to change notifications.
+ ## Permissions Creating a subscription requires read permission to the resource. For example, to get change notifications on messages, your app needs the Mail.Read permission.
- Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
@@ -45,7 +47,7 @@ Creating a subscription requires read permission to the resource. For example, t
> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc). ### driveItem
v1.0 https://docs.microsoft.com/en-us/graph/api/subscription-update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/subscription-update.md
@@ -15,11 +15,13 @@ Namespace: microsoft.graph
Renew a subscription by extending its expiry time.
+The table in the [Permissions](#permissions) section lists the resources that support subscribing to change notifications.
+ Subscriptions expire after a length of time that varies by resource type. In order to avoid missing change notifications, an app should renew its subscriptions well in advance of their expiry date. See [subscription](../resources/subscription.md) for maximum length of a subscription for each resource type. ## Permissions
-Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
@@ -45,7 +47,7 @@ Depending on the resource and the permission type (delegated or application) req
> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc). ### driveItem
v1.0 https://docs.microsoft.com/en-us/graph/resources/opentypeextension https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/opentypeextension.md
@@ -25,7 +25,7 @@ Open extensions are supported by the following resources in the corresponding ve
| Resource | Version | ||-|
-| [Administrative unit](administrativeunit.md) | Preview only |
+| [Administrative unit](administrativeunit.md) | GA |
| [Calendar event](event.md) | GA | | Group [calendar event](event.md) | GA | | Group conversation thread [post](post.md) | GA |
v1.0 https://docs.microsoft.com/en-us/graph/api/attachment-delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/attachment-delete.md
@@ -13,11 +13,15 @@ Namespace: microsoft.graph
Delete an attachment from a user calendar event, mail message, or group post. ## 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).
-* If accessing attachments in messages: Mail.ReadWrite.
-* If accessing attachments in events: Calendars.ReadWrite.
-* If accessing attachments in group posts: Group.ReadWrite.All.
+Depending on the resource (**event**, **message**, **outlookTask**, or **post**) that the attachment is attached to and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
+
+| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application |
+|:--|:--|:--|:--|
+| [event](../resources/event.md) | Calendars.ReadWrite | Calendars.ReadWrite | Calendars.ReadWrite |
+| [message](../resources/message.md) | Mail.ReadWrite | Mail.ReadWrite | Mail.ReadWrite |
+| [post](../resources/post.md) | Group.ReadWrite.All | Not supported | Not supported |
+ <!-- * If accessing attachments in Group Events or Posts: Group.ReadWrite.All.
v1.0 https://docs.microsoft.com/en-us/graph/api/attachment-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/attachment-get.md
@@ -11,17 +11,15 @@ doc_type: apiPageType
Namespace: microsoft.graph
-Read the properties, relationships, or raw contents of an attachment, attached to a user [event](../resources/event.md),
-[message](../resources/message.md), or [post](../resources/post.md).
+Read the properties, relationships, or raw contents of an attachment that is attached to a user [event](../resources/event.md), [message](../resources/message.md), or group [post](../resources/post.md).
An attachment can be one of the following types:
-* A file ([fileAttachment](../resources/fileattachment.md) resource).
-* An item (contact, event or message, represented by an [itemAttachment](../resources/itemattachment.md) resource). You can use `$expand` to further get the properties of that item. See an [example](#request-2) below.
-* A link to a file ([referenceAttachment](../resources/referenceattachment.md) resource).
+* A file. Programmatically, this is a [fileAttachment](../resources/fileattachment.md) resource.
+* An Outlook item (contact, event or message). Programmatically, an item attachment is an [itemAttachment](../resources/itemattachment.md) resource. You can use `$expand` to further get the properties of that item. See an [example](#request-2) below.
+* A link to a file stored in the cloud. Programmatically, this is a [referenceAttachment](../resources/referenceattachment.md) resource.
-All these types of attachment resources are derived from the [attachment](../resources/attachment.md)
-resource.
+All these types of attachments are derived from the [attachment](../resources/attachment.md) resource.
### Get the raw contents of a file or item attachment You can append the path segment `/$value` to get the raw contents of a file or item attachment.
@@ -39,11 +37,15 @@ For an item attachment that is a [contact](../resources/contact.md), [event](../
Attempting to get the `$value` of a reference attachment returns HTTP 405. ## 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).
-* If accessing attachments in messages: Mail.Read.
-* If accessing attachments in events: Calendars.Read.
-* If accessing attachments in group posts: Group.Read.All.
+Depending on the resource (**event**, **message**, or **post**) that the attachment is attached to and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
+
+| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application |
+|:--|:--|:--|:--|
+| [event](../resources/event.md) | Calendars.Read | Calendars.Read | Calendars.Read |
+| [message](../resources/message.md) | Mail.Read | Mail.Read | Mail.Read |
+| [post](../resources/post.md) | Group.Read.All | Not supported | Not supported |
+ <!-- * If accessing attachments in group events or posts: Group.Read.All.
v1.0 https://docs.microsoft.com/en-us/graph/api/opentypeextension-delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/opentypeextension-delete.md
@@ -13,9 +13,11 @@ Namespace: microsoft.graph
Delete an open extension ([openTypeExtension](../resources/opentypeextension.md) object) from the specified instance of a resource.
+See the table in the [Permissions](#permissions) section for the list of resources that support open extensions.
+ ## Permissions
-Depending on the resource you're deleting the extension from and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+Depending on the resource you're deleting the extension from and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
v1.0 https://docs.microsoft.com/en-us/graph/api/opentypeextension-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/opentypeextension-get.md
@@ -13,6 +13,8 @@ Namespace: microsoft.graph
Get an open extension ([openTypeExtension](../resources/opentypeextension.md) object) identified by name or fully qualified name.
+The table in the [Permissions](#permissions) section lists the resources that support open extensions.
+ The following table lists the three scenarios where you can get an open extension from a supported resource instance. |**GET scenario**|**Supported resources**|**Response body**|
@@ -23,7 +25,7 @@ The following table lists the three scenarios where you can get an open extensio
## Permissions
-Depending on the resource that contains the extension and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+Depending on the resource that contains the extension and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
v1.0 https://docs.microsoft.com/en-us/graph/api/opentypeextension-post-opentypeextension https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/opentypeextension-post-opentypeextension.md
@@ -13,11 +13,13 @@ Namespace: microsoft.graph
Create an open extension ([openTypeExtension](../resources/opentypeextension.md) object) and add custom properties in a new or existing instance of a resource.
+The table in the [Permissions](#permissions) section lists the resources that support open extensions.
+ > **Note:** If you're creating open extensions on Outlook resources, see **Outlook-specific considerations** in [openTypeExtension resource type](../resources/opentypeextension.md#outlook-specific-considerations). ## Permissions
-Depending on the resource you're creating the extension in and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+Depending on the resource you're creating the extension in and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
v1.0 https://docs.microsoft.com/en-us/graph/api/opentypeextension-update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/opentypeextension-update.md
@@ -19,9 +19,11 @@ extension is updated.
The data in an extension can be primitive types, or arrays of primitive types.
+See the table in the [Permissions](#permissions) section for the list of resources that support open extensions.
+ ## Permissions
-Depending on the resource that the extension was created in and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+Depending on the resource that the extension was created in and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
v1.0 https://docs.microsoft.com/en-us/graph/api/subscription-delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/subscription-delete.md
@@ -13,9 +13,11 @@ Namespace: microsoft.graph
Delete a subscription.
+See the table in the [Permissions](#permissions) section for the list of resources that support subscribing to change notifications.
+ ## Permissions
-Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
@@ -37,7 +39,7 @@ Depending on the resource and the permission type (delegated or application) req
> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc). ### driveItem
v1.0 https://docs.microsoft.com/en-us/graph/api/subscription-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/subscription-get.md
@@ -13,9 +13,11 @@ Namespace: microsoft.graph
Retrieve the properties and relationships of a subscription.
+See the table in the [Permissions](#permissions) section for the list of resources that support subscribing to change notifications.
+ ## Permissions
-Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
@@ -37,7 +39,7 @@ Depending on the resource and the permission type (delegated or application) req
> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc). ### driveItem
v1.0 https://docs.microsoft.com/en-us/graph/api/subscription-post-subscriptions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/subscription-post-subscriptions.md
@@ -13,11 +13,13 @@ Namespace: microsoft.graph
Subscribes a listener application to receive change notifications when the requested type of changes occur to the specified resource in Microsoft Graph.
+See the table in the [Permissions](#permissions) section for the list of resources that support subscribing to change notifications.
+ ## Permissions
- Creating a subscription requires read scope to the resource. For example, to get change notifications on messages, your app needs the `Mail.Read` permission.
+Creating a subscription requires read scope to the resource. For example, to get change notifications on messages, your app needs the `Mail.Read` permission.
- Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
@@ -39,7 +41,7 @@ Subscribes a listener application to receive change notifications when the reque
> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc). ### driveItem
v1.0 https://docs.microsoft.com/en-us/graph/api/subscription-update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/subscription-update.md
@@ -13,11 +13,13 @@ Namespace: microsoft.graph
Renew a subscription by extending its expiry time.
+The table in the [Permissions](#permissions) section lists tje resources that support subscribing to change notifications.
+ Subscriptions expire after a length of time that varies by resource type. In order to avoid missing change notifications, an app should renew its subscriptions well in advance of their expiry date. See [subscription](../resources/subscription.md) for maximum length of a subscription for each resource type. ## Permissions
-Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+Depending on the resource and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application | |:--|:--|:--|:--|
@@ -39,7 +41,7 @@ Depending on the resource and the permission type (delegated or application) req
> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc). ### driveItem
v1.0 https://docs.microsoft.com/en-us/graph/resources/opentypeextension https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/opentypeextension.md
@@ -23,7 +23,7 @@ Open extensions are supported by the following resources in the corresponding ve
|Resource |Version | |:|:-|
-| [Administrative unit](/graph/api/resources/administrativeunit?view=graph-rest-beta) | Preview only |
+| [Administrative unit](/graph/api/resources/administrativeunit?view=graph-rest-beta) | GA |
| [Calendar event](event.md) | GA | | Group [calendar event](event.md) | GA | | Group conversation thread [post](post.md) | GA |