Updates from: 06/11/2022 01:17:18
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Channel Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-post.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Create a new [channel](../resources/channel.md) in a team, as specified in the request body.
+> **Note:** You can add a maximum of 200 members when you create a private channel.
> [!IMPORTANT] > Shared channels are currently in public preview status. During this time, the Microsoft Graph API to create a shared channel is available to a limited audience. We recommend creating shared channels in the Teams client and using Microsoft Graph APIs to manage them. For details about how to enable shared channels in the Teams client, see [Shared channels in Microsoft Teams (Preview)](/microsoftteams/shared-channels).
v1.0 Projectrome Get Recent Activities https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/projectrome-get-recent-activities.md
The following is an example of the response.
<!-- { "blockType": "ignored", "truncated": true,
- "@odata.type": "Collection(microsoft.graph.activity)"
+ "@odata.type": "microsoft.graph.activity",
+ "isCollection": true
} --> ```http
v1.0 Rbacapplication Post Roleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/rbacapplication-post-roleassignments.md
Create a new [unifiedRoleAssignment](../resources/unifiedroleassignment.md) obje
Depending on the RBAC provider and the permission type (delegated or application) that is needed, choose from the following table the least privileged permission 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).
-### For Directory (Azure AD) provider
+### For the directory (Azure AD) provider
|Permission type | Permissions (from least to most privileged) | |:--|:|
Depending on the RBAC provider and the permission type (delegated or application
|Delegated (personal Microsoft account) | Not supported. | |Application | RoleManagement.ReadWrite.Directory |
-### For Entitlement management provider
+### For the entitlement management provider
|Permission type | Permissions (from least to most privileged) | |:--|:|
POST /roleManagement/entitlementManagement/roleAssignments
## Request body
-In the request body, supply a JSON representation of a [unifiedRoleAssignment](../resources/unifiedroleassignment.md) object. The request must have either a scope defined in Azure AD, such as **directoryScopeId**, or an application-specific scope, such as **appScopeId**. Examples of Azure AD scopes are tenant ("/"), administrative units, or applications. Entitlement management uses tenant ("/") and access package catalog scopes. For more information, see [appScope](../resources/appscope.md).
+In the request body, supply a JSON representation of a [unifiedRoleAssignment](../resources/unifiedroleassignment.md) object. The request must have either a scope defined in Azure AD, such as **directoryScopeId**, or an application-specific scope, such as **appScopeId**. Examples of Azure AD scopes are tenant ("/"), administrative unit, attribute set, or application. Entitlement management uses tenant ("/") and access package catalog scopes. For more information, see [appScope](../resources/appscope.md).
## Response
If successful, this method returns a `201 Created` response code and a new [unif
## Examples
-### Example 1: Create a role assignment at tenant scope
+### Example 1: Create a role assignment with tenant scope
#### Request
Content-type: application/json
} ```
-### Example 2 : Create a role assignment over an administrative unit scope
+### Example 2 : Create a role assignment with administrative unit scope
#### Request
-The following example assigns a principal User Admin role over an administrative unit.
+The following example assigns the User Administrator role to a principal with administrative unit scope.
# [HTTP](#tab/http)
Content-type: application/json
{ "@odata.type": "#microsoft.graph.unifiedRoleAssignment",
- "roleDefinitionId": "fe930be7-5e62-47db-91af-98c3a49a38b1", //template id of User Account Administrator
+ "roleDefinitionId": "fe930be7-5e62-47db-91af-98c3a49a38b1",
"principalId": "f8ca5a85-489a-49a0-b555-0a6d81e56f0d",
- "directoryScopeId": "/administrativeUnits/5d107bba-d8e2-4e13-b6ae-884be90e5d1a" //object id of an administrative unit
+ "directoryScopeId": "/administrativeUnits/5d107bba-d8e2-4e13-b6ae-884be90e5d1a"
} ``` # [C#](#tab/csharp)
Content-type: application/json
```
-### Example 3: Create a role assignment at access package catalog scope
+### Example 3 : Create a role assignment with attribute set scope
+
+#### Request
+
+The following example assigns the Attribute Assignment Administrator role to a principal with an attribute set scope named Engineering. For more information about Azure AD custom security attributes and attribute set scope, see [Manage access to custom security attributes in Azure AD](/azure/active-directory/fundamentals/custom-security-attributes-manage).
+
+<!-- {
+ "blockType": "request",
+ "name": "create_unifiedroleassignment_attributeset_scope"
+}-->
+
+```http
+POST https://graph.microsoft.com/beta/roleManagement/directory/roleAssignments
+Content-type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.unifiedRoleAssignment",
+ "roleDefinitionId": "58a13ea3-c632-46ae-9ee0-9c0d43cd7f3d",
+ "principalId": "f8ca5a85-489a-49a0-b555-0a6d81e56f0d",
+ "directoryScopeId": "/attributeSets/Engineering"
+}
+```
+
+#### Response
+
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.unifiedRoleAssignment"
+} -->
+
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#roleManagement/directory/roleAssignments/$entity",
+ "id": "oz6hWDLGrkae4JwNQ81_PU-mYqx8m71OpqEQPdN1u",
+ "roleDefinitionId": "58a13ea3-c632-46ae-9ee0-9c0d43cd7f3d",
+ "principalId": "f8ca5a85-489a-49a0-b555-0a6d81e56f0d",
+ "directoryScopeId": "/attributeSets/Engineering"
+}
+```
+
+### Example 4: Create a role assignment with access package catalog scope
#### Request
v1.0 Channel Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/channel-post.md
doc_type: apiPageType
Namespace: microsoft.graph Create a new [channel](../resources/channel.md) in a team, as specified in the request body.
+> **Note:** You can add a maximum of 200 members when you create a private channel.
## Permissions
v1.0 Rbacapplication Post Roleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/rbacapplication-post-roleassignments.md
POST /roleManagement/entitlementManagement/roleAssignments
## Request body
-In the request body, supply a JSON representation of [unifiedRoleAssignment](../resources/unifiedroleassignment.md) object. The request must have either a scope defined in Azure Active Directory (Azure AD) specified by **directoryScopeId**, or an application-specific scope specified by the **appScopeId**. Examples of Azure AD scopes are tenant (`/`), administrative units, or applications. For more information on appScope, see [appScope](../resources/appscope.md).
+In the request body, supply a JSON representation of [unifiedRoleAssignment](../resources/unifiedroleassignment.md) object. The request must have either a scope defined in Azure Active Directory (Azure AD) specified by **directoryScopeId**, or an application-specific scope specified by the **appScopeId**. Examples of Azure AD scopes are tenant (`/`), administrative unit, or application. For more information on appScope, see [appScope](../resources/appscope.md).
The following table shows the properties that are required when you create a [unifiedRoleAssignment](../resources/unifiedroleassignment.md) object.
If successful, this method returns a `201 Created` response code and a new [unif
## Examples
-### Example 1: Create a role assignment with a tenant-wide scope
+### Example 1: Create a role assignment with tenant scope
#### Request
Content-type: application/json
} ```
-### Example 2 : Create a role assignment with an administrative unit scope
+### Example 2 : Create a role assignment with administrative unit scope
#### Request
-The following example assigns a principal the User Administrator role over an administrative unit.
+The following example assigns the User Administrator role to a principal with administrative unit scope.
Content-type: application/json
} ```
-### Example 3 : Create a role assignment with an application scope
+### Example 3 : Create a role assignment with application scope
#### Request
v1.0 Nameditem https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/nameditem.md
Title: "NamedItem resource type"
description: "Represents a defined name for a range of cells or value. Names can be primitive named objects (as seen in the type below), range object, reference to a range. This object can be used to obtain range object associated with names." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Numbercolumn https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/numbercolumn.md
Last updated 09/11/2017
Title: NumberColumn ms.localizationpriority: medium description: "The numberColumn on a columnDefinition resource indicates that the column's values are numbers." doc_type: resourcePageType
v1.0 Onenoteentityhierarchymodel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/onenoteentityhierarchymodel.md
Title: "onenoteEntityHierarchyModel resource"
-description: "This is a base type for OneNote entities."
+description: "A base type for OneNote entities."
ms.localizationpriority: medium doc_type: resourcePageType
doc_type: resourcePageType
Namespace: microsoft.graph
-This is a base type for OneNote entities.
+A base type for OneNote entities.
## JSON representation
Here is a JSON representation of the resource.
``` ## Properties
-## Properties
| Property | Type |Description| |:|:--|:-| |displayName|String|The name of the notebook.|
v1.0 Operation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/operation.md
Title: "operation resource type"
description: "The status of a long-running operation." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Operationerror https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/operationerror.md
Title: "operationError resource type"
description: "Describes errors in teamsAsyncOperation." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Package https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/package.md
Previously updated : 09/10/2017 Title: Package
+ Title: package
ms.localizationpriority: medium
-description: " or a collection of items that should be treated as a collection instead of individual items."
+description: "Indicates that a driveItem is the top-level item in a "package" or a collection of items that should be treated as a collection instead of individual items."
doc_type: resourcePageType
-# Package resource type
+# package resource type
Namespace: microsoft.graph
-The **Package** resource indicates that a DriveItem is the top level item in a "package" or a collection of items that should be treated as a collection instead of individual items.
+The **package** resource indicates that a **driveItem** is the top-level item in a "package" or a collection of items that should be treated as a collection instead of individual items.
An example of a package is a OneNote notebook. While the notebook is made up of files and folders that represent the contents of the notebook, the top level item that represents the notebook has a **package** facet to indicate to clients that this is a collection of data that should be treated special.
-DriveItems with the **package** facet do not include a **folder** or **file** facet but are conceptually similar to an item with a **folder** facet.
+**driveItems** with the **package** facet do not include a **folder** or **file** facet but are conceptually similar to an item with a **folder** facet.
## JSON representation
DriveItems with the **package** facet do not include a **folder** or **file** fa
## Remarks
-For more information about the facets on a DriveItem, see [DriveItem](driveitem.md).
+For more information about the facets on a DriveItem, see [driveItem](driveitem.md).
<!-- {
v1.0 Page https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/page.md
Title: "page resource type"
description: "A page in a OneNote notebook." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Pagelinks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/pagelinks.md
Title: "pageLinks resource type"
description: "Links for opening a OneNote page." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Patchcontentcommand https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/patchcontentcommand.md
Title: "patchContentCommand resource type"
description: "The changes to make to a OneNote page in a PATCH request." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Photo https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/photo.md
Last updated 09/10/2017 Title: Photo
+ Title: photo
ms.localizationpriority: medium description: "The photo resource provides photo and camera properties, for example, EXIF metadata, on a driveItem." doc_type: resourcePageType
-# Photo resource type
+# photo resource type
Namespace: microsoft.graph
v1.0 Printerprocessingstatedetail https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/printerprocessingstatedetail.md
Title: printerProcessingStateDetail enum type
description: Represents the processing status detail of the printer. ms.localizationpriority: medium doc_type: enumPageType
v1.0 Project Rome Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/project-rome-overview.md
Title: "Use the Microsoft Graph API to work with Project Rome"
description: "Project Rome is a Microsoft initiative to build a cross-device experiences platform. Project Rome enables an app on a local client or service to interact with apps and services on a remote host when the user signs in with the same Microsoft account that they use to sign in on the client device. This allows you to program cross-device and cross-platform experiences that are centered around user tasks rather than devices." ms.localizationpriority: medium doc_type: conceptualPageType
v1.0 Publicationfacet https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/publicationfacet.md
Title: "PublicationFacet resource type"
description: "The **publicationFacet** resource provides details on the published status of a driveItemVersion or driveItem resource." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Quota https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/quota.md
Previously updated : 09/10/2017 Title: Quota
+ Title: quota
ms.localizationpriority: medium
-description: "The quota resource provides details about space constrains on a Drive resource."
+description: "The quota resource provides details about space constrains on a drive resource."
doc_type: resourcePageType
-# Quota resource type
+# quota resource type
Namespace: microsoft.graph
-The **quota** resource provides details about space constrains on a [Drive](drive.md) resource.
+The **quota** resource provides details about space constrains on a [drive](drive.md) resource.
## JSON representation
v1.0 Recentnotebook https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/recentnotebook.md
Title: "recentNotebook resource type"
description: "A recently accessed OneNote notebook. A **recentNotebook** is similar to a notebook but has fewer properties." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Recentnotebooklinks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/recentnotebooklinks.md
Title: "recentNotebookLinks resource type"
description: "Links for opening a OneNote notebook. This resource type exists as a property on a recentNotebook resource." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Recipient https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/recipient.md
Title: "recipient resource type"
description: "Represents information about a user in the sending or receiving end of an event, message or group post. " ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Remoteitem https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/remoteitem.md
Previously updated : 09/10/2017 Title: RemoteItem
+ Title: remoteItem
ms.localizationpriority: medium description: "The remoteItem resource indicates that a driveItem references an item that exists in another drive." doc_type: resourcePageType
-# RemoteItem resource type
+# remoteItem resource type
Namespace: microsoft.graph The **remoteItem** resource indicates that a [**driveItem**](driveitem.md) references an item that exists in another drive. This resource provides the unique IDs of the source drive and target item.
-[**DriveItems**](driveitem.md) with a non-null **remoteItem** facet are resources that are shared, added to the user's OneDrive, or on items returned from hetrogenous collections of items (like search results).
+[**driveItems**](driveitem.md) with a non-null **remoteItem** facet are resources that are shared, added to the user's OneDrive, or on items returned from hetrogenous collections of items (like search results).
-**Note:** Unlike with folders in the same drive, a **driveItem** moved into a remote item may have its `id` value changed.
+>**Note:** Unlike with folders in the same drive, a **driveItem** moved into a remote item may have its `id` value changed.
## JSON representation
v1.0 Resource https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/resource.md
Title: "OneNoteResource resource type"
+ Title: "oneNoteResource resource type"
description: "An image or other file resource on a OneNote page. " ms.localizationpriority: medium doc_type: resourcePageType
-# OneNoteResource resource type
+# oneNoteResource resource type
Namespace: microsoft.graph
v1.0 Root https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/root.md
Previously updated : 09/10/2017 Title: Root
+ Title: root resource type
ms.localizationpriority: medium
-description: "The Root facet indicates that an object is the top-most one in its hierarchy."
+description: "The root facet indicates that an object is the top-most one in its hierarchy."
doc_type: resourcePageType
-# Root resource type
+# root resource type
Namespace: microsoft.graph
-The **Root** facet indicates that an object is the top-most one in its hierarchy.
+The **root** facet indicates that an object is the top-most one in its hierarchy.
The presence (non-null) of the facet value indicates that the object is the root. A null (or missing) value indicates the object is not the root.
-**Note**: While this facet is empty today, in future API revisions the facet may be populated with additional properties.
+>**Note**: While this facet is empty today, in future API revisions the facet may be populated with additional properties.
## JSON representation
A null (or missing) value indicates the object is not the root.
## Properties
-The **Root** resource has no properties.
+The **root** resource has no properties.
<!-- {
v1.0 Scoredemailaddress https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/scoredemailaddress.md
Title: "scoredEmailAddress resource type"
description: "Represents a scored email address." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Searchresult https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/searchresult.md
Previously updated : 09/10/2017 Title: SearchResult
+ Title: searchResult resource type
ms.localizationpriority: medium
-description: "The SearchResult resource indicates than an item is the response to a search query."
+description: "The searchResult resource indicates than an item is the response to a search query."
doc_type: resourcePageType
-# SearchResult resource type
+# searchResult resource type
Namespace: microsoft.graph
-The **SearchResult** resource indicates than an item is the response to a search query.
+The **searchResult** resource indicates than an item is the response to a search query.
## JSON representation
The **SearchResult** resource indicates than an item is the response to a search
## Remarks
-For more information about the facets on a DriveItem, see [DriveItem](driveitem.md).
+For more information about the facets on a DriveItem, see [driveItem](driveitem.md).
<!-- { "type": "#page.annotation",
v1.0 Section https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/section.md
Title: "section resource type"
description: "A section in a OneNote notebook. Sections can contain pages." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Sectionlinks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/sectionlinks.md
Title: "sectionLinks resource type"
description: "Links for opening a OneNote section." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Shared https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/shared.md
Previously updated : 09/10/2017 Title: Shared
+ Title: shared resource type
ms.localizationpriority: medium
-description: "The Shared resource indicates a DriveItem has been shared with others."
+description: "The shared resource indicates a driveItem has been shared with others."
doc_type: resourcePageType
-# Shared resource type
+# shared resource type
Namespace: microsoft.graph
-The **Shared** resource indicates a DriveItem has been shared with others.
+The **shared** resource indicates a **driveItem** has been shared with others.
The resource includes information about how the item is shared.
-If a [**Driveitem**](driveitem.md) has a non-null **shared** facet, the item has been shared.
+If a [**driveitem**](driveitem.md) has a non-null **shared** facet, the item has been shared.
## JSON representation
v1.0 Shareddriveitem https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/shareddriveitem.md
Previously updated : 09/10/2017 Title: SharedDriveItem
+ Title: sharedDriveItem resource type
ms.localizationpriority: medium description: "The sharedDriveItem resource is returned when using the Shares API to access a shared driveItem." doc_type: resourcePageType
-# SharedDriveItem resource type
+# sharedDriveItem resource type
Namespace: microsoft.graph
-The **sharedDriveItem** resource is returned when using the [Shares](../api/shares-get.md) API to access a shared [driveItem](driveitem.md).
+The **sharedDriveItem** resource is returned when using the [shares](../api/shares-get.md) API to access a shared [driveItem](driveitem.md).
## JSON representation
The **sharedDriveItem** resource is derived from [**baseItem**](baseitem.md) and
| :- | :- | : | | id | String | The unique identifier for the share being accessed. | | name | String | The display name of the shared item. |
-| owner | [IdentitySet](identityset.md) | Information about the owner of the shared item being referenced. |
+| owner | [identitySet](identityset.md) | Information about the owner of the shared item being referenced. |
## Relationships
Alternatively, for **driveItems** shared from personal OneDrive accounts, the fo
## Remarks
-For more information about the facets on a DriveItem, see [DriveItem](driveitem.md).
+For more information about the facets on a DriveItem, see [driveItem](driveitem.md).
<!-- { "type": "#page.annotation",
v1.0 Sharinginvitation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/sharinginvitation.md
Last updated 09/10/2017 Title: SharingInvitation
+ Title: sharingInvitation resource type
ms.localizationpriority: medium
-description: "The SharingInvitation resource groups invitation-related data items into a single structure."
+description: "The sharingInvitation resource groups invitation-related data items into a single structure."
doc_type: resourcePageType
-# SharingInvitation resource type
+# sharingInvitation resource type
Namespace: microsoft.graph
-The **SharingInvitation** resource groups invitation-related data items into a single structure.
+Groups invitation-related data items into a single structure.
## JSON representation
Here is a JSON representation of the resource.
## Remarks
-For more information about the facets on a DriveItem, see [DriveItem](driveitem.md).
+For more information about the facets on a **driveItem**, see [driveItem](driveitem.md).
[DriveItem]: driveitem.md [IdentitySet]: identityset.md
v1.0 Sharinglink https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/sharinglink.md
Previously updated : 09/10/2017 Title: SharingLink
+ Title: sharingLink resource type
ms.localizationpriority: medium
-description: "The SharingLink resource groups link-related data items into a single structure."
+description: "The sharingLink resource groups link-related data items into a single structure."
doc_type: resourcePageType
-# SharingLink resource type
+# sharingLink resource type
Namespace: microsoft.graph
-The **SharingLink** resource groups link-related data items into a single structure.
+Groups link-related data items into a single structure.
-If a [**Permission**](permission.md) resource has a non-null **sharingLink** facet, the permission represents a sharing link (as opposed to permissions granted to a person or group).
+If a [**permission**](permission.md) resource has a non-null **sharingLink** facet, the permission represents a sharing link (as opposed to permissions granted to a person or group).
## JSON representation