| Service | Microsoft Docs article | Related commit history on GitHub | Change details |
|---|---|---|---|
| v1.0 | Driveitem Post Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-post-permissions.md | + + Title: "Create permission on a driveItem" +description: "Create a new permission for a driveItem." ++ms.localizationpriority: medium ++++# Create permission on a driveItem +Namespace: microsoft.graph +++Create a new [permission](../resources/permission.md) object on a [driveItem](../resources/permission.md). ++>**Note:** You can only use this method to create a new application permission. If you want to create a new user permission in a drive item, see [invite](./driveitem-invite.md). +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "driveitem_post_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /drives/{drive-id}/items/{item-id}/permissions +POST /groups/{group-id}/drive/items/{item-id}/permissions +POST /me/drive/items/{item-id}/permissions +POST /sites/{siteId}/drive/items/{itemId}/permissions +POST /users/{userId}/drive/items/{itemId}/permissions +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [permission](../resources/permission.md) object. ++## Response ++If successful, this method returns a `201 Created` response code and a [permission](../resources/permission.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "create_permission_from_" +} +--> ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.permission" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "id": "1", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "write" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "Items/Permissions/Create driveitem permissions" +} --> |
| v1.0 | List Delete Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/list-delete-permissions.md | + + Title: "Delete permission on a list" +description: "Delete a permission object on a list." ++ms.localizationpriority: medium ++++# Delete permission on a list +Namespace: microsoft.graph +++Delete a [permission](../resources/permission.md) object on a [list](../resources/list.md). +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "list_delete_permission" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /sites/{site-id}/lists/{list-id}/permissions/{permissionId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns `204 No Content` response code. It doesn't return anything in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "delete_permission_2" +} +--> ++++### Response +The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true +} --> ++```http +HTTP/1.1 204 No Content +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "Lists/Permissions/Delete list permission" +} --> |
| v1.0 | List Get Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/list-get-permissions.md | + + Title: "Get permission on a list" +description: "Retrieve the properties and relationships of a permission object on a list." ++ms.localizationpriority: medium ++++# Get permission on a list +Namespace: microsoft.graph +++Retrieve the properties and relationships of a [permission](../resources/permission.md) object on a [list](../resources/list.md). +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "list_get_permission" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /sites/{site-id}/lists/{list-id}/permissions/ +``` ++## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [permission](../resources/permission.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "get_permission", + "sampleKeys": ["f2d90359-865b-4b6c-8848-d2722dd630e5", "1"] +} +--> ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.permission" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "id": "1", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "read" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "Lists/Permissions/Get list permission" +} --> |
| v1.0 | List List Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/list-list-permissions.md | + + Title: "List permissions on a list" +description: "Get the permission resources from the permissions navigation property on a list." ++ms.localizationpriority: medium ++++# List permissions on a list +Namespace: microsoft.graph +++Get a list of the [permission](../resources/permission.md) objects associated with a [list](../resources/list.md). +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "list_list_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /sites/{site-id}/lists/{list-id}/permissions +``` ++## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a collection of [permission](../resources/permission.md) objects in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "list_permission_list_nav_property" +} +--> ++++### Response ++The following example shows the response. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.permission)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "id": "1", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "read" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ] + }, + { + "id": "2", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "write" + ], + "grantedToIdentities": [ + { + "application": { + "id": "22f09bb7-dd29-403e-bec2-ab5cde52c2b3", + "displayName": "Fabrikam Dashboard App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "22f09bb7-dd29-403e-bec2-ab5cde52c2b3", + "displayName": "Fabrikam Dashboard App" + } + } + ] + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "Lists/Permissions/List list permissions" +} --> |
| v1.0 | List Post Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/list-post-permissions.md | + + Title: "Create permission on a list" +description: "Create a new permission object." ++ms.localizationpriority: medium ++++# Create permission on a list +Namespace: microsoft.graph +++Create a new [permission](../resources/permission.md) object on a [list](../resources/list.md). ++>**Note:** You can only use this method to create a new application permission; you can't use it to create a new list permission for a user. +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "list_post_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /sites/f2d90359-865b-4b6c-8848-d2722dd630e5/lists/1d702d60-503c-4924-abfd-028c65fc89ed/permissions +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [permission](../resources/permission.md) object. ++## Response ++If successful, this method returns a `201 Created` response code and a [permission](../resources/permission.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "create_permission_from_" +} +--> ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.permission" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "id": "1", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "write" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "Lists/Permissions/Create list permissions" +} --> |
| v1.0 | List Update Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/list-update-permissions.md | + + Title: "Update permission on a list" +description: "Update the permission object on a list." ++ms.localizationpriority: medium ++++# Update permission on a list +Namespace: microsoft.graph +++Update the [permission](../resources/permission.md) object on a [list](../resources/list.md). ++>**Note:** You can't use this method to update a list permission for a user. +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "list_update_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /sites/{site-id}/lists/{list-id}/permissions/{permissionId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [permission](../resources/permission.md) object. ++## Response ++If successful, this method returns a `200 OK` response code and a [permission](../resources/permission.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "update_permission_from_", + "sampleKeys": ["f2d90359-865b-4b6c-8848-d2722dd630e5", "2"] +} +--> ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.permission" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "id": "2", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "read" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Fabrikam Dashboard App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Fabrikam Dashboard App" + } + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "Lists/Permissions/Update list permission" +} --> |
| v1.0 | Listitem Delete Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/listitem-delete-permissions.md | + + Title: "Delete permission on a listItem" +description: "Delete a permission object on a list item." ++ms.localizationpriority: medium ++++# Delete permission on a listItem +Namespace: microsoft.graph +++Delete a [permission](../resources/permission.md) object on a [list item](../resources/listitem.md). +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "listitem_delete_permission" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /sites/{site-id}/lists/{list-id}/items/{item-id}/{permissionId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns `204 No Content` response code. It doesn't return anything in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "delete_permission_2" +} +--> ++++### Response +The following example shows the response. +<!-- { + "blockType": "response", + "truncated": true +} --> ++```http +HTTP/1.1 204 No Content +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "ListItems/Permissions/Delete listitem permission" +} --> |
| v1.0 | Listitem Get Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/listitem-get-permissions.md | + + Title: "Get permission on a listItem" +description: "Retrieve the properties and relationships of a permission object on a list item." ++ms.localizationpriority: medium ++++# Get permission on a listItem +Namespace: microsoft.graph +++Retrieve the properties and relationships of a [permission](../resources/permission.md) object on a [list item](../resources/listitem.md). +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "listitem_get_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /sites/{site-id}/lists/{list-id}/items/{item-id}/permissions/{permission-id} +``` ++## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [permission](../resources/permission.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "get_permission", + "sampleKeys": ["f2d90359-865b-4b6c-8848-d2722dd630e5","f2d90359-865b-4b6c-8848-d2722dd630e5", "1", "3"] +} +--> ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.permission" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "id": "1", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "read" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "ListItems/Permissions/Get listitems permission" +} --> |
| v1.0 | Listitem List Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/listitem-list-permissions.md | + + Title: "List permissions on a listItem" +description: "Get a list of the permissions objects associated with a list item." ++ms.localizationpriority: medium ++++# List permissions on a listItem +Namespace: microsoft.graph +++Get a list of the [permission](../resources/permission.md) objects associated with a [listItem](../resources/listitem.md). +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "listitem_list_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /sites/{site-id}/lists/{list-id}/items/{item-id}/permissions +``` ++## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body +Don't supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a collection of [permission](../resources/permission.md) objects in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "list_permission_listitem_nav_property" +} +--> ++++### Response ++The following example shows the response. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.permission)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "id": "1", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "read" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ] + }, + { + "id": "2", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "write" + ], + "grantedToIdentities": [ + { + "application": { + "id": "22f09bb7-dd29-403e-bec2-ab5cde52c2b3", + "displayName": "Fabrikam Dashboard App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "22f09bb7-dd29-403e-bec2-ab5cde52c2b3", + "displayName": "Fabrikam Dashboard App" + } + } + ] + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "ListItems/Permissions/List listitem permissions" +} --> |
| v1.0 | Listitem Post Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/listitem-post-permissions.md | + + Title: "Create permission on a listItem" +description: "Create a new permission object." ++ms.localizationpriority: medium ++++# Create permission on a listItem +Namespace: microsoft.graph +++Create a new [permission](../resources/permission.md) object on a [list item](../resources/listitem.md). ++>**Note:** You can only use this method to create a new application permission; you can't use it to create a new list item permission for a user. +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "listitem_post_permissions" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /sites/{site-id}/lists/{list-id}/items/{item-id}/permissions +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [permission](../resources/permission.md) object. ++## Response ++If successful, this method returns a `201 Created` response code and a [permission](../resources/permission.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "create_permission_from_" +} +--> ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.permission" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "id": "1", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "write" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Contoso Time Manager App" + } + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "ListItems/Permissions/Create listitem permissions" +} --> |
| v1.0 | Listitem Update Permissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/listitem-update-permissions.md | + + Title: "Update permission on a listItem" +description: "Update the permission object on a list item." ++ms.localizationpriority: medium ++++# Update permission on a listItem +Namespace: microsoft.graph +++Update the [permission](../resources/permission.md) object on a [list item](../resources/listitem.md). ++>**Note:** You can't use this method to update a user listitem permission. +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "listitem_update_permission" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /sites/{site-id}/lists/{list-id}/items/{item-id}/permissions/{permission-id} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [permission](../resources/permission.md) object. ++## Response ++If successful, this method returns a `200 OK` response code and a [permission](../resources/permission.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "update_permission_from_", + "sampleKeys": ["f2d90359-865b-4b6c-8848-d2722dd630e5", "2"] +} +--> ++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.permission" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "id": "2", + "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2", + "roles": [ + "read" + ], + "grantedToIdentities": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Fabrikam Dashboard App" + } + } + ], + "grantedToIdentitiesV2": [ + { + "application": { + "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e", + "displayName": "Fabrikam Dashboard App" + } + } + ] +} +``` ++<!-- { + "type": "#page.annotation", + "section": "documentation", + "tocPath": "ListItems/Permissions/Update listitem permission" +} --> |
| v1.0 | Driveitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/driveitem.md | Items with the **folder** facet act as containers of items and therefore have a ## Methods -| Method | REST Path | -|:--|:--| -| [Get item](../api/driveitem-get.md) | `GET /drive/items/{item-id}` | -| [List activities](../api/activities-list.md) | `GET /drive/items/{item-id}/activities` | -| [Get analytics][] | `GET /drive/items/{item-id}/analytics` | -| [Get activities by interval][] | `GET /drive/items/{item-id}/getActivitiesByInterval` | -| [List children](../api/driveitem-list-children.md) | `GET /drive/items/{item-id}/children` | -| [List versions](../api/driveitem-list-versions.md) | `GET /drive/items/{item-id}/versions` | -| [Create folder](../api/driveitem-post-children.md) | `POST /drive/items/{item-id}/children` | -| [Update item](../api/driveitem-update.md) | `PATCH /drive/items/{item-id}` | -| [Upload](../api/driveitem-put-content.md) | `PUT /drive/items/{item-id}/content` | -| [Download content](../api/driveitem-get-content.md) (deprecated) | `GET /drive/items/{item-id}/content` | -| [Download file](../api/driveitem-get-contentstream.md) | `GET /drive/items/{item-id}/contentStream` | -| [Download specific file format][download-format] | `GET /drive/items/{item-id}/content?format={format}` | -| [Delete item](../api/driveitem-delete.md) | `DELETE /drive/items/{item-id}` | -| [Permanently delete item](../api/driveitem-permanentdelete.md) | `POST /drives/{driveId}/items/{itemId}/permanentDelete` | -| [Restore item](../api/driveitem-restore.md) | `POST /drive/items/{item-id}/restore` | -| [Move item](../api/driveitem-move.md) | `PATCH /drive/items/{item-id}` | -| [Copy item](../api/driveitem-copy.md) | `POST /drive/items/{item-id}/copy` | -| [Search items](../api/driveitem-search.md) | `GET /drive/items/{item-id}/search(q='text')` | -| [Track changes](../api/driveitem-delta.md) | `GET /drive/root/delta` | -| [Follow item](../api/driveitem-follow.md) | `POST /drives/{drive-id}/items/{item-id}/follow` | -| [Unfollow item](../api/driveitem-unfollow.md) | `POST /drives/{drive-id}/items/{item-id}/unfollow` | -| [Get thumbnails](../api/driveitem-list-thumbnails.md) | `GET /drive/items/{item-id}/thumbnails` | -| [Create sharing link](../api/driveitem-createlink.md) | `POST /drive/items/{item-id}/createLink` | -| [Add permissions](../api/driveitem-invite.md) | `POST /drive/items/{item-id}/invite` | -| [List permissions](../api/driveitem-list-permissions.md) | `GET /drive/items/{item-id}/permissions` | -| [Delete permission](../api/permission-delete.md) | `DELETE /drive/items/{item-id}/permissions/{perm-id}` | -| [Get WebSocket channel][getWebSocket] | `GET /drive/root/subscriptions/socketIo` | -| [Preview item][item-preview] | `POST /drive/items/{item-id}/preview` | -| [Check in files](../api/driveitem-checkin.md) | `POST /drives/{driveId}/items/{itemId}/checkin` | -| [Check out files](../api/driveitem-checkout.md) | `POST /drives/{driveId}/items/{itemId}/checkout` | -| [Revoke grants on sharing link](../api/permission-revokegrants.md) | `PATCH /drive/items/{item-id}/permissions/{perm-id}/revokeGrants` | -| [Extract sensitivity labels](../api/driveitem-extractsensitivitylabels.md) | `POST /drive/items/{item-id}/extractSensitivityLabels` | -| [Assign sensitivity label](../api/driveitem-assignsensitivitylabel.md) | `POST /drive/items/{item-id}/assignSensitivityLabel` | -| [Get retention label](../api/driveitem-getretentionlabel.md) | `GET /drives/{drive-id}/items/{id}/retentionLabel` | -| [Set retention label](../api/driveitem-setretentionlabel.md) | `PATCH /drives/{drive-id}/items/{id}/retentionLabel` | -| [Remove retention label](../api/driveitem-removeretentionlabel.md) | `DELETE /drives/{drive-id}/items/{id}/retentionLabel` | -| [Lock or unlock record](../api/driveitem-lockorunlockrecord.md) | `PATCH /drives/{drive-id}/items/{id}/retentionLabel` | +| Method | Return Type | Description | +|:--|:|:-| +| [Get item](../api/driveitem-get.md) | [driveItem](../resources/driveitem.md) |Retrieve the metadata for a **driveItem** in a drive.| +| [Get analytics][] | [itemAnalytics][] | Get analytics for this resource.| +| [Get activities by interval][] | [itemActivityStat](../resources/itemactivitystat.md) | Get a collection of **itemActivityStats** within the specified time interval.| +| [List children](../api/driveitem-list-children.md) | [driveItem](../resources/driveitem.md) collection | Return a collection of **driveItems** in the children relationship of a **driveItem**.| +| [List versions](../api/driveitem-list-versions.md) | [driveItemVersion][] collection | Retrieve the versions of a file in the current user's drive.| +| [Create folder](../api/driveitem-post-children.md) | [driveItem](../resources/driveitem.md) | Create a **driveItem** in the specified drive.| +| [Update item](../api/driveitem-update.md) | [driveItem](../resources/driveitem.md) | Update a **driveItem** in the drive.| +| [Upload](../api/driveitem-put-content.md) | [driveItem](../resources/driveitem.md) | Upload content to the **driveItem**.| +| [Download file content](../api/driveitem-get-contentstream.md) | Stream |Download the contents of the primary stream (file) of a **driveItem**. | +| [Download specific file format][download-format] | download URL | Download content of a **driveItem** with a specific format.| +| [Delete item](../api/driveitem-delete.md) | None | Delete a **driveItem**.| +| [Permanently delete item](../api/driveitem-permanentdelete.md) | None | Permanently delete a **driveItem** by using its ID. | +| [Move item](../api/driveitem-move.md) | [driveItem](../resources/driveitem.md) | Move a **driveItem** to a new parent item.| +| [Copy item](../api/driveitem-copy.md) | details about how to [monitor the progress](/graph/long-running-actions-overview) of the copy | Create a copy of a **driveItem** (including any children).| +| [Search items](../api/driveitem-search.md) | [driveItem](../resources/driveitem.md) collection | Search the hierarchy of items for items matching a query.| +| [Track changes](../api/driveitem-delta.md) | delta link | List any changes in the drive.| +| [Follow item](../api/driveitem-follow.md) | [driveItem](../resources/driveitem.md) | Follow a **driveItem**.| +| [Unfollow item](../api/driveitem-unfollow.md) | None | Unfollow a **driveItem**.| +| [Get thumbnails](../api/driveitem-list-thumbnails.md) | [driveItem](../resources/driveitem.md) collection | List **driveItems** with their thumbnails.| +| [Create sharing link](../api/driveitem-createlink.md) | sharing link | Create a link to share the **driveItem**.| +| [Add permissions](../api/driveitem-invite.md) | [permission][] collection | Send a sharing invite to a user.| +| [List permissions](../api/driveitem-list-permissions.md) | [permission][] collection | Retrieve the collection of permissions on a **driveItem**.| +| [Create permission](../api/driveitem-post-permissions.md) | [permission][] | Create a permission on a **driveItem**.| +| [Delete permission](../api/permission-delete.md) | None | Remove the permission from the **driveItem**.| +| [Revoke grants on sharing link](../api/permission-revokegrants.md)| [permission][] | Revoke access to a **listItem** or **driveItem** granted via a sharing link by removing the specified recipient from the link.| +| [Get WebSocket channel][getWebSocket] | [subscription][] | Receive near-real-time change notifications for a drive using socket.io.| +| [Preview item][item-preview] | json object | Obtain short-lived embeddable URLs for an item in order to render a temporary preview.| +| [Check in files](../api/driveitem-checkin.md) | None| Check in a checked out **driveItem** resource, which makes the version of the document available to others. | +| [Check out files](../api/driveitem-checkout.md) | None| Check out a **driveItem** resource to prevent others from editing the document, and prevent your changes from being visible until the documented is [checked in](../api/driveitem-checkin.md). | +| [Extract sensitivity labels](../api/driveitem-extractsensitivitylabels.md) | [extractSensitivityLabelsResult](../resources/extractsensitivitylabelsresult.md) | Extract one or more sensitivity labels assigned to a drive item and update the metadata of a drive item with the latest details of the assigned label. | +| [Assign sensitivity label](../api/driveitem-assignsensitivitylabel.md) | String | Asynchronously assign a sensitivity label to a **driveItem**.| +| [Get retention label](../api/driveitem-getretentionlabel.md) | [itemRetentionLabel](../resources/itemretentionlabel.md) | Get metadata information for a retention label applied on a **driveItem**. | +| [Set retention label](../api/driveitem-setretentionlabel.md) | [itemRetentionLabel](../resources/itemretentionlabel.md) | Apply (set) a retention label on a **driveItem** (files and folders). | +| [Remove retention label](../api/driveitem-removeretentionlabel.md) | None | Remove a retention label from a **driveItem**. | +| [Lock or unlock record](../api/driveitem-lockorunlockrecord.md) | [itemRetentionLabel](../resources/itemretentionlabel.md) | Lock or unlock a retention label on a **driveItem** that classifies content as records. | +| [Download file (deprecated)](../api/driveitem-get-content.md) | download URL | Download content of a **driveItem**.| ## Properties |
| v1.0 | List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/list.md | Represents a list in a [site](site.md). This resource contains the top level pro | Method | Return Type | Description | |:--|:--|:|+| [Create](../api/list-create.md) | [list](../resources/list.md) | Create a new **list** in a **site**. | +| [Get](../api/list-get.md) | [list](../resources/list.md) | Get the metadata for a **list**. | +| [Get items](../api/listitem-list.md) | [listItem](../resources/listitem.md) collection | Get the collection of [listItems]( ../resources/listitem.md) in a **list**. | | [Get lists in a site](../api/list-list.md) | [list](../resources/list.md) collection | Get the collection of **lists** in a [site](site.md). |-| [Create list](../api/list-create.md) | [list](../resources/list.md) | Create a new **list** in a **site**. | -| [Get list](../api/list-get.md) | [list](../resources/list.md) | Get the metadata for a **list**. | | [Get recent activities](../api/activities-list.md) | [itemActivity](../resources/itemactivity.md) collection | List the recent [activities](../resources/itemactivity.md) that took place on an item or under a hierarchy. |-| [Get items](../api/listitem-list.md) | [listItem](../resources/listitem.md) collection | Get the collection of [listItems]( ../resources/listitem.md) in a **list**. | +| [Create item](../api/listitem-create.md) | [listItem](../resources/listitem.md) | Create a new [listItem]( ../resources/listitem.md) in a **list**. | | [Update item](../api/listitem-update.md) | [listItem](../resources/listitem.md) | Update the properties on a [listItem]( ../resources/listitem.md). | | [Delete item](../api/listitem-delete.md) | None | Delete a [listItem]( ../resources/listitem.md) from a **list**. |-| [Create item](../api/listitem-create.md) | [listItem](../resources/listitem.md) | Create a new [listItem]( ../resources/listitem.md) in a **list**. | | [Get websocket endpoint](../api/subscriptions-socketio.md) | [subscription](../resources/subscription.md) | Get near-real-time change notifications for a [drive](../resources/drive.md) and **list** using [socket.io](https://socket.io/). | | [List operations in a list](../api/list-list-operations.md) | [richLongRunningOperation](../resources/richlongrunningoperation.md) collection | Get a list of [rich long-running operations](../resources/richlongrunningoperation.md) associated with a **list**. | | [List content types](../api/list-list-contenttypes.md) | [contentType](../resources/contenttype.md) collection | Get the collection of [contentType](../resources/contenttype.md) resources in a **list**. | | [Add copy to list](../api/contenttype-addcopy.md) | [contentType](../resources/contenttype.md) | Add a copy of a [contentType](../resources/contenttype.md) from a [site](site.md) to a **list**. | | [List columns](../api/list-list-columns.md) | [columnDefinition](../resources/columndefinition.md) collection | Get the collection of columns, represented as [columnDefinition](../resources/columndefinition.md) objects, in a **list**. | | [Create column](../api/list-post-columns.md) | [columnDefinition](../resources/columndefinition.md) | Create a column for a **list** with a request that specifies a [columnDefinition](../resources/columndefinition.md). |+| [List permissions](../api/list-list-permissions.md)| [permission](../resources/permission.md) |Get a list of the [permission](../resources/permission.md) objects associated with a [list](../resources/list.md).| +| [Create permission](../api/list-list-permissions.md)| [permission](../resources/permission.md) |Get a list of the [permission](../resources/permission.md) objects associated with a [list](../resources/list.md).| +| [Get permission](../api/list-post-permissions.md)| [permission](../resources/permission.md) |Create a new [permission](../resources/permission.md) object on a [list](../resources/list.md).| +| [Update permission](../api/list-update-permissions.md)| [permission](../resources/permission.md) |Update a [permission](../resources/permission.md) object on a [list](../resources/list.md).| +| [Delete permission](../api/list-delete-permissions.md)| None |Delete a [permission](../resources/permission.md) object on a [list](../resources/list.md).| ## Properties Represents a list in a [site](site.md). This resource contains the top level pro | drive | [drive](drive.md) | Allows access to the list as a **drive** resource with [driveItems](driveitem.md). Only present on document libraries. | | items | [listItem](listitem.md) collection | All items contained in the list. | | operations | [richLongRunningOperation](../resources/richlongrunningoperation.md) collection | The collection of long-running operations on the list. |+| permissions | [permission](permission.md) collection | The set of permissions for the item. Read-only. Nullable. | | subscriptions | [subscription](subscription.md) collection | The set of subscriptions on the list. | ## JSON representation |
| v1.0 | Listitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/listitem.md | Column values in the list are available through the `fieldValueSet` dictionary. ## Methods The following tasks are available for **listItem** resources.-All examples below are relative to a **[list][]**, eg: `https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}`. --| Common task | HTTP method | -| :-- | :- | -| [Get][] | GET /items/{item-id} | -| [Get column values][Get] | GET /items/{item-id}?expand=fields | -| [Get analytics][] | GET /items/{item-id}/analytics | -| [Get activities by interval][] | GET /items/{item-id}/getActivitiesByInterval | -| [Create][] | POST /items | -| [Delete][] | DELETE /items/{item-id} | -| [Update][] | PATCH /items/{item-id} | -| [Update column values][Update] | PATCH /items/{item-id}/fields | -| [createLink][CreateLink] | POST /items/{itemId}/createLink | -| [List](../api/listitem-list-documentsetversions.md)| GET /items/{item-id}/documentSetVersions | -| [Create](../api/listitem-post-documentsetversions.md)| POST /items/{item-id}/documentSetVersions | -| [Restore](../api/documentsetversion-restore.md)| POST /items/{item-id}/documentSetVersions/{documentSetVersion-id}/restore | -| [Get delta][item-changes] | GET /items/{item-id}/delta +All examples are relative to a **[list][]**; for example, `https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}`. ++| Method | Return Type | Description | +|:-|:--|:--| +| [Create][] | listItem | Create a new listItem in a list. | +| [Get][] | listItem | Get an item in a list. | +| [Update][] | [fieldValueSet][] | Update the properties on a listItem. | +| [Delete][] | No Content | Removes an item from a list. | +| [Get analytics][] | [itemAnalytics][] | Get analytics for this resource. | +| [Get column values][Get] | listItem | Get column values from listItem. | +| [Update column values][Update] | [fieldValueSet][] | Update column values on a listItem. | +| [List document set version](../api/listitem-list-documentsetversions.md) | [documentSetVersion][] collection | Get a list of the versions of a document set item in a list. | +| [Create document set version](../api/listitem-post-documentsetversions.md) | [documentSetVersion][] | Create a new version of a document set item in a list. | +| [Restore document set version](../api/documentsetversion-restore.md) | No Content | Restore the document set item to a specific version. | +| [Get delta](../api/listitem-delta.md) | [listItem](../resources/listitem.md) collection | Get newly created, updated, or deleted [list items](../resources/listitem.md) without having to perform a full read of the entire items collection. | +| [List permissions](../api/listitem-list-permissions.md)| [permission](../resources/permission.md) |Get a list of the [permission](../resources/permission.md) objects associated with a [listItem](../resources/listitem.md).| +| [Create permission](../api/listitem-list-permissions.md)| [permission](../resources/permission.md) |Get a list of the [permission](../resources/permission.md) objects associated with a [listItem](../resources/listitem.md).| +| [Get permission](../api/listitem-post-permissions.md)| [permission](../resources/permission.md) |Create a new [permission](../resources/permission.md) object on a [listItem](../resources/listitem.md).| +| [Update permission](../api/listitem-update-permissions.md)| [permission](../resources/permission.md) |Update a [permission](../resources/permission.md) object on a [listItem](../resources/listitem.md).| +| [Delete permission](../api/listitem-delete-permissions.md)| None |Delete a [permission](../resources/permission.md) object on a [listItem](../resources/listitem.md).| [Get]: ../api/listitem-get.md [Get analytics]: ../api/itemanalytics-get.md-[Get activities by interval]: ../api/itemactivity-getbyinterval.md [Create]: ../api/listitem-create.md [Delete]: ../api/listitem-delete.md [Update]: ../api/listitem-update.md-[CreateLink]: ../api/listitem-createlink.md -[item-changes]: ../api/listitem-delta.md +[itemActivityStat]: itemactivitystat.md +[fieldValueSet]: fieldvalueset.md +[documentSetVersion]: documentsetversion.md ## Properties The following properties are inherited from **[baseItem][]**. |documentSetVersions|[documentSetVersion](../resources/documentsetversion.md) collection| Version information for a document set version created by a user.| | driveItem | [driveItem][] | For document libraries, the **driveItem** relationship exposes the listItem as a **[driveItem][]** | | fields | [fieldValueSet][] | The values of the columns set on this list item. |+| permissions | [permission](permission.md) collection | The set of permissions for the item. Read-only. Nullable. | | versions | [listItemVersion][] collection | The list of previous versions of the list item. | ## JSON representation |
| v1.0 | Shared | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/shared.md | Title: Shared + Title: shared resource type -description: The Shared resource indicates a DriveItem has been shared with others. Previously updated : 09/10/2017+description: Indicates that a drive item has been shared with others. ms.localizationpriority: medium doc_type: resourcePageType -# Shared resource type +# shared resource type Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -The **Shared** resource indicates a DriveItem has been shared with others. -The resource includes information about how the item is shared. +Indicates that a [drive item](driveitem.md) was shared with others and 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 was shared. ++## Properties ++| Property | Type | Description +| :- |:|:- +| owner | [IdentitySet](identityset.md) | The identity of the owner of the shared item. Read-only.| +| sharedBy | [identitySet](identityset.md) | The identity of the user who shared the item. Read-only.| +| sharedDateTime | DateTimeOffset | The UTC date and time when the item was shared. Read-only.| +| scope (deprecated)| String | Indicates the scope of how the item is shared. The possible values are: `anonymous`, `organization`, or `users`. Read-only.| +++### scope property values ++| Value | Description | +|:|:--| +| `anonymous` | The item is shared by using a link that works for anyone with the link. | +| `organization` | The item is shared by using a link that works for anyone in the owner's organization. | +| `users` | The item is shared with specific users only. | ## JSON representation If a [**Driveitem**](driveitem.md) has a non-null **shared** facet, the item has } ``` -## Properties --| Property | Type | Description -| :- |:|:- -| owner | [IdentitySet](identityset.md) | The identity of the owner of the shared item. Read-only. -| scope | String | Indicates the scope of how the item is shared: `anonymous`, `organization`, or `users`. Read-only. -| sharedBy | [identitySet](identityset.md) | The identity of the user who shared the item. Read-only. -| sharedDateTime | DateTimeOffset | The UTC date and time when the item was shared. Read-only. --## Scope values --| Value | Description | -|:|:--| -| `anonymous` | The item is shared by using a link that works for anyone with the link. | -| `organization` | The item is shared by using a link that works for anyone in the owner's organization. | -| `users` | The item is shared with specific users only. | --## Remarks --For more information about the facets on a **driveItem**, see [**driveItem**](driveitem.md). - <!-- { "type": "#page.annotation", |
| v1.0 | Shared | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/shared.md | Title: shared resource type ms.localizationpriority: medium -description: "The shared resource indicates a driveItem has been shared with others." +description: "Indicates that a drive item has been shared with others." doc_type: resourcePageType doc_type: resourcePageType Namespace: microsoft.graph -The **shared** resource indicates a **driveItem** has been shared with others. -The resource includes information about how the item is shared. +Indicates that a [drive item](driveitem.md) was shared with others and includes information about how the item was 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 was shared. ++## Properties ++| Property | Type | Description +| :- |:|:- +| owner | [IdentitySet](identityset.md) | The identity of the owner of the shared item. Read-only.| +| sharedBy | [identitySet](identityset.md) | The identity of the user who shared the item. Read-only.| +| sharedDateTime | DateTimeOffset | The UTC date and time when the item was shared. Read-only.| +| scope (deprecated)| String | Indicates the scope of how the item is shared. The possible values are: `anonymous`, `organization`, or `users`. Read-only.| +++### scope property values ++| Value | Description | +|:|:--| +| `anonymous` | The item is shared by using a link that works for anyone with the link. | +| `organization` | The item is shared by using a link that works for anyone in the owner's organization. | +| `users` | The item is shared with specific users only. | ## JSON representation If a [**driveitem**](driveitem.md) has a non-null **shared** facet, the item has } ``` -## Properties --| Property | Type | Description -| :- |:|:- -| owner | [IdentitySet](identityset.md) | The identity of the owner of the shared item. Read-only. -| scope | String | Indicates the scope of how the item is shared: `anonymous`, `organization`, or `users`. Read-only. -| sharedBy | [identitySet](identityset.md) | The identity of the user who shared the item. Read-only. -| sharedDateTime | DateTimeOffset | The UTC date and time when the item was shared. Read-only. --## Scope options --| Value | Description | -|:|:--| -| `anonymous` | The item is shared by using a link that works for anyone with the link. | -| `organization` | The item is shared by using a link that works for anyone in the owner's organization. | -| `users` | The item is shared with specific users only. | --## Remarks --For more information about the facets on a **driveItem**, see [**driveItem**](driveitem.md). <!-- { "type": "#page.annotation", |