openapi: 3.0.4
info:
title: Files
version: v1.0
servers:
- url: https://graph.microsoft.com/v1.0/
description: Core
paths:
/drives:
get:
tags:
- drives.drive
summary: Get entities from drives
operationId: drive_ListDrive
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.drive
summary: Add new entity to drives
operationId: drive_CreateDrive
requestBody:
description: New entity
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
required: true
responses:
2XX:
description: Created entity
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}':
get:
tags:
- drives.drive
summary: Get entity from drives by key
operationId: drive_GetDrive
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved entity
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.drive
summary: Update entity in drives
operationId: drive_UpdateDrive
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.drive
summary: Delete entity from drives
operationId: drive_DeleteDrive
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/bundles':
get:
tags:
- drives.driveItem
summary: Get bundles from drives
description: Collection of bundles (albums and multi-select-shared sets of items). Only in personal OneDrive.
operationId: drive_ListBundle
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to bundles for drives
operationId: drive_CreateBundle
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/bundles/{driveItem-id}':
get:
tags:
- drives.driveItem
summary: Get bundles from drives
description: Collection of bundles (albums and multi-select-shared sets of items). Only in personal OneDrive.
operationId: drive_GetBundle
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/bundles/{driveItem-id}/content':
get:
tags:
- drives.driveItem
summary: Get content for the navigation property bundles from drives
description: 'The content stream, if the item represents a file.'
operationId: drive_GetBundlesContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- drives.driveItem
summary: Update content for the navigation property bundles in drives
description: 'The content stream, if the item represents a file.'
operationId: drive_SetBundlesContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- drives.driveItem
summary: Delete content for the navigation property bundles in drives
description: 'The content stream, if the item represents a file.'
operationId: drive_DeleteBundlesContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/bundles/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.bundle_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/createdByUser':
get:
tags:
- drives.user
summary: Get createdByUser from drives
description: Identity of the user who created the item. Read-only.
operationId: drive_GetCreatedGraphBPreUser
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/createdByUser/mailboxSettings':
get:
tags:
- drives.user
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: drive.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- drives.user
summary: Update property mailboxSettings value.
operationId: drive.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/createdByUser/serviceProvisioningErrors':
get:
tags:
- drives.user
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: drive.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- drives.user
summary: Get the number of the resource
operationId: drive.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/following':
get:
tags:
- drives.driveItem
summary: Get following from drives
description: The list of items the user is following. Only in OneDrive for Business.
operationId: drive_ListFollowing
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
'/drives/{drive-id}/following/{driveItem-id}':
get:
tags:
- drives.driveItem
summary: Get following from drives
description: The list of items the user is following. Only in OneDrive for Business.
operationId: drive_GetFollowing
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/following/{driveItem-id}/content':
get:
tags:
- drives.driveItem
summary: Get content for the navigation property following from drives
description: 'The content stream, if the item represents a file.'
operationId: drive_GetFollowingContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- drives.driveItem
summary: Update content for the navigation property following in drives
description: 'The content stream, if the item represents a file.'
operationId: drive_SetFollowingContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- drives.driveItem
summary: Delete content for the navigation property following in drives
description: 'The content stream, if the item represents a file.'
operationId: drive_DeleteFollowingContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/following/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.following_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items':
get:
tags:
- drives.driveItem
summary: 'drive: sharedWithMe (deprecated)'
description: Get a list of driveItem objects shared with the owner of a drive. The driveItems returned from the sharedWithMe method always include the remoteItem facet that indicates they are items from a different drive.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/drive-sharedwithme?view=graph-rest-1.0
operationId: drive_ListItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to items for drives
operationId: drive_CreateItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}':
get:
tags:
- drives.driveItem
summary: Get items from drives
description: All items contained in the drive. Read-only. Nullable.
operationId: drive_GetItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property items in drives
operationId: drive_UpdateItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property items for drives
operationId: drive_DeleteItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/analytics':
get:
tags:
- drives.driveItem
summary: Get analytics from drives
description: Analytics about the view activities that took place on this item.
operationId: drive.item_GetAnalytic
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property analytics in drives
operationId: drive.item_UpdateAnalytic
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property analytics for drives
operationId: drive.item_DeleteAnalytic
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/analytics/allTime':
get:
tags:
- drives.driveItem
summary: Get itemAnalytics
description: "Get itemAnalytics about the views that took place under this resource.\r\nThe itemAnalytics resource is a convenient way to get activity stats for allTime and the lastSevenDays.\r\nFor a custom time range or interval, use the getActivitiesByInterval API."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/itemanalytics-get?view=graph-rest-1.0
operationId: drive.item.analytic_GetAllTime
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats':
get:
tags:
- drives.driveItem
summary: Get itemActivityStats from drives
operationId: drive.item.analytic_ListItemActivityStat
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.itemActivityStatCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to itemActivityStats for drives
operationId: drive.item.analytic_CreateItemActivityStat
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}':
get:
tags:
- drives.driveItem
summary: Get itemActivityStats from drives
operationId: drive.item.analytic_GetItemActivityStat
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property itemActivityStats in drives
operationId: drive.item.analytic_UpdateItemActivityStat
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property itemActivityStats for drives
operationId: drive.item.analytic_DeleteItemActivityStat
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities':
get:
tags:
- drives.driveItem
summary: Get activities from drives
description: Exposes the itemActivities represented in this itemActivityStat resource.
operationId: drive.item.analytic.itemActivityStat_ListActivity
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.itemActivityCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to activities for drives
operationId: drive.item.analytic.itemActivityStat_CreateActivity
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}':
get:
tags:
- drives.driveItem
summary: Get activities from drives
description: Exposes the itemActivities represented in this itemActivityStat resource.
operationId: drive.item.analytic.itemActivityStat_GetActivity
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property activities in drives
operationId: drive.item.analytic.itemActivityStat_UpdateActivity
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property activities for drives
operationId: drive.item.analytic.itemActivityStat_DeleteActivity
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}/driveItem':
get:
tags:
- drives.driveItem
summary: Get driveItem from drives
description: Exposes the driveItem that was the target of this activity.
operationId: drive.item.analytic.itemActivityStat.activity_GetDriveItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}/driveItem/content':
get:
tags:
- drives.driveItem
summary: Get content for the navigation property driveItem from drives
description: 'The content stream, if the item represents a file.'
operationId: drive.item.analytic.itemActivityStat.activity_GetDriveItemContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- drives.driveItem
summary: Update content for the navigation property driveItem in drives
description: 'The content stream, if the item represents a file.'
operationId: drive.item.analytic.itemActivityStat.activity_SetDriveItemContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- drives.driveItem
summary: Delete content for the navigation property driveItem in drives
description: 'The content stream, if the item represents a file.'
operationId: drive.item.analytic.itemActivityStat.activity_DeleteDriveItemContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.item.analytic.itemActivityStat.activity_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.item.analytic.itemActivityStat_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/analytics/lastSevenDays':
get:
tags:
- drives.driveItem
summary: Get lastSevenDays from drives
operationId: drive.item.analytic_GetLastSevenDay
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/children':
get:
tags:
- drives.driveItem
summary: List children of a driveItem
description: Return a collection of DriveItems in the children relationship of a DriveItem. DriveItems with a non-null folder or package facet can have one or more child DriveItems.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-list-children?view=graph-rest-1.0
operationId: drive.item_ListChild
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to children for drives
operationId: drive.item_CreateChild
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/children/{driveItem-id1}':
get:
tags:
- drives.driveItem
summary: Get children from drives
description: Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.
operationId: drive.item_GetChild
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItem-id1
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/children/{driveItem-id1}/content':
get:
tags:
- drives.driveItem
summary: Get content for the navigation property children from drives
description: 'The content stream, if the item represents a file.'
operationId: drive.item_GetChildrenContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItem-id1
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- drives.driveItem
summary: Update content for the navigation property children in drives
description: 'The content stream, if the item represents a file.'
operationId: drive.item_SetChildrenContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItem-id1
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- drives.driveItem
summary: Delete content for the navigation property children in drives
description: 'The content stream, if the item represents a file.'
operationId: drive.item_DeleteChildrenContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItem-id1
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/children/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.item.child_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/content':
get:
tags:
- drives.driveItem
summary: Get content for the navigation property items from drives
description: 'The content stream, if the item represents a file.'
operationId: drive_GetItemsContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- drives.driveItem
summary: Update content for the navigation property items in drives
description: 'The content stream, if the item represents a file.'
operationId: drive_SetItemsContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- drives.driveItem
summary: Delete content for the navigation property items in drives
description: 'The content stream, if the item represents a file.'
operationId: drive_DeleteItemsContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/createdByUser':
get:
tags:
- drives.driveItem
summary: Get createdByUser from drives
description: Identity of the user who created the item. Read-only.
operationId: drive.item_GetCreatedGraphBPreUser
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/createdByUser/mailboxSettings':
get:
tags:
- drives.driveItem
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: drive.item.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- drives.driveItem
summary: Update property mailboxSettings value.
operationId: drive.item.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/createdByUser/serviceProvisioningErrors':
get:
tags:
- drives.driveItem
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: drive.item.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/items/{driveItem-id}/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.item.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/lastModifiedByUser':
get:
tags:
- drives.driveItem
summary: Get lastModifiedByUser from drives
description: Identity of the user who last modified the item. Read-only.
operationId: drive.item_GetLastModifiedGraphBPreUser
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/lastModifiedByUser/mailboxSettings':
get:
tags:
- drives.driveItem
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: drive.item.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- drives.driveItem
summary: Update property mailboxSettings value.
operationId: drive.item.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- drives.driveItem
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: drive.item.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/items/{driveItem-id}/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.item.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/listItem':
get:
tags:
- drives.driveItem
summary: Get listItem from drives
description: 'For drives in SharePoint, the associated document library list item. Read-only. Nullable.'
operationId: drive.item_GetListItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property listItem in drives
operationId: drive.item_UpdateListItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property listItem for drives
operationId: drive.item_DeleteListItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/listItem/analytics':
get:
tags:
- drives.driveItem
summary: Get analytics from drives
description: Analytics about the view activities that took place on this item.
operationId: drive.item.listItem_GetAnalytic
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/listItem/createdByUser':
get:
tags:
- drives.driveItem
summary: Get createdByUser from drives
description: Identity of the user who created the item. Read-only.
operationId: drive.item.listItem_GetCreatedGraphBPreUser
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/listItem/createdByUser/mailboxSettings':
get:
tags:
- drives.driveItem
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: drive.item.listItem.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- drives.driveItem
summary: Update property mailboxSettings value.
operationId: drive.item.listItem.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/listItem/createdByUser/serviceProvisioningErrors':
get:
tags:
- drives.driveItem
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: drive.item.listItem.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/items/{driveItem-id}/listItem/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.item.listItem.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/listItem/documentSetVersions':
get:
tags:
- drives.driveItem
summary: Get documentSetVersions from drives
description: Version information for a document set version created by a user.
operationId: drive.item.listItem_ListDocumentSetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.documentSetVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to documentSetVersions for drives
operationId: drive.item.listItem_CreateDocumentSetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/listItem/documentSetVersions/{documentSetVersion-id}':
get:
tags:
- drives.driveItem
summary: Get documentSetVersions from drives
description: Version information for a document set version created by a user.
operationId: drive.item.listItem_GetDocumentSetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property documentSetVersions in drives
operationId: drive.item.listItem_UpdateDocumentSetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property documentSetVersions for drives
operationId: drive.item.listItem_DeleteDocumentSetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/listItem/documentSetVersions/{documentSetVersion-id}/fields':
get:
tags:
- drives.driveItem
summary: Get fields from drives
description: A collection of the fields and values for this version of the list item.
operationId: drive.item.listItem.documentSetVersion_GetField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property fields in drives
operationId: drive.item.listItem.documentSetVersion_UpdateField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property fields for drives
operationId: drive.item.listItem.documentSetVersion_DeleteField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/listItem/documentSetVersions/{documentSetVersion-id}/microsoft.graph.restore':
post:
tags:
- drives.driveItem
summary: Invoke action restore
description: Restore a document set version.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/documentsetversion-restore?view=graph-rest-1.0
operationId: drive.item.listItem.documentSetVersion_restore
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/listItem/documentSetVersions/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.item.listItem.documentSetVersion_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/listItem/driveItem':
get:
tags:
- drives.driveItem
summary: Get driveItem from drives
description: 'For document libraries, the driveItem relationship exposes the listItem as a driveItem'
operationId: drive.item.listItem_GetDriveItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/listItem/driveItem/content':
get:
tags:
- drives.driveItem
summary: Get content for the navigation property driveItem from drives
description: 'The content stream, if the item represents a file.'
operationId: drive.item.listItem_GetDriveItemContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- drives.driveItem
summary: Update content for the navigation property driveItem in drives
description: 'The content stream, if the item represents a file.'
operationId: drive.item.listItem_SetDriveItemContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- drives.driveItem
summary: Delete content for the navigation property driveItem in drives
description: 'The content stream, if the item represents a file.'
operationId: drive.item.listItem_DeleteDriveItemContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/listItem/fields':
get:
tags:
- drives.driveItem
summary: Get fields from drives
description: The values of the columns set on this list item.
operationId: drive.item.listItem_GetField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property fields in drives
operationId: drive.item.listItem_UpdateField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property fields for drives
operationId: drive.item.listItem_DeleteField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/listItem/lastModifiedByUser':
get:
tags:
- drives.driveItem
summary: Get lastModifiedByUser from drives
description: Identity of the user who last modified the item. Read-only.
operationId: drive.item.listItem_GetLastModifiedGraphBPreUser
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/listItem/lastModifiedByUser/mailboxSettings':
get:
tags:
- drives.driveItem
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: drive.item.listItem.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- drives.driveItem
summary: Update property mailboxSettings value.
operationId: drive.item.listItem.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/listItem/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- drives.driveItem
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: drive.item.listItem.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/items/{driveItem-id}/listItem/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.item.listItem.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/listItem/microsoft.graph.createLink':
post:
tags:
- drives.driveItem
summary: Invoke action createLink
operationId: drive.item.listItem_createLink
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/listItem/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- drives.driveItem
summary: Invoke function getActivitiesByInterval
operationId: drive.item.listItem_getActivitiesGraphBPreInterval
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/items/{driveItem-id}/listItem/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- drives.driveItem
summary: Invoke function getActivitiesByInterval
operationId: drive.item.listItem_getActivitiesGraphBPreInterval
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/items/{driveItem-id}/listItem/permissions':
get:
tags:
- drives.driveItem
summary: Get permissions from drives
description: The set of permissions for the item. Read-only. Nullable.
operationId: drive.item.listItem_ListPermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to permissions for drives
operationId: drive.item.listItem_CreatePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/listItem/permissions/{permission-id}':
get:
tags:
- drives.driveItem
summary: Get permissions from drives
description: The set of permissions for the item. Read-only. Nullable.
operationId: drive.item.listItem_GetPermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property permissions in drives
operationId: drive.item.listItem_UpdatePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property permissions for drives
operationId: drive.item.listItem_DeletePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/listItem/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- drives.driveItem
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: drive.item.listItem.permission_grant
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/items/{driveItem-id}/listItem/permissions/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.item.listItem.permission_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/listItem/versions':
get:
tags:
- drives.driveItem
summary: Get versions from drives
description: The list of previous versions of the list item.
operationId: drive.item.listItem_ListVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.listItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to versions for drives
operationId: drive.item.listItem_CreateVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/listItem/versions/{listItemVersion-id}':
get:
tags:
- drives.driveItem
summary: Get versions from drives
description: The list of previous versions of the list item.
operationId: drive.item.listItem_GetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property versions in drives
operationId: drive.item.listItem_UpdateVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property versions for drives
operationId: drive.item.listItem_DeleteVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/listItem/versions/{listItemVersion-id}/fields':
get:
tags:
- drives.driveItem
summary: Get fields from drives
description: A collection of the fields and values for this version of the list item.
operationId: drive.item.listItem.version_GetField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property fields in drives
operationId: drive.item.listItem.version_UpdateField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property fields for drives
operationId: drive.item.listItem.version_DeleteField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/listItem/versions/{listItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- drives.driveItem
summary: Invoke action restoreVersion
description: 'Restore a previous version of a ListItem to be the current version. This will create a new version with the contents of the previous version, but preserves all existing versions of the item.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/listitemversion-restore?view=graph-rest-1.0
operationId: drive.item.listItem.version_restoreVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/listItem/versions/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.item.listItem.version_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.assignSensitivityLabel':
post:
tags:
- drives.driveItem
summary: Invoke action assignSensitivityLabel
description: 'Asynchronously assign a sensitivity label to a driveItem. This API is part of the Microsoft SharePoint and OneDrive APIs that perform advanced premium administrative functions, and is considered as protected. Protected APIs require you to have more validations, beyond permission and consent, before you can use them. For more information about sensitivity labels from an administrator''s perspective, see Enable sensitivity labels for Office files in SharePoint and OneDrive. This API applies sensitivity labels to files at rest. Office clients don''t apply watermarks, headers, or footers to files that contain the label information. For more information about sensitivity labels from an administrator''s perspective, see Enable sensitivity labels for Office files in SharePoint and OneDrive.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-assignsensitivitylabel?view=graph-rest-1.0
operationId: drive.item_assignSensitivityLabel
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
sensitivityLabelId:
type: string
nullable: true
assignmentMethod:
$ref: '#/components/schemas/microsoft.graph.sensitivityLabelAssignmentMethod'
justificationText:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.checkin':
post:
tags:
- drives.driveItem
summary: Invoke action checkin
description: 'Check in a checked out driveItem resource, which makes the version of the document available to others.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-checkin?view=graph-rest-1.0
operationId: drive.item_checkin
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
checkInAs:
type: string
nullable: true
comment:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.checkout':
post:
tags:
- drives.driveItem
summary: Invoke action checkout
description: '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.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-checkout?view=graph-rest-1.0
operationId: drive.item_checkout
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.copy':
post:
tags:
- drives.driveItem
summary: Invoke action copy
operationId: drive.item_copy
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
name:
type: string
nullable: true
parentReference:
$ref: '#/components/schemas/microsoft.graph.itemReference'
childrenOnly:
type: boolean
default: false
nullable: true
includeAllVersionHistory:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.createLink':
post:
tags:
- drives.driveItem
summary: Invoke action createLink
description: "Create a link to share a driveItem driveItem. The createLink action creates a new sharing link if the specified link type doesn't already exist for the calling application.\r\nIf a sharing link of the specified type already exists for the app, the existing sharing link is returned. DriveItem resources inherit sharing permissions from their ancestors."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-createlink?view=graph-rest-1.0
operationId: drive.item_createLink
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.createUploadSession':
post:
tags:
- drives.driveItem
summary: Invoke action createUploadSession
operationId: drive.item_createUploadSession
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
item:
$ref: '#/components/schemas/microsoft.graph.driveItemUploadableProperties'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.uploadSession'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.delta()':
get:
tags:
- drives.driveItem
summary: Invoke function delta
description: "Track changes in a driveItem and its children over time. Your app begins by calling delta without any parameters.\r\nThe service starts enumerating the drive's hierarchy, returning pages of items and either an @odata.nextLink or an @odata.deltaLink, as described below.\r\nYour app should continue calling with the @odata.nextLink until you no longer see an @odata.nextLink returned, or you see a response with an empty set of changes. After you have finished receiving all the changes, you may apply them to your local state.\r\nTo check for changes in the future, call delta again with the @odata.deltaLink from the previous response. Deleted items are returned with the deleted facet.\r\nItems with this property set should be removed from your local state."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-delta?view=graph-rest-1.0
operationId: drive.item_delta
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.delta(token=''{token}'')':
get:
tags:
- drives.driveItem
summary: Invoke function delta
operationId: drive.item_delta
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: token
in: path
description: 'Usage: token=''{token}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.discardCheckout':
post:
tags:
- drives.driveItem
summary: Invoke action discardCheckout
description: Discard the check out of a driveItem. This action releases a driveItem resource that was previously checked out. Any changes made to the item while it was checked out are discarded. The same user that performed the checkout must discard it. Another alternative is to use application permissions.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-discardcheckout?view=graph-rest-1.0
operationId: drive.item_discardCheckout
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.extractSensitivityLabels':
post:
tags:
- drives.driveItem
summary: Invoke action extractSensitivityLabels
operationId: drive.item_extractSensitivityLabel
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.extractSensitivityLabelsResult'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.follow':
post:
tags:
- drives.driveItem
summary: Invoke action follow
description: Follow a driveItem.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-follow?view=graph-rest-1.0
operationId: drive.item_follow
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- drives.driveItem
summary: Invoke function getActivitiesByInterval
description: Get a collection of itemActivityStats resources for the activities that took place on this resource within the specified time interval. Analytics aggregates might not be available for all action types.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/itemactivitystat-getactivitybyinterval?view=graph-rest-1.0
operationId: drive.item_getActivitiesGraphBPreInterval
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- drives.driveItem
summary: Invoke function getActivitiesByInterval
operationId: drive.item_getActivitiesGraphBPreInterval
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.invite':
post:
tags:
- drives.driveItem
summary: Invoke action invite
description: 'Send a sharing invitation for a driveItem. A sharing invitation provides permissions to the recipients and, optionally, sends them an email to notify them that the item was shared.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-invite?view=graph-rest-1.0
operationId: drive.item_invite
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
requireSignIn:
type: boolean
default: false
nullable: true
roles:
type: array
items:
type: string
nullable: true
sendInvitation:
type: boolean
default: false
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
expirationDateTime:
type: string
nullable: true
password:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.permanentDelete':
post:
tags:
- drives.driveItem
summary: Invoke action permanentDelete
operationId: drive.item_permanentDelete
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.preview':
post:
tags:
- drives.driveItem
summary: Invoke action preview
operationId: drive.item_preview
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
page:
type: string
nullable: true
zoom:
type: number
format: double
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemPreviewInfo'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.restore':
post:
tags:
- drives.driveItem
summary: Invoke action restore
description: Restore a deleted driveItem that is currently in the recycle bin.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-restore?view=graph-rest-1.0
operationId: drive.item_restore
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
parentReference:
$ref: '#/components/schemas/microsoft.graph.itemReference'
name:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.search(q=''{q}'')':
get:
tags:
- drives.driveItem
summary: Invoke function search
description: "Search the hierarchy of items for items matching a query.\r\nYou can search within a folder hierarchy, a whole drive, or files shared with the current user."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-search?view=graph-rest-1.0
operationId: drive.item_search
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: q
in: path
description: 'Usage: q=''{q}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.unfollow':
post:
tags:
- drives.driveItem
summary: Invoke action unfollow
description: Unfollow a driveItem.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-unfollow?view=graph-rest-1.0
operationId: drive.item_unfollow
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.validatePermission':
post:
tags:
- drives.driveItem
summary: Invoke action validatePermission
operationId: drive.item_validatePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
challengeToken:
type: string
nullable: true
password:
type: string
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/permissions':
get:
tags:
- drives.driveItem
summary: Get permissions from drives
description: The set of permissions for the item. Read-only. Nullable.
operationId: drive.item_ListPermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to permissions for drives
operationId: drive.item_CreatePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/permissions/{permission-id}':
get:
tags:
- drives.driveItem
summary: Get permissions from drives
description: The set of permissions for the item. Read-only. Nullable.
operationId: drive.item_GetPermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property permissions in drives
operationId: drive.item_UpdatePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property permissions for drives
operationId: drive.item_DeletePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- drives.driveItem
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: drive.item.permission_grant
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/items/{driveItem-id}/permissions/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.item.permission_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/retentionLabel':
get:
tags:
- drives.driveItem
summary: 'driveItem: getRetentionLabel'
description: 'Get metadata information for a retention label applied on a driveItem. For information about retention labels from an administrator''s perspective, see Use retention labels to manage the lifecycle of documents stored in SharePoint.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-getretentionlabel?view=graph-rest-1.0
operationId: drive.item_GetRetentionLabel
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: 'driveItem: lockOrUnlockRecord'
description: 'Lock or unlock a retention label on a driveItem that classifies content as records. For information about retention labels from an administrator''s perspective, see Use retention labels to manage the lifecycle of documents stored in SharePoint. For more information about how you can lock and unlock retention labels, see Use record versioning to update records stored in SharePoint or OneDrive.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-lockorunlockrecord?view=graph-rest-1.0
operationId: drive.item_UpdateRetentionLabel
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: 'driveItem: removeRetentionLabel'
description: 'Remove the retention label from a driveItem. This operation clears the retention label and all associated retention settings enforced on the item. For information about retention labels from an administrator''s perspective, see Use retention labels to manage the lifecycle of documents stored in SharePoint.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-removeretentionlabel?view=graph-rest-1.0
operationId: drive.item_DeleteRetentionLabel
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/subscriptions':
get:
tags:
- drives.driveItem
summary: Get subscriptions from drives
description: The set of subscriptions on the item. Only supported on the root of a drive.
operationId: drive.item_ListSubscription
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.subscriptionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to subscriptions for drives
operationId: drive.item_CreateSubscription
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/subscriptions/{subscription-id}':
get:
tags:
- drives.driveItem
summary: Get subscriptions from drives
description: The set of subscriptions on the item. Only supported on the root of a drive.
operationId: drive.item_GetSubscription
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property subscriptions in drives
operationId: drive.item_UpdateSubscription
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property subscriptions for drives
operationId: drive.item_DeleteSubscription
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/subscriptions/{subscription-id}/microsoft.graph.reauthorize':
post:
tags:
- drives.driveItem
summary: Invoke action reauthorize
description: Reauthorize a subscription when you receive a reauthorizationRequired challenge.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/subscription-reauthorize?view=graph-rest-1.0
operationId: drive.item.subscription_reauthorize
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/subscriptions/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.item.subscription_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/thumbnails':
get:
tags:
- drives.driveItem
summary: Get thumbnails from drives
description: 'Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.'
operationId: drive.item_ListThumbnail
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.thumbnailSetCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to thumbnails for drives
operationId: drive.item_CreateThumbnail
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/thumbnails/{thumbnailSet-id}':
get:
tags:
- drives.driveItem
summary: Get thumbnails from drives
description: 'Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.'
operationId: drive.item_GetThumbnail
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property thumbnails in drives
operationId: drive.item_UpdateThumbnail
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property thumbnails for drives
operationId: drive.item_DeleteThumbnail
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/thumbnails/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.item.thumbnail_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/versions':
get:
tags:
- drives.driveItem
summary: Get versions from drives
description: 'The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.'
operationId: drive.item_ListVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to versions for drives
operationId: drive.item_CreateVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/versions/{driveItemVersion-id}':
get:
tags:
- drives.driveItem
summary: Get versions from drives
description: 'The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.'
operationId: drive.item_GetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property versions in drives
operationId: drive.item_UpdateVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property versions for drives
operationId: drive.item_DeleteVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/items/{driveItem-id}/versions/{driveItemVersion-id}/content':
get:
tags:
- drives.driveItem
summary: Get content for the navigation property versions from drives
description: The content stream for this version of the item.
operationId: drive.item_GetVersionsContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- drives.driveItem
summary: Update content for the navigation property versions in drives
description: The content stream for this version of the item.
operationId: drive.item_SetVersionsContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
delete:
tags:
- drives.driveItem
summary: Delete content for the navigation property versions in drives
description: The content stream for this version of the item.
operationId: drive.item_DeleteVersionsContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/{driveItem-id}/versions/{driveItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- drives.driveItem
summary: Invoke action restoreVersion
description: 'Restore a previous version of a driveItem to be the current version. This operation creates a new version with the contents of the previous version, and it preserves all existing versions of the file.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitemversion-restoreversion?view=graph-rest-1.0
operationId: drive.item.version_restoreVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/items/{driveItem-id}/versions/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.item.version_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/items/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.item_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/lastModifiedByUser':
get:
tags:
- drives.user
summary: Get lastModifiedByUser from drives
description: Identity of the user who last modified the item. Read-only.
operationId: drive_GetLastModifiedGraphBPreUser
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/lastModifiedByUser/mailboxSettings':
get:
tags:
- drives.user
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: drive.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- drives.user
summary: Update property mailboxSettings value.
operationId: drive.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- drives.user
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: drive.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- drives.user
summary: Get the number of the resource
operationId: drive.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list':
get:
tags:
- drives.list
summary: Get list from drives
description: 'For drives in SharePoint, the underlying document library list. Read-only. Nullable.'
operationId: drive_GetList
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.list'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.list
summary: Update the navigation property list in drives
operationId: drive_UpdateList
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.list'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.list'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.list
summary: Delete navigation property list for drives
operationId: drive_DeleteList
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/columns':
get:
tags:
- drives.list
summary: Get columns from drives
description: The collection of field definitions for this list.
operationId: drive.list_ListColumn
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.columnDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.list
summary: Create new navigation property to columns for drives
operationId: drive.list_CreateColumn
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/columns/{columnDefinition-id}':
get:
tags:
- drives.list
summary: Get columns from drives
description: The collection of field definitions for this list.
operationId: drive.list_GetColumn
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.list
summary: Update the navigation property columns in drives
operationId: drive.list_UpdateColumn
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.list
summary: Delete navigation property columns for drives
operationId: drive.list_DeleteColumn
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/columns/{columnDefinition-id}/sourceColumn':
get:
tags:
- drives.list
summary: Get sourceColumn from drives
description: The source column for the content type column.
operationId: drive.list.column_GetSourceColumn
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/columns/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.column_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/contentTypes':
get:
tags:
- drives.list
summary: Get contentTypes from drives
description: The collection of content types present in this list.
operationId: drive.list_ListContentType
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.contentTypeCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.list
summary: Create new navigation property to contentTypes for drives
operationId: drive.list_CreateContentType
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/contentTypes/{contentType-id}':
get:
tags:
- drives.list
summary: Get contentTypes from drives
description: The collection of content types present in this list.
operationId: drive.list_GetContentType
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.list
summary: Update the navigation property contentTypes in drives
operationId: drive.list_UpdateContentType
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.list
summary: Delete navigation property contentTypes for drives
operationId: drive.list_DeleteContentType
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/contentTypes/{contentType-id}/base':
get:
tags:
- drives.list
summary: Get base from drives
description: Parent contentType from which this content type is derived.
operationId: drive.list.contentType_GetBase
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/contentTypes/{contentType-id}/baseTypes':
get:
tags:
- drives.list
summary: Get baseTypes from drives
description: The collection of content types that are ancestors of this content type.
operationId: drive.list.contentType_ListBaseType
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.contentTypeCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/contentTypes/{contentType-id}/baseTypes/{contentType-id1}':
get:
tags:
- drives.list
summary: Get baseTypes from drives
description: The collection of content types that are ancestors of this content type.
operationId: drive.list.contentType_GetBaseType
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: contentType-id1
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/contentTypes/{contentType-id}/baseTypes/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.contentType.baseType_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/contentTypes/{contentType-id}/columnLinks':
get:
tags:
- drives.list
summary: Get columnLinks from drives
description: The collection of columns that are required by this content type.
operationId: drive.list.contentType_ListColumnLink
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.columnLinkCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.list
summary: Create new navigation property to columnLinks for drives
operationId: drive.list.contentType_CreateColumnLink
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/contentTypes/{contentType-id}/columnLinks/{columnLink-id}':
get:
tags:
- drives.list
summary: Get columnLinks from drives
description: The collection of columns that are required by this content type.
operationId: drive.list.contentType_GetColumnLink
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnLink-id
in: path
description: The unique identifier of columnLink
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnLink
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.list
summary: Update the navigation property columnLinks in drives
operationId: drive.list.contentType_UpdateColumnLink
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnLink-id
in: path
description: The unique identifier of columnLink
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnLink
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.list
summary: Delete navigation property columnLinks for drives
operationId: drive.list.contentType_DeleteColumnLink
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnLink-id
in: path
description: The unique identifier of columnLink
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnLink
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/contentTypes/{contentType-id}/columnLinks/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.contentType.columnLink_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/contentTypes/{contentType-id}/columnPositions':
get:
tags:
- drives.list
summary: Get columnPositions from drives
description: Column order information in a content type.
operationId: drive.list.contentType_ListColumnPosition
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.columnDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/contentTypes/{contentType-id}/columnPositions/{columnDefinition-id}':
get:
tags:
- drives.list
summary: Get columnPositions from drives
description: Column order information in a content type.
operationId: drive.list.contentType_GetColumnPosition
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/contentTypes/{contentType-id}/columnPositions/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.contentType.columnPosition_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/contentTypes/{contentType-id}/columns':
get:
tags:
- drives.list
summary: Get columns from drives
description: The collection of column definitions for this content type.
operationId: drive.list.contentType_ListColumn
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.columnDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.list
summary: Create new navigation property to columns for drives
operationId: drive.list.contentType_CreateColumn
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/contentTypes/{contentType-id}/columns/{columnDefinition-id}':
get:
tags:
- drives.list
summary: Get columns from drives
description: The collection of column definitions for this content type.
operationId: drive.list.contentType_GetColumn
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.list
summary: Update the navigation property columns in drives
operationId: drive.list.contentType_UpdateColumn
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.list
summary: Delete navigation property columns for drives
operationId: drive.list.contentType_DeleteColumn
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/contentTypes/{contentType-id}/columns/{columnDefinition-id}/sourceColumn':
get:
tags:
- drives.list
summary: Get sourceColumn from drives
description: The source column for the content type column.
operationId: drive.list.contentType.column_GetSourceColumn
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/contentTypes/{contentType-id}/columns/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.contentType.column_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/contentTypes/{contentType-id}/microsoft.graph.associateWithHubSites':
post:
tags:
- drives.list
summary: Invoke action associateWithHubSites
description: Associate a published content type present in a content type hub with a list of hub sites.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-associatewithhubsites?view=graph-rest-1.0
operationId: drive.list.contentType_associateGraphWPreHubSite
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
hubSiteUrls:
type: array
items:
type: string
propagateToExistingLists:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/list/contentTypes/{contentType-id}/microsoft.graph.copyToDefaultContentLocation':
post:
tags:
- drives.list
summary: Invoke action copyToDefaultContentLocation
description: Copy a file to a default content location in a content type. The file can then be added as a default file or template via a POST operation.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-copytodefaultcontentlocation?view=graph-rest-1.0
operationId: drive.list.contentType_copyToDefaultContentLocation
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
sourceFile:
$ref: '#/components/schemas/microsoft.graph.itemReference'
destinationFileName:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/list/contentTypes/{contentType-id}/microsoft.graph.isPublished()':
get:
tags:
- drives.list
summary: Invoke function isPublished
description: Check the publishing status of a contentType in a content type hub site.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-ispublished?view=graph-rest-1.0
operationId: drive.list.contentType_isPublished
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
responses:
2XX:
description: Success
content:
application/json:
schema:
type: object
properties:
value:
type: boolean
default: false
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
'/drives/{drive-id}/list/contentTypes/{contentType-id}/microsoft.graph.publish':
post:
tags:
- drives.list
summary: Invoke action publish
description: Publishes a contentType present in the content type hub site.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-publish?view=graph-rest-1.0
operationId: drive.list.contentType_publish
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/list/contentTypes/{contentType-id}/microsoft.graph.unpublish':
post:
tags:
- drives.list
summary: Invoke action unpublish
description: Unpublish a contentType from a content type hub site.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-unpublish?view=graph-rest-1.0
operationId: drive.list.contentType_unpublish
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/list/contentTypes/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.contentType_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/contentTypes/microsoft.graph.addCopy':
post:
tags:
- drives.list
summary: Invoke action addCopy
description: Add a copy of a content type from a site to a list.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-addcopy?view=graph-rest-1.0
operationId: drive.list.contentType_addCopy
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
contentType:
type: string
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/list/contentTypes/microsoft.graph.addCopyFromContentTypeHub':
post:
tags:
- drives.list
summary: Invoke action addCopyFromContentTypeHub
description: 'Add or sync a copy of a published content type from the content type hub to a target site or a list. This method is part of the content type publishing changes to optimize the syncing of published content types to sites and lists, effectively switching from a ''push everywhere'' to ''pull as needed'' approach. The method allows users to pull content types directly from the content type hub to a site or list. For more information, see contentType: getCompatibleHubContentTypes and the blog post Syntex Product Updates – August 2021.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-addcopyfromcontenttypehub?view=graph-rest-1.0
operationId: drive.list.contentType_addCopyFromContentTypeHub
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
contentTypeId:
type: string
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/list/contentTypes/microsoft.graph.getCompatibleHubContentTypes()':
get:
tags:
- drives.list
summary: Invoke function getCompatibleHubContentTypes
description: 'Get a list of compatible content types from the content type hub that can be added to a target site or a list. This method is part of the content type publishing changes to optimize the syncing of published content types to sites and lists, effectively switching from a ''push everywhere'' to ''pull as needed'' approach. The method allows users to pull content types directly from the content type hub to a site or list. For more information, see contentType: addCopyFromContentTypeHub and the blog post Syntex Product Updates – August 2021.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-getcompatiblehubcontenttypes?view=graph-rest-1.0
operationId: drive.list.contentType_getCompatibleHubContentType
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of contentType
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.contentType'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/list/createdByUser':
get:
tags:
- drives.list
summary: Get createdByUser from drives
description: Identity of the user who created the item. Read-only.
operationId: drive.list_GetCreatedGraphBPreUser
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/createdByUser/mailboxSettings':
get:
tags:
- drives.list
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: drive.list.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- drives.list
summary: Update property mailboxSettings value.
operationId: drive.list.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/createdByUser/serviceProvisioningErrors':
get:
tags:
- drives.list
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: drive.list.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/list/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/drive':
get:
tags:
- drives.list
summary: Get drive from drives
description: Allows access to the list as a drive resource with driveItems. Only present on document libraries.
operationId: drive.list_GetDrive
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/items':
get:
tags:
- drives.list
summary: Get items from drives
description: All items contained in the list.
operationId: drive.list_ListItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.listItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.list
summary: Create new navigation property to items for drives
operationId: drive.list_CreateItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/items/{listItem-id}':
get:
tags:
- drives.list
summary: Get items from drives
description: All items contained in the list.
operationId: drive.list_GetItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.list
summary: Update the navigation property items in drives
operationId: drive.list_UpdateItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.list
summary: Delete navigation property items for drives
operationId: drive.list_DeleteItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/items/{listItem-id}/analytics':
get:
tags:
- drives.list
summary: Get analytics from drives
description: Analytics about the view activities that took place on this item.
operationId: drive.list.item_GetAnalytic
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/items/{listItem-id}/createdByUser':
get:
tags:
- drives.list
summary: Get createdByUser from drives
description: Identity of the user who created the item. Read-only.
operationId: drive.list.item_GetCreatedGraphBPreUser
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/items/{listItem-id}/createdByUser/mailboxSettings':
get:
tags:
- drives.list
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: drive.list.item.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- drives.list
summary: Update property mailboxSettings value.
operationId: drive.list.item.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/items/{listItem-id}/createdByUser/serviceProvisioningErrors':
get:
tags:
- drives.list
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: drive.list.item.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/list/items/{listItem-id}/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.item.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/items/{listItem-id}/documentSetVersions':
get:
tags:
- drives.list
summary: Get documentSetVersions from drives
description: Version information for a document set version created by a user.
operationId: drive.list.item_ListDocumentSetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.documentSetVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.list
summary: Create new navigation property to documentSetVersions for drives
operationId: drive.list.item_CreateDocumentSetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/items/{listItem-id}/documentSetVersions/{documentSetVersion-id}':
get:
tags:
- drives.list
summary: Get documentSetVersions from drives
description: Version information for a document set version created by a user.
operationId: drive.list.item_GetDocumentSetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.list
summary: Update the navigation property documentSetVersions in drives
operationId: drive.list.item_UpdateDocumentSetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.list
summary: Delete navigation property documentSetVersions for drives
operationId: drive.list.item_DeleteDocumentSetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/items/{listItem-id}/documentSetVersions/{documentSetVersion-id}/fields':
get:
tags:
- drives.list
summary: Get fields from drives
description: A collection of the fields and values for this version of the list item.
operationId: drive.list.item.documentSetVersion_GetField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.list
summary: Update the navigation property fields in drives
operationId: drive.list.item.documentSetVersion_UpdateField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.list
summary: Delete navigation property fields for drives
operationId: drive.list.item.documentSetVersion_DeleteField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/items/{listItem-id}/documentSetVersions/{documentSetVersion-id}/microsoft.graph.restore':
post:
tags:
- drives.list
summary: Invoke action restore
description: Restore a document set version.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/documentsetversion-restore?view=graph-rest-1.0
operationId: drive.list.item.documentSetVersion_restore
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/list/items/{listItem-id}/documentSetVersions/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.item.documentSetVersion_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/items/{listItem-id}/driveItem':
get:
tags:
- drives.list
summary: Get driveItem from drives
description: 'For document libraries, the driveItem relationship exposes the listItem as a driveItem'
operationId: drive.list.item_GetDriveItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/items/{listItem-id}/driveItem/content':
get:
tags:
- drives.list
summary: Get content for the navigation property driveItem from drives
description: 'The content stream, if the item represents a file.'
operationId: drive.list.item_GetDriveItemContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- drives.list
summary: Update content for the navigation property driveItem in drives
description: 'The content stream, if the item represents a file.'
operationId: drive.list.item_SetDriveItemContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- drives.list
summary: Delete content for the navigation property driveItem in drives
description: 'The content stream, if the item represents a file.'
operationId: drive.list.item_DeleteDriveItemContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/items/{listItem-id}/fields':
get:
tags:
- drives.list
summary: Get fields from drives
description: The values of the columns set on this list item.
operationId: drive.list.item_GetField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.list
summary: Update the navigation property fields in drives
operationId: drive.list.item_UpdateField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.list
summary: Delete navigation property fields for drives
operationId: drive.list.item_DeleteField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/items/{listItem-id}/lastModifiedByUser':
get:
tags:
- drives.list
summary: Get lastModifiedByUser from drives
description: Identity of the user who last modified the item. Read-only.
operationId: drive.list.item_GetLastModifiedGraphBPreUser
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/items/{listItem-id}/lastModifiedByUser/mailboxSettings':
get:
tags:
- drives.list
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: drive.list.item.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- drives.list
summary: Update property mailboxSettings value.
operationId: drive.list.item.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/items/{listItem-id}/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- drives.list
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: drive.list.item.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/list/items/{listItem-id}/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.item.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/items/{listItem-id}/microsoft.graph.createLink':
post:
tags:
- drives.list
summary: Invoke action createLink
operationId: drive.list.item_createLink
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/list/items/{listItem-id}/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- drives.list
summary: Invoke function getActivitiesByInterval
operationId: drive.list.item_getActivitiesGraphBPreInterval
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/list/items/{listItem-id}/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- drives.list
summary: Invoke function getActivitiesByInterval
operationId: drive.list.item_getActivitiesGraphBPreInterval
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/list/items/{listItem-id}/permissions':
get:
tags:
- drives.list
summary: Get permissions from drives
description: The set of permissions for the item. Read-only. Nullable.
operationId: drive.list.item_ListPermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.list
summary: Create new navigation property to permissions for drives
operationId: drive.list.item_CreatePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/items/{listItem-id}/permissions/{permission-id}':
get:
tags:
- drives.list
summary: Get permissions from drives
description: The set of permissions for the item. Read-only. Nullable.
operationId: drive.list.item_GetPermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.list
summary: Update the navigation property permissions in drives
operationId: drive.list.item_UpdatePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.list
summary: Delete navigation property permissions for drives
operationId: drive.list.item_DeletePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/items/{listItem-id}/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- drives.list
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: drive.list.item.permission_grant
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/list/items/{listItem-id}/permissions/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.item.permission_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/items/{listItem-id}/versions':
get:
tags:
- drives.list
summary: Get versions from drives
description: The list of previous versions of the list item.
operationId: drive.list.item_ListVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.listItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.list
summary: Create new navigation property to versions for drives
operationId: drive.list.item_CreateVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/items/{listItem-id}/versions/{listItemVersion-id}':
get:
tags:
- drives.list
summary: Get versions from drives
description: The list of previous versions of the list item.
operationId: drive.list.item_GetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.list
summary: Update the navigation property versions in drives
operationId: drive.list.item_UpdateVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.list
summary: Delete navigation property versions for drives
operationId: drive.list.item_DeleteVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/items/{listItem-id}/versions/{listItemVersion-id}/fields':
get:
tags:
- drives.list
summary: Get fields from drives
description: A collection of the fields and values for this version of the list item.
operationId: drive.list.item.version_GetField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.list
summary: Update the navigation property fields in drives
operationId: drive.list.item.version_UpdateField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.list
summary: Delete navigation property fields for drives
operationId: drive.list.item.version_DeleteField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/items/{listItem-id}/versions/{listItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- drives.list
summary: Invoke action restoreVersion
description: 'Restore a previous version of a ListItem to be the current version. This will create a new version with the contents of the previous version, but preserves all existing versions of the item.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/listitemversion-restore?view=graph-rest-1.0
operationId: drive.list.item.version_restoreVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/list/items/{listItem-id}/versions/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.item.version_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/items/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.item_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/items/microsoft.graph.delta()':
get:
tags:
- drives.list
summary: Invoke function delta
description: "Get newly created, updated, or deleted list items without having to perform a full read of the entire items collection. Your app begins by calling delta without any parameters.\r\nThe service starts enumerating the hierarchy of the list, returning pages of items, and either an @odata.nextLink or an @odata.deltaLink.\r\nYour app should continue calling with the @odata.nextLink until you see an @odata.deltaLink returned. After you received all the changes, you can apply them to your local state.\r\nTo check for changes in the future, call delta again with the @odata.deltaLink from the previous response. The delta feed shows the latest state for each item, not each change. If an item was renamed twice, it only shows up once, with its latest name.\r\nThe same item might appear more than once in a delta feed, for various reasons. You should use the last occurrence you see. Items with this property should be removed from your local state."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/listitem-delta?view=graph-rest-1.0
operationId: drive.list.item_delta
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of listItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.listItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/list/items/microsoft.graph.delta(token=''{token}'')':
get:
tags:
- drives.list
summary: Invoke function delta
operationId: drive.list.item_delta
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: token
in: path
description: 'Usage: token=''{token}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of listItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.listItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/list/lastModifiedByUser':
get:
tags:
- drives.list
summary: Get lastModifiedByUser from drives
description: Identity of the user who last modified the item. Read-only.
operationId: drive.list_GetLastModifiedGraphBPreUser
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/lastModifiedByUser/mailboxSettings':
get:
tags:
- drives.list
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: drive.list.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- drives.list
summary: Update property mailboxSettings value.
operationId: drive.list.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- drives.list
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: drive.list.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/list/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/operations':
get:
tags:
- drives.list
summary: Get operations from drives
description: The collection of long-running operations on the list.
operationId: drive.list_ListOperation
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.richLongRunningOperationCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.list
summary: Create new navigation property to operations for drives
operationId: drive.list_CreateOperation
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/operations/{richLongRunningOperation-id}':
get:
tags:
- drives.list
summary: Get operations from drives
description: The collection of long-running operations on the list.
operationId: drive.list_GetOperation
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: richLongRunningOperation-id
in: path
description: The unique identifier of richLongRunningOperation
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: richLongRunningOperation
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.list
summary: Update the navigation property operations in drives
operationId: drive.list_UpdateOperation
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: richLongRunningOperation-id
in: path
description: The unique identifier of richLongRunningOperation
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: richLongRunningOperation
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.list
summary: Delete navigation property operations for drives
operationId: drive.list_DeleteOperation
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: richLongRunningOperation-id
in: path
description: The unique identifier of richLongRunningOperation
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: richLongRunningOperation
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/operations/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.operation_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/permissions':
get:
tags:
- drives.list
summary: Get permissions from drives
description: The set of permissions for the item. Read-only. Nullable.
operationId: drive.list_ListPermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.list
summary: Create new navigation property to permissions for drives
operationId: drive.list_CreatePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/permissions/{permission-id}':
get:
tags:
- drives.list
summary: Get permissions from drives
description: The set of permissions for the item. Read-only. Nullable.
operationId: drive.list_GetPermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.list
summary: Update the navigation property permissions in drives
operationId: drive.list_UpdatePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.list
summary: Delete navigation property permissions for drives
operationId: drive.list_DeletePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- drives.list
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: drive.list.permission_grant
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/list/permissions/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.permission_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/list/subscriptions':
get:
tags:
- drives.list
summary: Get subscriptions from drives
description: The set of subscriptions on the list.
operationId: drive.list_ListSubscription
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.subscriptionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.list
summary: Create new navigation property to subscriptions for drives
operationId: drive.list_CreateSubscription
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/subscriptions/{subscription-id}':
get:
tags:
- drives.list
summary: Get subscriptions from drives
description: The set of subscriptions on the list.
operationId: drive.list_GetSubscription
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.list
summary: Update the navigation property subscriptions in drives
operationId: drive.list_UpdateSubscription
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.list
summary: Delete navigation property subscriptions for drives
operationId: drive.list_DeleteSubscription
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/list/subscriptions/{subscription-id}/microsoft.graph.reauthorize':
post:
tags:
- drives.list
summary: Invoke action reauthorize
description: Reauthorize a subscription when you receive a reauthorizationRequired challenge.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/subscription-reauthorize?view=graph-rest-1.0
operationId: drive.list.subscription_reauthorize
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/list/subscriptions/$count':
get:
tags:
- drives.list
summary: Get the number of the resource
operationId: drive.list.subscription_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/microsoft.graph.recent()':
get:
tags:
- drives.drive.Functions
summary: Invoke function recent
description: "List a set of items recently used by the signed-in user.\r\nThis collection includes items that are in the user's drive and items they have access to from other drives."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/drive-recent?view=graph-rest-1.0
operationId: drive_recent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/recentResponse'
default:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2027-11-01'
date: '2025-11-13'
version: 2025-11/Removal
description: 'This API is deprecated and will stop returning data after November, 2027.'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/microsoft.graph.search(q=''{q}'')':
get:
tags:
- drives.drive.Functions
summary: Invoke function search
description: "Search the hierarchy of items for items matching a query.\r\nYou can search within a folder hierarchy, a whole drive, or files shared with the current user."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-search?view=graph-rest-1.0
operationId: drive_search
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: q
in: path
description: 'Usage: q=''{q}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/searchResponse'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/microsoft.graph.sharedWithMe()':
get:
tags:
- drives.drive.Functions
summary: Invoke function sharedWithMe
description: Get a list of driveItem objects shared with the owner of a drive. The driveItems returned from the sharedWithMe method always include the remoteItem facet that indicates they are items from a different drive.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/drive-sharedwithme?view=graph-rest-1.0
operationId: drive_sharedGraphWPreMe
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/sharedWithMeResponse'
default:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2027-11-01'
date: '2025-11-13'
version: 2025-11/Removal
description: 'This API is deprecated and will stop returning data after November, 2027.'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/root':
get:
tags:
- drives.driveItem
summary: Get root from drives
description: The root folder of the drive. Read-only.
operationId: drive_GetRoot
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property root in drives
operationId: drive_UpdateRoot
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property root for drives
operationId: drive_DeleteRoot
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/analytics':
get:
tags:
- drives.driveItem
summary: Get analytics from drives
description: Analytics about the view activities that took place on this item.
operationId: drive.root_GetAnalytic
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property analytics in drives
operationId: drive.root_UpdateAnalytic
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property analytics for drives
operationId: drive.root_DeleteAnalytic
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/analytics/allTime':
get:
tags:
- drives.driveItem
summary: Get allTime from drives
operationId: drive.root.analytic_GetAllTime
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/analytics/itemActivityStats':
get:
tags:
- drives.driveItem
summary: Get itemActivityStats from drives
operationId: drive.root.analytic_ListItemActivityStat
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.itemActivityStatCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to itemActivityStats for drives
operationId: drive.root.analytic_CreateItemActivityStat
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}':
get:
tags:
- drives.driveItem
summary: Get itemActivityStats from drives
operationId: drive.root.analytic_GetItemActivityStat
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property itemActivityStats in drives
operationId: drive.root.analytic_UpdateItemActivityStat
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property itemActivityStats for drives
operationId: drive.root.analytic_DeleteItemActivityStat
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}/activities':
get:
tags:
- drives.driveItem
summary: Get activities from drives
description: Exposes the itemActivities represented in this itemActivityStat resource.
operationId: drive.root.analytic.itemActivityStat_ListActivity
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.itemActivityCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to activities for drives
operationId: drive.root.analytic.itemActivityStat_CreateActivity
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}':
get:
tags:
- drives.driveItem
summary: Get activities from drives
description: Exposes the itemActivities represented in this itemActivityStat resource.
operationId: drive.root.analytic.itemActivityStat_GetActivity
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property activities in drives
operationId: drive.root.analytic.itemActivityStat_UpdateActivity
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property activities for drives
operationId: drive.root.analytic.itemActivityStat_DeleteActivity
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}/driveItem':
get:
tags:
- drives.driveItem
summary: Get driveItem from drives
description: Exposes the driveItem that was the target of this activity.
operationId: drive.root.analytic.itemActivityStat.activity_GetDriveItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}/driveItem/content':
get:
tags:
- drives.driveItem
summary: Get content for the navigation property driveItem from drives
description: 'The content stream, if the item represents a file.'
operationId: drive.root.analytic.itemActivityStat.activity_GetDriveItemContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- drives.driveItem
summary: Update content for the navigation property driveItem in drives
description: 'The content stream, if the item represents a file.'
operationId: drive.root.analytic.itemActivityStat.activity_SetDriveItemContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- drives.driveItem
summary: Delete content for the navigation property driveItem in drives
description: 'The content stream, if the item represents a file.'
operationId: drive.root.analytic.itemActivityStat.activity_DeleteDriveItemContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}/activities/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.root.analytic.itemActivityStat.activity_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/analytics/itemActivityStats/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.root.analytic.itemActivityStat_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/analytics/lastSevenDays':
get:
tags:
- drives.driveItem
summary: Get lastSevenDays from drives
operationId: drive.root.analytic_GetLastSevenDay
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/children':
get:
tags:
- drives.driveItem
summary: Get children from drives
description: Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.
operationId: drive.root_ListChild
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to children for drives
operationId: drive.root_CreateChild
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/children/{driveItem-id}':
get:
tags:
- drives.driveItem
summary: Get children from drives
description: Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.
operationId: drive.root_GetChild
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/children/{driveItem-id}/content':
get:
tags:
- drives.driveItem
summary: Get content for the navigation property children from drives
description: 'The content stream, if the item represents a file.'
operationId: drive.root_GetChildrenContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- drives.driveItem
summary: Update content for the navigation property children in drives
description: 'The content stream, if the item represents a file.'
operationId: drive.root_SetChildrenContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- drives.driveItem
summary: Delete content for the navigation property children in drives
description: 'The content stream, if the item represents a file.'
operationId: drive.root_DeleteChildrenContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/children/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.root.child_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/content':
get:
tags:
- drives.driveItem
summary: Get content for the navigation property root from drives
description: 'The content stream, if the item represents a file.'
operationId: drive_GetRootContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- drives.driveItem
summary: Update content for the navigation property root in drives
description: 'The content stream, if the item represents a file.'
operationId: drive_SetRootContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- drives.driveItem
summary: Delete content for the navigation property root in drives
description: 'The content stream, if the item represents a file.'
operationId: drive_DeleteRootContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/createdByUser':
get:
tags:
- drives.driveItem
summary: Get createdByUser from drives
description: Identity of the user who created the item. Read-only.
operationId: drive.root_GetCreatedGraphBPreUser
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/createdByUser/mailboxSettings':
get:
tags:
- drives.driveItem
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: drive.root.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- drives.driveItem
summary: Update property mailboxSettings value.
operationId: drive.root.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/createdByUser/serviceProvisioningErrors':
get:
tags:
- drives.driveItem
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: drive.root.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/root/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.root.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/lastModifiedByUser':
get:
tags:
- drives.driveItem
summary: Get lastModifiedByUser from drives
description: Identity of the user who last modified the item. Read-only.
operationId: drive.root_GetLastModifiedGraphBPreUser
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/lastModifiedByUser/mailboxSettings':
get:
tags:
- drives.driveItem
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: drive.root.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- drives.driveItem
summary: Update property mailboxSettings value.
operationId: drive.root.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- drives.driveItem
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: drive.root.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/root/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.root.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/listItem':
get:
tags:
- drives.driveItem
summary: Get listItem from drives
description: 'For drives in SharePoint, the associated document library list item. Read-only. Nullable.'
operationId: drive.root_GetListItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property listItem in drives
operationId: drive.root_UpdateListItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property listItem for drives
operationId: drive.root_DeleteListItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/listItem/analytics':
get:
tags:
- drives.driveItem
summary: Get analytics from drives
description: Analytics about the view activities that took place on this item.
operationId: drive.root.listItem_GetAnalytic
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/listItem/createdByUser':
get:
tags:
- drives.driveItem
summary: Get createdByUser from drives
description: Identity of the user who created the item. Read-only.
operationId: drive.root.listItem_GetCreatedGraphBPreUser
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/listItem/createdByUser/mailboxSettings':
get:
tags:
- drives.driveItem
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: drive.root.listItem.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- drives.driveItem
summary: Update property mailboxSettings value.
operationId: drive.root.listItem.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/listItem/createdByUser/serviceProvisioningErrors':
get:
tags:
- drives.driveItem
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: drive.root.listItem.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/root/listItem/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.root.listItem.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/listItem/documentSetVersions':
get:
tags:
- drives.driveItem
summary: Get documentSetVersions from drives
description: Version information for a document set version created by a user.
operationId: drive.root.listItem_ListDocumentSetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.documentSetVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to documentSetVersions for drives
operationId: drive.root.listItem_CreateDocumentSetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/listItem/documentSetVersions/{documentSetVersion-id}':
get:
tags:
- drives.driveItem
summary: Get documentSetVersions from drives
description: Version information for a document set version created by a user.
operationId: drive.root.listItem_GetDocumentSetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property documentSetVersions in drives
operationId: drive.root.listItem_UpdateDocumentSetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property documentSetVersions for drives
operationId: drive.root.listItem_DeleteDocumentSetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/listItem/documentSetVersions/{documentSetVersion-id}/fields':
get:
tags:
- drives.driveItem
summary: Get fields from drives
description: A collection of the fields and values for this version of the list item.
operationId: drive.root.listItem.documentSetVersion_GetField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property fields in drives
operationId: drive.root.listItem.documentSetVersion_UpdateField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property fields for drives
operationId: drive.root.listItem.documentSetVersion_DeleteField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/listItem/documentSetVersions/{documentSetVersion-id}/microsoft.graph.restore':
post:
tags:
- drives.driveItem
summary: Invoke action restore
description: Restore a document set version.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/documentsetversion-restore?view=graph-rest-1.0
operationId: drive.root.listItem.documentSetVersion_restore
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/listItem/documentSetVersions/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.root.listItem.documentSetVersion_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/listItem/driveItem':
get:
tags:
- drives.driveItem
summary: Get driveItem from drives
description: 'For document libraries, the driveItem relationship exposes the listItem as a driveItem'
operationId: drive.root.listItem_GetDriveItem
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/listItem/driveItem/content':
get:
tags:
- drives.driveItem
summary: Get content for the navigation property driveItem from drives
description: 'The content stream, if the item represents a file.'
operationId: drive.root.listItem_GetDriveItemContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- drives.driveItem
summary: Update content for the navigation property driveItem in drives
description: 'The content stream, if the item represents a file.'
operationId: drive.root.listItem_SetDriveItemContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- drives.driveItem
summary: Delete content for the navigation property driveItem in drives
description: 'The content stream, if the item represents a file.'
operationId: drive.root.listItem_DeleteDriveItemContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/listItem/fields':
get:
tags:
- drives.driveItem
summary: Get fields from drives
description: The values of the columns set on this list item.
operationId: drive.root.listItem_GetField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property fields in drives
operationId: drive.root.listItem_UpdateField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property fields for drives
operationId: drive.root.listItem_DeleteField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/listItem/lastModifiedByUser':
get:
tags:
- drives.driveItem
summary: Get lastModifiedByUser from drives
description: Identity of the user who last modified the item. Read-only.
operationId: drive.root.listItem_GetLastModifiedGraphBPreUser
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/listItem/lastModifiedByUser/mailboxSettings':
get:
tags:
- drives.driveItem
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: drive.root.listItem.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- drives.driveItem
summary: Update property mailboxSettings value.
operationId: drive.root.listItem.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/listItem/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- drives.driveItem
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: drive.root.listItem.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/root/listItem/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.root.listItem.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/listItem/microsoft.graph.createLink':
post:
tags:
- drives.driveItem
summary: Invoke action createLink
operationId: drive.root.listItem_createLink
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/listItem/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- drives.driveItem
summary: Invoke function getActivitiesByInterval
operationId: drive.root.listItem_getActivitiesGraphBPreInterval
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/root/listItem/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- drives.driveItem
summary: Invoke function getActivitiesByInterval
operationId: drive.root.listItem_getActivitiesGraphBPreInterval
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/root/listItem/permissions':
get:
tags:
- drives.driveItem
summary: Get permissions from drives
description: The set of permissions for the item. Read-only. Nullable.
operationId: drive.root.listItem_ListPermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to permissions for drives
operationId: drive.root.listItem_CreatePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/listItem/permissions/{permission-id}':
get:
tags:
- drives.driveItem
summary: Get permissions from drives
description: The set of permissions for the item. Read-only. Nullable.
operationId: drive.root.listItem_GetPermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property permissions in drives
operationId: drive.root.listItem_UpdatePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property permissions for drives
operationId: drive.root.listItem_DeletePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/listItem/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- drives.driveItem
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: drive.root.listItem.permission_grant
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/root/listItem/permissions/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.root.listItem.permission_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/listItem/versions':
get:
tags:
- drives.driveItem
summary: Get versions from drives
description: The list of previous versions of the list item.
operationId: drive.root.listItem_ListVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.listItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to versions for drives
operationId: drive.root.listItem_CreateVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/listItem/versions/{listItemVersion-id}':
get:
tags:
- drives.driveItem
summary: Get versions from drives
description: The list of previous versions of the list item.
operationId: drive.root.listItem_GetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property versions in drives
operationId: drive.root.listItem_UpdateVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property versions for drives
operationId: drive.root.listItem_DeleteVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/listItem/versions/{listItemVersion-id}/fields':
get:
tags:
- drives.driveItem
summary: Get fields from drives
description: A collection of the fields and values for this version of the list item.
operationId: drive.root.listItem.version_GetField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property fields in drives
operationId: drive.root.listItem.version_UpdateField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property fields for drives
operationId: drive.root.listItem.version_DeleteField
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/listItem/versions/{listItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- drives.driveItem
summary: Invoke action restoreVersion
description: 'Restore a previous version of a ListItem to be the current version. This will create a new version with the contents of the previous version, but preserves all existing versions of the item.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/listitemversion-restore?view=graph-rest-1.0
operationId: drive.root.listItem.version_restoreVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/listItem/versions/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.root.listItem.version_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/microsoft.graph.assignSensitivityLabel':
post:
tags:
- drives.driveItem
summary: Invoke action assignSensitivityLabel
description: 'Asynchronously assign a sensitivity label to a driveItem. This API is part of the Microsoft SharePoint and OneDrive APIs that perform advanced premium administrative functions, and is considered as protected. Protected APIs require you to have more validations, beyond permission and consent, before you can use them. For more information about sensitivity labels from an administrator''s perspective, see Enable sensitivity labels for Office files in SharePoint and OneDrive. This API applies sensitivity labels to files at rest. Office clients don''t apply watermarks, headers, or footers to files that contain the label information. For more information about sensitivity labels from an administrator''s perspective, see Enable sensitivity labels for Office files in SharePoint and OneDrive.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-assignsensitivitylabel?view=graph-rest-1.0
operationId: drive.root_assignSensitivityLabel
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
sensitivityLabelId:
type: string
nullable: true
assignmentMethod:
$ref: '#/components/schemas/microsoft.graph.sensitivityLabelAssignmentMethod'
justificationText:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/microsoft.graph.checkin':
post:
tags:
- drives.driveItem
summary: Invoke action checkin
description: 'Check in a checked out driveItem resource, which makes the version of the document available to others.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-checkin?view=graph-rest-1.0
operationId: drive.root_checkin
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
checkInAs:
type: string
nullable: true
comment:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/microsoft.graph.checkout':
post:
tags:
- drives.driveItem
summary: Invoke action checkout
description: '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.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-checkout?view=graph-rest-1.0
operationId: drive.root_checkout
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/microsoft.graph.copy':
post:
tags:
- drives.driveItem
summary: Invoke action copy
operationId: drive.root_copy
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
name:
type: string
nullable: true
parentReference:
$ref: '#/components/schemas/microsoft.graph.itemReference'
childrenOnly:
type: boolean
default: false
nullable: true
includeAllVersionHistory:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/microsoft.graph.createLink':
post:
tags:
- drives.driveItem
summary: Invoke action createLink
description: "Create a link to share a driveItem driveItem. The createLink action creates a new sharing link if the specified link type doesn't already exist for the calling application.\r\nIf a sharing link of the specified type already exists for the app, the existing sharing link is returned. DriveItem resources inherit sharing permissions from their ancestors."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-createlink?view=graph-rest-1.0
operationId: drive.root_createLink
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/microsoft.graph.createUploadSession':
post:
tags:
- drives.driveItem
summary: Invoke action createUploadSession
operationId: drive.root_createUploadSession
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
item:
$ref: '#/components/schemas/microsoft.graph.driveItemUploadableProperties'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.uploadSession'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/microsoft.graph.delta()':
get:
tags:
- drives.driveItem
summary: Invoke function delta
description: "Track changes in a driveItem and its children over time. Your app begins by calling delta without any parameters.\r\nThe service starts enumerating the drive's hierarchy, returning pages of items and either an @odata.nextLink or an @odata.deltaLink, as described below.\r\nYour app should continue calling with the @odata.nextLink until you no longer see an @odata.nextLink returned, or you see a response with an empty set of changes. After you have finished receiving all the changes, you may apply them to your local state.\r\nTo check for changes in the future, call delta again with the @odata.deltaLink from the previous response. Deleted items are returned with the deleted facet.\r\nItems with this property set should be removed from your local state."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-delta?view=graph-rest-1.0
operationId: drive.root_delta
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/root/microsoft.graph.delta(token=''{token}'')':
get:
tags:
- drives.driveItem
summary: Invoke function delta
operationId: drive.root_delta
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: token
in: path
description: 'Usage: token=''{token}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/root/microsoft.graph.discardCheckout':
post:
tags:
- drives.driveItem
summary: Invoke action discardCheckout
description: Discard the check out of a driveItem. This action releases a driveItem resource that was previously checked out. Any changes made to the item while it was checked out are discarded. The same user that performed the checkout must discard it. Another alternative is to use application permissions.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-discardcheckout?view=graph-rest-1.0
operationId: drive.root_discardCheckout
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/microsoft.graph.extractSensitivityLabels':
post:
tags:
- drives.driveItem
summary: Invoke action extractSensitivityLabels
operationId: drive.root_extractSensitivityLabel
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.extractSensitivityLabelsResult'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/microsoft.graph.follow':
post:
tags:
- drives.driveItem
summary: Invoke action follow
description: Follow a driveItem.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-follow?view=graph-rest-1.0
operationId: drive.root_follow
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- drives.driveItem
summary: Invoke function getActivitiesByInterval
description: Get a collection of itemActivityStats resources for the activities that took place on this resource within the specified time interval. Analytics aggregates might not be available for all action types.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/itemactivitystat-getactivitybyinterval?view=graph-rest-1.0
operationId: drive.root_getActivitiesGraphBPreInterval
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/root/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- drives.driveItem
summary: Invoke function getActivitiesByInterval
operationId: drive.root_getActivitiesGraphBPreInterval
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/root/microsoft.graph.invite':
post:
tags:
- drives.driveItem
summary: Invoke action invite
description: 'Send a sharing invitation for a driveItem. A sharing invitation provides permissions to the recipients and, optionally, sends them an email to notify them that the item was shared.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-invite?view=graph-rest-1.0
operationId: drive.root_invite
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
requireSignIn:
type: boolean
default: false
nullable: true
roles:
type: array
items:
type: string
nullable: true
sendInvitation:
type: boolean
default: false
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
expirationDateTime:
type: string
nullable: true
password:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/root/microsoft.graph.permanentDelete':
post:
tags:
- drives.driveItem
summary: Invoke action permanentDelete
operationId: drive.root_permanentDelete
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/microsoft.graph.preview':
post:
tags:
- drives.driveItem
summary: Invoke action preview
operationId: drive.root_preview
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
page:
type: string
nullable: true
zoom:
type: number
format: double
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemPreviewInfo'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/microsoft.graph.restore':
post:
tags:
- drives.driveItem
summary: Invoke action restore
description: Restore a deleted driveItem that is currently in the recycle bin.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-restore?view=graph-rest-1.0
operationId: drive.root_restore
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
parentReference:
$ref: '#/components/schemas/microsoft.graph.itemReference'
name:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/microsoft.graph.search(q=''{q}'')':
get:
tags:
- drives.driveItem
summary: Invoke function search
description: "Search the hierarchy of items for items matching a query.\r\nYou can search within a folder hierarchy, a whole drive, or files shared with the current user."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-search?view=graph-rest-1.0
operationId: drive.root_search
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: q
in: path
description: 'Usage: q=''{q}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/root/microsoft.graph.unfollow':
post:
tags:
- drives.driveItem
summary: Invoke action unfollow
description: Unfollow a driveItem.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-unfollow?view=graph-rest-1.0
operationId: drive.root_unfollow
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/microsoft.graph.validatePermission':
post:
tags:
- drives.driveItem
summary: Invoke action validatePermission
operationId: drive.root_validatePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
challengeToken:
type: string
nullable: true
password:
type: string
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/permissions':
get:
tags:
- drives.driveItem
summary: Get permissions from drives
description: The set of permissions for the item. Read-only. Nullable.
operationId: drive.root_ListPermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to permissions for drives
operationId: drive.root_CreatePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/permissions/{permission-id}':
get:
tags:
- drives.driveItem
summary: Get permissions from drives
description: The set of permissions for the item. Read-only. Nullable.
operationId: drive.root_GetPermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property permissions in drives
operationId: drive.root_UpdatePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property permissions for drives
operationId: drive.root_DeletePermission
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- drives.driveItem
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: drive.root.permission_grant
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/drives/{drive-id}/root/permissions/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.root.permission_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/retentionLabel':
get:
tags:
- drives.driveItem
summary: Get retentionLabel from drives
description: Information about retention label and settings enforced on the driveItem. Read-write.
operationId: drive.root_GetRetentionLabel
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property retentionLabel in drives
operationId: drive.root_UpdateRetentionLabel
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property retentionLabel for drives
operationId: drive.root_DeleteRetentionLabel
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/subscriptions':
get:
tags:
- drives.driveItem
summary: Get subscriptions from drives
description: The set of subscriptions on the item. Only supported on the root of a drive.
operationId: drive.root_ListSubscription
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.subscriptionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to subscriptions for drives
operationId: drive.root_CreateSubscription
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/subscriptions/{subscription-id}':
get:
tags:
- drives.driveItem
summary: Get subscriptions from drives
description: The set of subscriptions on the item. Only supported on the root of a drive.
operationId: drive.root_GetSubscription
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property subscriptions in drives
operationId: drive.root_UpdateSubscription
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property subscriptions for drives
operationId: drive.root_DeleteSubscription
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/subscriptions/{subscription-id}/microsoft.graph.reauthorize':
post:
tags:
- drives.driveItem
summary: Invoke action reauthorize
description: Reauthorize a subscription when you receive a reauthorizationRequired challenge.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/subscription-reauthorize?view=graph-rest-1.0
operationId: drive.root.subscription_reauthorize
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/subscriptions/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.root.subscription_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/thumbnails':
get:
tags:
- drives.driveItem
summary: Get thumbnails from drives
description: 'Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.'
operationId: drive.root_ListThumbnail
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.thumbnailSetCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to thumbnails for drives
operationId: drive.root_CreateThumbnail
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/thumbnails/{thumbnailSet-id}':
get:
tags:
- drives.driveItem
summary: Get thumbnails from drives
description: 'Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.'
operationId: drive.root_GetThumbnail
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property thumbnails in drives
operationId: drive.root_UpdateThumbnail
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property thumbnails for drives
operationId: drive.root_DeleteThumbnail
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/thumbnails/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.root.thumbnail_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/versions':
get:
tags:
- drives.driveItem
summary: Get versions from drives
description: 'The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.'
operationId: drive.root_ListVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- drives.driveItem
summary: Create new navigation property to versions for drives
operationId: drive.root_CreateVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/versions/{driveItemVersion-id}':
get:
tags:
- drives.driveItem
summary: Get versions from drives
description: 'The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.'
operationId: drive.root_GetVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- drives.driveItem
summary: Update the navigation property versions in drives
operationId: drive.root_UpdateVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- drives.driveItem
summary: Delete navigation property versions for drives
operationId: drive.root_DeleteVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/root/versions/{driveItemVersion-id}/content':
get:
tags:
- drives.driveItem
summary: Get content for the navigation property versions from drives
description: The content stream for this version of the item.
operationId: drive.root_GetVersionsContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- drives.driveItem
summary: Update content for the navigation property versions in drives
description: The content stream for this version of the item.
operationId: drive.root_SetVersionsContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
delete:
tags:
- drives.driveItem
summary: Delete content for the navigation property versions in drives
description: The content stream for this version of the item.
operationId: drive.root_DeleteVersionsContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/root/versions/{driveItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- drives.driveItem
summary: Invoke action restoreVersion
description: 'Restore a previous version of a driveItem to be the current version. This operation creates a new version with the contents of the previous version, and it preserves all existing versions of the file.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitemversion-restoreversion?view=graph-rest-1.0
operationId: drive.root.version_restoreVersion
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/drives/{drive-id}/root/versions/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.root.version_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/special':
get:
tags:
- drives.driveItem
summary: Get special from drives
description: Collection of common folders available in OneDrive. Read-only. Nullable.
operationId: drive_ListSpecial
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
'/drives/{drive-id}/special/{driveItem-id}':
get:
tags:
- drives.driveItem
summary: Get special from drives
description: Collection of common folders available in OneDrive. Read-only. Nullable.
operationId: drive_GetSpecial
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/drives/{drive-id}/special/{driveItem-id}/content':
get:
tags:
- drives.driveItem
summary: Get content for the navigation property special from drives
description: 'The content stream, if the item represents a file.'
operationId: drive_GetSpecialContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- drives.driveItem
summary: Update content for the navigation property special in drives
description: 'The content stream, if the item represents a file.'
operationId: drive_SetSpecialContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- drives.driveItem
summary: Delete content for the navigation property special in drives
description: 'The content stream, if the item represents a file.'
operationId: drive_DeleteSpecialContent
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/drives/{drive-id}/special/$count':
get:
tags:
- drives.driveItem
summary: Get the number of the resource
operationId: drive.special_GetCount
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drive':
get:
tags:
- groups.drive
summary: Get drive from groups
description: The group's default drive. Read-only.
operationId: group_GetDrive
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives':
get:
tags:
- groups.drive
summary: Get drives from groups
description: The group's drives. Read-only.
operationId: group_ListDrive
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to drives for groups
operationId: group_CreateDrive
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}':
get:
tags:
- groups.drive
summary: Get drives from groups
description: The group's drives. Read-only.
operationId: group_GetDrive
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property drives in groups
operationId: group_UpdateDrive
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property drives for groups
operationId: group_DeleteDrive
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/bundles':
get:
tags:
- groups.drive
summary: Get bundles from groups
description: Collection of bundles (albums and multi-select-shared sets of items). Only in personal OneDrive.
operationId: group.drive_ListBundle
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to bundles for groups
operationId: group.drive_CreateBundle
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/bundles/{driveItem-id}':
get:
tags:
- groups.drive
summary: Get bundles from groups
description: Collection of bundles (albums and multi-select-shared sets of items). Only in personal OneDrive.
operationId: group.drive_GetBundle
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/bundles/{driveItem-id}/content':
get:
tags:
- groups.drive
summary: Get content for the navigation property bundles from groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive_GetBundlesContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- groups.drive
summary: Update content for the navigation property bundles in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive_SetBundlesContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- groups.drive
summary: Delete content for the navigation property bundles in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive_DeleteBundlesContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/bundles/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.bundle_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/createdByUser':
get:
tags:
- groups.drive
summary: Get createdByUser from groups
description: Identity of the user who created the item. Read-only.
operationId: group.drive_GetCreatedGraphBPreUser
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/createdByUser/mailboxSettings':
get:
tags:
- groups.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: group.drive.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- groups.drive
summary: Update property mailboxSettings value.
operationId: group.drive.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/createdByUser/serviceProvisioningErrors':
get:
tags:
- groups.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: group.drive.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/following':
get:
tags:
- groups.drive
summary: Get following from groups
description: The list of items the user is following. Only in OneDrive for Business.
operationId: group.drive_ListFollowing
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/following/{driveItem-id}':
get:
tags:
- groups.drive
summary: Get following from groups
description: The list of items the user is following. Only in OneDrive for Business.
operationId: group.drive_GetFollowing
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/following/{driveItem-id}/content':
get:
tags:
- groups.drive
summary: Get content for the navigation property following from groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive_GetFollowingContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- groups.drive
summary: Update content for the navigation property following in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive_SetFollowingContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- groups.drive
summary: Delete content for the navigation property following in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive_DeleteFollowingContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/following/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.following_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items':
get:
tags:
- groups.drive
summary: Get items from groups
description: All items contained in the drive. Read-only. Nullable.
operationId: group.drive_ListItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to items for groups
operationId: group.drive_CreateItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}':
get:
tags:
- groups.drive
summary: Get items from groups
description: All items contained in the drive. Read-only. Nullable.
operationId: group.drive_GetItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property items in groups
operationId: group.drive_UpdateItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property items for groups
operationId: group.drive_DeleteItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/analytics':
get:
tags:
- groups.drive
summary: Get analytics from groups
description: Analytics about the view activities that took place on this item.
operationId: group.drive.item_GetAnalytic
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property analytics in groups
operationId: group.drive.item_UpdateAnalytic
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property analytics for groups
operationId: group.drive.item_DeleteAnalytic
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/analytics/allTime':
get:
tags:
- groups.drive
summary: Get allTime from groups
operationId: group.drive.item.analytic_GetAllTime
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats':
get:
tags:
- groups.drive
summary: Get itemActivityStats from groups
operationId: group.drive.item.analytic_ListItemActivityStat
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.itemActivityStatCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to itemActivityStats for groups
operationId: group.drive.item.analytic_CreateItemActivityStat
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}':
get:
tags:
- groups.drive
summary: Get itemActivityStats from groups
operationId: group.drive.item.analytic_GetItemActivityStat
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property itemActivityStats in groups
operationId: group.drive.item.analytic_UpdateItemActivityStat
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property itemActivityStats for groups
operationId: group.drive.item.analytic_DeleteItemActivityStat
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities':
get:
tags:
- groups.drive
summary: Get activities from groups
description: Exposes the itemActivities represented in this itemActivityStat resource.
operationId: group.drive.item.analytic.itemActivityStat_ListActivity
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.itemActivityCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to activities for groups
operationId: group.drive.item.analytic.itemActivityStat_CreateActivity
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}':
get:
tags:
- groups.drive
summary: Get activities from groups
description: Exposes the itemActivities represented in this itemActivityStat resource.
operationId: group.drive.item.analytic.itemActivityStat_GetActivity
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property activities in groups
operationId: group.drive.item.analytic.itemActivityStat_UpdateActivity
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property activities for groups
operationId: group.drive.item.analytic.itemActivityStat_DeleteActivity
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}/driveItem':
get:
tags:
- groups.drive
summary: Get driveItem from groups
description: Exposes the driveItem that was the target of this activity.
operationId: group.drive.item.analytic.itemActivityStat.activity_GetDriveItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}/driveItem/content':
get:
tags:
- groups.drive
summary: Get content for the navigation property driveItem from groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.item.analytic.itemActivityStat.activity_GetDriveItemContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- groups.drive
summary: Update content for the navigation property driveItem in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.item.analytic.itemActivityStat.activity_SetDriveItemContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- groups.drive
summary: Delete content for the navigation property driveItem in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.item.analytic.itemActivityStat.activity_DeleteDriveItemContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.item.analytic.itemActivityStat.activity_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.item.analytic.itemActivityStat_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/analytics/lastSevenDays':
get:
tags:
- groups.drive
summary: Get lastSevenDays from groups
operationId: group.drive.item.analytic_GetLastSevenDay
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/children':
get:
tags:
- groups.drive
summary: Get children from groups
description: Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.
operationId: group.drive.item_ListChild
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to children for groups
operationId: group.drive.item_CreateChild
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/children/{driveItem-id1}':
get:
tags:
- groups.drive
summary: Get children from groups
description: Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.
operationId: group.drive.item_GetChild
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItem-id1
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/children/{driveItem-id1}/content':
get:
tags:
- groups.drive
summary: Get content for the navigation property children from groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.item_GetChildrenContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItem-id1
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- groups.drive
summary: Update content for the navigation property children in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.item_SetChildrenContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItem-id1
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- groups.drive
summary: Delete content for the navigation property children in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.item_DeleteChildrenContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItem-id1
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/children/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.item.child_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/content':
get:
tags:
- groups.drive
summary: Get content for the navigation property items from groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive_GetItemsContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- groups.drive
summary: Update content for the navigation property items in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive_SetItemsContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- groups.drive
summary: Delete content for the navigation property items in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive_DeleteItemsContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/createdByUser':
get:
tags:
- groups.drive
summary: Get createdByUser from groups
description: Identity of the user who created the item. Read-only.
operationId: group.drive.item_GetCreatedGraphBPreUser
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/createdByUser/mailboxSettings':
get:
tags:
- groups.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: group.drive.item.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- groups.drive
summary: Update property mailboxSettings value.
operationId: group.drive.item.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/createdByUser/serviceProvisioningErrors':
get:
tags:
- groups.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: group.drive.item.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.item.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/lastModifiedByUser':
get:
tags:
- groups.drive
summary: Get lastModifiedByUser from groups
description: Identity of the user who last modified the item. Read-only.
operationId: group.drive.item_GetLastModifiedGraphBPreUser
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/lastModifiedByUser/mailboxSettings':
get:
tags:
- groups.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: group.drive.item.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- groups.drive
summary: Update property mailboxSettings value.
operationId: group.drive.item.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- groups.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: group.drive.item.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.item.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem':
get:
tags:
- groups.drive
summary: Get listItem from groups
description: 'For drives in SharePoint, the associated document library list item. Read-only. Nullable.'
operationId: group.drive.item_GetListItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property listItem in groups
operationId: group.drive.item_UpdateListItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property listItem for groups
operationId: group.drive.item_DeleteListItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/analytics':
get:
tags:
- groups.drive
summary: Get analytics from groups
description: Analytics about the view activities that took place on this item.
operationId: group.drive.item.listItem_GetAnalytic
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/createdByUser':
get:
tags:
- groups.drive
summary: Get createdByUser from groups
description: Identity of the user who created the item. Read-only.
operationId: group.drive.item.listItem_GetCreatedGraphBPreUser
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/createdByUser/mailboxSettings':
get:
tags:
- groups.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: group.drive.item.listItem.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- groups.drive
summary: Update property mailboxSettings value.
operationId: group.drive.item.listItem.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/createdByUser/serviceProvisioningErrors':
get:
tags:
- groups.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: group.drive.item.listItem.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.item.listItem.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/documentSetVersions':
get:
tags:
- groups.drive
summary: Get documentSetVersions from groups
description: Version information for a document set version created by a user.
operationId: group.drive.item.listItem_ListDocumentSetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.documentSetVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to documentSetVersions for groups
operationId: group.drive.item.listItem_CreateDocumentSetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/documentSetVersions/{documentSetVersion-id}':
get:
tags:
- groups.drive
summary: Get documentSetVersions from groups
description: Version information for a document set version created by a user.
operationId: group.drive.item.listItem_GetDocumentSetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property documentSetVersions in groups
operationId: group.drive.item.listItem_UpdateDocumentSetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property documentSetVersions for groups
operationId: group.drive.item.listItem_DeleteDocumentSetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/documentSetVersions/{documentSetVersion-id}/fields':
get:
tags:
- groups.drive
summary: Get fields from groups
description: A collection of the fields and values for this version of the list item.
operationId: group.drive.item.listItem.documentSetVersion_GetField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property fields in groups
operationId: group.drive.item.listItem.documentSetVersion_UpdateField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property fields for groups
operationId: group.drive.item.listItem.documentSetVersion_DeleteField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/documentSetVersions/{documentSetVersion-id}/microsoft.graph.restore':
post:
tags:
- groups.drive
summary: Invoke action restore
description: Restore a document set version.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/documentsetversion-restore?view=graph-rest-1.0
operationId: group.drive.item.listItem.documentSetVersion_restore
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/documentSetVersions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.item.listItem.documentSetVersion_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/driveItem':
get:
tags:
- groups.drive
summary: Get driveItem from groups
description: 'For document libraries, the driveItem relationship exposes the listItem as a driveItem'
operationId: group.drive.item.listItem_GetDriveItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/driveItem/content':
get:
tags:
- groups.drive
summary: Get content for the navigation property driveItem from groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.item.listItem_GetDriveItemContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- groups.drive
summary: Update content for the navigation property driveItem in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.item.listItem_SetDriveItemContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- groups.drive
summary: Delete content for the navigation property driveItem in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.item.listItem_DeleteDriveItemContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/fields':
get:
tags:
- groups.drive
summary: Get fields from groups
description: The values of the columns set on this list item.
operationId: group.drive.item.listItem_GetField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property fields in groups
operationId: group.drive.item.listItem_UpdateField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property fields for groups
operationId: group.drive.item.listItem_DeleteField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/lastModifiedByUser':
get:
tags:
- groups.drive
summary: Get lastModifiedByUser from groups
description: Identity of the user who last modified the item. Read-only.
operationId: group.drive.item.listItem_GetLastModifiedGraphBPreUser
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/lastModifiedByUser/mailboxSettings':
get:
tags:
- groups.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: group.drive.item.listItem.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- groups.drive
summary: Update property mailboxSettings value.
operationId: group.drive.item.listItem.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- groups.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: group.drive.item.listItem.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.item.listItem.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/microsoft.graph.createLink':
post:
tags:
- groups.drive
summary: Invoke action createLink
operationId: group.drive.item.listItem_createLink
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- groups.drive
summary: Invoke function getActivitiesByInterval
operationId: group.drive.item.listItem_getActivitiesGraphBPreInterval
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- groups.drive
summary: Invoke function getActivitiesByInterval
operationId: group.drive.item.listItem_getActivitiesGraphBPreInterval
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/permissions':
get:
tags:
- groups.drive
summary: Get permissions from groups
description: The set of permissions for the item. Read-only. Nullable.
operationId: group.drive.item.listItem_ListPermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to permissions for groups
operationId: group.drive.item.listItem_CreatePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/permissions/{permission-id}':
get:
tags:
- groups.drive
summary: Get permissions from groups
description: The set of permissions for the item. Read-only. Nullable.
operationId: group.drive.item.listItem_GetPermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property permissions in groups
operationId: group.drive.item.listItem_UpdatePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property permissions for groups
operationId: group.drive.item.listItem_DeletePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- groups.drive
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: group.drive.item.listItem.permission_grant
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/permissions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.item.listItem.permission_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/versions':
get:
tags:
- groups.drive
summary: Get versions from groups
description: The list of previous versions of the list item.
operationId: group.drive.item.listItem_ListVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.listItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to versions for groups
operationId: group.drive.item.listItem_CreateVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/versions/{listItemVersion-id}':
get:
tags:
- groups.drive
summary: Get versions from groups
description: The list of previous versions of the list item.
operationId: group.drive.item.listItem_GetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property versions in groups
operationId: group.drive.item.listItem_UpdateVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property versions for groups
operationId: group.drive.item.listItem_DeleteVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/versions/{listItemVersion-id}/fields':
get:
tags:
- groups.drive
summary: Get fields from groups
description: A collection of the fields and values for this version of the list item.
operationId: group.drive.item.listItem.version_GetField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property fields in groups
operationId: group.drive.item.listItem.version_UpdateField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property fields for groups
operationId: group.drive.item.listItem.version_DeleteField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/versions/{listItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- groups.drive
summary: Invoke action restoreVersion
description: 'Restore a previous version of a ListItem to be the current version. This will create a new version with the contents of the previous version, but preserves all existing versions of the item.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/listitemversion-restore?view=graph-rest-1.0
operationId: group.drive.item.listItem.version_restoreVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/listItem/versions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.item.listItem.version_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.assignSensitivityLabel':
post:
tags:
- groups.drive
summary: Invoke action assignSensitivityLabel
description: 'Asynchronously assign a sensitivity label to a driveItem. This API is part of the Microsoft SharePoint and OneDrive APIs that perform advanced premium administrative functions, and is considered as protected. Protected APIs require you to have more validations, beyond permission and consent, before you can use them. For more information about sensitivity labels from an administrator''s perspective, see Enable sensitivity labels for Office files in SharePoint and OneDrive. This API applies sensitivity labels to files at rest. Office clients don''t apply watermarks, headers, or footers to files that contain the label information. For more information about sensitivity labels from an administrator''s perspective, see Enable sensitivity labels for Office files in SharePoint and OneDrive.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-assignsensitivitylabel?view=graph-rest-1.0
operationId: group.drive.item_assignSensitivityLabel
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
sensitivityLabelId:
type: string
nullable: true
assignmentMethod:
$ref: '#/components/schemas/microsoft.graph.sensitivityLabelAssignmentMethod'
justificationText:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.checkin':
post:
tags:
- groups.drive
summary: Invoke action checkin
description: 'Check in a checked out driveItem resource, which makes the version of the document available to others.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-checkin?view=graph-rest-1.0
operationId: group.drive.item_checkin
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
checkInAs:
type: string
nullable: true
comment:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.checkout':
post:
tags:
- groups.drive
summary: Invoke action checkout
description: '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.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-checkout?view=graph-rest-1.0
operationId: group.drive.item_checkout
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.copy':
post:
tags:
- groups.drive
summary: Invoke action copy
operationId: group.drive.item_copy
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
name:
type: string
nullable: true
parentReference:
$ref: '#/components/schemas/microsoft.graph.itemReference'
childrenOnly:
type: boolean
default: false
nullable: true
includeAllVersionHistory:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.createLink':
post:
tags:
- groups.drive
summary: Invoke action createLink
description: "Create a link to share a driveItem driveItem. The createLink action creates a new sharing link if the specified link type doesn't already exist for the calling application.\r\nIf a sharing link of the specified type already exists for the app, the existing sharing link is returned. DriveItem resources inherit sharing permissions from their ancestors."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-createlink?view=graph-rest-1.0
operationId: group.drive.item_createLink
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.createUploadSession':
post:
tags:
- groups.drive
summary: Invoke action createUploadSession
operationId: group.drive.item_createUploadSession
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
item:
$ref: '#/components/schemas/microsoft.graph.driveItemUploadableProperties'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.uploadSession'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.delta()':
get:
tags:
- groups.drive
summary: Invoke function delta
description: "Track changes in a driveItem and its children over time. Your app begins by calling delta without any parameters.\r\nThe service starts enumerating the drive's hierarchy, returning pages of items and either an @odata.nextLink or an @odata.deltaLink, as described below.\r\nYour app should continue calling with the @odata.nextLink until you no longer see an @odata.nextLink returned, or you see a response with an empty set of changes. After you have finished receiving all the changes, you may apply them to your local state.\r\nTo check for changes in the future, call delta again with the @odata.deltaLink from the previous response. Deleted items are returned with the deleted facet.\r\nItems with this property set should be removed from your local state."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-delta?view=graph-rest-1.0
operationId: group.drive.item_delta
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.delta(token=''{token}'')':
get:
tags:
- groups.drive
summary: Invoke function delta
operationId: group.drive.item_delta
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: token
in: path
description: 'Usage: token=''{token}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.discardCheckout':
post:
tags:
- groups.drive
summary: Invoke action discardCheckout
description: Discard the check out of a driveItem. This action releases a driveItem resource that was previously checked out. Any changes made to the item while it was checked out are discarded. The same user that performed the checkout must discard it. Another alternative is to use application permissions.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-discardcheckout?view=graph-rest-1.0
operationId: group.drive.item_discardCheckout
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.extractSensitivityLabels':
post:
tags:
- groups.drive
summary: Invoke action extractSensitivityLabels
operationId: group.drive.item_extractSensitivityLabel
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.extractSensitivityLabelsResult'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.follow':
post:
tags:
- groups.drive
summary: Invoke action follow
description: Follow a driveItem.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-follow?view=graph-rest-1.0
operationId: group.drive.item_follow
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- groups.drive
summary: Invoke function getActivitiesByInterval
description: Get a collection of itemActivityStats resources for the activities that took place on this resource within the specified time interval. Analytics aggregates might not be available for all action types.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/itemactivitystat-getactivitybyinterval?view=graph-rest-1.0
operationId: group.drive.item_getActivitiesGraphBPreInterval
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- groups.drive
summary: Invoke function getActivitiesByInterval
operationId: group.drive.item_getActivitiesGraphBPreInterval
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.invite':
post:
tags:
- groups.drive
summary: Invoke action invite
description: 'Send a sharing invitation for a driveItem. A sharing invitation provides permissions to the recipients and, optionally, sends them an email to notify them that the item was shared.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-invite?view=graph-rest-1.0
operationId: group.drive.item_invite
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
requireSignIn:
type: boolean
default: false
nullable: true
roles:
type: array
items:
type: string
nullable: true
sendInvitation:
type: boolean
default: false
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
expirationDateTime:
type: string
nullable: true
password:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.permanentDelete':
post:
tags:
- groups.drive
summary: Invoke action permanentDelete
operationId: group.drive.item_permanentDelete
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.preview':
post:
tags:
- groups.drive
summary: Invoke action preview
operationId: group.drive.item_preview
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
page:
type: string
nullable: true
zoom:
type: number
format: double
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemPreviewInfo'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.restore':
post:
tags:
- groups.drive
summary: Invoke action restore
description: Restore a deleted driveItem that is currently in the recycle bin.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-restore?view=graph-rest-1.0
operationId: group.drive.item_restore
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
parentReference:
$ref: '#/components/schemas/microsoft.graph.itemReference'
name:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.search(q=''{q}'')':
get:
tags:
- groups.drive
summary: Invoke function search
description: "Search the hierarchy of items for items matching a query.\r\nYou can search within a folder hierarchy, a whole drive, or files shared with the current user."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-search?view=graph-rest-1.0
operationId: group.drive.item_search
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: q
in: path
description: 'Usage: q=''{q}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.unfollow':
post:
tags:
- groups.drive
summary: Invoke action unfollow
description: Unfollow a driveItem.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-unfollow?view=graph-rest-1.0
operationId: group.drive.item_unfollow
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.validatePermission':
post:
tags:
- groups.drive
summary: Invoke action validatePermission
operationId: group.drive.item_validatePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
challengeToken:
type: string
nullable: true
password:
type: string
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/permissions':
get:
tags:
- groups.drive
summary: Get permissions from groups
description: The set of permissions for the item. Read-only. Nullable.
operationId: group.drive.item_ListPermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to permissions for groups
operationId: group.drive.item_CreatePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/permissions/{permission-id}':
get:
tags:
- groups.drive
summary: Get permissions from groups
description: The set of permissions for the item. Read-only. Nullable.
operationId: group.drive.item_GetPermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property permissions in groups
operationId: group.drive.item_UpdatePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property permissions for groups
operationId: group.drive.item_DeletePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- groups.drive
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: group.drive.item.permission_grant
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/permissions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.item.permission_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/retentionLabel':
get:
tags:
- groups.drive
summary: Get retentionLabel from groups
description: Information about retention label and settings enforced on the driveItem. Read-write.
operationId: group.drive.item_GetRetentionLabel
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property retentionLabel in groups
operationId: group.drive.item_UpdateRetentionLabel
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property retentionLabel for groups
operationId: group.drive.item_DeleteRetentionLabel
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/subscriptions':
get:
tags:
- groups.drive
summary: Get subscriptions from groups
description: The set of subscriptions on the item. Only supported on the root of a drive.
operationId: group.drive.item_ListSubscription
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.subscriptionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to subscriptions for groups
operationId: group.drive.item_CreateSubscription
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/subscriptions/{subscription-id}':
get:
tags:
- groups.drive
summary: Get subscriptions from groups
description: The set of subscriptions on the item. Only supported on the root of a drive.
operationId: group.drive.item_GetSubscription
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property subscriptions in groups
operationId: group.drive.item_UpdateSubscription
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property subscriptions for groups
operationId: group.drive.item_DeleteSubscription
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/subscriptions/{subscription-id}/microsoft.graph.reauthorize':
post:
tags:
- groups.drive
summary: Invoke action reauthorize
description: Reauthorize a subscription when you receive a reauthorizationRequired challenge.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/subscription-reauthorize?view=graph-rest-1.0
operationId: group.drive.item.subscription_reauthorize
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/subscriptions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.item.subscription_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/thumbnails':
get:
tags:
- groups.drive
summary: Get thumbnails from groups
description: 'Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.'
operationId: group.drive.item_ListThumbnail
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.thumbnailSetCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to thumbnails for groups
operationId: group.drive.item_CreateThumbnail
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/thumbnails/{thumbnailSet-id}':
get:
tags:
- groups.drive
summary: Get thumbnails from groups
description: 'Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.'
operationId: group.drive.item_GetThumbnail
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property thumbnails in groups
operationId: group.drive.item_UpdateThumbnail
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property thumbnails for groups
operationId: group.drive.item_DeleteThumbnail
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/thumbnails/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.item.thumbnail_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/versions':
get:
tags:
- groups.drive
summary: Get versions from groups
description: 'The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.'
operationId: group.drive.item_ListVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to versions for groups
operationId: group.drive.item_CreateVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/versions/{driveItemVersion-id}':
get:
tags:
- groups.drive
summary: Get versions from groups
description: 'The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.'
operationId: group.drive.item_GetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property versions in groups
operationId: group.drive.item_UpdateVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property versions for groups
operationId: group.drive.item_DeleteVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/versions/{driveItemVersion-id}/content':
get:
tags:
- groups.drive
summary: Get content for the navigation property versions from groups
description: The content stream for this version of the item.
operationId: group.drive.item_GetVersionsContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- groups.drive
summary: Update content for the navigation property versions in groups
description: The content stream for this version of the item.
operationId: group.drive.item_SetVersionsContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
delete:
tags:
- groups.drive
summary: Delete content for the navigation property versions in groups
description: The content stream for this version of the item.
operationId: group.drive.item_DeleteVersionsContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/versions/{driveItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- groups.drive
summary: Invoke action restoreVersion
description: 'Restore a previous version of a driveItem to be the current version. This operation creates a new version with the contents of the previous version, and it preserves all existing versions of the file.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitemversion-restoreversion?view=graph-rest-1.0
operationId: group.drive.item.version_restoreVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/items/{driveItem-id}/versions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.item.version_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/items/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.item_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/lastModifiedByUser':
get:
tags:
- groups.drive
summary: Get lastModifiedByUser from groups
description: Identity of the user who last modified the item. Read-only.
operationId: group.drive_GetLastModifiedGraphBPreUser
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/lastModifiedByUser/mailboxSettings':
get:
tags:
- groups.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: group.drive.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- groups.drive
summary: Update property mailboxSettings value.
operationId: group.drive.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- groups.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: group.drive.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list':
get:
tags:
- groups.drive
summary: Get list from groups
description: 'For drives in SharePoint, the underlying document library list. Read-only. Nullable.'
operationId: group.drive_GetList
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.list'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property list in groups
operationId: group.drive_UpdateList
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.list'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.list'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property list for groups
operationId: group.drive_DeleteList
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/columns':
get:
tags:
- groups.drive
summary: Get columns from groups
description: The collection of field definitions for this list.
operationId: group.drive.list_ListColumn
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.columnDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to columns for groups
operationId: group.drive.list_CreateColumn
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/columns/{columnDefinition-id}':
get:
tags:
- groups.drive
summary: Get columns from groups
description: The collection of field definitions for this list.
operationId: group.drive.list_GetColumn
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property columns in groups
operationId: group.drive.list_UpdateColumn
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property columns for groups
operationId: group.drive.list_DeleteColumn
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/columns/{columnDefinition-id}/sourceColumn':
get:
tags:
- groups.drive
summary: Get sourceColumn from groups
description: The source column for the content type column.
operationId: group.drive.list.column_GetSourceColumn
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/columns/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.list.column_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/contentTypes':
get:
tags:
- groups.drive
summary: Get contentTypes from groups
description: The collection of content types present in this list.
operationId: group.drive.list_ListContentType
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.contentTypeCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to contentTypes for groups
operationId: group.drive.list_CreateContentType
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}':
get:
tags:
- groups.drive
summary: Get contentTypes from groups
description: The collection of content types present in this list.
operationId: group.drive.list_GetContentType
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property contentTypes in groups
operationId: group.drive.list_UpdateContentType
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property contentTypes for groups
operationId: group.drive.list_DeleteContentType
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/base':
get:
tags:
- groups.drive
summary: Get base from groups
description: Parent contentType from which this content type is derived.
operationId: group.drive.list.contentType_GetBase
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/baseTypes':
get:
tags:
- groups.drive
summary: Get baseTypes from groups
description: The collection of content types that are ancestors of this content type.
operationId: group.drive.list.contentType_ListBaseType
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.contentTypeCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/baseTypes/{contentType-id1}':
get:
tags:
- groups.drive
summary: Get baseTypes from groups
description: The collection of content types that are ancestors of this content type.
operationId: group.drive.list.contentType_GetBaseType
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: contentType-id1
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/baseTypes/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.list.contentType.baseType_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columnLinks':
get:
tags:
- groups.drive
summary: Get columnLinks from groups
description: The collection of columns that are required by this content type.
operationId: group.drive.list.contentType_ListColumnLink
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.columnLinkCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to columnLinks for groups
operationId: group.drive.list.contentType_CreateColumnLink
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columnLinks/{columnLink-id}':
get:
tags:
- groups.drive
summary: Get columnLinks from groups
description: The collection of columns that are required by this content type.
operationId: group.drive.list.contentType_GetColumnLink
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnLink-id
in: path
description: The unique identifier of columnLink
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnLink
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property columnLinks in groups
operationId: group.drive.list.contentType_UpdateColumnLink
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnLink-id
in: path
description: The unique identifier of columnLink
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnLink
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property columnLinks for groups
operationId: group.drive.list.contentType_DeleteColumnLink
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnLink-id
in: path
description: The unique identifier of columnLink
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnLink
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columnLinks/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.list.contentType.columnLink_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columnPositions':
get:
tags:
- groups.drive
summary: Get columnPositions from groups
description: Column order information in a content type.
operationId: group.drive.list.contentType_ListColumnPosition
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.columnDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columnPositions/{columnDefinition-id}':
get:
tags:
- groups.drive
summary: Get columnPositions from groups
description: Column order information in a content type.
operationId: group.drive.list.contentType_GetColumnPosition
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columnPositions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.list.contentType.columnPosition_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columns':
get:
tags:
- groups.drive
summary: Get columns from groups
description: The collection of column definitions for this content type.
operationId: group.drive.list.contentType_ListColumn
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.columnDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to columns for groups
operationId: group.drive.list.contentType_CreateColumn
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columns/{columnDefinition-id}':
get:
tags:
- groups.drive
summary: Get columns from groups
description: The collection of column definitions for this content type.
operationId: group.drive.list.contentType_GetColumn
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property columns in groups
operationId: group.drive.list.contentType_UpdateColumn
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property columns for groups
operationId: group.drive.list.contentType_DeleteColumn
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columns/{columnDefinition-id}/sourceColumn':
get:
tags:
- groups.drive
summary: Get sourceColumn from groups
description: The source column for the content type column.
operationId: group.drive.list.contentType.column_GetSourceColumn
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columns/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.list.contentType.column_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/microsoft.graph.associateWithHubSites':
post:
tags:
- groups.drive
summary: Invoke action associateWithHubSites
description: Associate a published content type present in a content type hub with a list of hub sites.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-associatewithhubsites?view=graph-rest-1.0
operationId: group.drive.list.contentType_associateGraphWPreHubSite
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
hubSiteUrls:
type: array
items:
type: string
propagateToExistingLists:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/microsoft.graph.copyToDefaultContentLocation':
post:
tags:
- groups.drive
summary: Invoke action copyToDefaultContentLocation
description: Copy a file to a default content location in a content type. The file can then be added as a default file or template via a POST operation.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-copytodefaultcontentlocation?view=graph-rest-1.0
operationId: group.drive.list.contentType_copyToDefaultContentLocation
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
sourceFile:
$ref: '#/components/schemas/microsoft.graph.itemReference'
destinationFileName:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/microsoft.graph.isPublished()':
get:
tags:
- groups.drive
summary: Invoke function isPublished
description: Check the publishing status of a contentType in a content type hub site.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-ispublished?view=graph-rest-1.0
operationId: group.drive.list.contentType_isPublished
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
responses:
2XX:
description: Success
content:
application/json:
schema:
type: object
properties:
value:
type: boolean
default: false
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/microsoft.graph.publish':
post:
tags:
- groups.drive
summary: Invoke action publish
description: Publishes a contentType present in the content type hub site.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-publish?view=graph-rest-1.0
operationId: group.drive.list.contentType_publish
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/microsoft.graph.unpublish':
post:
tags:
- groups.drive
summary: Invoke action unpublish
description: Unpublish a contentType from a content type hub site.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-unpublish?view=graph-rest-1.0
operationId: group.drive.list.contentType_unpublish
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.list.contentType_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/microsoft.graph.addCopy':
post:
tags:
- groups.drive
summary: Invoke action addCopy
description: Add a copy of a content type from a site to a list.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-addcopy?view=graph-rest-1.0
operationId: group.drive.list.contentType_addCopy
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
contentType:
type: string
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/microsoft.graph.addCopyFromContentTypeHub':
post:
tags:
- groups.drive
summary: Invoke action addCopyFromContentTypeHub
description: 'Add or sync a copy of a published content type from the content type hub to a target site or a list. This method is part of the content type publishing changes to optimize the syncing of published content types to sites and lists, effectively switching from a ''push everywhere'' to ''pull as needed'' approach. The method allows users to pull content types directly from the content type hub to a site or list. For more information, see contentType: getCompatibleHubContentTypes and the blog post Syntex Product Updates – August 2021.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-addcopyfromcontenttypehub?view=graph-rest-1.0
operationId: group.drive.list.contentType_addCopyFromContentTypeHub
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
contentTypeId:
type: string
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/list/contentTypes/microsoft.graph.getCompatibleHubContentTypes()':
get:
tags:
- groups.drive
summary: Invoke function getCompatibleHubContentTypes
description: 'Get a list of compatible content types from the content type hub that can be added to a target site or a list. This method is part of the content type publishing changes to optimize the syncing of published content types to sites and lists, effectively switching from a ''push everywhere'' to ''pull as needed'' approach. The method allows users to pull content types directly from the content type hub to a site or list. For more information, see contentType: addCopyFromContentTypeHub and the blog post Syntex Product Updates – August 2021.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-getcompatiblehubcontenttypes?view=graph-rest-1.0
operationId: group.drive.list.contentType_getCompatibleHubContentType
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of contentType
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.contentType'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/list/createdByUser':
get:
tags:
- groups.drive
summary: Get createdByUser from groups
description: Identity of the user who created the item. Read-only.
operationId: group.drive.list_GetCreatedGraphBPreUser
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/createdByUser/mailboxSettings':
get:
tags:
- groups.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: group.drive.list.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- groups.drive
summary: Update property mailboxSettings value.
operationId: group.drive.list.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/createdByUser/serviceProvisioningErrors':
get:
tags:
- groups.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: group.drive.list.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/list/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.list.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/drive':
get:
tags:
- groups.drive
summary: Get drive from groups
description: Allows access to the list as a drive resource with driveItems. Only present on document libraries.
operationId: group.drive.list_GetDrive
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/items':
get:
tags:
- groups.drive
summary: Get items from groups
description: All items contained in the list.
operationId: group.drive.list_ListItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.listItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to items for groups
operationId: group.drive.list_CreateItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}':
get:
tags:
- groups.drive
summary: Get items from groups
description: All items contained in the list.
operationId: group.drive.list_GetItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property items in groups
operationId: group.drive.list_UpdateItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property items for groups
operationId: group.drive.list_DeleteItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/analytics':
get:
tags:
- groups.drive
summary: Get analytics from groups
description: Analytics about the view activities that took place on this item.
operationId: group.drive.list.item_GetAnalytic
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/createdByUser':
get:
tags:
- groups.drive
summary: Get createdByUser from groups
description: Identity of the user who created the item. Read-only.
operationId: group.drive.list.item_GetCreatedGraphBPreUser
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/createdByUser/mailboxSettings':
get:
tags:
- groups.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: group.drive.list.item.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- groups.drive
summary: Update property mailboxSettings value.
operationId: group.drive.list.item.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/createdByUser/serviceProvisioningErrors':
get:
tags:
- groups.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: group.drive.list.item.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.list.item.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/documentSetVersions':
get:
tags:
- groups.drive
summary: Get documentSetVersions from groups
description: Version information for a document set version created by a user.
operationId: group.drive.list.item_ListDocumentSetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.documentSetVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to documentSetVersions for groups
operationId: group.drive.list.item_CreateDocumentSetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/documentSetVersions/{documentSetVersion-id}':
get:
tags:
- groups.drive
summary: Get documentSetVersions from groups
description: Version information for a document set version created by a user.
operationId: group.drive.list.item_GetDocumentSetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property documentSetVersions in groups
operationId: group.drive.list.item_UpdateDocumentSetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property documentSetVersions for groups
operationId: group.drive.list.item_DeleteDocumentSetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/documentSetVersions/{documentSetVersion-id}/fields':
get:
tags:
- groups.drive
summary: Get fields from groups
description: A collection of the fields and values for this version of the list item.
operationId: group.drive.list.item.documentSetVersion_GetField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property fields in groups
operationId: group.drive.list.item.documentSetVersion_UpdateField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property fields for groups
operationId: group.drive.list.item.documentSetVersion_DeleteField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/documentSetVersions/{documentSetVersion-id}/microsoft.graph.restore':
post:
tags:
- groups.drive
summary: Invoke action restore
description: Restore a document set version.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/documentsetversion-restore?view=graph-rest-1.0
operationId: group.drive.list.item.documentSetVersion_restore
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/documentSetVersions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.list.item.documentSetVersion_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/driveItem':
get:
tags:
- groups.drive
summary: Get driveItem from groups
description: 'For document libraries, the driveItem relationship exposes the listItem as a driveItem'
operationId: group.drive.list.item_GetDriveItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/driveItem/content':
get:
tags:
- groups.drive
summary: Get content for the navigation property driveItem from groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.list.item_GetDriveItemContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- groups.drive
summary: Update content for the navigation property driveItem in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.list.item_SetDriveItemContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- groups.drive
summary: Delete content for the navigation property driveItem in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.list.item_DeleteDriveItemContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/fields':
get:
tags:
- groups.drive
summary: Get fields from groups
description: The values of the columns set on this list item.
operationId: group.drive.list.item_GetField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property fields in groups
operationId: group.drive.list.item_UpdateField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property fields for groups
operationId: group.drive.list.item_DeleteField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/lastModifiedByUser':
get:
tags:
- groups.drive
summary: Get lastModifiedByUser from groups
description: Identity of the user who last modified the item. Read-only.
operationId: group.drive.list.item_GetLastModifiedGraphBPreUser
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/lastModifiedByUser/mailboxSettings':
get:
tags:
- groups.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: group.drive.list.item.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- groups.drive
summary: Update property mailboxSettings value.
operationId: group.drive.list.item.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- groups.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: group.drive.list.item.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.list.item.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/microsoft.graph.createLink':
post:
tags:
- groups.drive
summary: Invoke action createLink
operationId: group.drive.list.item_createLink
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- groups.drive
summary: Invoke function getActivitiesByInterval
operationId: group.drive.list.item_getActivitiesGraphBPreInterval
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- groups.drive
summary: Invoke function getActivitiesByInterval
operationId: group.drive.list.item_getActivitiesGraphBPreInterval
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/permissions':
get:
tags:
- groups.drive
summary: Get permissions from groups
description: The set of permissions for the item. Read-only. Nullable.
operationId: group.drive.list.item_ListPermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to permissions for groups
operationId: group.drive.list.item_CreatePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/permissions/{permission-id}':
get:
tags:
- groups.drive
summary: Get permissions from groups
description: The set of permissions for the item. Read-only. Nullable.
operationId: group.drive.list.item_GetPermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property permissions in groups
operationId: group.drive.list.item_UpdatePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property permissions for groups
operationId: group.drive.list.item_DeletePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- groups.drive
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: group.drive.list.item.permission_grant
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/permissions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.list.item.permission_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/versions':
get:
tags:
- groups.drive
summary: Get versions from groups
description: The list of previous versions of the list item.
operationId: group.drive.list.item_ListVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.listItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to versions for groups
operationId: group.drive.list.item_CreateVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/versions/{listItemVersion-id}':
get:
tags:
- groups.drive
summary: Get versions from groups
description: The list of previous versions of the list item.
operationId: group.drive.list.item_GetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property versions in groups
operationId: group.drive.list.item_UpdateVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property versions for groups
operationId: group.drive.list.item_DeleteVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/versions/{listItemVersion-id}/fields':
get:
tags:
- groups.drive
summary: Get fields from groups
description: A collection of the fields and values for this version of the list item.
operationId: group.drive.list.item.version_GetField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property fields in groups
operationId: group.drive.list.item.version_UpdateField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property fields for groups
operationId: group.drive.list.item.version_DeleteField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/versions/{listItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- groups.drive
summary: Invoke action restoreVersion
description: 'Restore a previous version of a ListItem to be the current version. This will create a new version with the contents of the previous version, but preserves all existing versions of the item.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/listitemversion-restore?view=graph-rest-1.0
operationId: group.drive.list.item.version_restoreVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/list/items/{listItem-id}/versions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.list.item.version_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/items/microsoft.graph.delta()':
get:
tags:
- groups.drive
summary: Invoke function delta
description: "Get newly created, updated, or deleted list items without having to perform a full read of the entire items collection. Your app begins by calling delta without any parameters.\r\nThe service starts enumerating the hierarchy of the list, returning pages of items, and either an @odata.nextLink or an @odata.deltaLink.\r\nYour app should continue calling with the @odata.nextLink until you see an @odata.deltaLink returned. After you received all the changes, you can apply them to your local state.\r\nTo check for changes in the future, call delta again with the @odata.deltaLink from the previous response. The delta feed shows the latest state for each item, not each change. If an item was renamed twice, it only shows up once, with its latest name.\r\nThe same item might appear more than once in a delta feed, for various reasons. You should use the last occurrence you see. Items with this property should be removed from your local state."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/listitem-delta?view=graph-rest-1.0
operationId: group.drive.list.item_delta
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of listItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.listItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/list/items/microsoft.graph.delta(token=''{token}'')':
get:
tags:
- groups.drive
summary: Invoke function delta
operationId: group.drive.list.item_delta
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: token
in: path
description: 'Usage: token=''{token}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of listItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.listItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/list/lastModifiedByUser':
get:
tags:
- groups.drive
summary: Get lastModifiedByUser from groups
description: Identity of the user who last modified the item. Read-only.
operationId: group.drive.list_GetLastModifiedGraphBPreUser
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/lastModifiedByUser/mailboxSettings':
get:
tags:
- groups.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: group.drive.list.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- groups.drive
summary: Update property mailboxSettings value.
operationId: group.drive.list.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- groups.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: group.drive.list.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/list/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.list.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/operations':
get:
tags:
- groups.drive
summary: Get operations from groups
description: The collection of long-running operations on the list.
operationId: group.drive.list_ListOperation
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.richLongRunningOperationCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to operations for groups
operationId: group.drive.list_CreateOperation
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/operations/{richLongRunningOperation-id}':
get:
tags:
- groups.drive
summary: Get operations from groups
description: The collection of long-running operations on the list.
operationId: group.drive.list_GetOperation
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: richLongRunningOperation-id
in: path
description: The unique identifier of richLongRunningOperation
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: richLongRunningOperation
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property operations in groups
operationId: group.drive.list_UpdateOperation
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: richLongRunningOperation-id
in: path
description: The unique identifier of richLongRunningOperation
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: richLongRunningOperation
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property operations for groups
operationId: group.drive.list_DeleteOperation
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: richLongRunningOperation-id
in: path
description: The unique identifier of richLongRunningOperation
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: richLongRunningOperation
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/operations/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.list.operation_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/permissions':
get:
tags:
- groups.drive
summary: Get permissions from groups
description: The set of permissions for the item. Read-only. Nullable.
operationId: group.drive.list_ListPermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to permissions for groups
operationId: group.drive.list_CreatePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/permissions/{permission-id}':
get:
tags:
- groups.drive
summary: Get permissions from groups
description: The set of permissions for the item. Read-only. Nullable.
operationId: group.drive.list_GetPermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property permissions in groups
operationId: group.drive.list_UpdatePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property permissions for groups
operationId: group.drive.list_DeletePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- groups.drive
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: group.drive.list.permission_grant
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/list/permissions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.list.permission_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/list/subscriptions':
get:
tags:
- groups.drive
summary: Get subscriptions from groups
description: The set of subscriptions on the list.
operationId: group.drive.list_ListSubscription
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.subscriptionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to subscriptions for groups
operationId: group.drive.list_CreateSubscription
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/subscriptions/{subscription-id}':
get:
tags:
- groups.drive
summary: Get subscriptions from groups
description: The set of subscriptions on the list.
operationId: group.drive.list_GetSubscription
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property subscriptions in groups
operationId: group.drive.list_UpdateSubscription
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property subscriptions for groups
operationId: group.drive.list_DeleteSubscription
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/list/subscriptions/{subscription-id}/microsoft.graph.reauthorize':
post:
tags:
- groups.drive
summary: Invoke action reauthorize
description: Reauthorize a subscription when you receive a reauthorizationRequired challenge.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/subscription-reauthorize?view=graph-rest-1.0
operationId: group.drive.list.subscription_reauthorize
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/list/subscriptions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.list.subscription_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/microsoft.graph.recent()':
get:
tags:
- groups.drive
summary: Invoke function recent
description: "List a set of items recently used by the signed-in user.\r\nThis collection includes items that are in the user's drive and items they have access to from other drives."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/drive-recent?view=graph-rest-1.0
operationId: group.drive_recent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/recentResponse'
default:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2027-11-01'
date: '2025-11-13'
version: 2025-11/Removal
description: 'This API is deprecated and will stop returning data after November, 2027.'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/microsoft.graph.search(q=''{q}'')':
get:
tags:
- groups.drive
summary: Invoke function search
description: "Search the hierarchy of items for items matching a query.\r\nYou can search within a folder hierarchy, a whole drive, or files shared with the current user."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-search?view=graph-rest-1.0
operationId: group.drive_search
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: q
in: path
description: 'Usage: q=''{q}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/searchResponse'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/microsoft.graph.sharedWithMe()':
get:
tags:
- groups.drive
summary: Invoke function sharedWithMe
description: Get a list of driveItem objects shared with the owner of a drive. The driveItems returned from the sharedWithMe method always include the remoteItem facet that indicates they are items from a different drive.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/drive-sharedwithme?view=graph-rest-1.0
operationId: group.drive_sharedGraphWPreMe
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/sharedWithMeResponse'
default:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2027-11-01'
date: '2025-11-13'
version: 2025-11/Removal
description: 'This API is deprecated and will stop returning data after November, 2027.'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/root':
get:
tags:
- groups.drive
summary: Get root from groups
description: The root folder of the drive. Read-only.
operationId: group.drive_GetRoot
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property root in groups
operationId: group.drive_UpdateRoot
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property root for groups
operationId: group.drive_DeleteRoot
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/analytics':
get:
tags:
- groups.drive
summary: Get analytics from groups
description: Analytics about the view activities that took place on this item.
operationId: group.drive.root_GetAnalytic
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property analytics in groups
operationId: group.drive.root_UpdateAnalytic
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property analytics for groups
operationId: group.drive.root_DeleteAnalytic
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/analytics/allTime':
get:
tags:
- groups.drive
summary: Get allTime from groups
operationId: group.drive.root.analytic_GetAllTime
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/analytics/itemActivityStats':
get:
tags:
- groups.drive
summary: Get itemActivityStats from groups
operationId: group.drive.root.analytic_ListItemActivityStat
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.itemActivityStatCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to itemActivityStats for groups
operationId: group.drive.root.analytic_CreateItemActivityStat
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}':
get:
tags:
- groups.drive
summary: Get itemActivityStats from groups
operationId: group.drive.root.analytic_GetItemActivityStat
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property itemActivityStats in groups
operationId: group.drive.root.analytic_UpdateItemActivityStat
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property itemActivityStats for groups
operationId: group.drive.root.analytic_DeleteItemActivityStat
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}/activities':
get:
tags:
- groups.drive
summary: Get activities from groups
description: Exposes the itemActivities represented in this itemActivityStat resource.
operationId: group.drive.root.analytic.itemActivityStat_ListActivity
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.itemActivityCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to activities for groups
operationId: group.drive.root.analytic.itemActivityStat_CreateActivity
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}':
get:
tags:
- groups.drive
summary: Get activities from groups
description: Exposes the itemActivities represented in this itemActivityStat resource.
operationId: group.drive.root.analytic.itemActivityStat_GetActivity
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property activities in groups
operationId: group.drive.root.analytic.itemActivityStat_UpdateActivity
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property activities for groups
operationId: group.drive.root.analytic.itemActivityStat_DeleteActivity
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}/driveItem':
get:
tags:
- groups.drive
summary: Get driveItem from groups
description: Exposes the driveItem that was the target of this activity.
operationId: group.drive.root.analytic.itemActivityStat.activity_GetDriveItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}/driveItem/content':
get:
tags:
- groups.drive
summary: Get content for the navigation property driveItem from groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.root.analytic.itemActivityStat.activity_GetDriveItemContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- groups.drive
summary: Update content for the navigation property driveItem in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.root.analytic.itemActivityStat.activity_SetDriveItemContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- groups.drive
summary: Delete content for the navigation property driveItem in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.root.analytic.itemActivityStat.activity_DeleteDriveItemContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}/activities/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.root.analytic.itemActivityStat.activity_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/analytics/itemActivityStats/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.root.analytic.itemActivityStat_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/analytics/lastSevenDays':
get:
tags:
- groups.drive
summary: Get lastSevenDays from groups
operationId: group.drive.root.analytic_GetLastSevenDay
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/children':
get:
tags:
- groups.drive
summary: Get children from groups
description: Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.
operationId: group.drive.root_ListChild
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to children for groups
operationId: group.drive.root_CreateChild
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/children/{driveItem-id}':
get:
tags:
- groups.drive
summary: Get children from groups
description: Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.
operationId: group.drive.root_GetChild
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/children/{driveItem-id}/content':
get:
tags:
- groups.drive
summary: Get content for the navigation property children from groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.root_GetChildrenContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- groups.drive
summary: Update content for the navigation property children in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.root_SetChildrenContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- groups.drive
summary: Delete content for the navigation property children in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.root_DeleteChildrenContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/children/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.root.child_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/content':
get:
tags:
- groups.drive
summary: Get content for the navigation property root from groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive_GetRootContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- groups.drive
summary: Update content for the navigation property root in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive_SetRootContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- groups.drive
summary: Delete content for the navigation property root in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive_DeleteRootContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/createdByUser':
get:
tags:
- groups.drive
summary: Get createdByUser from groups
description: Identity of the user who created the item. Read-only.
operationId: group.drive.root_GetCreatedGraphBPreUser
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/createdByUser/mailboxSettings':
get:
tags:
- groups.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: group.drive.root.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- groups.drive
summary: Update property mailboxSettings value.
operationId: group.drive.root.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/createdByUser/serviceProvisioningErrors':
get:
tags:
- groups.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: group.drive.root.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/root/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.root.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/lastModifiedByUser':
get:
tags:
- groups.drive
summary: Get lastModifiedByUser from groups
description: Identity of the user who last modified the item. Read-only.
operationId: group.drive.root_GetLastModifiedGraphBPreUser
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/lastModifiedByUser/mailboxSettings':
get:
tags:
- groups.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: group.drive.root.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- groups.drive
summary: Update property mailboxSettings value.
operationId: group.drive.root.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- groups.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: group.drive.root.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/root/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.root.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/listItem':
get:
tags:
- groups.drive
summary: Get listItem from groups
description: 'For drives in SharePoint, the associated document library list item. Read-only. Nullable.'
operationId: group.drive.root_GetListItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property listItem in groups
operationId: group.drive.root_UpdateListItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property listItem for groups
operationId: group.drive.root_DeleteListItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/listItem/analytics':
get:
tags:
- groups.drive
summary: Get analytics from groups
description: Analytics about the view activities that took place on this item.
operationId: group.drive.root.listItem_GetAnalytic
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/listItem/createdByUser':
get:
tags:
- groups.drive
summary: Get createdByUser from groups
description: Identity of the user who created the item. Read-only.
operationId: group.drive.root.listItem_GetCreatedGraphBPreUser
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/listItem/createdByUser/mailboxSettings':
get:
tags:
- groups.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: group.drive.root.listItem.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- groups.drive
summary: Update property mailboxSettings value.
operationId: group.drive.root.listItem.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/listItem/createdByUser/serviceProvisioningErrors':
get:
tags:
- groups.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: group.drive.root.listItem.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/root/listItem/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.root.listItem.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/listItem/documentSetVersions':
get:
tags:
- groups.drive
summary: Get documentSetVersions from groups
description: Version information for a document set version created by a user.
operationId: group.drive.root.listItem_ListDocumentSetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.documentSetVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to documentSetVersions for groups
operationId: group.drive.root.listItem_CreateDocumentSetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/listItem/documentSetVersions/{documentSetVersion-id}':
get:
tags:
- groups.drive
summary: Get documentSetVersions from groups
description: Version information for a document set version created by a user.
operationId: group.drive.root.listItem_GetDocumentSetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property documentSetVersions in groups
operationId: group.drive.root.listItem_UpdateDocumentSetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property documentSetVersions for groups
operationId: group.drive.root.listItem_DeleteDocumentSetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/listItem/documentSetVersions/{documentSetVersion-id}/fields':
get:
tags:
- groups.drive
summary: Get fields from groups
description: A collection of the fields and values for this version of the list item.
operationId: group.drive.root.listItem.documentSetVersion_GetField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property fields in groups
operationId: group.drive.root.listItem.documentSetVersion_UpdateField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property fields for groups
operationId: group.drive.root.listItem.documentSetVersion_DeleteField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/listItem/documentSetVersions/{documentSetVersion-id}/microsoft.graph.restore':
post:
tags:
- groups.drive
summary: Invoke action restore
description: Restore a document set version.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/documentsetversion-restore?view=graph-rest-1.0
operationId: group.drive.root.listItem.documentSetVersion_restore
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/listItem/documentSetVersions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.root.listItem.documentSetVersion_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/listItem/driveItem':
get:
tags:
- groups.drive
summary: Get driveItem from groups
description: 'For document libraries, the driveItem relationship exposes the listItem as a driveItem'
operationId: group.drive.root.listItem_GetDriveItem
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/listItem/driveItem/content':
get:
tags:
- groups.drive
summary: Get content for the navigation property driveItem from groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.root.listItem_GetDriveItemContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- groups.drive
summary: Update content for the navigation property driveItem in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.root.listItem_SetDriveItemContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- groups.drive
summary: Delete content for the navigation property driveItem in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive.root.listItem_DeleteDriveItemContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/listItem/fields':
get:
tags:
- groups.drive
summary: Get fields from groups
description: The values of the columns set on this list item.
operationId: group.drive.root.listItem_GetField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property fields in groups
operationId: group.drive.root.listItem_UpdateField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property fields for groups
operationId: group.drive.root.listItem_DeleteField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/listItem/lastModifiedByUser':
get:
tags:
- groups.drive
summary: Get lastModifiedByUser from groups
description: Identity of the user who last modified the item. Read-only.
operationId: group.drive.root.listItem_GetLastModifiedGraphBPreUser
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/listItem/lastModifiedByUser/mailboxSettings':
get:
tags:
- groups.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: group.drive.root.listItem.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- groups.drive
summary: Update property mailboxSettings value.
operationId: group.drive.root.listItem.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/listItem/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- groups.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: group.drive.root.listItem.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/root/listItem/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.root.listItem.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/listItem/microsoft.graph.createLink':
post:
tags:
- groups.drive
summary: Invoke action createLink
operationId: group.drive.root.listItem_createLink
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/listItem/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- groups.drive
summary: Invoke function getActivitiesByInterval
operationId: group.drive.root.listItem_getActivitiesGraphBPreInterval
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/root/listItem/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- groups.drive
summary: Invoke function getActivitiesByInterval
operationId: group.drive.root.listItem_getActivitiesGraphBPreInterval
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/root/listItem/permissions':
get:
tags:
- groups.drive
summary: Get permissions from groups
description: The set of permissions for the item. Read-only. Nullable.
operationId: group.drive.root.listItem_ListPermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to permissions for groups
operationId: group.drive.root.listItem_CreatePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/listItem/permissions/{permission-id}':
get:
tags:
- groups.drive
summary: Get permissions from groups
description: The set of permissions for the item. Read-only. Nullable.
operationId: group.drive.root.listItem_GetPermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property permissions in groups
operationId: group.drive.root.listItem_UpdatePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property permissions for groups
operationId: group.drive.root.listItem_DeletePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/listItem/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- groups.drive
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: group.drive.root.listItem.permission_grant
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/root/listItem/permissions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.root.listItem.permission_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/listItem/versions':
get:
tags:
- groups.drive
summary: Get versions from groups
description: The list of previous versions of the list item.
operationId: group.drive.root.listItem_ListVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.listItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to versions for groups
operationId: group.drive.root.listItem_CreateVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/listItem/versions/{listItemVersion-id}':
get:
tags:
- groups.drive
summary: Get versions from groups
description: The list of previous versions of the list item.
operationId: group.drive.root.listItem_GetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property versions in groups
operationId: group.drive.root.listItem_UpdateVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property versions for groups
operationId: group.drive.root.listItem_DeleteVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/listItem/versions/{listItemVersion-id}/fields':
get:
tags:
- groups.drive
summary: Get fields from groups
description: A collection of the fields and values for this version of the list item.
operationId: group.drive.root.listItem.version_GetField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property fields in groups
operationId: group.drive.root.listItem.version_UpdateField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property fields for groups
operationId: group.drive.root.listItem.version_DeleteField
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/listItem/versions/{listItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- groups.drive
summary: Invoke action restoreVersion
description: 'Restore a previous version of a ListItem to be the current version. This will create a new version with the contents of the previous version, but preserves all existing versions of the item.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/listitemversion-restore?view=graph-rest-1.0
operationId: group.drive.root.listItem.version_restoreVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/listItem/versions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.root.listItem.version_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.assignSensitivityLabel':
post:
tags:
- groups.drive
summary: Invoke action assignSensitivityLabel
description: 'Asynchronously assign a sensitivity label to a driveItem. This API is part of the Microsoft SharePoint and OneDrive APIs that perform advanced premium administrative functions, and is considered as protected. Protected APIs require you to have more validations, beyond permission and consent, before you can use them. For more information about sensitivity labels from an administrator''s perspective, see Enable sensitivity labels for Office files in SharePoint and OneDrive. This API applies sensitivity labels to files at rest. Office clients don''t apply watermarks, headers, or footers to files that contain the label information. For more information about sensitivity labels from an administrator''s perspective, see Enable sensitivity labels for Office files in SharePoint and OneDrive.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-assignsensitivitylabel?view=graph-rest-1.0
operationId: group.drive.root_assignSensitivityLabel
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
sensitivityLabelId:
type: string
nullable: true
assignmentMethod:
$ref: '#/components/schemas/microsoft.graph.sensitivityLabelAssignmentMethod'
justificationText:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.checkin':
post:
tags:
- groups.drive
summary: Invoke action checkin
description: 'Check in a checked out driveItem resource, which makes the version of the document available to others.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-checkin?view=graph-rest-1.0
operationId: group.drive.root_checkin
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
checkInAs:
type: string
nullable: true
comment:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.checkout':
post:
tags:
- groups.drive
summary: Invoke action checkout
description: '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.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-checkout?view=graph-rest-1.0
operationId: group.drive.root_checkout
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.copy':
post:
tags:
- groups.drive
summary: Invoke action copy
operationId: group.drive.root_copy
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
name:
type: string
nullable: true
parentReference:
$ref: '#/components/schemas/microsoft.graph.itemReference'
childrenOnly:
type: boolean
default: false
nullable: true
includeAllVersionHistory:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.createLink':
post:
tags:
- groups.drive
summary: Invoke action createLink
description: "Create a link to share a driveItem driveItem. The createLink action creates a new sharing link if the specified link type doesn't already exist for the calling application.\r\nIf a sharing link of the specified type already exists for the app, the existing sharing link is returned. DriveItem resources inherit sharing permissions from their ancestors."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-createlink?view=graph-rest-1.0
operationId: group.drive.root_createLink
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.createUploadSession':
post:
tags:
- groups.drive
summary: Invoke action createUploadSession
operationId: group.drive.root_createUploadSession
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
item:
$ref: '#/components/schemas/microsoft.graph.driveItemUploadableProperties'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.uploadSession'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.delta()':
get:
tags:
- groups.drive
summary: Invoke function delta
description: "Track changes in a driveItem and its children over time. Your app begins by calling delta without any parameters.\r\nThe service starts enumerating the drive's hierarchy, returning pages of items and either an @odata.nextLink or an @odata.deltaLink, as described below.\r\nYour app should continue calling with the @odata.nextLink until you no longer see an @odata.nextLink returned, or you see a response with an empty set of changes. After you have finished receiving all the changes, you may apply them to your local state.\r\nTo check for changes in the future, call delta again with the @odata.deltaLink from the previous response. Deleted items are returned with the deleted facet.\r\nItems with this property set should be removed from your local state."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-delta?view=graph-rest-1.0
operationId: group.drive.root_delta
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.delta(token=''{token}'')':
get:
tags:
- groups.drive
summary: Invoke function delta
operationId: group.drive.root_delta
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: token
in: path
description: 'Usage: token=''{token}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.discardCheckout':
post:
tags:
- groups.drive
summary: Invoke action discardCheckout
description: Discard the check out of a driveItem. This action releases a driveItem resource that was previously checked out. Any changes made to the item while it was checked out are discarded. The same user that performed the checkout must discard it. Another alternative is to use application permissions.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-discardcheckout?view=graph-rest-1.0
operationId: group.drive.root_discardCheckout
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.extractSensitivityLabels':
post:
tags:
- groups.drive
summary: Invoke action extractSensitivityLabels
operationId: group.drive.root_extractSensitivityLabel
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.extractSensitivityLabelsResult'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.follow':
post:
tags:
- groups.drive
summary: Invoke action follow
description: Follow a driveItem.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-follow?view=graph-rest-1.0
operationId: group.drive.root_follow
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- groups.drive
summary: Invoke function getActivitiesByInterval
description: Get a collection of itemActivityStats resources for the activities that took place on this resource within the specified time interval. Analytics aggregates might not be available for all action types.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/itemactivitystat-getactivitybyinterval?view=graph-rest-1.0
operationId: group.drive.root_getActivitiesGraphBPreInterval
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- groups.drive
summary: Invoke function getActivitiesByInterval
operationId: group.drive.root_getActivitiesGraphBPreInterval
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.invite':
post:
tags:
- groups.drive
summary: Invoke action invite
description: 'Send a sharing invitation for a driveItem. A sharing invitation provides permissions to the recipients and, optionally, sends them an email to notify them that the item was shared.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-invite?view=graph-rest-1.0
operationId: group.drive.root_invite
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
requireSignIn:
type: boolean
default: false
nullable: true
roles:
type: array
items:
type: string
nullable: true
sendInvitation:
type: boolean
default: false
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
expirationDateTime:
type: string
nullable: true
password:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.permanentDelete':
post:
tags:
- groups.drive
summary: Invoke action permanentDelete
operationId: group.drive.root_permanentDelete
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.preview':
post:
tags:
- groups.drive
summary: Invoke action preview
operationId: group.drive.root_preview
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
page:
type: string
nullable: true
zoom:
type: number
format: double
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemPreviewInfo'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.restore':
post:
tags:
- groups.drive
summary: Invoke action restore
description: Restore a deleted driveItem that is currently in the recycle bin.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-restore?view=graph-rest-1.0
operationId: group.drive.root_restore
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
parentReference:
$ref: '#/components/schemas/microsoft.graph.itemReference'
name:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.search(q=''{q}'')':
get:
tags:
- groups.drive
summary: Invoke function search
description: "Search the hierarchy of items for items matching a query.\r\nYou can search within a folder hierarchy, a whole drive, or files shared with the current user."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-search?view=graph-rest-1.0
operationId: group.drive.root_search
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: q
in: path
description: 'Usage: q=''{q}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.unfollow':
post:
tags:
- groups.drive
summary: Invoke action unfollow
description: Unfollow a driveItem.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-unfollow?view=graph-rest-1.0
operationId: group.drive.root_unfollow
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/microsoft.graph.validatePermission':
post:
tags:
- groups.drive
summary: Invoke action validatePermission
operationId: group.drive.root_validatePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
challengeToken:
type: string
nullable: true
password:
type: string
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/permissions':
get:
tags:
- groups.drive
summary: Get permissions from groups
description: The set of permissions for the item. Read-only. Nullable.
operationId: group.drive.root_ListPermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to permissions for groups
operationId: group.drive.root_CreatePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/permissions/{permission-id}':
get:
tags:
- groups.drive
summary: Get permissions from groups
description: The set of permissions for the item. Read-only. Nullable.
operationId: group.drive.root_GetPermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property permissions in groups
operationId: group.drive.root_UpdatePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property permissions for groups
operationId: group.drive.root_DeletePermission
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- groups.drive
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: group.drive.root.permission_grant
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/groups/{group-id}/drives/{drive-id}/root/permissions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.root.permission_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/retentionLabel':
get:
tags:
- groups.drive
summary: Get retentionLabel from groups
description: Information about retention label and settings enforced on the driveItem. Read-write.
operationId: group.drive.root_GetRetentionLabel
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property retentionLabel in groups
operationId: group.drive.root_UpdateRetentionLabel
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property retentionLabel for groups
operationId: group.drive.root_DeleteRetentionLabel
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/subscriptions':
get:
tags:
- groups.drive
summary: Get subscriptions from groups
description: The set of subscriptions on the item. Only supported on the root of a drive.
operationId: group.drive.root_ListSubscription
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.subscriptionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to subscriptions for groups
operationId: group.drive.root_CreateSubscription
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/subscriptions/{subscription-id}':
get:
tags:
- groups.drive
summary: Get subscriptions from groups
description: The set of subscriptions on the item. Only supported on the root of a drive.
operationId: group.drive.root_GetSubscription
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property subscriptions in groups
operationId: group.drive.root_UpdateSubscription
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property subscriptions for groups
operationId: group.drive.root_DeleteSubscription
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/subscriptions/{subscription-id}/microsoft.graph.reauthorize':
post:
tags:
- groups.drive
summary: Invoke action reauthorize
description: Reauthorize a subscription when you receive a reauthorizationRequired challenge.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/subscription-reauthorize?view=graph-rest-1.0
operationId: group.drive.root.subscription_reauthorize
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/subscriptions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.root.subscription_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/thumbnails':
get:
tags:
- groups.drive
summary: Get thumbnails from groups
description: 'Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.'
operationId: group.drive.root_ListThumbnail
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.thumbnailSetCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to thumbnails for groups
operationId: group.drive.root_CreateThumbnail
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/thumbnails/{thumbnailSet-id}':
get:
tags:
- groups.drive
summary: Get thumbnails from groups
description: 'Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.'
operationId: group.drive.root_GetThumbnail
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property thumbnails in groups
operationId: group.drive.root_UpdateThumbnail
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property thumbnails for groups
operationId: group.drive.root_DeleteThumbnail
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/thumbnails/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.root.thumbnail_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/versions':
get:
tags:
- groups.drive
summary: Get versions from groups
description: 'The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.'
operationId: group.drive.root_ListVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- groups.drive
summary: Create new navigation property to versions for groups
operationId: group.drive.root_CreateVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/versions/{driveItemVersion-id}':
get:
tags:
- groups.drive
summary: Get versions from groups
description: 'The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.'
operationId: group.drive.root_GetVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.drive
summary: Update the navigation property versions in groups
operationId: group.drive.root_UpdateVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.drive
summary: Delete navigation property versions for groups
operationId: group.drive.root_DeleteVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/root/versions/{driveItemVersion-id}/content':
get:
tags:
- groups.drive
summary: Get content for the navigation property versions from groups
description: The content stream for this version of the item.
operationId: group.drive.root_GetVersionsContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- groups.drive
summary: Update content for the navigation property versions in groups
description: The content stream for this version of the item.
operationId: group.drive.root_SetVersionsContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
delete:
tags:
- groups.drive
summary: Delete content for the navigation property versions in groups
description: The content stream for this version of the item.
operationId: group.drive.root_DeleteVersionsContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/root/versions/{driveItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- groups.drive
summary: Invoke action restoreVersion
description: 'Restore a previous version of a driveItem to be the current version. This operation creates a new version with the contents of the previous version, and it preserves all existing versions of the file.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitemversion-restoreversion?view=graph-rest-1.0
operationId: group.drive.root.version_restoreVersion
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/groups/{group-id}/drives/{drive-id}/root/versions/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.root.version_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/special':
get:
tags:
- groups.drive
summary: Get special from groups
description: Collection of common folders available in OneDrive. Read-only. Nullable.
operationId: group.drive_ListSpecial
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/special/{driveItem-id}':
get:
tags:
- groups.drive
summary: Get special from groups
description: Collection of common folders available in OneDrive. Read-only. Nullable.
operationId: group.drive_GetSpecial
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/groups/{group-id}/drives/{drive-id}/special/{driveItem-id}/content':
get:
tags:
- groups.drive
summary: Get content for the navigation property special from groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive_GetSpecialContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- groups.drive
summary: Update content for the navigation property special in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive_SetSpecialContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- groups.drive
summary: Delete content for the navigation property special in groups
description: 'The content stream, if the item represents a file.'
operationId: group.drive_DeleteSpecialContent
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/{drive-id}/special/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive.special_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/groups/{group-id}/drives/$count':
get:
tags:
- groups.drive
summary: Get the number of the resource
operationId: group.drive_GetCount
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: group
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
/shares:
get:
tags:
- shares.sharedDriveItem
summary: Accessing shared DriveItems
description: 'Access a shared DriveItem or a collection of shared items by using a shareId or sharing URL. To use a sharing URL with this API, your app needs to transform the URL into a sharing token.'
operationId: share.sharedDriveItem_ListSharedDriveItem
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.sharedDriveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- shares.sharedDriveItem
summary: Add new entity to shares
operationId: share.sharedDriveItem_CreateSharedDriveItem
requestBody:
description: New entity
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.sharedDriveItem'
required: true
responses:
2XX:
description: Created entity
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.sharedDriveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}':
get:
tags:
- shares.sharedDriveItem
summary: Accessing shared DriveItems
description: 'Access a shared DriveItem or a collection of shared items by using a shareId or sharing URL. To use a sharing URL with this API, your app needs to transform the URL into a sharing token.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/shares-get?view=graph-rest-1.0
operationId: share.sharedDriveItem_GetSharedDriveItem
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved entity
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.sharedDriveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.sharedDriveItem
summary: Update entity in shares
operationId: share.sharedDriveItem_UpdateSharedDriveItem
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.sharedDriveItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.sharedDriveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.sharedDriveItem
summary: Delete entity from shares
operationId: share.sharedDriveItem_DeleteSharedDriveItem
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/createdByUser':
get:
tags:
- shares.user
summary: Get createdByUser from shares
description: Identity of the user who created the item. Read-only.
operationId: share_GetCreatedGraphBPreUser
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/createdByUser/mailboxSettings':
get:
tags:
- shares.user
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: share.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- shares.user
summary: Update property mailboxSettings value.
operationId: share.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/createdByUser/serviceProvisioningErrors':
get:
tags:
- shares.user
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: share.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- shares.user
summary: Get the number of the resource
operationId: share.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: ConsistencyLevel
in: header
description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
style: simple
schema:
type: string
examples:
example-1:
description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
value: eventual
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/driveItem':
get:
tags:
- shares.driveItem
summary: Accessing shared DriveItems
description: 'Access a shared DriveItem or a collection of shared items by using a shareId or sharing URL. To use a sharing URL with this API, your app needs to transform the URL into a sharing token.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/shares-get?view=graph-rest-1.0
operationId: share_GetDriveItem
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/driveItem/content':
get:
tags:
- shares.driveItem
summary: Get content for the navigation property driveItem from shares
description: 'The content stream, if the item represents a file.'
operationId: share_GetDriveItemContent
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- shares.driveItem
summary: Update content for the navigation property driveItem in shares
description: 'The content stream, if the item represents a file.'
operationId: share_SetDriveItemContent
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- shares.driveItem
summary: Delete content for the navigation property driveItem in shares
description: 'The content stream, if the item represents a file.'
operationId: share_DeleteDriveItemContent
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/items':
get:
tags:
- shares.driveItem
summary: Get items from shares
description: All driveItems contained in the sharing root. This collection cannot be enumerated.
operationId: share_ListItem
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/items/{driveItem-id}':
get:
tags:
- shares.driveItem
summary: Get items from shares
description: All driveItems contained in the sharing root. This collection cannot be enumerated.
operationId: share_GetItem
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/items/{driveItem-id}/content':
get:
tags:
- shares.driveItem
summary: Get content for the navigation property items from shares
description: 'The content stream, if the item represents a file.'
operationId: share_GetItemsContent
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- shares.driveItem
summary: Update content for the navigation property items in shares
description: 'The content stream, if the item represents a file.'
operationId: share_SetItemsContent
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- shares.driveItem
summary: Delete content for the navigation property items in shares
description: 'The content stream, if the item represents a file.'
operationId: share_DeleteItemsContent
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/items/$count':
get:
tags:
- shares.driveItem
summary: Get the number of the resource
operationId: share.item_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/lastModifiedByUser':
get:
tags:
- shares.user
summary: Get lastModifiedByUser from shares
description: Identity of the user who last modified the item. Read-only.
operationId: share_GetLastModifiedGraphBPreUser
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/lastModifiedByUser/mailboxSettings':
get:
tags:
- shares.user
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: share.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- shares.user
summary: Update property mailboxSettings value.
operationId: share.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- shares.user
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: share.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- shares.user
summary: Get the number of the resource
operationId: share.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list':
get:
tags:
- shares.list
summary: Get list from shares
description: Used to access the underlying list
operationId: share_GetList
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.list'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.list
summary: Update the navigation property list in shares
operationId: share_UpdateList
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.list'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.list'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.list
summary: Delete navigation property list for shares
operationId: share_DeleteList
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/columns':
get:
tags:
- shares.list
summary: Get columns from shares
description: The collection of field definitions for this list.
operationId: share.list_ListColumn
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.columnDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- shares.list
summary: Create new navigation property to columns for shares
operationId: share.list_CreateColumn
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/columns/{columnDefinition-id}':
get:
tags:
- shares.list
summary: Get columns from shares
description: The collection of field definitions for this list.
operationId: share.list_GetColumn
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.list
summary: Update the navigation property columns in shares
operationId: share.list_UpdateColumn
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.list
summary: Delete navigation property columns for shares
operationId: share.list_DeleteColumn
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/columns/{columnDefinition-id}/sourceColumn':
get:
tags:
- shares.list
summary: Get sourceColumn from shares
description: The source column for the content type column.
operationId: share.list.column_GetSourceColumn
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/columns/$count':
get:
tags:
- shares.list
summary: Get the number of the resource
operationId: share.list.column_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/contentTypes':
get:
tags:
- shares.list
summary: Get contentTypes from shares
description: The collection of content types present in this list.
operationId: share.list_ListContentType
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.contentTypeCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- shares.list
summary: Create new navigation property to contentTypes for shares
operationId: share.list_CreateContentType
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}':
get:
tags:
- shares.list
summary: Get contentTypes from shares
description: The collection of content types present in this list.
operationId: share.list_GetContentType
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.list
summary: Update the navigation property contentTypes in shares
operationId: share.list_UpdateContentType
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.list
summary: Delete navigation property contentTypes for shares
operationId: share.list_DeleteContentType
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/base':
get:
tags:
- shares.list
summary: Get base from shares
description: Parent contentType from which this content type is derived.
operationId: share.list.contentType_GetBase
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/baseTypes':
get:
tags:
- shares.list
summary: Get baseTypes from shares
description: The collection of content types that are ancestors of this content type.
operationId: share.list.contentType_ListBaseType
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.contentTypeCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/baseTypes/{contentType-id1}':
get:
tags:
- shares.list
summary: Get baseTypes from shares
description: The collection of content types that are ancestors of this content type.
operationId: share.list.contentType_GetBaseType
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: contentType-id1
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/baseTypes/$count':
get:
tags:
- shares.list
summary: Get the number of the resource
operationId: share.list.contentType.baseType_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columnLinks':
get:
tags:
- shares.list
summary: Get columnLinks from shares
description: The collection of columns that are required by this content type.
operationId: share.list.contentType_ListColumnLink
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.columnLinkCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- shares.list
summary: Create new navigation property to columnLinks for shares
operationId: share.list.contentType_CreateColumnLink
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columnLinks/{columnLink-id}':
get:
tags:
- shares.list
summary: Get columnLinks from shares
description: The collection of columns that are required by this content type.
operationId: share.list.contentType_GetColumnLink
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnLink-id
in: path
description: The unique identifier of columnLink
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnLink
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.list
summary: Update the navigation property columnLinks in shares
operationId: share.list.contentType_UpdateColumnLink
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnLink-id
in: path
description: The unique identifier of columnLink
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnLink
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.list
summary: Delete navigation property columnLinks for shares
operationId: share.list.contentType_DeleteColumnLink
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnLink-id
in: path
description: The unique identifier of columnLink
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnLink
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columnLinks/$count':
get:
tags:
- shares.list
summary: Get the number of the resource
operationId: share.list.contentType.columnLink_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columnPositions':
get:
tags:
- shares.list
summary: Get columnPositions from shares
description: Column order information in a content type.
operationId: share.list.contentType_ListColumnPosition
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.columnDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columnPositions/{columnDefinition-id}':
get:
tags:
- shares.list
summary: Get columnPositions from shares
description: Column order information in a content type.
operationId: share.list.contentType_GetColumnPosition
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columnPositions/$count':
get:
tags:
- shares.list
summary: Get the number of the resource
operationId: share.list.contentType.columnPosition_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columns':
get:
tags:
- shares.list
summary: Get columns from shares
description: The collection of column definitions for this content type.
operationId: share.list.contentType_ListColumn
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.columnDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- shares.list
summary: Create new navigation property to columns for shares
operationId: share.list.contentType_CreateColumn
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columns/{columnDefinition-id}':
get:
tags:
- shares.list
summary: Get columns from shares
description: The collection of column definitions for this content type.
operationId: share.list.contentType_GetColumn
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.list
summary: Update the navigation property columns in shares
operationId: share.list.contentType_UpdateColumn
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.list
summary: Delete navigation property columns for shares
operationId: share.list.contentType_DeleteColumn
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columns/{columnDefinition-id}/sourceColumn':
get:
tags:
- shares.list
summary: Get sourceColumn from shares
description: The source column for the content type column.
operationId: share.list.contentType.column_GetSourceColumn
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columns/$count':
get:
tags:
- shares.list
summary: Get the number of the resource
operationId: share.list.contentType.column_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/microsoft.graph.associateWithHubSites':
post:
tags:
- shares.list
summary: Invoke action associateWithHubSites
description: Associate a published content type present in a content type hub with a list of hub sites.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-associatewithhubsites?view=graph-rest-1.0
operationId: share.list.contentType_associateGraphWPreHubSite
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
hubSiteUrls:
type: array
items:
type: string
propagateToExistingLists:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/microsoft.graph.copyToDefaultContentLocation':
post:
tags:
- shares.list
summary: Invoke action copyToDefaultContentLocation
description: Copy a file to a default content location in a content type. The file can then be added as a default file or template via a POST operation.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-copytodefaultcontentlocation?view=graph-rest-1.0
operationId: share.list.contentType_copyToDefaultContentLocation
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
sourceFile:
$ref: '#/components/schemas/microsoft.graph.itemReference'
destinationFileName:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/microsoft.graph.isPublished()':
get:
tags:
- shares.list
summary: Invoke function isPublished
description: Check the publishing status of a contentType in a content type hub site.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-ispublished?view=graph-rest-1.0
operationId: share.list.contentType_isPublished
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
responses:
2XX:
description: Success
content:
application/json:
schema:
type: object
properties:
value:
type: boolean
default: false
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/microsoft.graph.publish':
post:
tags:
- shares.list
summary: Invoke action publish
description: Publishes a contentType present in the content type hub site.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-publish?view=graph-rest-1.0
operationId: share.list.contentType_publish
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/microsoft.graph.unpublish':
post:
tags:
- shares.list
summary: Invoke action unpublish
description: Unpublish a contentType from a content type hub site.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-unpublish?view=graph-rest-1.0
operationId: share.list.contentType_unpublish
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/shares/{sharedDriveItem-id}/list/contentTypes/$count':
get:
tags:
- shares.list
summary: Get the number of the resource
operationId: share.list.contentType_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/contentTypes/microsoft.graph.addCopy':
post:
tags:
- shares.list
summary: Invoke action addCopy
description: Add a copy of a content type from a site to a list.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-addcopy?view=graph-rest-1.0
operationId: share.list.contentType_addCopy
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
contentType:
type: string
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/shares/{sharedDriveItem-id}/list/contentTypes/microsoft.graph.addCopyFromContentTypeHub':
post:
tags:
- shares.list
summary: Invoke action addCopyFromContentTypeHub
description: 'Add or sync a copy of a published content type from the content type hub to a target site or a list. This method is part of the content type publishing changes to optimize the syncing of published content types to sites and lists, effectively switching from a ''push everywhere'' to ''pull as needed'' approach. The method allows users to pull content types directly from the content type hub to a site or list. For more information, see contentType: getCompatibleHubContentTypes and the blog post Syntex Product Updates – August 2021.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-addcopyfromcontenttypehub?view=graph-rest-1.0
operationId: share.list.contentType_addCopyFromContentTypeHub
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
contentTypeId:
type: string
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/shares/{sharedDriveItem-id}/list/contentTypes/microsoft.graph.getCompatibleHubContentTypes()':
get:
tags:
- shares.list
summary: Invoke function getCompatibleHubContentTypes
description: 'Get a list of compatible content types from the content type hub that can be added to a target site or a list. This method is part of the content type publishing changes to optimize the syncing of published content types to sites and lists, effectively switching from a ''push everywhere'' to ''pull as needed'' approach. The method allows users to pull content types directly from the content type hub to a site or list. For more information, see contentType: addCopyFromContentTypeHub and the blog post Syntex Product Updates – August 2021.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-getcompatiblehubcontenttypes?view=graph-rest-1.0
operationId: share.list.contentType_getCompatibleHubContentType
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of contentType
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.contentType'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/list/createdByUser':
get:
tags:
- shares.list
summary: Get createdByUser from shares
description: Identity of the user who created the item. Read-only.
operationId: share.list_GetCreatedGraphBPreUser
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/createdByUser/mailboxSettings':
get:
tags:
- shares.list
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: share.list.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- shares.list
summary: Update property mailboxSettings value.
operationId: share.list.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/createdByUser/serviceProvisioningErrors':
get:
tags:
- shares.list
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: share.list.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/list/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- shares.list
summary: Get the number of the resource
operationId: share.list.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/drive':
get:
tags:
- shares.list
summary: Get drive from shares
description: Allows access to the list as a drive resource with driveItems. Only present on document libraries.
operationId: share.list_GetDrive
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/items':
get:
tags:
- shares.list
summary: Get items from shares
description: All items contained in the list.
operationId: share.list_ListItem
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.listItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- shares.list
summary: Create new navigation property to items for shares
operationId: share.list_CreateItem
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}':
get:
tags:
- shares.list
summary: Get items from shares
description: All items contained in the list.
operationId: share.list_GetItem
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.list
summary: Update the navigation property items in shares
operationId: share.list_UpdateItem
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.list
summary: Delete navigation property items for shares
operationId: share.list_DeleteItem
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/analytics':
get:
tags:
- shares.list
summary: Get analytics from shares
description: Analytics about the view activities that took place on this item.
operationId: share.list.item_GetAnalytic
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/createdByUser':
get:
tags:
- shares.list
summary: Get createdByUser from shares
description: Identity of the user who created the item. Read-only.
operationId: share.list.item_GetCreatedGraphBPreUser
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/createdByUser/mailboxSettings':
get:
tags:
- shares.list
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: share.list.item.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- shares.list
summary: Update property mailboxSettings value.
operationId: share.list.item.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/createdByUser/serviceProvisioningErrors':
get:
tags:
- shares.list
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: share.list.item.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- shares.list
summary: Get the number of the resource
operationId: share.list.item.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/documentSetVersions':
get:
tags:
- shares.list
summary: Get documentSetVersions from shares
description: Version information for a document set version created by a user.
operationId: share.list.item_ListDocumentSetVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.documentSetVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- shares.list
summary: Create new navigation property to documentSetVersions for shares
operationId: share.list.item_CreateDocumentSetVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/documentSetVersions/{documentSetVersion-id}':
get:
tags:
- shares.list
summary: Get documentSetVersions from shares
description: Version information for a document set version created by a user.
operationId: share.list.item_GetDocumentSetVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.list
summary: Update the navigation property documentSetVersions in shares
operationId: share.list.item_UpdateDocumentSetVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.list
summary: Delete navigation property documentSetVersions for shares
operationId: share.list.item_DeleteDocumentSetVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/documentSetVersions/{documentSetVersion-id}/fields':
get:
tags:
- shares.list
summary: Get fields from shares
description: A collection of the fields and values for this version of the list item.
operationId: share.list.item.documentSetVersion_GetField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.list
summary: Update the navigation property fields in shares
operationId: share.list.item.documentSetVersion_UpdateField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.list
summary: Delete navigation property fields for shares
operationId: share.list.item.documentSetVersion_DeleteField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/documentSetVersions/{documentSetVersion-id}/microsoft.graph.restore':
post:
tags:
- shares.list
summary: Invoke action restore
description: Restore a document set version.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/documentsetversion-restore?view=graph-rest-1.0
operationId: share.list.item.documentSetVersion_restore
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/documentSetVersions/$count':
get:
tags:
- shares.list
summary: Get the number of the resource
operationId: share.list.item.documentSetVersion_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/driveItem':
get:
tags:
- shares.list
summary: Get driveItem from shares
description: 'For document libraries, the driveItem relationship exposes the listItem as a driveItem'
operationId: share.list.item_GetDriveItem
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/driveItem/content':
get:
tags:
- shares.list
summary: Get content for the navigation property driveItem from shares
description: 'The content stream, if the item represents a file.'
operationId: share.list.item_GetDriveItemContent
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- shares.list
summary: Update content for the navigation property driveItem in shares
description: 'The content stream, if the item represents a file.'
operationId: share.list.item_SetDriveItemContent
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- shares.list
summary: Delete content for the navigation property driveItem in shares
description: 'The content stream, if the item represents a file.'
operationId: share.list.item_DeleteDriveItemContent
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/fields':
get:
tags:
- shares.list
summary: Get fields from shares
description: The values of the columns set on this list item.
operationId: share.list.item_GetField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.list
summary: Update the navigation property fields in shares
operationId: share.list.item_UpdateField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.list
summary: Delete navigation property fields for shares
operationId: share.list.item_DeleteField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/lastModifiedByUser':
get:
tags:
- shares.list
summary: Get lastModifiedByUser from shares
description: Identity of the user who last modified the item. Read-only.
operationId: share.list.item_GetLastModifiedGraphBPreUser
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/lastModifiedByUser/mailboxSettings':
get:
tags:
- shares.list
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: share.list.item.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- shares.list
summary: Update property mailboxSettings value.
operationId: share.list.item.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- shares.list
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: share.list.item.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- shares.list
summary: Get the number of the resource
operationId: share.list.item.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/microsoft.graph.createLink':
post:
tags:
- shares.list
summary: Invoke action createLink
operationId: share.list.item_createLink
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- shares.list
summary: Invoke function getActivitiesByInterval
operationId: share.list.item_getActivitiesGraphBPreInterval
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- shares.list
summary: Invoke function getActivitiesByInterval
operationId: share.list.item_getActivitiesGraphBPreInterval
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/permissions':
get:
tags:
- shares.list
summary: Get permissions from shares
description: The set of permissions for the item. Read-only. Nullable.
operationId: share.list.item_ListPermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- shares.list
summary: Create new navigation property to permissions for shares
operationId: share.list.item_CreatePermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/permissions/{permission-id}':
get:
tags:
- shares.list
summary: Get permissions from shares
description: The set of permissions for the item. Read-only. Nullable.
operationId: share.list.item_GetPermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.list
summary: Update the navigation property permissions in shares
operationId: share.list.item_UpdatePermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.list
summary: Delete navigation property permissions for shares
operationId: share.list.item_DeletePermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- shares.list
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: share.list.item.permission_grant
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/permissions/$count':
get:
tags:
- shares.list
summary: Get the number of the resource
operationId: share.list.item.permission_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/versions':
get:
tags:
- shares.list
summary: Get versions from shares
description: The list of previous versions of the list item.
operationId: share.list.item_ListVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.listItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- shares.list
summary: Create new navigation property to versions for shares
operationId: share.list.item_CreateVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/versions/{listItemVersion-id}':
get:
tags:
- shares.list
summary: Get versions from shares
description: The list of previous versions of the list item.
operationId: share.list.item_GetVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.list
summary: Update the navigation property versions in shares
operationId: share.list.item_UpdateVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.list
summary: Delete navigation property versions for shares
operationId: share.list.item_DeleteVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/versions/{listItemVersion-id}/fields':
get:
tags:
- shares.list
summary: Get fields from shares
description: A collection of the fields and values for this version of the list item.
operationId: share.list.item.version_GetField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.list
summary: Update the navigation property fields in shares
operationId: share.list.item.version_UpdateField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.list
summary: Delete navigation property fields for shares
operationId: share.list.item.version_DeleteField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/versions/{listItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- shares.list
summary: Invoke action restoreVersion
description: 'Restore a previous version of a ListItem to be the current version. This will create a new version with the contents of the previous version, but preserves all existing versions of the item.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/listitemversion-restore?view=graph-rest-1.0
operationId: share.list.item.version_restoreVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/shares/{sharedDriveItem-id}/list/items/{listItem-id}/versions/$count':
get:
tags:
- shares.list
summary: Get the number of the resource
operationId: share.list.item.version_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/items/microsoft.graph.delta()':
get:
tags:
- shares.list
summary: Invoke function delta
description: "Get newly created, updated, or deleted list items without having to perform a full read of the entire items collection. Your app begins by calling delta without any parameters.\r\nThe service starts enumerating the hierarchy of the list, returning pages of items, and either an @odata.nextLink or an @odata.deltaLink.\r\nYour app should continue calling with the @odata.nextLink until you see an @odata.deltaLink returned. After you received all the changes, you can apply them to your local state.\r\nTo check for changes in the future, call delta again with the @odata.deltaLink from the previous response. The delta feed shows the latest state for each item, not each change. If an item was renamed twice, it only shows up once, with its latest name.\r\nThe same item might appear more than once in a delta feed, for various reasons. You should use the last occurrence you see. Items with this property should be removed from your local state."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/listitem-delta?view=graph-rest-1.0
operationId: share.list.item_delta
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of listItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.listItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/list/items/microsoft.graph.delta(token=''{token}'')':
get:
tags:
- shares.list
summary: Invoke function delta
operationId: share.list.item_delta
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: token
in: path
description: 'Usage: token=''{token}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of listItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.listItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/list/lastModifiedByUser':
get:
tags:
- shares.list
summary: Get lastModifiedByUser from shares
description: Identity of the user who last modified the item. Read-only.
operationId: share.list_GetLastModifiedGraphBPreUser
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/lastModifiedByUser/mailboxSettings':
get:
tags:
- shares.list
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: share.list.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- shares.list
summary: Update property mailboxSettings value.
operationId: share.list.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- shares.list
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: share.list.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/list/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- shares.list
summary: Get the number of the resource
operationId: share.list.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/operations':
get:
tags:
- shares.list
summary: Get operations from shares
description: The collection of long-running operations on the list.
operationId: share.list_ListOperation
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.richLongRunningOperationCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- shares.list
summary: Create new navigation property to operations for shares
operationId: share.list_CreateOperation
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/operations/{richLongRunningOperation-id}':
get:
tags:
- shares.list
summary: Get operations from shares
description: The collection of long-running operations on the list.
operationId: share.list_GetOperation
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: richLongRunningOperation-id
in: path
description: The unique identifier of richLongRunningOperation
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: richLongRunningOperation
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.list
summary: Update the navigation property operations in shares
operationId: share.list_UpdateOperation
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: richLongRunningOperation-id
in: path
description: The unique identifier of richLongRunningOperation
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: richLongRunningOperation
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.list
summary: Delete navigation property operations for shares
operationId: share.list_DeleteOperation
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: richLongRunningOperation-id
in: path
description: The unique identifier of richLongRunningOperation
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: richLongRunningOperation
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/operations/$count':
get:
tags:
- shares.list
summary: Get the number of the resource
operationId: share.list.operation_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/permissions':
get:
tags:
- shares.list
summary: Get permissions from shares
description: The set of permissions for the item. Read-only. Nullable.
operationId: share.list_ListPermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- shares.list
summary: Create new navigation property to permissions for shares
operationId: share.list_CreatePermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/permissions/{permission-id}':
get:
tags:
- shares.list
summary: Get permissions from shares
description: The set of permissions for the item. Read-only. Nullable.
operationId: share.list_GetPermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.list
summary: Update the navigation property permissions in shares
operationId: share.list_UpdatePermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.list
summary: Delete navigation property permissions for shares
operationId: share.list_DeletePermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- shares.list
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: share.list.permission_grant
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/list/permissions/$count':
get:
tags:
- shares.list
summary: Get the number of the resource
operationId: share.list.permission_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/list/subscriptions':
get:
tags:
- shares.list
summary: Get subscriptions from shares
description: The set of subscriptions on the list.
operationId: share.list_ListSubscription
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.subscriptionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- shares.list
summary: Create new navigation property to subscriptions for shares
operationId: share.list_CreateSubscription
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/subscriptions/{subscription-id}':
get:
tags:
- shares.list
summary: Get subscriptions from shares
description: The set of subscriptions on the list.
operationId: share.list_GetSubscription
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.list
summary: Update the navigation property subscriptions in shares
operationId: share.list_UpdateSubscription
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.list
summary: Delete navigation property subscriptions for shares
operationId: share.list_DeleteSubscription
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/list/subscriptions/{subscription-id}/microsoft.graph.reauthorize':
post:
tags:
- shares.list
summary: Invoke action reauthorize
description: Reauthorize a subscription when you receive a reauthorizationRequired challenge.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/subscription-reauthorize?view=graph-rest-1.0
operationId: share.list.subscription_reauthorize
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/shares/{sharedDriveItem-id}/list/subscriptions/$count':
get:
tags:
- shares.list
summary: Get the number of the resource
operationId: share.list.subscription_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/listItem':
get:
tags:
- shares.listItem
summary: Get listItem from shares
description: Used to access the underlying listItem
operationId: share_GetListItem
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.listItem
summary: Update the navigation property listItem in shares
operationId: share_UpdateListItem
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.listItem
summary: Delete navigation property listItem for shares
operationId: share_DeleteListItem
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/listItem/analytics':
get:
tags:
- shares.listItem
summary: Get analytics from shares
description: Analytics about the view activities that took place on this item.
operationId: share.listItem_GetAnalytic
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/listItem/createdByUser':
get:
tags:
- shares.listItem
summary: Get createdByUser from shares
description: Identity of the user who created the item. Read-only.
operationId: share.listItem_GetCreatedGraphBPreUser
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/listItem/createdByUser/mailboxSettings':
get:
tags:
- shares.listItem
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: share.listItem.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- shares.listItem
summary: Update property mailboxSettings value.
operationId: share.listItem.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/listItem/createdByUser/serviceProvisioningErrors':
get:
tags:
- shares.listItem
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: share.listItem.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/listItem/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- shares.listItem
summary: Get the number of the resource
operationId: share.listItem.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/listItem/documentSetVersions':
get:
tags:
- shares.listItem
summary: Get documentSetVersions from shares
description: Version information for a document set version created by a user.
operationId: share.listItem_ListDocumentSetVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.documentSetVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- shares.listItem
summary: Create new navigation property to documentSetVersions for shares
operationId: share.listItem_CreateDocumentSetVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/listItem/documentSetVersions/{documentSetVersion-id}':
get:
tags:
- shares.listItem
summary: Get documentSetVersions from shares
description: Version information for a document set version created by a user.
operationId: share.listItem_GetDocumentSetVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.listItem
summary: Update the navigation property documentSetVersions in shares
operationId: share.listItem_UpdateDocumentSetVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.listItem
summary: Delete navigation property documentSetVersions for shares
operationId: share.listItem_DeleteDocumentSetVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/listItem/documentSetVersions/{documentSetVersion-id}/fields':
get:
tags:
- shares.listItem
summary: Get fields from shares
description: A collection of the fields and values for this version of the list item.
operationId: share.listItem.documentSetVersion_GetField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.listItem
summary: Update the navigation property fields in shares
operationId: share.listItem.documentSetVersion_UpdateField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.listItem
summary: Delete navigation property fields for shares
operationId: share.listItem.documentSetVersion_DeleteField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/listItem/documentSetVersions/{documentSetVersion-id}/microsoft.graph.restore':
post:
tags:
- shares.listItem
summary: Invoke action restore
description: Restore a document set version.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/documentsetversion-restore?view=graph-rest-1.0
operationId: share.listItem.documentSetVersion_restore
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/shares/{sharedDriveItem-id}/listItem/documentSetVersions/$count':
get:
tags:
- shares.listItem
summary: Get the number of the resource
operationId: share.listItem.documentSetVersion_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/listItem/driveItem':
get:
tags:
- shares.listItem
summary: Get driveItem from shares
description: 'For document libraries, the driveItem relationship exposes the listItem as a driveItem'
operationId: share.listItem_GetDriveItem
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/listItem/driveItem/content':
get:
tags:
- shares.listItem
summary: Get content for the navigation property driveItem from shares
description: 'The content stream, if the item represents a file.'
operationId: share.listItem_GetDriveItemContent
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- shares.listItem
summary: Update content for the navigation property driveItem in shares
description: 'The content stream, if the item represents a file.'
operationId: share.listItem_SetDriveItemContent
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- shares.listItem
summary: Delete content for the navigation property driveItem in shares
description: 'The content stream, if the item represents a file.'
operationId: share.listItem_DeleteDriveItemContent
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/listItem/fields':
get:
tags:
- shares.listItem
summary: Get fields from shares
description: The values of the columns set on this list item.
operationId: share.listItem_GetField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.listItem
summary: Update the navigation property fields in shares
operationId: share.listItem_UpdateField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.listItem
summary: Delete navigation property fields for shares
operationId: share.listItem_DeleteField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/listItem/lastModifiedByUser':
get:
tags:
- shares.listItem
summary: Get lastModifiedByUser from shares
description: Identity of the user who last modified the item. Read-only.
operationId: share.listItem_GetLastModifiedGraphBPreUser
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/listItem/lastModifiedByUser/mailboxSettings':
get:
tags:
- shares.listItem
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: share.listItem.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- shares.listItem
summary: Update property mailboxSettings value.
operationId: share.listItem.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/listItem/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- shares.listItem
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: share.listItem.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/listItem/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- shares.listItem
summary: Get the number of the resource
operationId: share.listItem.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/listItem/microsoft.graph.createLink':
post:
tags:
- shares.listItem
summary: Invoke action createLink
operationId: share.listItem_createLink
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/shares/{sharedDriveItem-id}/listItem/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- shares.listItem
summary: Invoke function getActivitiesByInterval
operationId: share.listItem_getActivitiesGraphBPreInterval
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/listItem/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- shares.listItem
summary: Invoke function getActivitiesByInterval
operationId: share.listItem_getActivitiesGraphBPreInterval
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/listItem/permissions':
get:
tags:
- shares.listItem
summary: Get permissions from shares
description: The set of permissions for the item. Read-only. Nullable.
operationId: share.listItem_ListPermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- shares.listItem
summary: Create new navigation property to permissions for shares
operationId: share.listItem_CreatePermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/listItem/permissions/{permission-id}':
get:
tags:
- shares.listItem
summary: Get permissions from shares
description: The set of permissions for the item. Read-only. Nullable.
operationId: share.listItem_GetPermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.listItem
summary: Update the navigation property permissions in shares
operationId: share.listItem_UpdatePermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.listItem
summary: Delete navigation property permissions for shares
operationId: share.listItem_DeletePermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/listItem/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- shares.listItem
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: share.listItem.permission_grant
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/listItem/permissions/$count':
get:
tags:
- shares.listItem
summary: Get the number of the resource
operationId: share.listItem.permission_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/listItem/versions':
get:
tags:
- shares.listItem
summary: Get versions from shares
description: The list of previous versions of the list item.
operationId: share.listItem_ListVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.listItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- shares.listItem
summary: Create new navigation property to versions for shares
operationId: share.listItem_CreateVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/listItem/versions/{listItemVersion-id}':
get:
tags:
- shares.listItem
summary: Get versions from shares
description: The list of previous versions of the list item.
operationId: share.listItem_GetVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.listItem
summary: Update the navigation property versions in shares
operationId: share.listItem_UpdateVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.listItem
summary: Delete navigation property versions for shares
operationId: share.listItem_DeleteVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/listItem/versions/{listItemVersion-id}/fields':
get:
tags:
- shares.listItem
summary: Get fields from shares
description: A collection of the fields and values for this version of the list item.
operationId: share.listItem.version_GetField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.listItem
summary: Update the navigation property fields in shares
operationId: share.listItem.version_UpdateField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.listItem
summary: Delete navigation property fields for shares
operationId: share.listItem.version_DeleteField
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/listItem/versions/{listItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- shares.listItem
summary: Invoke action restoreVersion
description: 'Restore a previous version of a ListItem to be the current version. This will create a new version with the contents of the previous version, but preserves all existing versions of the item.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/listitemversion-restore?view=graph-rest-1.0
operationId: share.listItem.version_restoreVersion
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/shares/{sharedDriveItem-id}/listItem/versions/$count':
get:
tags:
- shares.listItem
summary: Get the number of the resource
operationId: share.listItem.version_GetCount
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/permission':
get:
tags:
- shares.permission
summary: Get permission from shares
description: Used to access the permission representing the underlying sharing link
operationId: share_GetPermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- shares.permission
summary: Update the navigation property permission in shares
operationId: share_UpdatePermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- shares.permission
summary: Delete navigation property permission for shares
operationId: share_DeletePermission
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/permission/microsoft.graph.grant':
post:
tags:
- shares.permission
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: share.permission_grant
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/shares/{sharedDriveItem-id}/root':
get:
tags:
- shares.driveItem
summary: Get root from shares
description: Used to access the underlying driveItem. Deprecated -- use driveItem instead.
operationId: share_GetRoot
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/shares/{sharedDriveItem-id}/root/content':
get:
tags:
- shares.driveItem
summary: Get content for the navigation property root from shares
description: 'The content stream, if the item represents a file.'
operationId: share_GetRootContent
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- shares.driveItem
summary: Update content for the navigation property root in shares
description: 'The content stream, if the item represents a file.'
operationId: share_SetRootContent
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- shares.driveItem
summary: Delete content for the navigation property root in shares
description: 'The content stream, if the item represents a file.'
operationId: share_DeleteRootContent
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/shares/{sharedDriveItem-id}/site':
get:
tags:
- shares.site
summary: Get site from shares
description: Used to access the underlying site
operationId: share_GetSite
parameters:
- name: sharedDriveItem-id
in: path
description: The unique identifier of sharedDriveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: sharedDriveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.site'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/shares/$count:
get:
tags:
- shares.sharedDriveItem
summary: Get the number of the resource
operationId: share_GetCount
parameters:
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drive':
get:
tags:
- users.drive
summary: Get drive from users
description: The user's OneDrive. Read-only.
operationId: user_GetDrive
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives':
get:
tags:
- users.drive
summary: Get drives from users
description: A collection of drives available for this user. Read-only.
operationId: user_ListDrive
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to drives for users
operationId: user_CreateDrive
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}':
get:
tags:
- users.drive
summary: Get drives from users
description: A collection of drives available for this user. Read-only.
operationId: user_GetDrive
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property drives in users
operationId: user_UpdateDrive
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property drives for users
operationId: user_DeleteDrive
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/bundles':
get:
tags:
- users.drive
summary: Get bundles from users
description: Collection of bundles (albums and multi-select-shared sets of items). Only in personal OneDrive.
operationId: user.drive_ListBundle
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to bundles for users
operationId: user.drive_CreateBundle
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/bundles/{driveItem-id}':
get:
tags:
- users.drive
summary: Get bundles from users
description: Collection of bundles (albums and multi-select-shared sets of items). Only in personal OneDrive.
operationId: user.drive_GetBundle
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/bundles/{driveItem-id}/content':
get:
tags:
- users.drive
summary: Get content for the navigation property bundles from users
description: 'The content stream, if the item represents a file.'
operationId: user.drive_GetBundlesContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- users.drive
summary: Update content for the navigation property bundles in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive_SetBundlesContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- users.drive
summary: Delete content for the navigation property bundles in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive_DeleteBundlesContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/bundles/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.bundle_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/createdByUser':
get:
tags:
- users.drive
summary: Get createdByUser from users
description: Identity of the user who created the item. Read-only.
operationId: user.drive_GetCreatedGraphBPreUser
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/createdByUser/mailboxSettings':
get:
tags:
- users.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: user.drive.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- users.drive
summary: Update property mailboxSettings value.
operationId: user.drive.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/createdByUser/serviceProvisioningErrors':
get:
tags:
- users.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: user.drive.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/following':
get:
tags:
- users.drive
summary: Get following from users
description: The list of items the user is following. Only in OneDrive for Business.
operationId: user.drive_ListFollowing
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/following/{driveItem-id}':
get:
tags:
- users.drive
summary: Get following from users
description: The list of items the user is following. Only in OneDrive for Business.
operationId: user.drive_GetFollowing
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/following/{driveItem-id}/content':
get:
tags:
- users.drive
summary: Get content for the navigation property following from users
description: 'The content stream, if the item represents a file.'
operationId: user.drive_GetFollowingContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- users.drive
summary: Update content for the navigation property following in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive_SetFollowingContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- users.drive
summary: Delete content for the navigation property following in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive_DeleteFollowingContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/following/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.following_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items':
get:
tags:
- users.drive
summary: Get items from users
description: All items contained in the drive. Read-only. Nullable.
operationId: user.drive_ListItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to items for users
operationId: user.drive_CreateItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}':
get:
tags:
- users.drive
summary: Get items from users
description: All items contained in the drive. Read-only. Nullable.
operationId: user.drive_GetItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property items in users
operationId: user.drive_UpdateItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property items for users
operationId: user.drive_DeleteItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/analytics':
get:
tags:
- users.drive
summary: Get analytics from users
description: Analytics about the view activities that took place on this item.
operationId: user.drive.item_GetAnalytic
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property analytics in users
operationId: user.drive.item_UpdateAnalytic
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property analytics for users
operationId: user.drive.item_DeleteAnalytic
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/analytics/allTime':
get:
tags:
- users.drive
summary: Get allTime from users
operationId: user.drive.item.analytic_GetAllTime
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats':
get:
tags:
- users.drive
summary: Get itemActivityStats from users
operationId: user.drive.item.analytic_ListItemActivityStat
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.itemActivityStatCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to itemActivityStats for users
operationId: user.drive.item.analytic_CreateItemActivityStat
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}':
get:
tags:
- users.drive
summary: Get itemActivityStats from users
operationId: user.drive.item.analytic_GetItemActivityStat
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property itemActivityStats in users
operationId: user.drive.item.analytic_UpdateItemActivityStat
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property itemActivityStats for users
operationId: user.drive.item.analytic_DeleteItemActivityStat
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities':
get:
tags:
- users.drive
summary: Get activities from users
description: Exposes the itemActivities represented in this itemActivityStat resource.
operationId: user.drive.item.analytic.itemActivityStat_ListActivity
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.itemActivityCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to activities for users
operationId: user.drive.item.analytic.itemActivityStat_CreateActivity
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}':
get:
tags:
- users.drive
summary: Get activities from users
description: Exposes the itemActivities represented in this itemActivityStat resource.
operationId: user.drive.item.analytic.itemActivityStat_GetActivity
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property activities in users
operationId: user.drive.item.analytic.itemActivityStat_UpdateActivity
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property activities for users
operationId: user.drive.item.analytic.itemActivityStat_DeleteActivity
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}/driveItem':
get:
tags:
- users.drive
summary: Get driveItem from users
description: Exposes the driveItem that was the target of this activity.
operationId: user.drive.item.analytic.itemActivityStat.activity_GetDriveItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}/driveItem/content':
get:
tags:
- users.drive
summary: Get content for the navigation property driveItem from users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.item.analytic.itemActivityStat.activity_GetDriveItemContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- users.drive
summary: Update content for the navigation property driveItem in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.item.analytic.itemActivityStat.activity_SetDriveItemContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- users.drive
summary: Delete content for the navigation property driveItem in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.item.analytic.itemActivityStat.activity_DeleteDriveItemContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.item.analytic.itemActivityStat.activity_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/analytics/itemActivityStats/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.item.analytic.itemActivityStat_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/analytics/lastSevenDays':
get:
tags:
- users.drive
summary: Get lastSevenDays from users
operationId: user.drive.item.analytic_GetLastSevenDay
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/children':
get:
tags:
- users.drive
summary: Get children from users
description: Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.
operationId: user.drive.item_ListChild
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to children for users
operationId: user.drive.item_CreateChild
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/children/{driveItem-id1}':
get:
tags:
- users.drive
summary: Get children from users
description: Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.
operationId: user.drive.item_GetChild
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItem-id1
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/children/{driveItem-id1}/content':
get:
tags:
- users.drive
summary: Get content for the navigation property children from users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.item_GetChildrenContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItem-id1
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- users.drive
summary: Update content for the navigation property children in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.item_SetChildrenContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItem-id1
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- users.drive
summary: Delete content for the navigation property children in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.item_DeleteChildrenContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItem-id1
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/children/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.item.child_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/content':
get:
tags:
- users.drive
summary: Get content for the navigation property items from users
description: 'The content stream, if the item represents a file.'
operationId: user.drive_GetItemsContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- users.drive
summary: Update content for the navigation property items in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive_SetItemsContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- users.drive
summary: Delete content for the navigation property items in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive_DeleteItemsContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/createdByUser':
get:
tags:
- users.drive
summary: Get createdByUser from users
description: Identity of the user who created the item. Read-only.
operationId: user.drive.item_GetCreatedGraphBPreUser
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/createdByUser/mailboxSettings':
get:
tags:
- users.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: user.drive.item.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- users.drive
summary: Update property mailboxSettings value.
operationId: user.drive.item.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/createdByUser/serviceProvisioningErrors':
get:
tags:
- users.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: user.drive.item.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.item.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/lastModifiedByUser':
get:
tags:
- users.drive
summary: Get lastModifiedByUser from users
description: Identity of the user who last modified the item. Read-only.
operationId: user.drive.item_GetLastModifiedGraphBPreUser
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/lastModifiedByUser/mailboxSettings':
get:
tags:
- users.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: user.drive.item.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- users.drive
summary: Update property mailboxSettings value.
operationId: user.drive.item.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- users.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: user.drive.item.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.item.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem':
get:
tags:
- users.drive
summary: Get listItem from users
description: 'For drives in SharePoint, the associated document library list item. Read-only. Nullable.'
operationId: user.drive.item_GetListItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property listItem in users
operationId: user.drive.item_UpdateListItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property listItem for users
operationId: user.drive.item_DeleteListItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/analytics':
get:
tags:
- users.drive
summary: Get analytics from users
description: Analytics about the view activities that took place on this item.
operationId: user.drive.item.listItem_GetAnalytic
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/createdByUser':
get:
tags:
- users.drive
summary: Get createdByUser from users
description: Identity of the user who created the item. Read-only.
operationId: user.drive.item.listItem_GetCreatedGraphBPreUser
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/createdByUser/mailboxSettings':
get:
tags:
- users.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: user.drive.item.listItem.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- users.drive
summary: Update property mailboxSettings value.
operationId: user.drive.item.listItem.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/createdByUser/serviceProvisioningErrors':
get:
tags:
- users.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: user.drive.item.listItem.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.item.listItem.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/documentSetVersions':
get:
tags:
- users.drive
summary: Get documentSetVersions from users
description: Version information for a document set version created by a user.
operationId: user.drive.item.listItem_ListDocumentSetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.documentSetVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to documentSetVersions for users
operationId: user.drive.item.listItem_CreateDocumentSetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/documentSetVersions/{documentSetVersion-id}':
get:
tags:
- users.drive
summary: Get documentSetVersions from users
description: Version information for a document set version created by a user.
operationId: user.drive.item.listItem_GetDocumentSetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property documentSetVersions in users
operationId: user.drive.item.listItem_UpdateDocumentSetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property documentSetVersions for users
operationId: user.drive.item.listItem_DeleteDocumentSetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/documentSetVersions/{documentSetVersion-id}/fields':
get:
tags:
- users.drive
summary: Get fields from users
description: A collection of the fields and values for this version of the list item.
operationId: user.drive.item.listItem.documentSetVersion_GetField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property fields in users
operationId: user.drive.item.listItem.documentSetVersion_UpdateField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property fields for users
operationId: user.drive.item.listItem.documentSetVersion_DeleteField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/documentSetVersions/{documentSetVersion-id}/microsoft.graph.restore':
post:
tags:
- users.drive
summary: Invoke action restore
description: Restore a document set version.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/documentsetversion-restore?view=graph-rest-1.0
operationId: user.drive.item.listItem.documentSetVersion_restore
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/documentSetVersions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.item.listItem.documentSetVersion_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/driveItem':
get:
tags:
- users.drive
summary: Get driveItem from users
description: 'For document libraries, the driveItem relationship exposes the listItem as a driveItem'
operationId: user.drive.item.listItem_GetDriveItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/driveItem/content':
get:
tags:
- users.drive
summary: Get content for the navigation property driveItem from users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.item.listItem_GetDriveItemContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- users.drive
summary: Update content for the navigation property driveItem in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.item.listItem_SetDriveItemContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- users.drive
summary: Delete content for the navigation property driveItem in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.item.listItem_DeleteDriveItemContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/fields':
get:
tags:
- users.drive
summary: Get fields from users
description: The values of the columns set on this list item.
operationId: user.drive.item.listItem_GetField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property fields in users
operationId: user.drive.item.listItem_UpdateField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property fields for users
operationId: user.drive.item.listItem_DeleteField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/lastModifiedByUser':
get:
tags:
- users.drive
summary: Get lastModifiedByUser from users
description: Identity of the user who last modified the item. Read-only.
operationId: user.drive.item.listItem_GetLastModifiedGraphBPreUser
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/lastModifiedByUser/mailboxSettings':
get:
tags:
- users.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: user.drive.item.listItem.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- users.drive
summary: Update property mailboxSettings value.
operationId: user.drive.item.listItem.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- users.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: user.drive.item.listItem.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.item.listItem.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/microsoft.graph.createLink':
post:
tags:
- users.drive
summary: Invoke action createLink
operationId: user.drive.item.listItem_createLink
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- users.drive
summary: Invoke function getActivitiesByInterval
operationId: user.drive.item.listItem_getActivitiesGraphBPreInterval
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- users.drive
summary: Invoke function getActivitiesByInterval
operationId: user.drive.item.listItem_getActivitiesGraphBPreInterval
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/permissions':
get:
tags:
- users.drive
summary: Get permissions from users
description: The set of permissions for the item. Read-only. Nullable.
operationId: user.drive.item.listItem_ListPermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to permissions for users
operationId: user.drive.item.listItem_CreatePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/permissions/{permission-id}':
get:
tags:
- users.drive
summary: Get permissions from users
description: The set of permissions for the item. Read-only. Nullable.
operationId: user.drive.item.listItem_GetPermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property permissions in users
operationId: user.drive.item.listItem_UpdatePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property permissions for users
operationId: user.drive.item.listItem_DeletePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- users.drive
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: user.drive.item.listItem.permission_grant
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/permissions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.item.listItem.permission_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/versions':
get:
tags:
- users.drive
summary: Get versions from users
description: The list of previous versions of the list item.
operationId: user.drive.item.listItem_ListVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.listItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to versions for users
operationId: user.drive.item.listItem_CreateVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/versions/{listItemVersion-id}':
get:
tags:
- users.drive
summary: Get versions from users
description: The list of previous versions of the list item.
operationId: user.drive.item.listItem_GetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property versions in users
operationId: user.drive.item.listItem_UpdateVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property versions for users
operationId: user.drive.item.listItem_DeleteVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/versions/{listItemVersion-id}/fields':
get:
tags:
- users.drive
summary: Get fields from users
description: A collection of the fields and values for this version of the list item.
operationId: user.drive.item.listItem.version_GetField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property fields in users
operationId: user.drive.item.listItem.version_UpdateField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property fields for users
operationId: user.drive.item.listItem.version_DeleteField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/versions/{listItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- users.drive
summary: Invoke action restoreVersion
description: 'Restore a previous version of a ListItem to be the current version. This will create a new version with the contents of the previous version, but preserves all existing versions of the item.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/listitemversion-restore?view=graph-rest-1.0
operationId: user.drive.item.listItem.version_restoreVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/listItem/versions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.item.listItem.version_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.assignSensitivityLabel':
post:
tags:
- users.drive
summary: Invoke action assignSensitivityLabel
description: 'Asynchronously assign a sensitivity label to a driveItem. This API is part of the Microsoft SharePoint and OneDrive APIs that perform advanced premium administrative functions, and is considered as protected. Protected APIs require you to have more validations, beyond permission and consent, before you can use them. For more information about sensitivity labels from an administrator''s perspective, see Enable sensitivity labels for Office files in SharePoint and OneDrive. This API applies sensitivity labels to files at rest. Office clients don''t apply watermarks, headers, or footers to files that contain the label information. For more information about sensitivity labels from an administrator''s perspective, see Enable sensitivity labels for Office files in SharePoint and OneDrive.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-assignsensitivitylabel?view=graph-rest-1.0
operationId: user.drive.item_assignSensitivityLabel
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
sensitivityLabelId:
type: string
nullable: true
assignmentMethod:
$ref: '#/components/schemas/microsoft.graph.sensitivityLabelAssignmentMethod'
justificationText:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.checkin':
post:
tags:
- users.drive
summary: Invoke action checkin
description: 'Check in a checked out driveItem resource, which makes the version of the document available to others.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-checkin?view=graph-rest-1.0
operationId: user.drive.item_checkin
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
checkInAs:
type: string
nullable: true
comment:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.checkout':
post:
tags:
- users.drive
summary: Invoke action checkout
description: '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.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-checkout?view=graph-rest-1.0
operationId: user.drive.item_checkout
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.copy':
post:
tags:
- users.drive
summary: Invoke action copy
operationId: user.drive.item_copy
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
name:
type: string
nullable: true
parentReference:
$ref: '#/components/schemas/microsoft.graph.itemReference'
childrenOnly:
type: boolean
default: false
nullable: true
includeAllVersionHistory:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.createLink':
post:
tags:
- users.drive
summary: Invoke action createLink
description: "Create a link to share a driveItem driveItem. The createLink action creates a new sharing link if the specified link type doesn't already exist for the calling application.\r\nIf a sharing link of the specified type already exists for the app, the existing sharing link is returned. DriveItem resources inherit sharing permissions from their ancestors."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-createlink?view=graph-rest-1.0
operationId: user.drive.item_createLink
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.createUploadSession':
post:
tags:
- users.drive
summary: Invoke action createUploadSession
operationId: user.drive.item_createUploadSession
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
item:
$ref: '#/components/schemas/microsoft.graph.driveItemUploadableProperties'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.uploadSession'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.delta()':
get:
tags:
- users.drive
summary: Invoke function delta
description: "Track changes in a driveItem and its children over time. Your app begins by calling delta without any parameters.\r\nThe service starts enumerating the drive's hierarchy, returning pages of items and either an @odata.nextLink or an @odata.deltaLink, as described below.\r\nYour app should continue calling with the @odata.nextLink until you no longer see an @odata.nextLink returned, or you see a response with an empty set of changes. After you have finished receiving all the changes, you may apply them to your local state.\r\nTo check for changes in the future, call delta again with the @odata.deltaLink from the previous response. Deleted items are returned with the deleted facet.\r\nItems with this property set should be removed from your local state."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-delta?view=graph-rest-1.0
operationId: user.drive.item_delta
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.delta(token=''{token}'')':
get:
tags:
- users.drive
summary: Invoke function delta
operationId: user.drive.item_delta
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: token
in: path
description: 'Usage: token=''{token}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.discardCheckout':
post:
tags:
- users.drive
summary: Invoke action discardCheckout
description: Discard the check out of a driveItem. This action releases a driveItem resource that was previously checked out. Any changes made to the item while it was checked out are discarded. The same user that performed the checkout must discard it. Another alternative is to use application permissions.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-discardcheckout?view=graph-rest-1.0
operationId: user.drive.item_discardCheckout
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.extractSensitivityLabels':
post:
tags:
- users.drive
summary: Invoke action extractSensitivityLabels
operationId: user.drive.item_extractSensitivityLabel
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.extractSensitivityLabelsResult'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.follow':
post:
tags:
- users.drive
summary: Invoke action follow
description: Follow a driveItem.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-follow?view=graph-rest-1.0
operationId: user.drive.item_follow
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- users.drive
summary: Invoke function getActivitiesByInterval
description: Get a collection of itemActivityStats resources for the activities that took place on this resource within the specified time interval. Analytics aggregates might not be available for all action types.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/itemactivitystat-getactivitybyinterval?view=graph-rest-1.0
operationId: user.drive.item_getActivitiesGraphBPreInterval
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- users.drive
summary: Invoke function getActivitiesByInterval
operationId: user.drive.item_getActivitiesGraphBPreInterval
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.invite':
post:
tags:
- users.drive
summary: Invoke action invite
description: 'Send a sharing invitation for a driveItem. A sharing invitation provides permissions to the recipients and, optionally, sends them an email to notify them that the item was shared.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-invite?view=graph-rest-1.0
operationId: user.drive.item_invite
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
requireSignIn:
type: boolean
default: false
nullable: true
roles:
type: array
items:
type: string
nullable: true
sendInvitation:
type: boolean
default: false
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
expirationDateTime:
type: string
nullable: true
password:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.permanentDelete':
post:
tags:
- users.drive
summary: Invoke action permanentDelete
operationId: user.drive.item_permanentDelete
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.preview':
post:
tags:
- users.drive
summary: Invoke action preview
operationId: user.drive.item_preview
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
page:
type: string
nullable: true
zoom:
type: number
format: double
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemPreviewInfo'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.restore':
post:
tags:
- users.drive
summary: Invoke action restore
description: Restore a deleted driveItem that is currently in the recycle bin.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-restore?view=graph-rest-1.0
operationId: user.drive.item_restore
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
parentReference:
$ref: '#/components/schemas/microsoft.graph.itemReference'
name:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.search(q=''{q}'')':
get:
tags:
- users.drive
summary: Invoke function search
description: "Search the hierarchy of items for items matching a query.\r\nYou can search within a folder hierarchy, a whole drive, or files shared with the current user."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-search?view=graph-rest-1.0
operationId: user.drive.item_search
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: q
in: path
description: 'Usage: q=''{q}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.unfollow':
post:
tags:
- users.drive
summary: Invoke action unfollow
description: Unfollow a driveItem.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-unfollow?view=graph-rest-1.0
operationId: user.drive.item_unfollow
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/microsoft.graph.validatePermission':
post:
tags:
- users.drive
summary: Invoke action validatePermission
operationId: user.drive.item_validatePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
challengeToken:
type: string
nullable: true
password:
type: string
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/permissions':
get:
tags:
- users.drive
summary: Get permissions from users
description: The set of permissions for the item. Read-only. Nullable.
operationId: user.drive.item_ListPermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to permissions for users
operationId: user.drive.item_CreatePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/permissions/{permission-id}':
get:
tags:
- users.drive
summary: Get permissions from users
description: The set of permissions for the item. Read-only. Nullable.
operationId: user.drive.item_GetPermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property permissions in users
operationId: user.drive.item_UpdatePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property permissions for users
operationId: user.drive.item_DeletePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- users.drive
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: user.drive.item.permission_grant
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/permissions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.item.permission_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/retentionLabel':
get:
tags:
- users.drive
summary: Get retentionLabel from users
description: Information about retention label and settings enforced on the driveItem. Read-write.
operationId: user.drive.item_GetRetentionLabel
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property retentionLabel in users
operationId: user.drive.item_UpdateRetentionLabel
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property retentionLabel for users
operationId: user.drive.item_DeleteRetentionLabel
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/subscriptions':
get:
tags:
- users.drive
summary: Get subscriptions from users
description: The set of subscriptions on the item. Only supported on the root of a drive.
operationId: user.drive.item_ListSubscription
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.subscriptionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to subscriptions for users
operationId: user.drive.item_CreateSubscription
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/subscriptions/{subscription-id}':
get:
tags:
- users.drive
summary: Get subscriptions from users
description: The set of subscriptions on the item. Only supported on the root of a drive.
operationId: user.drive.item_GetSubscription
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property subscriptions in users
operationId: user.drive.item_UpdateSubscription
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property subscriptions for users
operationId: user.drive.item_DeleteSubscription
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/subscriptions/{subscription-id}/microsoft.graph.reauthorize':
post:
tags:
- users.drive
summary: Invoke action reauthorize
description: Reauthorize a subscription when you receive a reauthorizationRequired challenge.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/subscription-reauthorize?view=graph-rest-1.0
operationId: user.drive.item.subscription_reauthorize
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/subscriptions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.item.subscription_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/thumbnails':
get:
tags:
- users.drive
summary: Get thumbnails from users
description: 'Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.'
operationId: user.drive.item_ListThumbnail
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.thumbnailSetCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to thumbnails for users
operationId: user.drive.item_CreateThumbnail
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/thumbnails/{thumbnailSet-id}':
get:
tags:
- users.drive
summary: Get thumbnails from users
description: 'Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.'
operationId: user.drive.item_GetThumbnail
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property thumbnails in users
operationId: user.drive.item_UpdateThumbnail
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property thumbnails for users
operationId: user.drive.item_DeleteThumbnail
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/thumbnails/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.item.thumbnail_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/versions':
get:
tags:
- users.drive
summary: Get versions from users
description: 'The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.'
operationId: user.drive.item_ListVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to versions for users
operationId: user.drive.item_CreateVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/versions/{driveItemVersion-id}':
get:
tags:
- users.drive
summary: Get versions from users
description: 'The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.'
operationId: user.drive.item_GetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property versions in users
operationId: user.drive.item_UpdateVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property versions for users
operationId: user.drive.item_DeleteVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/versions/{driveItemVersion-id}/content':
get:
tags:
- users.drive
summary: Get content for the navigation property versions from users
description: The content stream for this version of the item.
operationId: user.drive.item_GetVersionsContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- users.drive
summary: Update content for the navigation property versions in users
description: The content stream for this version of the item.
operationId: user.drive.item_SetVersionsContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
delete:
tags:
- users.drive
summary: Delete content for the navigation property versions in users
description: The content stream for this version of the item.
operationId: user.drive.item_DeleteVersionsContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/versions/{driveItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- users.drive
summary: Invoke action restoreVersion
description: 'Restore a previous version of a driveItem to be the current version. This operation creates a new version with the contents of the previous version, and it preserves all existing versions of the file.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitemversion-restoreversion?view=graph-rest-1.0
operationId: user.drive.item.version_restoreVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/items/{driveItem-id}/versions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.item.version_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/items/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.item_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/lastModifiedByUser':
get:
tags:
- users.drive
summary: Get lastModifiedByUser from users
description: Identity of the user who last modified the item. Read-only.
operationId: user.drive_GetLastModifiedGraphBPreUser
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/lastModifiedByUser/mailboxSettings':
get:
tags:
- users.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: user.drive.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- users.drive
summary: Update property mailboxSettings value.
operationId: user.drive.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- users.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: user.drive.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list':
get:
tags:
- users.drive
summary: Get list from users
description: 'For drives in SharePoint, the underlying document library list. Read-only. Nullable.'
operationId: user.drive_GetList
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.list'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property list in users
operationId: user.drive_UpdateList
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.list'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.list'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property list for users
operationId: user.drive_DeleteList
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/columns':
get:
tags:
- users.drive
summary: Get columns from users
description: The collection of field definitions for this list.
operationId: user.drive.list_ListColumn
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.columnDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to columns for users
operationId: user.drive.list_CreateColumn
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/columns/{columnDefinition-id}':
get:
tags:
- users.drive
summary: Get columns from users
description: The collection of field definitions for this list.
operationId: user.drive.list_GetColumn
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property columns in users
operationId: user.drive.list_UpdateColumn
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property columns for users
operationId: user.drive.list_DeleteColumn
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/columns/{columnDefinition-id}/sourceColumn':
get:
tags:
- users.drive
summary: Get sourceColumn from users
description: The source column for the content type column.
operationId: user.drive.list.column_GetSourceColumn
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/columns/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.list.column_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/contentTypes':
get:
tags:
- users.drive
summary: Get contentTypes from users
description: The collection of content types present in this list.
operationId: user.drive.list_ListContentType
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.contentTypeCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to contentTypes for users
operationId: user.drive.list_CreateContentType
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}':
get:
tags:
- users.drive
summary: Get contentTypes from users
description: The collection of content types present in this list.
operationId: user.drive.list_GetContentType
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property contentTypes in users
operationId: user.drive.list_UpdateContentType
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property contentTypes for users
operationId: user.drive.list_DeleteContentType
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/base':
get:
tags:
- users.drive
summary: Get base from users
description: Parent contentType from which this content type is derived.
operationId: user.drive.list.contentType_GetBase
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/baseTypes':
get:
tags:
- users.drive
summary: Get baseTypes from users
description: The collection of content types that are ancestors of this content type.
operationId: user.drive.list.contentType_ListBaseType
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.contentTypeCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/baseTypes/{contentType-id1}':
get:
tags:
- users.drive
summary: Get baseTypes from users
description: The collection of content types that are ancestors of this content type.
operationId: user.drive.list.contentType_GetBaseType
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: contentType-id1
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/baseTypes/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.list.contentType.baseType_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columnLinks':
get:
tags:
- users.drive
summary: Get columnLinks from users
description: The collection of columns that are required by this content type.
operationId: user.drive.list.contentType_ListColumnLink
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.columnLinkCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to columnLinks for users
operationId: user.drive.list.contentType_CreateColumnLink
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columnLinks/{columnLink-id}':
get:
tags:
- users.drive
summary: Get columnLinks from users
description: The collection of columns that are required by this content type.
operationId: user.drive.list.contentType_GetColumnLink
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnLink-id
in: path
description: The unique identifier of columnLink
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnLink
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property columnLinks in users
operationId: user.drive.list.contentType_UpdateColumnLink
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnLink-id
in: path
description: The unique identifier of columnLink
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnLink
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnLink'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property columnLinks for users
operationId: user.drive.list.contentType_DeleteColumnLink
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnLink-id
in: path
description: The unique identifier of columnLink
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnLink
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columnLinks/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.list.contentType.columnLink_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columnPositions':
get:
tags:
- users.drive
summary: Get columnPositions from users
description: Column order information in a content type.
operationId: user.drive.list.contentType_ListColumnPosition
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.columnDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columnPositions/{columnDefinition-id}':
get:
tags:
- users.drive
summary: Get columnPositions from users
description: Column order information in a content type.
operationId: user.drive.list.contentType_GetColumnPosition
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columnPositions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.list.contentType.columnPosition_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columns':
get:
tags:
- users.drive
summary: Get columns from users
description: The collection of column definitions for this content type.
operationId: user.drive.list.contentType_ListColumn
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.columnDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to columns for users
operationId: user.drive.list.contentType_CreateColumn
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columns/{columnDefinition-id}':
get:
tags:
- users.drive
summary: Get columns from users
description: The collection of column definitions for this content type.
operationId: user.drive.list.contentType_GetColumn
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property columns in users
operationId: user.drive.list.contentType_UpdateColumn
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property columns for users
operationId: user.drive.list.contentType_DeleteColumn
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columns/{columnDefinition-id}/sourceColumn':
get:
tags:
- users.drive
summary: Get sourceColumn from users
description: The source column for the content type column.
operationId: user.drive.list.contentType.column_GetSourceColumn
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- name: columnDefinition-id
in: path
description: The unique identifier of columnDefinition
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: columnDefinition
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/columns/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.list.contentType.column_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/microsoft.graph.associateWithHubSites':
post:
tags:
- users.drive
summary: Invoke action associateWithHubSites
description: Associate a published content type present in a content type hub with a list of hub sites.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-associatewithhubsites?view=graph-rest-1.0
operationId: user.drive.list.contentType_associateGraphWPreHubSite
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
hubSiteUrls:
type: array
items:
type: string
propagateToExistingLists:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/microsoft.graph.copyToDefaultContentLocation':
post:
tags:
- users.drive
summary: Invoke action copyToDefaultContentLocation
description: Copy a file to a default content location in a content type. The file can then be added as a default file or template via a POST operation.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-copytodefaultcontentlocation?view=graph-rest-1.0
operationId: user.drive.list.contentType_copyToDefaultContentLocation
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
sourceFile:
$ref: '#/components/schemas/microsoft.graph.itemReference'
destinationFileName:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/microsoft.graph.isPublished()':
get:
tags:
- users.drive
summary: Invoke function isPublished
description: Check the publishing status of a contentType in a content type hub site.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-ispublished?view=graph-rest-1.0
operationId: user.drive.list.contentType_isPublished
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
responses:
2XX:
description: Success
content:
application/json:
schema:
type: object
properties:
value:
type: boolean
default: false
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/microsoft.graph.publish':
post:
tags:
- users.drive
summary: Invoke action publish
description: Publishes a contentType present in the content type hub site.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-publish?view=graph-rest-1.0
operationId: user.drive.list.contentType_publish
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/list/contentTypes/{contentType-id}/microsoft.graph.unpublish':
post:
tags:
- users.drive
summary: Invoke action unpublish
description: Unpublish a contentType from a content type hub site.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-unpublish?view=graph-rest-1.0
operationId: user.drive.list.contentType_unpublish
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: contentType-id
in: path
description: The unique identifier of contentType
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: contentType
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/list/contentTypes/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.list.contentType_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/contentTypes/microsoft.graph.addCopy':
post:
tags:
- users.drive
summary: Invoke action addCopy
description: Add a copy of a content type from a site to a list.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-addcopy?view=graph-rest-1.0
operationId: user.drive.list.contentType_addCopy
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
contentType:
type: string
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/list/contentTypes/microsoft.graph.addCopyFromContentTypeHub':
post:
tags:
- users.drive
summary: Invoke action addCopyFromContentTypeHub
description: 'Add or sync a copy of a published content type from the content type hub to a target site or a list. This method is part of the content type publishing changes to optimize the syncing of published content types to sites and lists, effectively switching from a ''push everywhere'' to ''pull as needed'' approach. The method allows users to pull content types directly from the content type hub to a site or list. For more information, see contentType: getCompatibleHubContentTypes and the blog post Syntex Product Updates – August 2021.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-addcopyfromcontenttypehub?view=graph-rest-1.0
operationId: user.drive.list.contentType_addCopyFromContentTypeHub
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
contentTypeId:
type: string
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.contentType'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/list/contentTypes/microsoft.graph.getCompatibleHubContentTypes()':
get:
tags:
- users.drive
summary: Invoke function getCompatibleHubContentTypes
description: 'Get a list of compatible content types from the content type hub that can be added to a target site or a list. This method is part of the content type publishing changes to optimize the syncing of published content types to sites and lists, effectively switching from a ''push everywhere'' to ''pull as needed'' approach. The method allows users to pull content types directly from the content type hub to a site or list. For more information, see contentType: addCopyFromContentTypeHub and the blog post Syntex Product Updates – August 2021.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/contenttype-getcompatiblehubcontenttypes?view=graph-rest-1.0
operationId: user.drive.list.contentType_getCompatibleHubContentType
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of contentType
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.contentType'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/list/createdByUser':
get:
tags:
- users.drive
summary: Get createdByUser from users
description: Identity of the user who created the item. Read-only.
operationId: user.drive.list_GetCreatedGraphBPreUser
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/createdByUser/mailboxSettings':
get:
tags:
- users.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: user.drive.list.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- users.drive
summary: Update property mailboxSettings value.
operationId: user.drive.list.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/createdByUser/serviceProvisioningErrors':
get:
tags:
- users.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: user.drive.list.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/list/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.list.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/drive':
get:
tags:
- users.drive
summary: Get drive from users
description: Allows access to the list as a drive resource with driveItems. Only present on document libraries.
operationId: user.drive.list_GetDrive
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.drive'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/items':
get:
tags:
- users.drive
summary: Get items from users
description: All items contained in the list.
operationId: user.drive.list_ListItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.listItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to items for users
operationId: user.drive.list_CreateItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}':
get:
tags:
- users.drive
summary: Get items from users
description: All items contained in the list.
operationId: user.drive.list_GetItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property items in users
operationId: user.drive.list_UpdateItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property items for users
operationId: user.drive.list_DeleteItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/analytics':
get:
tags:
- users.drive
summary: Get analytics from users
description: Analytics about the view activities that took place on this item.
operationId: user.drive.list.item_GetAnalytic
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/createdByUser':
get:
tags:
- users.drive
summary: Get createdByUser from users
description: Identity of the user who created the item. Read-only.
operationId: user.drive.list.item_GetCreatedGraphBPreUser
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/createdByUser/mailboxSettings':
get:
tags:
- users.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: user.drive.list.item.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- users.drive
summary: Update property mailboxSettings value.
operationId: user.drive.list.item.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/createdByUser/serviceProvisioningErrors':
get:
tags:
- users.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: user.drive.list.item.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.list.item.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/documentSetVersions':
get:
tags:
- users.drive
summary: Get documentSetVersions from users
description: Version information for a document set version created by a user.
operationId: user.drive.list.item_ListDocumentSetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.documentSetVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to documentSetVersions for users
operationId: user.drive.list.item_CreateDocumentSetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/documentSetVersions/{documentSetVersion-id}':
get:
tags:
- users.drive
summary: Get documentSetVersions from users
description: Version information for a document set version created by a user.
operationId: user.drive.list.item_GetDocumentSetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property documentSetVersions in users
operationId: user.drive.list.item_UpdateDocumentSetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property documentSetVersions for users
operationId: user.drive.list.item_DeleteDocumentSetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/documentSetVersions/{documentSetVersion-id}/fields':
get:
tags:
- users.drive
summary: Get fields from users
description: A collection of the fields and values for this version of the list item.
operationId: user.drive.list.item.documentSetVersion_GetField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property fields in users
operationId: user.drive.list.item.documentSetVersion_UpdateField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property fields for users
operationId: user.drive.list.item.documentSetVersion_DeleteField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/documentSetVersions/{documentSetVersion-id}/microsoft.graph.restore':
post:
tags:
- users.drive
summary: Invoke action restore
description: Restore a document set version.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/documentsetversion-restore?view=graph-rest-1.0
operationId: user.drive.list.item.documentSetVersion_restore
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/documentSetVersions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.list.item.documentSetVersion_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/driveItem':
get:
tags:
- users.drive
summary: Get driveItem from users
description: 'For document libraries, the driveItem relationship exposes the listItem as a driveItem'
operationId: user.drive.list.item_GetDriveItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/driveItem/content':
get:
tags:
- users.drive
summary: Get content for the navigation property driveItem from users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.list.item_GetDriveItemContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- users.drive
summary: Update content for the navigation property driveItem in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.list.item_SetDriveItemContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- users.drive
summary: Delete content for the navigation property driveItem in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.list.item_DeleteDriveItemContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/fields':
get:
tags:
- users.drive
summary: Get fields from users
description: The values of the columns set on this list item.
operationId: user.drive.list.item_GetField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property fields in users
operationId: user.drive.list.item_UpdateField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property fields for users
operationId: user.drive.list.item_DeleteField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/lastModifiedByUser':
get:
tags:
- users.drive
summary: Get lastModifiedByUser from users
description: Identity of the user who last modified the item. Read-only.
operationId: user.drive.list.item_GetLastModifiedGraphBPreUser
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/lastModifiedByUser/mailboxSettings':
get:
tags:
- users.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: user.drive.list.item.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- users.drive
summary: Update property mailboxSettings value.
operationId: user.drive.list.item.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- users.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: user.drive.list.item.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.list.item.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/microsoft.graph.createLink':
post:
tags:
- users.drive
summary: Invoke action createLink
operationId: user.drive.list.item_createLink
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- users.drive
summary: Invoke function getActivitiesByInterval
operationId: user.drive.list.item_getActivitiesGraphBPreInterval
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- users.drive
summary: Invoke function getActivitiesByInterval
operationId: user.drive.list.item_getActivitiesGraphBPreInterval
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/permissions':
get:
tags:
- users.drive
summary: Get permissions from users
description: The set of permissions for the item. Read-only. Nullable.
operationId: user.drive.list.item_ListPermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to permissions for users
operationId: user.drive.list.item_CreatePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/permissions/{permission-id}':
get:
tags:
- users.drive
summary: Get permissions from users
description: The set of permissions for the item. Read-only. Nullable.
operationId: user.drive.list.item_GetPermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property permissions in users
operationId: user.drive.list.item_UpdatePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property permissions for users
operationId: user.drive.list.item_DeletePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- users.drive
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: user.drive.list.item.permission_grant
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/permissions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.list.item.permission_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/versions':
get:
tags:
- users.drive
summary: Get versions from users
description: The list of previous versions of the list item.
operationId: user.drive.list.item_ListVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.listItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to versions for users
operationId: user.drive.list.item_CreateVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/versions/{listItemVersion-id}':
get:
tags:
- users.drive
summary: Get versions from users
description: The list of previous versions of the list item.
operationId: user.drive.list.item_GetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property versions in users
operationId: user.drive.list.item_UpdateVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property versions for users
operationId: user.drive.list.item_DeleteVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/versions/{listItemVersion-id}/fields':
get:
tags:
- users.drive
summary: Get fields from users
description: A collection of the fields and values for this version of the list item.
operationId: user.drive.list.item.version_GetField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property fields in users
operationId: user.drive.list.item.version_UpdateField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property fields for users
operationId: user.drive.list.item.version_DeleteField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/versions/{listItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- users.drive
summary: Invoke action restoreVersion
description: 'Restore a previous version of a ListItem to be the current version. This will create a new version with the contents of the previous version, but preserves all existing versions of the item.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/listitemversion-restore?view=graph-rest-1.0
operationId: user.drive.list.item.version_restoreVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/list/items/{listItem-id}/versions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.list.item.version_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItem-id
in: path
description: The unique identifier of listItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItem
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/items/microsoft.graph.delta()':
get:
tags:
- users.drive
summary: Invoke function delta
description: "Get newly created, updated, or deleted list items without having to perform a full read of the entire items collection. Your app begins by calling delta without any parameters.\r\nThe service starts enumerating the hierarchy of the list, returning pages of items, and either an @odata.nextLink or an @odata.deltaLink.\r\nYour app should continue calling with the @odata.nextLink until you see an @odata.deltaLink returned. After you received all the changes, you can apply them to your local state.\r\nTo check for changes in the future, call delta again with the @odata.deltaLink from the previous response. The delta feed shows the latest state for each item, not each change. If an item was renamed twice, it only shows up once, with its latest name.\r\nThe same item might appear more than once in a delta feed, for various reasons. You should use the last occurrence you see. Items with this property should be removed from your local state."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/listitem-delta?view=graph-rest-1.0
operationId: user.drive.list.item_delta
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of listItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.listItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/list/items/microsoft.graph.delta(token=''{token}'')':
get:
tags:
- users.drive
summary: Invoke function delta
operationId: user.drive.list.item_delta
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: token
in: path
description: 'Usage: token=''{token}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of listItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.listItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/list/lastModifiedByUser':
get:
tags:
- users.drive
summary: Get lastModifiedByUser from users
description: Identity of the user who last modified the item. Read-only.
operationId: user.drive.list_GetLastModifiedGraphBPreUser
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/lastModifiedByUser/mailboxSettings':
get:
tags:
- users.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: user.drive.list.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- users.drive
summary: Update property mailboxSettings value.
operationId: user.drive.list.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- users.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: user.drive.list.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/list/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.list.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/operations':
get:
tags:
- users.drive
summary: Get operations from users
description: The collection of long-running operations on the list.
operationId: user.drive.list_ListOperation
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.richLongRunningOperationCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to operations for users
operationId: user.drive.list_CreateOperation
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/operations/{richLongRunningOperation-id}':
get:
tags:
- users.drive
summary: Get operations from users
description: The collection of long-running operations on the list.
operationId: user.drive.list_GetOperation
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: richLongRunningOperation-id
in: path
description: The unique identifier of richLongRunningOperation
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: richLongRunningOperation
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property operations in users
operationId: user.drive.list_UpdateOperation
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: richLongRunningOperation-id
in: path
description: The unique identifier of richLongRunningOperation
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: richLongRunningOperation
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property operations for users
operationId: user.drive.list_DeleteOperation
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: richLongRunningOperation-id
in: path
description: The unique identifier of richLongRunningOperation
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: richLongRunningOperation
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/operations/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.list.operation_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/permissions':
get:
tags:
- users.drive
summary: Get permissions from users
description: The set of permissions for the item. Read-only. Nullable.
operationId: user.drive.list_ListPermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to permissions for users
operationId: user.drive.list_CreatePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/permissions/{permission-id}':
get:
tags:
- users.drive
summary: Get permissions from users
description: The set of permissions for the item. Read-only. Nullable.
operationId: user.drive.list_GetPermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property permissions in users
operationId: user.drive.list_UpdatePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property permissions for users
operationId: user.drive.list_DeletePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- users.drive
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: user.drive.list.permission_grant
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/list/permissions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.list.permission_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/list/subscriptions':
get:
tags:
- users.drive
summary: Get subscriptions from users
description: The set of subscriptions on the list.
operationId: user.drive.list_ListSubscription
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.subscriptionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to subscriptions for users
operationId: user.drive.list_CreateSubscription
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/subscriptions/{subscription-id}':
get:
tags:
- users.drive
summary: Get subscriptions from users
description: The set of subscriptions on the list.
operationId: user.drive.list_GetSubscription
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property subscriptions in users
operationId: user.drive.list_UpdateSubscription
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property subscriptions for users
operationId: user.drive.list_DeleteSubscription
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/list/subscriptions/{subscription-id}/microsoft.graph.reauthorize':
post:
tags:
- users.drive
summary: Invoke action reauthorize
description: Reauthorize a subscription when you receive a reauthorizationRequired challenge.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/subscription-reauthorize?view=graph-rest-1.0
operationId: user.drive.list.subscription_reauthorize
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/list/subscriptions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.list.subscription_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/microsoft.graph.recent()':
get:
tags:
- users.drive
summary: Invoke function recent
description: "List a set of items recently used by the signed-in user.\r\nThis collection includes items that are in the user's drive and items they have access to from other drives."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/drive-recent?view=graph-rest-1.0
operationId: user.drive_recent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/recentResponse'
default:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2027-11-01'
date: '2025-11-13'
version: 2025-11/Removal
description: 'This API is deprecated and will stop returning data after November, 2027.'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/microsoft.graph.search(q=''{q}'')':
get:
tags:
- users.drive
summary: Invoke function search
description: "Search the hierarchy of items for items matching a query.\r\nYou can search within a folder hierarchy, a whole drive, or files shared with the current user."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-search?view=graph-rest-1.0
operationId: user.drive_search
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: q
in: path
description: 'Usage: q=''{q}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/searchResponse'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/microsoft.graph.sharedWithMe()':
get:
tags:
- users.drive
summary: Invoke function sharedWithMe
description: Get a list of driveItem objects shared with the owner of a drive. The driveItems returned from the sharedWithMe method always include the remoteItem facet that indicates they are items from a different drive.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/drive-sharedwithme?view=graph-rest-1.0
operationId: user.drive_sharedGraphWPreMe
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/sharedWithMeResponse'
default:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2027-11-01'
date: '2025-11-13'
version: 2025-11/Removal
description: 'This API is deprecated and will stop returning data after November, 2027.'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/root':
get:
tags:
- users.drive
summary: Get root from users
description: The root folder of the drive. Read-only.
operationId: user.drive_GetRoot
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property root in users
operationId: user.drive_UpdateRoot
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property root for users
operationId: user.drive_DeleteRoot
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/analytics':
get:
tags:
- users.drive
summary: Get analytics from users
description: Analytics about the view activities that took place on this item.
operationId: user.drive.root_GetAnalytic
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property analytics in users
operationId: user.drive.root_UpdateAnalytic
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property analytics for users
operationId: user.drive.root_DeleteAnalytic
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/analytics/allTime':
get:
tags:
- users.drive
summary: Get allTime from users
operationId: user.drive.root.analytic_GetAllTime
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/analytics/itemActivityStats':
get:
tags:
- users.drive
summary: Get itemActivityStats from users
operationId: user.drive.root.analytic_ListItemActivityStat
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.itemActivityStatCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to itemActivityStats for users
operationId: user.drive.root.analytic_CreateItemActivityStat
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}':
get:
tags:
- users.drive
summary: Get itemActivityStats from users
operationId: user.drive.root.analytic_GetItemActivityStat
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property itemActivityStats in users
operationId: user.drive.root.analytic_UpdateItemActivityStat
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property itemActivityStats for users
operationId: user.drive.root.analytic_DeleteItemActivityStat
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}/activities':
get:
tags:
- users.drive
summary: Get activities from users
description: Exposes the itemActivities represented in this itemActivityStat resource.
operationId: user.drive.root.analytic.itemActivityStat_ListActivity
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.itemActivityCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to activities for users
operationId: user.drive.root.analytic.itemActivityStat_CreateActivity
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}':
get:
tags:
- users.drive
summary: Get activities from users
description: Exposes the itemActivities represented in this itemActivityStat resource.
operationId: user.drive.root.analytic.itemActivityStat_GetActivity
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property activities in users
operationId: user.drive.root.analytic.itemActivityStat_UpdateActivity
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property activities for users
operationId: user.drive.root.analytic.itemActivityStat_DeleteActivity
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}/driveItem':
get:
tags:
- users.drive
summary: Get driveItem from users
description: Exposes the driveItem that was the target of this activity.
operationId: user.drive.root.analytic.itemActivityStat.activity_GetDriveItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}/driveItem/content':
get:
tags:
- users.drive
summary: Get content for the navigation property driveItem from users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.root.analytic.itemActivityStat.activity_GetDriveItemContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- users.drive
summary: Update content for the navigation property driveItem in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.root.analytic.itemActivityStat.activity_SetDriveItemContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- users.drive
summary: Delete content for the navigation property driveItem in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.root.analytic.itemActivityStat.activity_DeleteDriveItemContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivity
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/analytics/itemActivityStats/{itemActivityStat-id}/activities/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.root.analytic.itemActivityStat.activity_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/analytics/itemActivityStats/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.root.analytic.itemActivityStat_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/analytics/lastSevenDays':
get:
tags:
- users.drive
summary: Get lastSevenDays from users
operationId: user.drive.root.analytic_GetLastSevenDay
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/children':
get:
tags:
- users.drive
summary: Get children from users
description: Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.
operationId: user.drive.root_ListChild
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to children for users
operationId: user.drive.root_CreateChild
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/children/{driveItem-id}':
get:
tags:
- users.drive
summary: Get children from users
description: Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.
operationId: user.drive.root_GetChild
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/children/{driveItem-id}/content':
get:
tags:
- users.drive
summary: Get content for the navigation property children from users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.root_GetChildrenContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- users.drive
summary: Update content for the navigation property children in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.root_SetChildrenContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- users.drive
summary: Delete content for the navigation property children in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.root_DeleteChildrenContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/children/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.root.child_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/content':
get:
tags:
- users.drive
summary: Get content for the navigation property root from users
description: 'The content stream, if the item represents a file.'
operationId: user.drive_GetRootContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- users.drive
summary: Update content for the navigation property root in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive_SetRootContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- users.drive
summary: Delete content for the navigation property root in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive_DeleteRootContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/createdByUser':
get:
tags:
- users.drive
summary: Get createdByUser from users
description: Identity of the user who created the item. Read-only.
operationId: user.drive.root_GetCreatedGraphBPreUser
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/createdByUser/mailboxSettings':
get:
tags:
- users.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: user.drive.root.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- users.drive
summary: Update property mailboxSettings value.
operationId: user.drive.root.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/createdByUser/serviceProvisioningErrors':
get:
tags:
- users.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: user.drive.root.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/root/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.root.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/lastModifiedByUser':
get:
tags:
- users.drive
summary: Get lastModifiedByUser from users
description: Identity of the user who last modified the item. Read-only.
operationId: user.drive.root_GetLastModifiedGraphBPreUser
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/lastModifiedByUser/mailboxSettings':
get:
tags:
- users.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: user.drive.root.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- users.drive
summary: Update property mailboxSettings value.
operationId: user.drive.root.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- users.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: user.drive.root.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/root/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.root.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/listItem':
get:
tags:
- users.drive
summary: Get listItem from users
description: 'For drives in SharePoint, the associated document library list item. Read-only. Nullable.'
operationId: user.drive.root_GetListItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property listItem in users
operationId: user.drive.root_UpdateListItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property listItem for users
operationId: user.drive.root_DeleteListItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/listItem/analytics':
get:
tags:
- users.drive
summary: Get analytics from users
description: Analytics about the view activities that took place on this item.
operationId: user.drive.root.listItem_GetAnalytic
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/listItem/createdByUser':
get:
tags:
- users.drive
summary: Get createdByUser from users
description: Identity of the user who created the item. Read-only.
operationId: user.drive.root.listItem_GetCreatedGraphBPreUser
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/listItem/createdByUser/mailboxSettings':
get:
tags:
- users.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: user.drive.root.listItem.createdGraphBPreUser_GetMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- users.drive
summary: Update property mailboxSettings value.
operationId: user.drive.root.listItem.createdGraphBPreUser_UpdateMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/listItem/createdByUser/serviceProvisioningErrors':
get:
tags:
- users.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: user.drive.root.listItem.createdGraphBPreUser_ListServiceProvisioningError
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/root/listItem/createdByUser/serviceProvisioningErrors/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.root.listItem.createdGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/listItem/documentSetVersions':
get:
tags:
- users.drive
summary: Get documentSetVersions from users
description: Version information for a document set version created by a user.
operationId: user.drive.root.listItem_ListDocumentSetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.documentSetVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to documentSetVersions for users
operationId: user.drive.root.listItem_CreateDocumentSetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/listItem/documentSetVersions/{documentSetVersion-id}':
get:
tags:
- users.drive
summary: Get documentSetVersions from users
description: Version information for a document set version created by a user.
operationId: user.drive.root.listItem_GetDocumentSetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property documentSetVersions in users
operationId: user.drive.root.listItem_UpdateDocumentSetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property documentSetVersions for users
operationId: user.drive.root.listItem_DeleteDocumentSetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/listItem/documentSetVersions/{documentSetVersion-id}/fields':
get:
tags:
- users.drive
summary: Get fields from users
description: A collection of the fields and values for this version of the list item.
operationId: user.drive.root.listItem.documentSetVersion_GetField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property fields in users
operationId: user.drive.root.listItem.documentSetVersion_UpdateField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property fields for users
operationId: user.drive.root.listItem.documentSetVersion_DeleteField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/listItem/documentSetVersions/{documentSetVersion-id}/microsoft.graph.restore':
post:
tags:
- users.drive
summary: Invoke action restore
description: Restore a document set version.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/documentsetversion-restore?view=graph-rest-1.0
operationId: user.drive.root.listItem.documentSetVersion_restore
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: documentSetVersion-id
in: path
description: The unique identifier of documentSetVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: documentSetVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/listItem/documentSetVersions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.root.listItem.documentSetVersion_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/listItem/driveItem':
get:
tags:
- users.drive
summary: Get driveItem from users
description: 'For document libraries, the driveItem relationship exposes the listItem as a driveItem'
operationId: user.drive.root.listItem_GetDriveItem
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/listItem/driveItem/content':
get:
tags:
- users.drive
summary: Get content for the navigation property driveItem from users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.root.listItem_GetDriveItemContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- users.drive
summary: Update content for the navigation property driveItem in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.root.listItem_SetDriveItemContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- users.drive
summary: Delete content for the navigation property driveItem in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive.root.listItem_DeleteDriveItemContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/listItem/fields':
get:
tags:
- users.drive
summary: Get fields from users
description: The values of the columns set on this list item.
operationId: user.drive.root.listItem_GetField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property fields in users
operationId: user.drive.root.listItem_UpdateField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property fields for users
operationId: user.drive.root.listItem_DeleteField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/listItem/lastModifiedByUser':
get:
tags:
- users.drive
summary: Get lastModifiedByUser from users
description: Identity of the user who last modified the item. Read-only.
operationId: user.drive.root.listItem_GetLastModifiedGraphBPreUser
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.user'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/listItem/lastModifiedByUser/mailboxSettings':
get:
tags:
- users.drive
summary: Get mailboxSettings property value
description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Requires $select to retrieve.'
operationId: user.drive.root.listItem.lastModifiedGraphBPreUser_GetMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
patch:
tags:
- users.drive
summary: Update property mailboxSettings value.
operationId: user.drive.root.listItem.lastModifiedGraphBPreUser_UpdateMailboxSetting
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/listItem/lastModifiedByUser/serviceProvisioningErrors':
get:
tags:
- users.drive
summary: Get serviceProvisioningErrors property value
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
operationId: user.drive.root.listItem.lastModifiedGraphBPreUser_ListServiceProvisioningError
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/root/listItem/lastModifiedByUser/serviceProvisioningErrors/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.root.listItem.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/listItem/microsoft.graph.createLink':
post:
tags:
- users.drive
summary: Invoke action createLink
operationId: user.drive.root.listItem_createLink
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/listItem/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- users.drive
summary: Invoke function getActivitiesByInterval
operationId: user.drive.root.listItem_getActivitiesGraphBPreInterval
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/root/listItem/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- users.drive
summary: Invoke function getActivitiesByInterval
operationId: user.drive.root.listItem_getActivitiesGraphBPreInterval
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/root/listItem/permissions':
get:
tags:
- users.drive
summary: Get permissions from users
description: The set of permissions for the item. Read-only. Nullable.
operationId: user.drive.root.listItem_ListPermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to permissions for users
operationId: user.drive.root.listItem_CreatePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/listItem/permissions/{permission-id}':
get:
tags:
- users.drive
summary: Get permissions from users
description: The set of permissions for the item. Read-only. Nullable.
operationId: user.drive.root.listItem_GetPermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property permissions in users
operationId: user.drive.root.listItem_UpdatePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property permissions for users
operationId: user.drive.root.listItem_DeletePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/listItem/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- users.drive
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: user.drive.root.listItem.permission_grant
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/root/listItem/permissions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.root.listItem.permission_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/listItem/versions':
get:
tags:
- users.drive
summary: Get versions from users
description: The list of previous versions of the list item.
operationId: user.drive.root.listItem_ListVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.listItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to versions for users
operationId: user.drive.root.listItem_CreateVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/listItem/versions/{listItemVersion-id}':
get:
tags:
- users.drive
summary: Get versions from users
description: The list of previous versions of the list item.
operationId: user.drive.root.listItem_GetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property versions in users
operationId: user.drive.root.listItem_UpdateVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property versions for users
operationId: user.drive.root.listItem_DeleteVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/listItem/versions/{listItemVersion-id}/fields':
get:
tags:
- users.drive
summary: Get fields from users
description: A collection of the fields and values for this version of the list item.
operationId: user.drive.root.listItem.version_GetField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property fields in users
operationId: user.drive.root.listItem.version_UpdateField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property fields for users
operationId: user.drive.root.listItem.version_DeleteField
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/listItem/versions/{listItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- users.drive
summary: Invoke action restoreVersion
description: 'Restore a previous version of a ListItem to be the current version. This will create a new version with the contents of the previous version, but preserves all existing versions of the item.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/listitemversion-restore?view=graph-rest-1.0
operationId: user.drive.root.listItem.version_restoreVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: listItemVersion-id
in: path
description: The unique identifier of listItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: listItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/listItem/versions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.root.listItem.version_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.assignSensitivityLabel':
post:
tags:
- users.drive
summary: Invoke action assignSensitivityLabel
description: 'Asynchronously assign a sensitivity label to a driveItem. This API is part of the Microsoft SharePoint and OneDrive APIs that perform advanced premium administrative functions, and is considered as protected. Protected APIs require you to have more validations, beyond permission and consent, before you can use them. For more information about sensitivity labels from an administrator''s perspective, see Enable sensitivity labels for Office files in SharePoint and OneDrive. This API applies sensitivity labels to files at rest. Office clients don''t apply watermarks, headers, or footers to files that contain the label information. For more information about sensitivity labels from an administrator''s perspective, see Enable sensitivity labels for Office files in SharePoint and OneDrive.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-assignsensitivitylabel?view=graph-rest-1.0
operationId: user.drive.root_assignSensitivityLabel
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
sensitivityLabelId:
type: string
nullable: true
assignmentMethod:
$ref: '#/components/schemas/microsoft.graph.sensitivityLabelAssignmentMethod'
justificationText:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.checkin':
post:
tags:
- users.drive
summary: Invoke action checkin
description: 'Check in a checked out driveItem resource, which makes the version of the document available to others.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-checkin?view=graph-rest-1.0
operationId: user.drive.root_checkin
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
checkInAs:
type: string
nullable: true
comment:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.checkout':
post:
tags:
- users.drive
summary: Invoke action checkout
description: '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.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-checkout?view=graph-rest-1.0
operationId: user.drive.root_checkout
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.copy':
post:
tags:
- users.drive
summary: Invoke action copy
operationId: user.drive.root_copy
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
name:
type: string
nullable: true
parentReference:
$ref: '#/components/schemas/microsoft.graph.itemReference'
childrenOnly:
type: boolean
default: false
nullable: true
includeAllVersionHistory:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.createLink':
post:
tags:
- users.drive
summary: Invoke action createLink
description: "Create a link to share a driveItem driveItem. The createLink action creates a new sharing link if the specified link type doesn't already exist for the calling application.\r\nIf a sharing link of the specified type already exists for the app, the existing sharing link is returned. DriveItem resources inherit sharing permissions from their ancestors."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-createlink?view=graph-rest-1.0
operationId: user.drive.root_createLink
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
type:
type: string
nullable: true
scope:
type: string
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
format: date-time
nullable: true
password:
type: string
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
sendNotification:
type: boolean
default: false
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.createUploadSession':
post:
tags:
- users.drive
summary: Invoke action createUploadSession
operationId: user.drive.root_createUploadSession
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
item:
$ref: '#/components/schemas/microsoft.graph.driveItemUploadableProperties'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.uploadSession'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.delta()':
get:
tags:
- users.drive
summary: Invoke function delta
description: "Track changes in a driveItem and its children over time. Your app begins by calling delta without any parameters.\r\nThe service starts enumerating the drive's hierarchy, returning pages of items and either an @odata.nextLink or an @odata.deltaLink, as described below.\r\nYour app should continue calling with the @odata.nextLink until you no longer see an @odata.nextLink returned, or you see a response with an empty set of changes. After you have finished receiving all the changes, you may apply them to your local state.\r\nTo check for changes in the future, call delta again with the @odata.deltaLink from the previous response. Deleted items are returned with the deleted facet.\r\nItems with this property set should be removed from your local state."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-delta?view=graph-rest-1.0
operationId: user.drive.root_delta
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.delta(token=''{token}'')':
get:
tags:
- users.drive
summary: Invoke function delta
operationId: user.drive.root_delta
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: token
in: path
description: 'Usage: token=''{token}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
'@odata.deltaLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.discardCheckout':
post:
tags:
- users.drive
summary: Invoke action discardCheckout
description: Discard the check out of a driveItem. This action releases a driveItem resource that was previously checked out. Any changes made to the item while it was checked out are discarded. The same user that performed the checkout must discard it. Another alternative is to use application permissions.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-discardcheckout?view=graph-rest-1.0
operationId: user.drive.root_discardCheckout
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.extractSensitivityLabels':
post:
tags:
- users.drive
summary: Invoke action extractSensitivityLabels
operationId: user.drive.root_extractSensitivityLabel
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.extractSensitivityLabelsResult'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.follow':
post:
tags:
- users.drive
summary: Invoke action follow
description: Follow a driveItem.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-follow?view=graph-rest-1.0
operationId: user.drive.root_follow
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.getActivitiesByInterval()':
get:
tags:
- users.drive
summary: Invoke function getActivitiesByInterval
description: Get a collection of itemActivityStats resources for the activities that took place on this resource within the specified time interval. Analytics aggregates might not be available for all action types.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/itemactivitystat-getactivitybyinterval?view=graph-rest-1.0
operationId: user.drive.root_getActivitiesGraphBPreInterval
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.getActivitiesByInterval(startDateTime=''{startDateTime}'',endDateTime=''{endDateTime}'',interval=''{interval}'')':
get:
tags:
- users.drive
summary: Invoke function getActivitiesByInterval
operationId: user.drive.root_getActivitiesGraphBPreInterval
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: startDateTime
in: path
description: 'Usage: startDateTime=''{startDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: endDateTime
in: path
description: 'Usage: endDateTime=''{endDateTime}'''
required: true
style: simple
schema:
type: string
nullable: true
- name: interval
in: path
description: 'Usage: interval=''{interval}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of itemActivityStat
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.invite':
post:
tags:
- users.drive
summary: Invoke action invite
description: 'Send a sharing invitation for a driveItem. A sharing invitation provides permissions to the recipients and, optionally, sends them an email to notify them that the item was shared.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-invite?view=graph-rest-1.0
operationId: user.drive.root_invite
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
requireSignIn:
type: boolean
default: false
nullable: true
roles:
type: array
items:
type: string
nullable: true
sendInvitation:
type: boolean
default: false
nullable: true
message:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
retainInheritedPermissions:
type: boolean
default: false
nullable: true
expirationDateTime:
type: string
nullable: true
password:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.permanentDelete':
post:
tags:
- users.drive
summary: Invoke action permanentDelete
operationId: user.drive.root_permanentDelete
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.preview':
post:
tags:
- users.drive
summary: Invoke action preview
operationId: user.drive.root_preview
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
page:
type: string
nullable: true
zoom:
type: number
format: double
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemPreviewInfo'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.restore':
post:
tags:
- users.drive
summary: Invoke action restore
description: Restore a deleted driveItem that is currently in the recycle bin.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-restore?view=graph-rest-1.0
operationId: user.drive.root_restore
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
parentReference:
$ref: '#/components/schemas/microsoft.graph.itemReference'
name:
type: string
nullable: true
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.search(q=''{q}'')':
get:
tags:
- users.drive
summary: Invoke function search
description: "Search the hierarchy of items for items matching a query.\r\nYou can search within a folder hierarchy, a whole drive, or files shared with the current user."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-search?view=graph-rest-1.0
operationId: user.drive.root_search
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: q
in: path
description: 'Usage: q=''{q}'''
required: true
style: simple
schema:
type: string
nullable: true
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.unfollow':
post:
tags:
- users.drive
summary: Invoke action unfollow
description: Unfollow a driveItem.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitem-unfollow?view=graph-rest-1.0
operationId: user.drive.root_unfollow
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/microsoft.graph.validatePermission':
post:
tags:
- users.drive
summary: Invoke action validatePermission
operationId: user.drive.root_validatePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
challengeToken:
type: string
nullable: true
password:
type: string
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/permissions':
get:
tags:
- users.drive
summary: Get permissions from users
description: The set of permissions for the item. Read-only. Nullable.
operationId: user.drive.root_ListPermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to permissions for users
operationId: user.drive.root_CreatePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/permissions/{permission-id}':
get:
tags:
- users.drive
summary: Get permissions from users
description: The set of permissions for the item. Read-only. Nullable.
operationId: user.drive.root_GetPermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property permissions in users
operationId: user.drive.root_UpdatePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property permissions for users
operationId: user.drive.root_DeletePermission
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/permissions/{permission-id}/microsoft.graph.grant':
post:
tags:
- users.drive
summary: Invoke action grant
description: Grant users access to a link represented by a permission.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
operationId: user.drive.root.permission_grant
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: permission-id
in: path
description: The unique identifier of permission
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: permission
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
roles:
type: array
items:
type: string
nullable: true
recipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveRecipient'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of permission
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
'@odata.nextLink':
type: string
nullable: true
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
'/users/{user-id}/drives/{drive-id}/root/permissions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.root.permission_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/retentionLabel':
get:
tags:
- users.drive
summary: Get retentionLabel from users
description: Information about retention label and settings enforced on the driveItem. Read-write.
operationId: user.drive.root_GetRetentionLabel
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property retentionLabel in users
operationId: user.drive.root_UpdateRetentionLabel
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property retentionLabel for users
operationId: user.drive.root_DeleteRetentionLabel
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/subscriptions':
get:
tags:
- users.drive
summary: Get subscriptions from users
description: The set of subscriptions on the item. Only supported on the root of a drive.
operationId: user.drive.root_ListSubscription
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.subscriptionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to subscriptions for users
operationId: user.drive.root_CreateSubscription
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/subscriptions/{subscription-id}':
get:
tags:
- users.drive
summary: Get subscriptions from users
description: The set of subscriptions on the item. Only supported on the root of a drive.
operationId: user.drive.root_GetSubscription
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property subscriptions in users
operationId: user.drive.root_UpdateSubscription
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subscription'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property subscriptions for users
operationId: user.drive.root_DeleteSubscription
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/subscriptions/{subscription-id}/microsoft.graph.reauthorize':
post:
tags:
- users.drive
summary: Invoke action reauthorize
description: Reauthorize a subscription when you receive a reauthorizationRequired challenge.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/subscription-reauthorize?view=graph-rest-1.0
operationId: user.drive.root.subscription_reauthorize
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: subscription-id
in: path
description: The unique identifier of subscription
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: subscription
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/subscriptions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.root.subscription_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/thumbnails':
get:
tags:
- users.drive
summary: Get thumbnails from users
description: 'Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.'
operationId: user.drive.root_ListThumbnail
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.thumbnailSetCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to thumbnails for users
operationId: user.drive.root_CreateThumbnail
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/thumbnails/{thumbnailSet-id}':
get:
tags:
- users.drive
summary: Get thumbnails from users
description: 'Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.'
operationId: user.drive.root_GetThumbnail
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property thumbnails in users
operationId: user.drive.root_UpdateThumbnail
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property thumbnails for users
operationId: user.drive.root_DeleteThumbnail
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: thumbnailSet-id
in: path
description: The unique identifier of thumbnailSet
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: thumbnailSet
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/thumbnails/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.root.thumbnail_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/versions':
get:
tags:
- users.drive
summary: Get versions from users
description: 'The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.'
operationId: user.drive.root_ListVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemVersionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- users.drive
summary: Create new navigation property to versions for users
operationId: user.drive.root_CreateVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/versions/{driveItemVersion-id}':
get:
tags:
- users.drive
summary: Get versions from users
description: 'The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.'
operationId: user.drive.root_GetVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- users.drive
summary: Update the navigation property versions in users
operationId: user.drive.root_UpdateVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.drive
summary: Delete navigation property versions for users
operationId: user.drive.root_DeleteVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/root/versions/{driveItemVersion-id}/content':
get:
tags:
- users.drive
summary: Get content for the navigation property versions from users
description: The content stream for this version of the item.
operationId: user.drive.root_GetVersionsContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- users.drive
summary: Update content for the navigation property versions in users
description: The content stream for this version of the item.
operationId: user.drive.root_SetVersionsContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
default:
$ref: '#/components/responses/error'
delete:
tags:
- users.drive
summary: Delete content for the navigation property versions in users
description: The content stream for this version of the item.
operationId: user.drive.root_DeleteVersionsContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/root/versions/{driveItemVersion-id}/microsoft.graph.restoreVersion':
post:
tags:
- users.drive
summary: Invoke action restoreVersion
description: 'Restore a previous version of a driveItem to be the current version. This operation creates a new version with the contents of the previous version, and it preserves all existing versions of the file.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/driveitemversion-restoreversion?view=graph-rest-1.0
operationId: user.drive.root.version_restoreVersion
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItemVersion-id
in: path
description: The unique identifier of driveItemVersion
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItemVersion
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
'/users/{user-id}/drives/{drive-id}/root/versions/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.root.version_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/special':
get:
tags:
- users.drive
summary: Get special from users
description: Collection of common folders available in OneDrive. Read-only. Nullable.
operationId: user.drive_ListSpecial
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.driveItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/special/{driveItem-id}':
get:
tags:
- users.drive
summary: Get special from users
description: Collection of common folders available in OneDrive. Read-only. Nullable.
operationId: user.drive_GetSpecial
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
'/users/{user-id}/drives/{drive-id}/special/{driveItem-id}/content':
get:
tags:
- users.drive
summary: Get content for the navigation property special from users
description: 'The content stream, if the item represents a file.'
operationId: user.drive_GetSpecialContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: $format
in: query
description: Format of the content
style: form
explode: false
schema:
type: string
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- users.drive
summary: Update content for the navigation property special in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive_SetSpecialContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
default:
$ref: '#/components/responses/error'
delete:
tags:
- users.drive
summary: Delete content for the navigation property special in users
description: 'The content stream, if the item represents a file.'
operationId: user.drive_DeleteSpecialContent
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: driveItem
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/{drive-id}/special/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive.special_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- name: drive-id
in: path
description: The unique identifier of drive
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: drive
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
'/users/{user-id}/drives/$count':
get:
tags:
- users.drive
summary: Get the number of the resource
operationId: user.drive_GetCount
parameters:
- name: user-id
in: path
description: The unique identifier of user
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: user
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
components:
schemas:
microsoft.graph.drive:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
- title: drive
type: object
properties:
driveType:
type: string
description: Describes the type of drive represented by this resource. OneDrive personal drives return personal. OneDrive for Business returns business. SharePoint document libraries return documentLibrary. Read-only.
nullable: true
owner:
$ref: '#/components/schemas/microsoft.graph.identitySet'
quota:
$ref: '#/components/schemas/microsoft.graph.quota'
sharePointIds:
$ref: '#/components/schemas/microsoft.graph.sharepointIds'
system:
$ref: '#/components/schemas/microsoft.graph.systemFacet'
bundles:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
description: Collection of bundles (albums and multi-select-shared sets of items). Only in personal OneDrive.
x-ms-navigationProperty: true
following:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
description: The list of items the user is following. Only in OneDrive for Business.
x-ms-navigationProperty: true
items:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
description: All items contained in the drive. Read-only. Nullable.
x-ms-navigationProperty: true
list:
$ref: '#/components/schemas/microsoft.graph.list'
root:
$ref: '#/components/schemas/microsoft.graph.driveItem'
special:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
description: Collection of common folders available in OneDrive. Read-only. Nullable.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.driveItem:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
- title: driveItem
type: object
properties:
audio:
$ref: '#/components/schemas/microsoft.graph.audio'
bundle:
$ref: '#/components/schemas/microsoft.graph.bundle'
content:
type: string
description: 'The content stream, if the item represents a file.'
format: base64url
nullable: true
cTag:
type: string
description: An eTag for the content of the item. This eTag isn't changed if only the metadata is changed. Note This property isn't returned if the item is a folder. Read-only.
nullable: true
deleted:
$ref: '#/components/schemas/microsoft.graph.deleted'
file:
$ref: '#/components/schemas/microsoft.graph.file'
fileSystemInfo:
$ref: '#/components/schemas/microsoft.graph.fileSystemInfo'
folder:
$ref: '#/components/schemas/microsoft.graph.folder'
image:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
package:
$ref: '#/components/schemas/microsoft.graph.package'
pendingOperations:
$ref: '#/components/schemas/microsoft.graph.pendingOperations'
photo:
$ref: '#/components/schemas/microsoft.graph.photo'
publication:
$ref: '#/components/schemas/microsoft.graph.publicationFacet'
remoteItem:
$ref: '#/components/schemas/microsoft.graph.remoteItem'
root:
$ref: '#/components/schemas/microsoft.graph.root'
searchResult:
$ref: '#/components/schemas/microsoft.graph.searchResult'
shared:
$ref: '#/components/schemas/microsoft.graph.shared'
sharepointIds:
$ref: '#/components/schemas/microsoft.graph.sharepointIds'
size:
type: number
description: Size of the item in bytes. Read-only.
format: int64
nullable: true
specialFolder:
$ref: '#/components/schemas/microsoft.graph.specialFolder'
video:
$ref: '#/components/schemas/microsoft.graph.video'
webDavUrl:
type: string
description: WebDAV compatible URL for the item.
nullable: true
analytics:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
children:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
description: Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.
x-ms-navigationProperty: true
listItem:
$ref: '#/components/schemas/microsoft.graph.listItem'
permissions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
description: The set of permissions for the item. Read-only. Nullable.
x-ms-navigationProperty: true
retentionLabel:
$ref: '#/components/schemas/microsoft.graph.itemRetentionLabel'
subscriptions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.subscription'
description: The set of subscriptions on the item. Only supported on the root of a drive.
x-ms-navigationProperty: true
thumbnails:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.thumbnailSet'
description: 'Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.'
x-ms-navigationProperty: true
versions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItemVersion'
description: 'The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.'
x-ms-navigationProperty: true
workbook:
$ref: '#/components/schemas/microsoft.graph.workbook'
additionalProperties:
type: object
microsoft.graph.user:
allOf:
- $ref: '#/components/schemas/microsoft.graph.directoryObject'
- title: user
type: object
properties:
aboutMe:
type: string
description: A freeform text entry field for the user to describe themselves. Requires $select to retrieve.
nullable: true
accountEnabled:
type: boolean
description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
description: 'Sets the age group of the user. Allowed values: null, Minor, NotAdult, and Adult. For more information, see legal age group property definitions. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
nullable: true
assignedLicenses:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLicense'
description: 'The licenses that are assigned to the user, including inherited (group-based) licenses. This property doesn''t differentiate between directly assigned and inherited licenses. Use the licenseAssignmentStates property to identify the directly assigned and inherited licenses. Not nullable. Requires $select to retrieve. Supports $filter (eq, not, /$count eq 0, /$count ne 0).'
assignedPlans:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedPlan'
description: The plans that are assigned to the user. Read-only. Not nullable. Requires $select to retrieve. Supports $filter (eq and not).
authorizationInfo:
$ref: '#/components/schemas/microsoft.graph.authorizationInfo'
birthday:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The birthday of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014, is 2014-01-01T00:00:00Z. Requires $select to retrieve.'
format: date-time
businessPhones:
type: array
items:
type: string
description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
nullable: true
companyName:
type: string
description: 'The name of the company that the user is associated with. This property can be useful for describing the company that a guest comes from. The maximum length is 64 characters.Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
nullable: true
consentProvidedForMinor:
type: string
description: 'Sets whether consent was obtained for minors. Allowed values: null, Granted, Denied, and NotRequired. For more information, see legal age group property definitions. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
nullable: true
country:
type: string
description: 'The country or region where the user is located; for example, US or UK. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
nullable: true
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The date and time the user was created, in ISO 8601 format and UTC. The value can''t be modified and is automatically populated when the entity is created. Nullable. For on-premises users, the value represents when they were first created in Microsoft Entra ID. Property is null for some users created before June 2018 and on-premises users that were synced to Microsoft Entra ID before June 2018. Read-only. Requires $select to retrieve. Supports $filter (eq, ne, not , ge, le, in).'
format: date-time
nullable: true
creationType:
type: string
description: 'Indicates whether the user account was created through one of the following methods: As a regular school or work account (null). As an external account (Invitation). As a local account for an Azure Active Directory B2C tenant (LocalAccount). Through self-service sign-up by an internal user using email verification (EmailVerified). Through self-service sign-up by a guest signing up through a link that is part of a user flow (SelfServiceSignUp). Read-only.Requires $select to retrieve. Supports $filter (eq, ne, not, in).'
nullable: true
customSecurityAttributes:
$ref: '#/components/schemas/microsoft.graph.customSecurityAttributeValue'
department:
type: string
description: 'The name of the department in which the user works. Maximum length is 64 characters. Requires $select to retrieve. Supports $filter (eq, ne, not , ge, le, in, and eq on null values).'
nullable: true
deviceEnrollmentLimit:
maximum: 2147483647
minimum: -2147483648
type: number
description: The limit on the maximum number of devices that the user is permitted to enroll. Allowed values are 5 or 1000.
format: int32
displayName:
type: string
description: 'The name displayed in the address book for the user. This value is usually the combination of the user''s first name, middle initial, and family name. This property is required when a user is created and it can''t be cleared during updates. Maximum length is 256 characters. Returned by default. Supports $filter (eq, ne, not , ge, le, in, startsWith, and eq on null values), $orderby, and $search.'
nullable: true
employeeHireDate:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The date and time when the user was hired or will start work in a future hire. Requires $select to retrieve. Supports $filter (eq, ne, not , ge, le, in).'
format: date-time
nullable: true
employeeId:
type: string
description: 'The employee identifier assigned to the user by the organization. The maximum length is 16 characters. Requires $select to retrieve. Supports $filter (eq, ne, not , ge, le, in, startsWith, and eq on null values).'
nullable: true
employeeLeaveDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The date and time when the user left or will leave the organization. To read this property, the calling app must be assigned the User-LifeCycleInfo.Read.All permission. To write this property, the calling app must be assigned the User.Read.All and User-LifeCycleInfo.ReadWrite.All permissions. To read this property in delegated scenarios, the admin needs at least one of the following Microsoft Entra roles: Lifecycle Workflows Administrator (least privilege), Global Reader. To write this property in delegated scenarios, the admin needs the Global Administrator role. Supports $filter (eq, ne, not , ge, le, in). For more information, see Configure the employeeLeaveDateTime property for a user.'
format: date-time
nullable: true
employeeOrgData:
$ref: '#/components/schemas/microsoft.graph.employeeOrgData'
employeeType:
type: string
description: 'Captures enterprise worker type. For example, Employee, Contractor, Consultant, or Vendor. Requires $select to retrieve. Supports $filter (eq, ne, not , ge, le, in, startsWith).'
nullable: true
externalUserState:
type: string
description: 'For a guest invited to the tenant using the invitation API, this property represents the invited user''s invitation status. For invited users, the state can be PendingAcceptance or Accepted, or null for all other users. Requires $select to retrieve. Supports $filter (eq, ne, not , in).'
nullable: true
externalUserStateChangeDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'Shows the timestamp for the latest change to the externalUserState property. Requires $select to retrieve. Supports $filter (eq, ne, not , in).'
format: date-time
nullable: true
faxNumber:
type: string
description: 'The fax number of the user. Requires $select to retrieve. Supports $filter (eq, ne, not , ge, le, in, startsWith, and eq on null values).'
nullable: true
givenName:
type: string
description: 'The given name (first name) of the user. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not , ge, le, in, startsWith, and eq on null values).'
nullable: true
hireDate:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The hire date of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014, is 2014-01-01T00:00:00Z. Requires $select to retrieve. Note: This property is specific to SharePoint in Microsoft 365. We recommend using the native employeeHireDate property to set and update hire date values using Microsoft Graph APIs.'
format: date-time
identities:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.objectIdentity'
description: 'Represents the identities that can be used to sign in to this user account. Microsoft (also known as a local account), organizations, or social identity providers such as Facebook, Google, and Microsoft can provide identity and tie it to a user account. It might contain multiple items with the same signInType value. Requires $select to retrieve. Supports $filter (eq) with limitations.'
identityParentId:
type: string
nullable: true
imAddresses:
type: array
items:
type: string
nullable: true
description: 'The instant message voice-over IP (VOIP) session initiation protocol (SIP) addresses for the user. Read-only. Requires $select to retrieve. Supports $filter (eq, not, ge, le, startsWith).'
interests:
type: array
items:
type: string
nullable: true
description: A list for the user to describe their interests. Requires $select to retrieve.
isManagementRestricted:
type: boolean
description: 'true if the user is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a user who is a member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
nullable: true
isResourceAccount:
type: boolean
description: Don't use – reserved for future use.
nullable: true
jobTitle:
type: string
description: 'The user''s job title. Maximum length is 128 characters. Returned by default. Supports $filter (eq, ne, not , ge, le, in, startsWith, and eq on null values).'
nullable: true
lastPasswordChangeDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The time when this Microsoft Entra user last changed their password or when their password was created, whichever date the latest action was performed. The date and time information uses ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Requires $select to retrieve.'
format: date-time
nullable: true
legalAgeGroupClassification:
type: string
description: 'Used by enterprise applications to determine the legal age group of the user. This property is read-only and calculated based on ageGroup and consentProvidedForMinor properties. Allowed values: null, Undefined, MinorWithOutParentalConsent, MinorWithParentalConsent, MinorNoParentalConsentRequired, NotAdult, and Adult. For more information, see legal age group property definitions. Requires $select to retrieve.'
nullable: true
licenseAssignmentStates:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.licenseAssignmentState'
description: State of license assignments for this user. Also indicates licenses that are directly assigned or the user inherited through group memberships. Read-only. Requires $select to retrieve.
mail:
type: string
description: 'The SMTP address for the user, for example, jeff@contoso.com. Changes to this property update the user''s proxyAddresses collection to include the value as an SMTP address. This property can''t contain accent characters. NOTE: We don''t recommend updating this property for Azure AD B2C user profiles. Use the otherMails property instead. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith, and eq on null values).'
nullable: true
mailboxSettings:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
mailNickname:
type: string
description: 'The mail alias for the user. This property must be specified when a user is created. Maximum length is 64 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
nullable: true
mobilePhone:
type: string
description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
description: The URL for the user's site. Requires $select to retrieve.
nullable: true
officeLocation:
type: string
description: 'The office location in the user''s place of business. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
nullable: true
onPremisesDistinguishedName:
type: string
description: Contains the on-premises Active Directory distinguished name or DN. The property is only populated for customers who are synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect. Read-only. Requires $select to retrieve.
nullable: true
onPremisesDomainName:
type: string
description: 'Contains the on-premises domainFQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect. Read-only. Requires $select to retrieve.'
nullable: true
onPremisesExtensionAttributes:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'Indicates the last time at which the object was synced with the on-premises directory; for example: 2013-02-16T03:04:54Z. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
format: date-time
nullable: true
onPremisesProvisioningErrors:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.onPremisesProvisioningError'
description: 'Errors when using Microsoft synchronization product during provisioning. Requires $select to retrieve. Supports $filter (eq, not, ge, le).'
onPremisesSamAccountName:
type: string
description: 'Contains the on-premises samAccountName synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect. Read-only. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith).'
nullable: true
onPremisesSecurityIdentifier:
type: string
description: Contains the on-premises security identifier (SID) for the user that was synchronized from on-premises to the cloud. Read-only. Requires $select to retrieve. Supports $filter (eq including on null values).
nullable: true
onPremisesSyncEnabled:
type: boolean
description: 'true if this user object is currently being synced from an on-premises Active Directory (AD); otherwise the user isn''t being synced and can be managed in Microsoft Entra ID. Read-only. Requires $select to retrieve. Supports $filter (eq, ne, not, in, and eq on null values).'
nullable: true
onPremisesUserPrincipalName:
type: string
description: 'Contains the on-premises userPrincipalName synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect. Read-only. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith).'
nullable: true
otherMails:
type: array
items:
type: string
description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
nullable: true
passwordProfile:
$ref: '#/components/schemas/microsoft.graph.passwordProfile'
pastProjects:
type: array
items:
type: string
nullable: true
description: A list for the user to enumerate their past projects. Requires $select to retrieve.
postalCode:
type: string
description: 'The postal code for the user''s postal address. The postal code is specific to the user''s country or region. In the United States of America, this attribute contains the ZIP code. Maximum length is 40 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
nullable: true
preferredDataLocation:
type: string
description: 'The preferred data location for the user. For more information, see OneDrive Online Multi-Geo.'
nullable: true
preferredLanguage:
type: string
description: 'The preferred language for the user. The preferred language format is based on RFC 4646. The name is a combination of an ISO 639 two-letter lowercase culture code associated with the language, and an ISO 3166 two-letter uppercase subculture code associated with the country or region. Example: ''en-US'', or ''es-ES''. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values)'
nullable: true
preferredName:
type: string
description: The preferred name for the user. Not Supported. This attribute returns an empty string.Requires $select to retrieve.
nullable: true
print:
$ref: '#/components/schemas/microsoft.graph.userPrint'
provisionedPlans:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.provisionedPlan'
description: 'The plans that are provisioned for the user. Read-only. Not nullable. Requires $select to retrieve. Supports $filter (eq, not, ge, le).'
proxyAddresses:
type: array
items:
type: string
description: 'For example: [''SMTP: bob@contoso.com'', ''smtp: bob@sales.contoso.com'']. Changes to the mail property update this collection to include the value as an SMTP address. For more information, see mail and proxyAddresses properties. The proxy address prefixed with SMTP (capitalized) is the primary proxy address, while those addresses prefixed with smtp are the secondary proxy addresses. For Azure AD B2C accounts, this property has a limit of 10 unique addresses. Read-only in Microsoft Graph; you can update this property only through the Microsoft 365 admin center. Not nullable. Requires $select to retrieve. Supports $filter (eq, not, ge, le, startsWith, endsWith, /$count eq 0, /$count ne 0).'
responsibilities:
type: array
items:
type: string
nullable: true
description: A list for the user to enumerate their responsibilities. Requires $select to retrieve.
schools:
type: array
items:
type: string
nullable: true
description: A list for the user to enumerate the schools they attended. Requires $select to retrieve.
securityIdentifier:
type: string
description: 'Security identifier (SID) of the user, used in Windows scenarios. Read-only. Returned by default. Supports $select and $filter (eq, not, ge, le, startsWith).'
nullable: true
serviceProvisioningErrors:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.serviceProvisioningError'
description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
showInAddressList:
type: boolean
description: Do not use in Microsoft Graph. Manage this property through the Microsoft 365 admin center instead. Represents whether the user should be included in the Outlook global address list. See Known issue.
nullable: true
signInActivity:
$ref: '#/components/schemas/microsoft.graph.signInActivity'
signInSessionsValidFromDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'Any refresh tokens or session tokens (session cookies) issued before this time are invalid. Applications get an error when using an invalid refresh or session token to acquire a delegated access token (to access APIs such as Microsoft Graph). If this happens, the application needs to acquire a new refresh token by requesting the authorized endpoint. Read-only. Use revokeSignInSessions to reset. Requires $select to retrieve.'
format: date-time
nullable: true
skills:
type: array
items:
type: string
nullable: true
description: A list for the user to enumerate their skills. Requires $select to retrieve.
state:
type: string
description: 'The state or province in the user''s address. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
nullable: true
streetAddress:
type: string
description: 'The street address of the user''s place of business. Maximum length is 1,024 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
nullable: true
surname:
type: string
description: 'The user''s surname (family name or last name). Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
nullable: true
usageLocation:
type: string
description: 'A two-letter country code (ISO standard 3166). Required for users that are assigned licenses due to legal requirements to check for availability of services in countries/regions. Examples include: US, JP, and GB. Not nullable. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
nullable: true
userPrincipalName:
type: string
description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
description: 'A string value that can be used to classify user types in your directory. The possible values are Member and Guest. Requires $select to retrieve. Supports $filter (eq, ne, not, in, and eq on null values). NOTE: For more information about the permissions for members and guests, see What are the default user permissions in Microsoft Entra ID?'
nullable: true
activities:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.userActivity'
description: The user's activities across devices. Read-only. Nullable.
x-ms-navigationProperty: true
adhocCalls:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.adhocCall'
description: Ad hoc calls associated with the user. Read-only. Nullable.
x-ms-navigationProperty: true
agreementAcceptances:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.agreementAcceptance'
description: The user's terms of use acceptance statuses. Read-only. Nullable.
x-ms-navigationProperty: true
appRoleAssignments:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.appRoleAssignment'
description: Represents the app roles a user is granted for an application. Supports $expand.
x-ms-navigationProperty: true
authentication:
$ref: '#/components/schemas/microsoft.graph.authentication'
calendar:
$ref: '#/components/schemas/microsoft.graph.calendar'
calendarGroups:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.calendarGroup'
description: The user's calendar groups. Read-only. Nullable.
x-ms-navigationProperty: true
calendars:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.calendar'
description: The user's calendars. Read-only. Nullable.
x-ms-navigationProperty: true
calendarView:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.event'
description: The calendar view for the calendar. Read-only. Nullable.
x-ms-navigationProperty: true
chats:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.chat'
x-ms-navigationProperty: true
cloudClipboard:
$ref: '#/components/schemas/microsoft.graph.cloudClipboardRoot'
cloudPCs:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.cloudPC'
description: The user's Cloud PCs. Read-only. Nullable.
x-ms-navigationProperty: true
contactFolders:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.contactFolder'
description: The user's contacts folders. Read-only. Nullable.
x-ms-navigationProperty: true
contacts:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.contact'
description: The user's contacts. Read-only. Nullable.
x-ms-navigationProperty: true
createdObjects:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: Directory objects that the user created. Read-only. Nullable.
x-ms-navigationProperty: true
dataSecurityAndGovernance:
$ref: '#/components/schemas/microsoft.graph.userDataSecurityAndGovernance'
deviceManagementTroubleshootingEvents:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.deviceManagementTroubleshootingEvent'
description: The list of troubleshooting events for this user.
x-ms-navigationProperty: true
directReports:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts that have their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.drive'
description: A collection of drives available for this user. Read-only.
x-ms-navigationProperty: true
employeeExperience:
$ref: '#/components/schemas/microsoft.graph.employeeExperienceUser'
events:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.event'
description: The user's events. Default is to show Events under the Default Calendar. Read-only. Nullable.
x-ms-navigationProperty: true
extensions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.extension'
description: The collection of open extensions defined for the user. Read-only. Supports $expand. Nullable.
x-ms-navigationProperty: true
followedSites:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.site'
x-ms-navigationProperty: true
inferenceClassification:
$ref: '#/components/schemas/microsoft.graph.inferenceClassification'
insights:
$ref: '#/components/schemas/microsoft.graph.itemInsights'
joinedTeams:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.team'
x-ms-navigationProperty: true
licenseDetails:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.licenseDetails'
description: A collection of this user's license details. Read-only.
x-ms-navigationProperty: true
mailFolders:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.mailFolder'
description: The user's mail folders. Read-only. Nullable.
x-ms-navigationProperty: true
managedAppRegistrations:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.managedAppRegistration'
description: Zero or more managed app registrations that belong to the user.
x-ms-navigationProperty: true
managedDevices:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.managedDevice'
description: The managed devices associated with the user.
x-ms-navigationProperty: true
manager:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
memberOf:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The groups and directory roles that the user is a member of. Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
messages:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.message'
description: The messages in a mailbox or folder. Read-only. Nullable.
x-ms-navigationProperty: true
notes:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.note'
description: The notes in the user's Notes folder. Read-only. Nullable.
x-ms-navigationProperty: true
oauth2PermissionGrants:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.oAuth2PermissionGrant'
x-ms-navigationProperty: true
onenote:
$ref: '#/components/schemas/microsoft.graph.onenote'
onlineMeetings:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.onlineMeeting'
description: 'Information about a meeting, including the URL used to join a meeting, the attendees list, and the description.'
x-ms-navigationProperty: true
onPremisesSyncBehavior:
$ref: '#/components/schemas/microsoft.graph.onPremisesSyncBehavior'
outlook:
$ref: '#/components/schemas/microsoft.graph.outlookUser'
ownedDevices:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: 'Devices the user owns. Read-only. Nullable. Supports $expand and $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1).'
x-ms-navigationProperty: true
ownedObjects:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: 'Directory objects the user owns. Read-only. Nullable. Supports $expand, $select nested in $expand, and $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1).'
x-ms-navigationProperty: true
people:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.person'
description: People that are relevant to the user. Read-only. Nullable.
x-ms-navigationProperty: true
permissionGrants:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.resourceSpecificPermissionGrant'
description: List all resource-specific permission grants of a user.
x-ms-navigationProperty: true
photo:
$ref: '#/components/schemas/microsoft.graph.profilePhoto'
photos:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.profilePhoto'
description: The collection of the user's profile photos in different sizes. Read-only.
x-ms-navigationProperty: true
planner:
$ref: '#/components/schemas/microsoft.graph.plannerUser'
presence:
$ref: '#/components/schemas/microsoft.graph.presence'
registeredDevices:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: Devices that are registered for the user. Read-only. Nullable. Supports $expand and returns up to 100 objects.
x-ms-navigationProperty: true
scopedRoleMemberOf:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.scopedRoleMembership'
x-ms-navigationProperty: true
settings:
$ref: '#/components/schemas/microsoft.graph.userSettings'
solutions:
$ref: '#/components/schemas/microsoft.graph.userSolutionRoot'
sponsorOf:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: 'Directory objects that this user sponsors, such as guest users, agent users, agent blueprints, agent blueprint principals, and agent identities. If the user is a member of a group that''s a sponsor, the objects sponsored by that group are also included. Read-only. Nullable. Supports $filter, $count, $select, $expand, $top, and $skip.'
x-ms-navigationProperty: true
sponsors:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: 'The users and groups responsible for this guest''s privileges in the tenant and keeping the guest''s information and access updated. (HTTP Methods: GET, POST, DELETE.). Supports $expand.'
x-ms-navigationProperty: true
teamwork:
$ref: '#/components/schemas/microsoft.graph.userTeamwork'
todo:
$ref: '#/components/schemas/microsoft.graph.todo'
transitiveMemberOf:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: 'The groups, including nested groups, and directory roles that a user is a member of. Nullable.'
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.mailboxSettings:
title: mailboxSettings
type: object
properties:
archiveFolder:
type: string
description: Folder ID of an archive folder for the user.
nullable: true
automaticRepliesSetting:
$ref: '#/components/schemas/microsoft.graph.automaticRepliesSetting'
dateFormat:
type: string
description: The date format for the user's mailbox.
nullable: true
delegateMeetingMessageDeliveryOptions:
$ref: '#/components/schemas/microsoft.graph.delegateMeetingMessageDeliveryOptions'
language:
$ref: '#/components/schemas/microsoft.graph.localeInfo'
timeFormat:
type: string
description: The time format for the user's mailbox.
nullable: true
timeZone:
type: string
description: The default time zone for the user's mailbox.
nullable: true
userPurpose:
$ref: '#/components/schemas/microsoft.graph.userPurpose'
workingHours:
$ref: '#/components/schemas/microsoft.graph.workingHours'
additionalProperties:
type: object
microsoft.graph.itemAnalytics:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: itemAnalytics
type: object
properties:
allTime:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
itemActivityStats:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
x-ms-navigationProperty: true
lastSevenDays:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
additionalProperties:
type: object
microsoft.graph.itemActivityStat:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: itemActivityStat
type: object
properties:
access:
$ref: '#/components/schemas/microsoft.graph.itemActionStat'
create:
$ref: '#/components/schemas/microsoft.graph.itemActionStat'
delete:
$ref: '#/components/schemas/microsoft.graph.itemActionStat'
edit:
$ref: '#/components/schemas/microsoft.graph.itemActionStat'
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: When the interval ends. Read-only.
format: date-time
nullable: true
incompleteData:
$ref: '#/components/schemas/microsoft.graph.incompleteData'
isTrending:
type: boolean
description: Indicates whether the item is 'trending.' Read-only.
nullable: true
move:
$ref: '#/components/schemas/microsoft.graph.itemActionStat'
startDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: When the interval starts. Read-only.
format: date-time
nullable: true
activities:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
description: Exposes the itemActivities represented in this itemActivityStat resource.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.itemActivity:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: itemActivity
type: object
properties:
access:
$ref: '#/components/schemas/microsoft.graph.accessAction'
activityDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Details about when the activity took place. Read-only.
format: date-time
nullable: true
actor:
$ref: '#/components/schemas/microsoft.graph.identitySet'
driveItem:
$ref: '#/components/schemas/microsoft.graph.driveItem'
additionalProperties:
type: object
microsoft.graph.listItem:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
- title: listItem
type: object
properties:
contentType:
$ref: '#/components/schemas/microsoft.graph.contentTypeInfo'
deleted:
$ref: '#/components/schemas/microsoft.graph.deleted'
sharepointIds:
$ref: '#/components/schemas/microsoft.graph.sharepointIds'
analytics:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
documentSetVersions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.documentSetVersion'
description: Version information for a document set version created by a user.
x-ms-navigationProperty: true
driveItem:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
permissions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
description: The set of permissions for the item. Read-only. Nullable.
x-ms-navigationProperty: true
versions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.listItemVersion'
description: The list of previous versions of the list item.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.documentSetVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.listItemVersion'
- title: documentSetVersion
type: object
properties:
comment:
type: string
description: Comment about the captured version.
nullable: true
createdBy:
$ref: '#/components/schemas/microsoft.graph.identitySet'
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Date and time when this version was created.
format: date-time
nullable: true
items:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.documentSetVersionItem'
description: Items within the document set that are captured as part of this version.
shouldCaptureMinorVersion:
type: boolean
description: 'If true, minor versions of items are also captured; otherwise, only major versions are captured. The default value is false.'
nullable: true
additionalProperties:
type: object
microsoft.graph.fieldValueSet:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: fieldValueSet
type: object
additionalProperties:
type: object
microsoft.graph.driveRecipient:
title: driveRecipient
type: object
properties:
alias:
type: string
description: 'The alias of the domain object, for cases where an email address is unavailable (for example, security groups).'
nullable: true
email:
type: string
description: 'The email address for the recipient, if the recipient has an associated email address.'
nullable: true
objectId:
type: string
description: The unique identifier for the recipient in the directory.
nullable: true
additionalProperties:
type: object
microsoft.graph.permission:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: permission
type: object
properties:
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: A format of yyyy-MM-ddTHH:mm:ssZ of DateTimeOffset indicates the expiration time of the permission. DateTime.MinValue indicates there's no expiration set for this permission. Optional.
format: date-time
nullable: true
grantedTo:
$ref: '#/components/schemas/microsoft.graph.identitySet'
grantedToIdentities:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.identitySet'
description: 'For type permissions, the details of the users to whom permission was granted. Read-only.'
grantedToIdentitiesV2:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.sharePointIdentitySet'
description: 'For link type permissions, the details of the users to whom permission was granted. Read-only.'
grantedToV2:
$ref: '#/components/schemas/microsoft.graph.sharePointIdentitySet'
hasPassword:
type: boolean
description: Indicates whether the password is set for this permission. This property only appears in the response. Optional. Read-only. For OneDrive Personal only..
nullable: true
inheritedFrom:
$ref: '#/components/schemas/microsoft.graph.itemReference'
invitation:
$ref: '#/components/schemas/microsoft.graph.sharingInvitation'
link:
$ref: '#/components/schemas/microsoft.graph.sharingLink'
roles:
type: array
items:
type: string
nullable: true
description: 'The type of permission, for example, read. See below for the full list of roles. Read-only.'
shareId:
type: string
description: A unique token that can be used to access this shared item via the shares API. Read-only.
nullable: true
additionalProperties:
type: object
microsoft.graph.listItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
- title: listItemVersion
type: object
properties:
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
additionalProperties:
type: object
microsoft.graph.sensitivityLabelAssignmentMethod:
title: sensitivityLabelAssignmentMethod
enum:
- standard
- privileged
- auto
- unknownFutureValue
type: string
microsoft.graph.itemReference:
title: itemReference
type: object
properties:
driveId:
type: string
description: Unique identifier of the drive instance that contains the driveItem. Only returned if the item is located in a drive. Read-only.
nullable: true
driveType:
type: string
description: Identifies the type of drive. Only returned if the item is located in a drive. See drive resource for values.
nullable: true
id:
type: string
description: Unique identifier of the driveItem in the drive or a listItem in a list. Read-only.
nullable: true
name:
type: string
description: The name of the item being referenced. Read-only.
nullable: true
path:
type: string
description: Percent-encoded path that can be used to navigate to the item. Read-only.
nullable: true
shareId:
type: string
description: A unique identifier for a shared resource that can be accessed via the Shares API.
nullable: true
sharepointIds:
$ref: '#/components/schemas/microsoft.graph.sharepointIds'
siteId:
type: string
description: 'For OneDrive for Business and SharePoint, this property represents the ID of the site that contains the parent document library of the driveItem resource or the parent list of the listItem resource. The value is the same as the id property of that site resource. It is an opaque string that consists of three identifiers of the site. For OneDrive, this property is not populated.'
nullable: true
additionalProperties:
type: object
microsoft.graph.driveItemUploadableProperties:
title: driveItemUploadableProperties
type: object
properties:
description:
type: string
description: Provides a user-visible description of the item. Read-write. Only on OneDrive Personal.
nullable: true
driveItemSource:
$ref: '#/components/schemas/microsoft.graph.driveItemSource'
fileSize:
type: number
description: Provides an expected file size to perform a quota check before uploading. Only on OneDrive Personal.
format: int64
nullable: true
fileSystemInfo:
$ref: '#/components/schemas/microsoft.graph.fileSystemInfo'
mediaSource:
$ref: '#/components/schemas/microsoft.graph.mediaSource'
name:
type: string
description: The name of the item (filename and extension). Read-write.
nullable: true
additionalProperties:
type: object
microsoft.graph.uploadSession:
title: uploadSession
type: object
properties:
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: The date and time in UTC that the upload session expires. The complete file must be uploaded before this expiration time is reached. Each fragment uploaded during the session extends the expiration time.
format: date-time
nullable: true
nextExpectedRanges:
type: array
items:
type: string
nullable: true
description: 'A collection of byte ranges that the server is missing for the file. These ranges are zero indexed and of the format ''start-end'' (for example ''0-26'' to indicate the first 27 bytes of the file). When uploading files as Outlook attachments, instead of a collection of ranges, this property always indicates a single value ''{start}'', the location in the file where the next upload should begin.'
uploadUrl:
type: string
description: The URL endpoint that accepts PUT requests for byte ranges of the file.
nullable: true
additionalProperties:
type: object
microsoft.graph.extractSensitivityLabelsResult:
title: extractSensitivityLabelsResult
type: object
properties:
labels:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.sensitivityLabelAssignment'
description: List of sensitivity labels assigned to a file.
additionalProperties:
type: object
ReferenceNumeric:
enum:
- '-INF'
- INF
- NaN
type: string
nullable: true
microsoft.graph.itemPreviewInfo:
title: itemPreviewInfo
type: object
properties:
getUrl:
type: string
nullable: true
postParameters:
type: string
nullable: true
postUrl:
type: string
nullable: true
additionalProperties:
type: object
microsoft.graph.itemRetentionLabel:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: itemRetentionLabel
type: object
properties:
isLabelAppliedExplicitly:
type: boolean
description: 'Specifies whether the label is applied explicitly on the item. True indicates that the label is applied explicitly; otherwise, the label is inherited from its parent. Read-only.'
nullable: true
labelAppliedBy:
$ref: '#/components/schemas/microsoft.graph.identitySet'
labelAppliedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The date and time when the label was applied on the item. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.'
format: date-time
nullable: true
name:
type: string
description: The retention label on the document. Read-write.
nullable: true
retentionSettings:
$ref: '#/components/schemas/microsoft.graph.retentionLabelSettings'
additionalProperties:
type: object
microsoft.graph.subscription:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: subscription
type: object
properties:
applicationId:
type: string
description: Optional. Identifier of the application used to create the subscription. Read-only.
nullable: true
changeType:
type: string
description: 'Required. Indicates the type of change in the subscribed resource that raises a change notification. The supported values are: created, updated, deleted. Multiple values can be combined using a comma-separated list. Note: Drive root item and list change notifications support only the updated changeType. User and group change notifications support updated and deleted changeType. Use updated to receive notifications when user or group is created, updated, or soft deleted. Use deleted to receive notifications when user or group is permanently deleted.'
clientState:
type: string
description: Optional. Specifies the value of the clientState property sent by the service in each change notification. The maximum length is 128 characters. The client can check that the change notification came from the service by comparing the value of the clientState property sent with the subscription with the value of the clientState property received with each change notification.
nullable: true
creatorId:
type: string
description: 'Optional. Identifier of the user or service principal that created the subscription. If the app used delegated permissions to create the subscription, this field contains the ID of the signed-in user the app called on behalf of. If the app used application permissions, this field contains the ID of the service principal corresponding to the app. Read-only.'
nullable: true
encryptionCertificate:
type: string
description: Optional. A base64-encoded representation of a certificate with a public key used to encrypt resource data in change notifications. Optional but required when includeResourceData is true.
nullable: true
encryptionCertificateId:
type: string
description: Optional. A custom app-provided identifier to help identify the certificate needed to decrypt resource data.
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'Required. Specifies the date and time when the webhook subscription expires. The time is in UTC, and can be an amount of time from subscription creation that varies for the resource subscribed to. Any value under 45 minutes after the time of the request is automatically set to 45 minutes after the request time. For the maximum supported subscription length of time, see Subscription lifetime.'
format: date-time
includeResourceData:
type: boolean
description: 'Optional. When set to true, change notifications include resource data (such as content of a chat message).'
nullable: true
latestSupportedTlsVersion:
type: string
description: 'Optional. Specifies the latest version of Transport Layer Security (TLS) that the notification endpoint, specified by notificationUrl, supports. The possible values are: v10, v11, v12, v13. For subscribers whose notification endpoint supports a version lower than the currently recommended version (TLS 1.2), specifying this property by a set timeline allows them to temporarily use their deprecated version of TLS before completing their upgrade to TLS 1.2. For these subscribers, not setting this property per the timeline would result in subscription operations failing. For subscribers whose notification endpoint already supports TLS 1.2, setting this property is optional. In such cases, Microsoft Graph defaults the property to v1_2.'
nullable: true
lifecycleNotificationUrl:
type: string
description: 'Required for Teams resources if the expirationDateTime value is more than 1 hour from now; optional otherwise. The URL of the endpoint that receives lifecycle notifications, including subscriptionRemoved, reauthorizationRequired, and missed notifications. This URL must make use of the HTTPS protocol. For more information, see Reduce missing subscriptions and change notifications.'
nullable: true
notificationQueryOptions:
type: string
description: 'Optional. OData query options for specifying value for the targeting resource. Clients receive notifications when resource reaches the state matching the query options provided here. With this new property in the subscription creation payload along with all existing properties, Webhooks deliver notifications whenever a resource reaches the desired state mentioned in the notificationQueryOptions property. For example, when the print job is completed or when a print job resource isFetchable property value becomes true etc. Supported only for Universal Print Service. For more information, see Subscribe to change notifications from cloud printing APIs using Microsoft Graph.'
nullable: true
notificationUrl:
type: string
description: Required. The URL of the endpoint that receives the change notifications. This URL must make use of the HTTPS protocol. Any query string parameter included in the notificationUrl property is included in the HTTP POST request when Microsoft Graph sends the change notifications.
notificationUrlAppId:
type: string
description: Optional. The app ID that the subscription service can use to generate the validation token. The value allows the client to validate the authenticity of the notification received.
nullable: true
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/v1.0/). See the possible resource path values for each supported resource.
additionalProperties:
type: object
microsoft.graph.thumbnailSet:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: thumbnailSet
type: object
properties:
large:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
medium:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
small:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
source:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
- title: driveItemVersion
type: object
properties:
content:
type: string
description: The content stream for this version of the item.
format: base64url
nullable: true
size:
type: number
description: Indicates the size of the content stream for this version of the item.
format: int64
nullable: true
additionalProperties:
type: object
microsoft.graph.list:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
- title: list
type: object
properties:
displayName:
type: string
description: The displayable title of the list.
nullable: true
list:
$ref: '#/components/schemas/microsoft.graph.listInfo'
sharepointIds:
$ref: '#/components/schemas/microsoft.graph.sharepointIds'
system:
$ref: '#/components/schemas/microsoft.graph.systemFacet'
columns:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
description: The collection of field definitions for this list.
x-ms-navigationProperty: true
contentTypes:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.contentType'
description: The collection of content types present in this list.
x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
items:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.listItem'
description: All items contained in the list.
x-ms-navigationProperty: true
operations:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
permissions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
description: The set of permissions for the item. Read-only. Nullable.
x-ms-navigationProperty: true
subscriptions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.subscription'
description: The set of subscriptions on the list.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.columnDefinition:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: columnDefinition
type: object
properties:
boolean:
$ref: '#/components/schemas/microsoft.graph.booleanColumn'
calculated:
$ref: '#/components/schemas/microsoft.graph.calculatedColumn'
choice:
$ref: '#/components/schemas/microsoft.graph.choiceColumn'
columnGroup:
type: string
description: 'For site columns, the name of the group this column belongs to. Helps organize related columns.'
nullable: true
contentApprovalStatus:
$ref: '#/components/schemas/microsoft.graph.contentApprovalStatusColumn'
currency:
$ref: '#/components/schemas/microsoft.graph.currencyColumn'
dateTime:
$ref: '#/components/schemas/microsoft.graph.dateTimeColumn'
defaultValue:
$ref: '#/components/schemas/microsoft.graph.defaultColumnValue'
description:
type: string
description: The user-facing description of the column.
nullable: true
displayName:
type: string
description: The user-facing name of the column.
nullable: true
enforceUniqueValues:
type: boolean
description: 'If true, no two list items may have the same value for this column.'
nullable: true
geolocation:
$ref: '#/components/schemas/microsoft.graph.geolocationColumn'
hidden:
type: boolean
description: Specifies whether the column is displayed in the user interface.
nullable: true
hyperlinkOrPicture:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
description: Indicates whether this column can be deleted.
nullable: true
isReorderable:
type: boolean
description: Indicates whether values in the column can be reordered. Read-only.
nullable: true
isSealed:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
type: string
description: 'The API-facing name of the column as it appears in the fields on a listItem. For the user-facing name, see displayName.'
nullable: true
number:
$ref: '#/components/schemas/microsoft.graph.numberColumn'
personOrGroup:
$ref: '#/components/schemas/microsoft.graph.personOrGroupColumn'
propagateChanges:
type: boolean
description: 'If ''true'', changes to this column will be propagated to lists that implement the column.'
nullable: true
readOnly:
type: boolean
description: Specifies whether the column values can be modified.
nullable: true
required:
type: boolean
description: Specifies whether the column value isn't optional.
nullable: true
sourceContentType:
$ref: '#/components/schemas/microsoft.graph.contentTypeInfo'
term:
$ref: '#/components/schemas/microsoft.graph.termColumn'
text:
$ref: '#/components/schemas/microsoft.graph.textColumn'
thumbnail:
$ref: '#/components/schemas/microsoft.graph.thumbnailColumn'
type:
$ref: '#/components/schemas/microsoft.graph.columnTypes'
validation:
$ref: '#/components/schemas/microsoft.graph.columnValidation'
sourceColumn:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
additionalProperties:
type: object
microsoft.graph.contentType:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: contentType
type: object
properties:
associatedHubsUrls:
type: array
items:
type: string
nullable: true
description: List of canonical URLs for hub sites with which this content type is associated to. This will contain all hub sites where this content type is queued to be enforced or is already enforced. Enforcing a content type means that the content type is applied to the lists in the enforced sites.
description:
type: string
description: The descriptive text for the item.
nullable: true
documentSet:
$ref: '#/components/schemas/microsoft.graph.documentSet'
documentTemplate:
$ref: '#/components/schemas/microsoft.graph.documentSetContent'
group:
type: string
description: The name of the group this content type belongs to. Helps organize related content types.
nullable: true
hidden:
type: boolean
description: Indicates whether the content type is hidden in the list's 'New' menu.
nullable: true
inheritedFrom:
$ref: '#/components/schemas/microsoft.graph.itemReference'
isBuiltIn:
type: boolean
description: Specifies if a content type is a built-in content type.
nullable: true
name:
type: string
description: The name of the content type.
nullable: true
order:
$ref: '#/components/schemas/microsoft.graph.contentTypeOrder'
parentId:
type: string
description: The unique identifier of the content type.
nullable: true
propagateChanges:
type: boolean
description: 'If true, any changes made to the content type are pushed to inherited content types and lists that implement the content type.'
nullable: true
readOnly:
type: boolean
description: 'If true, the content type can''t be modified unless this value is first set to false.'
nullable: true
sealed:
type: boolean
description: 'If true, the content type can''t be modified by users or through push-down operations. Only site collection administrators can seal or unseal content types.'
nullable: true
base:
$ref: '#/components/schemas/microsoft.graph.contentType'
baseTypes:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.contentType'
description: The collection of content types that are ancestors of this content type.
x-ms-navigationProperty: true
columnLinks:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.columnLink'
description: The collection of columns that are required by this content type.
x-ms-navigationProperty: true
columnPositions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
description: Column order information in a content type.
x-ms-navigationProperty: true
columns:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
description: The collection of column definitions for this content type.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.columnLink:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: columnLink
type: object
properties:
name:
type: string
description: The name of the column in this content type.
nullable: true
additionalProperties:
type: object
microsoft.graph.richLongRunningOperation:
allOf:
- $ref: '#/components/schemas/microsoft.graph.longRunningOperation'
- title: richLongRunningOperation
type: object
properties:
error:
$ref: '#/components/schemas/microsoft.graph.publicError'
percentageComplete:
maximum: 2147483647
minimum: -2147483648
type: number
description: A value between 0 and 100 that indicates the progress of the operation.
format: int32
nullable: true
resourceId:
type: string
description: The unique identifier for the result.
nullable: true
type:
type: string
description: The type of the operation.
nullable: true
additionalProperties:
type: object
description: The status of a long-running operation.
microsoft.graph.sharedDriveItem:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
- title: sharedDriveItem
type: object
properties:
owner:
$ref: '#/components/schemas/microsoft.graph.identitySet'
driveItem:
$ref: '#/components/schemas/microsoft.graph.driveItem'
items:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
description: All driveItems contained in the sharing root. This collection cannot be enumerated.
x-ms-navigationProperty: true
list:
$ref: '#/components/schemas/microsoft.graph.list'
listItem:
$ref: '#/components/schemas/microsoft.graph.listItem'
permission:
$ref: '#/components/schemas/microsoft.graph.permission'
root:
$ref: '#/components/schemas/microsoft.graph.driveItem'
site:
$ref: '#/components/schemas/microsoft.graph.site'
additionalProperties:
type: object
microsoft.graph.site:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
- title: site
type: object
properties:
displayName:
type: string
description: The full title for the site. Read-only.
nullable: true
error:
$ref: '#/components/schemas/microsoft.graph.publicError'
isPersonalSite:
type: boolean
description: Identifies whether the site is personal or not. Read-only.
nullable: true
root:
$ref: '#/components/schemas/microsoft.graph.root'
sharepointIds:
$ref: '#/components/schemas/microsoft.graph.sharepointIds'
siteCollection:
$ref: '#/components/schemas/microsoft.graph.siteCollection'
analytics:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
columns:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
description: The collection of column definitions reusable across lists under this site.
x-ms-navigationProperty: true
contentTypes:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.contentType'
description: The collection of content types defined for this site.
x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.drive'
description: The collection of drives (document libraries) under this site.
x-ms-navigationProperty: true
externalColumns:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.columnDefinition'
x-ms-navigationProperty: true
items:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.baseItem'
description: Used to address any item contained in this site. This collection can't be enumerated.
x-ms-navigationProperty: true
lists:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.list'
description: The collection of lists under this site.
x-ms-navigationProperty: true
onenote:
$ref: '#/components/schemas/microsoft.graph.onenote'
operations:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the site.
x-ms-navigationProperty: true
pages:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.baseSitePage'
description: The collection of pages in the baseSitePages list in this site.
x-ms-navigationProperty: true
permissions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.permission'
description: The permissions associated with the site. Nullable.
x-ms-navigationProperty: true
sites:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.site'
description: The collection of the sub-sites under this site.
x-ms-navigationProperty: true
termStore:
$ref: '#/components/schemas/microsoft.graph.termStore.store'
termStores:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.termStore.store'
description: The collection of termStores under this site.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.baseItem:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: baseItem
type: object
properties:
createdBy:
$ref: '#/components/schemas/microsoft.graph.identitySet'
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Date and time of item creation. Read-only.
format: date-time
description:
type: string
description: Provides a user-visible description of the item. Optional.
nullable: true
eTag:
type: string
description: ETag for the item. Read-only.
nullable: true
lastModifiedBy:
$ref: '#/components/schemas/microsoft.graph.identitySet'
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Date and time the item was last modified. Read-only.
format: date-time
name:
type: string
description: The name of the item. Read-write.
nullable: true
parentReference:
$ref: '#/components/schemas/microsoft.graph.itemReference'
webUrl:
type: string
description: 'URL that either displays the resource in the browser (for Office file formats), or is a direct link to the file (for other formats). Read-only.'
nullable: true
createdByUser:
$ref: '#/components/schemas/microsoft.graph.user'
lastModifiedByUser:
$ref: '#/components/schemas/microsoft.graph.user'
additionalProperties:
type: object
microsoft.graph.identitySet:
title: identitySet
type: object
properties:
application:
$ref: '#/components/schemas/microsoft.graph.identity'
device:
$ref: '#/components/schemas/microsoft.graph.identity'
user:
$ref: '#/components/schemas/microsoft.graph.identity'
additionalProperties:
type: object
microsoft.graph.quota:
title: quota
type: object
properties:
deleted:
type: number
description: 'Total space consumed by files in the recycle bin, in bytes. Read-only.'
format: int64
nullable: true
remaining:
type: number
description: 'Total space remaining before reaching the capacity limit, in bytes. Read-only.'
format: int64
nullable: true
state:
type: string
description: Enumeration value that indicates the state of the storage space. Read-only.
nullable: true
storagePlanInformation:
$ref: '#/components/schemas/microsoft.graph.storagePlanInformation'
total:
type: number
description: 'Total allowed storage space, in bytes. Read-only.'
format: int64
nullable: true
used:
type: number
description: 'Total space used, in bytes. Read-only.'
format: int64
nullable: true
additionalProperties:
type: object
microsoft.graph.sharepointIds:
title: sharepointIds
type: object
properties:
listId:
type: string
description: The unique identifier (guid) for the item's list in SharePoint.
nullable: true
listItemId:
type: string
description: An integer identifier for the item within the containing list.
nullable: true
listItemUniqueId:
type: string
description: The unique identifier (guid) for the item within OneDrive for Business or a SharePoint site.
nullable: true
siteId:
type: string
description: The unique identifier (guid) for the item's site collection (SPSite).
nullable: true
siteUrl:
type: string
description: The SharePoint URL for the site that contains the item.
nullable: true
tenantId:
type: string
description: The unique identifier (guid) for the tenancy.
nullable: true
webId:
type: string
description: The unique identifier (guid) for the item's site (SPWeb).
nullable: true
additionalProperties:
type: object
microsoft.graph.systemFacet:
title: systemFacet
type: object
additionalProperties:
type: object
microsoft.graph.audio:
title: audio
type: object
properties:
album:
type: string
description: The title of the album for this audio file.
nullable: true
albumArtist:
type: string
description: The artist named on the album for the audio file.
nullable: true
artist:
type: string
description: The performing artist for the audio file.
nullable: true
bitrate:
type: number
description: Bitrate expressed in kbps.
format: int64
nullable: true
composers:
type: string
description: The name of the composer of the audio file.
nullable: true
copyright:
type: string
description: Copyright information for the audio file.
nullable: true
disc:
maximum: 32767
minimum: -32768
type: number
description: The number of the disc this audio file came from.
format: int16
nullable: true
discCount:
maximum: 32767
minimum: -32768
type: number
description: The total number of discs in this album.
format: int16
nullable: true
duration:
type: number
description: 'Duration of the audio file, expressed in milliseconds'
format: int64
nullable: true
genre:
type: string
description: The genre of this audio file.
nullable: true
hasDrm:
type: boolean
description: Indicates if the file is protected with digital rights management.
nullable: true
isVariableBitrate:
type: boolean
description: Indicates if the file is encoded with a variable bitrate.
nullable: true
title:
type: string
description: The title of the audio file.
nullable: true
track:
maximum: 2147483647
minimum: -2147483648
type: number
description: The number of the track on the original disc for this audio file.
format: int32
nullable: true
trackCount:
maximum: 2147483647
minimum: -2147483648
type: number
description: The total number of tracks on the original disc for this audio file.
format: int32
nullable: true
year:
maximum: 2147483647
minimum: -2147483648
type: number
description: The year the audio file was recorded.
format: int32
nullable: true
additionalProperties:
type: object
microsoft.graph.bundle:
title: bundle
type: object
properties:
album:
$ref: '#/components/schemas/microsoft.graph.album'
childCount:
maximum: 2147483647
minimum: -2147483648
type: number
description: Number of children contained immediately within this container.
format: int32
nullable: true
additionalProperties:
type: object
microsoft.graph.deleted:
title: deleted
type: object
properties:
state:
type: string
description: Represents the state of the deleted item.
nullable: true
additionalProperties:
type: object
microsoft.graph.file:
title: file
type: object
properties:
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
nullable: true
processingMetadata:
type: boolean
nullable: true
additionalProperties:
type: object
microsoft.graph.fileSystemInfo:
title: fileSystemInfo
type: object
properties:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: The UTC date and time the file was created on a client.
format: date-time
nullable: true
lastAccessedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: The UTC date and time the file was last accessed. Available for the recent file list only.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: The UTC date and time the file was last modified on a client.
format: date-time
nullable: true
additionalProperties:
type: object
microsoft.graph.folder:
title: folder
type: object
properties:
childCount:
maximum: 2147483647
minimum: -2147483648
type: number
description: Number of children contained immediately within this container.
format: int32
nullable: true
view:
$ref: '#/components/schemas/microsoft.graph.folderView'
additionalProperties:
type: object
microsoft.graph.image:
title: image
type: object
properties:
height:
maximum: 2147483647
minimum: -2147483648
type: number
description: 'Optional. Height of the image, in pixels. Read-only.'
format: int32
nullable: true
width:
maximum: 2147483647
minimum: -2147483648
type: number
description: 'Optional. Width of the image, in pixels. Read-only.'
format: int32
nullable: true
additionalProperties:
type: object
microsoft.graph.geoCoordinates:
title: geoCoordinates
type: object
properties:
altitude:
type: number
description: 'Optional. The altitude (height), in feet, above sea level for the item. Read-only.'
format: double
nullable: true
latitude:
type: number
description: 'Optional. The latitude, in decimal, for the item. Read-only.'
format: double
nullable: true
longitude:
type: number
description: 'Optional. The longitude, in decimal, for the item. Read-only.'
format: double
nullable: true
additionalProperties:
type: object
microsoft.graph.malware:
title: malware
type: object
properties:
description:
type: string
description: Contains the virus details for the malware facet.
nullable: true
additionalProperties:
type: object
microsoft.graph.package:
title: package
type: object
properties:
type:
type: string
description: 'A string indicating the type of package. While oneNote is the only currently defined value, you should expect other package types to be returned and handle them accordingly.'
nullable: true
additionalProperties:
type: object
microsoft.graph.pendingOperations:
title: pendingOperations
type: object
properties:
pendingContentUpdate:
$ref: '#/components/schemas/microsoft.graph.pendingContentUpdate'
additionalProperties:
type: object
microsoft.graph.photo:
title: photo
type: object
properties:
cameraMake:
type: string
description: Camera manufacturer. Read-only.
nullable: true
cameraModel:
type: string
description: Camera model. Read-only.
nullable: true
exposureDenominator:
type: number
description: The denominator for the exposure time fraction from the camera. Read-only.
format: double
nullable: true
exposureNumerator:
type: number
description: The numerator for the exposure time fraction from the camera. Read-only.
format: double
nullable: true
fNumber:
type: number
description: The F-stop value from the camera. Read-only.
format: double
nullable: true
focalLength:
type: number
description: The focal length from the camera. Read-only.
format: double
nullable: true
iso:
maximum: 2147483647
minimum: -2147483648
type: number
description: The ISO value from the camera. Read-only.
format: int32
nullable: true
orientation:
maximum: 32767
minimum: -32768
type: number
description: The orientation value from the camera. Writable on OneDrive Personal.
format: int16
nullable: true
takenDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Represents the date and time the photo was taken. Read-only.
format: date-time
nullable: true
additionalProperties:
type: object
microsoft.graph.publicationFacet:
title: publicationFacet
type: object
properties:
checkedOutBy:
$ref: '#/components/schemas/microsoft.graph.identitySet'
level:
type: string
description: The state of publication for this document. Either published or checkout. Read-only.
nullable: true
versionId:
type: string
description: The unique identifier for the version that is visible to the current caller. Read-only.
nullable: true
additionalProperties:
type: object
microsoft.graph.remoteItem:
title: remoteItem
type: object
properties:
createdBy:
$ref: '#/components/schemas/microsoft.graph.identitySet'
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Date and time of item creation. Read-only.
format: date-time
nullable: true
file:
$ref: '#/components/schemas/microsoft.graph.file'
fileSystemInfo:
$ref: '#/components/schemas/microsoft.graph.fileSystemInfo'
folder:
$ref: '#/components/schemas/microsoft.graph.folder'
id:
type: string
description: Unique identifier for the remote item in its drive. Read-only.
nullable: true
image:
$ref: '#/components/schemas/microsoft.graph.image'
lastModifiedBy:
$ref: '#/components/schemas/microsoft.graph.identitySet'
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Date and time the item was last modified. Read-only.
format: date-time
nullable: true
name:
type: string
description: Optional. Filename of the remote item. Read-only.
nullable: true
package:
$ref: '#/components/schemas/microsoft.graph.package'
parentReference:
$ref: '#/components/schemas/microsoft.graph.itemReference'
shared:
$ref: '#/components/schemas/microsoft.graph.shared'
sharepointIds:
$ref: '#/components/schemas/microsoft.graph.sharepointIds'
size:
type: number
description: Size of the remote item. Read-only.
format: int64
nullable: true
specialFolder:
$ref: '#/components/schemas/microsoft.graph.specialFolder'
video:
$ref: '#/components/schemas/microsoft.graph.video'
webDavUrl:
type: string
description: DAV compatible URL for the item.
nullable: true
webUrl:
type: string
description: URL that displays the resource in the browser. Read-only.
nullable: true
additionalProperties:
type: object
microsoft.graph.root:
title: root
type: object
additionalProperties:
type: object
microsoft.graph.searchResult:
title: searchResult
type: object
properties:
onClickTelemetryUrl:
type: string
description: A callback URL that can be used to record telemetry information. The application should issue a GET on this URL if the user interacts with this item to improve the quality of results.
nullable: true
additionalProperties:
type: object
microsoft.graph.shared:
title: shared
type: object
properties:
owner:
$ref: '#/components/schemas/microsoft.graph.identitySet'
scope:
type: string
description: 'Indicates the scope of how the item is shared. The possible values are: anonymous, organization, or users. Read-only.'
nullable: true
sharedBy:
$ref: '#/components/schemas/microsoft.graph.identitySet'
sharedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: The UTC date and time when the item was shared. Read-only.
format: date-time
nullable: true
additionalProperties:
type: object
microsoft.graph.specialFolder:
title: specialFolder
type: object
properties:
name:
type: string
description: The unique identifier for this item in the /drive/special collection
nullable: true
additionalProperties:
type: object
microsoft.graph.video:
title: video
type: object
properties:
audioBitsPerSample:
maximum: 2147483647
minimum: -2147483648
type: number
description: Number of audio bits per sample.
format: int32
nullable: true
audioChannels:
maximum: 2147483647
minimum: -2147483648
type: number
description: Number of audio channels.
format: int32
nullable: true
audioFormat:
type: string
description: 'Name of the audio format (AAC, MP3, etc.).'
nullable: true
audioSamplesPerSecond:
maximum: 2147483647
minimum: -2147483648
type: number
description: Number of audio samples per second.
format: int32
nullable: true
bitrate:
maximum: 2147483647
minimum: -2147483648
type: number
description: Bit rate of the video in bits per second.
format: int32
nullable: true
duration:
type: number
description: Duration of the file in milliseconds.
format: int64
nullable: true
fourCC:
type: string
description: '''Four character code'' name of the video format.'
nullable: true
frameRate:
type: number
description: Frame rate of the video.
format: double
nullable: true
height:
maximum: 2147483647
minimum: -2147483648
type: number
description: 'Height of the video, in pixels.'
format: int32
nullable: true
width:
maximum: 2147483647
minimum: -2147483648
type: number
description: 'Width of the video, in pixels.'
format: int32
nullable: true
additionalProperties:
type: object
microsoft.graph.workbook:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: workbook
type: object
properties:
application:
$ref: '#/components/schemas/microsoft.graph.workbookApplication'
comments:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.workbookComment'
description: Represents a collection of comments in a workbook.
x-ms-navigationProperty: true
functions:
$ref: '#/components/schemas/microsoft.graph.workbookFunctions'
names:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.workbookNamedItem'
description: Represents a collection of workbooks scoped named items (named ranges and constants). Read-only.
x-ms-navigationProperty: true
operations:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.workbookOperation'
description: 'The status of workbook operations. Getting an operation collection is not supported, but you can get the status of a long-running operation if the Location header is returned in the response. Read-only.'
x-ms-navigationProperty: true
tables:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.workbookTable'
description: Represents a collection of tables associated with the workbook. Read-only.
x-ms-navigationProperty: true
worksheets:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.workbookWorksheet'
description: Represents a collection of worksheets associated with the workbook. Read-only.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.directoryObject:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: directoryObject
type: object
properties:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Date and time when this object was deleted. Always null when the object hasn't been deleted.
format: date-time
nullable: true
additionalProperties:
type: object
microsoft.graph.assignedLicense:
title: assignedLicense
type: object
properties:
disabledPlans:
type: array
items:
pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$'
type: string
format: uuid
description: A collection of the unique identifiers for plans that have been disabled. IDs are available in servicePlans > servicePlanId in the tenant's subscribedSkus or serviceStatus > servicePlanId in the tenant's companySubscription.
skuId:
pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$'
type: string
description: The unique identifier for the SKU. Corresponds to the skuId from subscribedSkus or companySubscription.
format: uuid
nullable: true
additionalProperties:
type: object
microsoft.graph.assignedPlan:
title: assignedPlan
type: object
properties:
assignedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The date and time at which the plan was assigned. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.'
format: date-time
nullable: true
capabilityStatus:
type: string
description: 'Condition of the capability assignment. The possible values are Enabled, Warning, Suspended, Deleted, LockedOut. See a detailed description of each value.'
nullable: true
service:
type: string
description: 'The name of the service; for example, exchange.'
nullable: true
servicePlanId:
pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$'
type: string
description: 'A GUID that identifies the service plan. For a complete list of GUIDs and their equivalent friendly service names, see Product names and service plan identifiers for licensing.'
format: uuid
nullable: true
additionalProperties:
type: object
microsoft.graph.authorizationInfo:
title: authorizationInfo
type: object
properties:
certificateUserIds:
type: array
items:
type: string
nullable: true
additionalProperties:
type: object
microsoft.graph.customSecurityAttributeValue:
title: customSecurityAttributeValue
type: object
additionalProperties:
type: object
microsoft.graph.employeeOrgData:
title: employeeOrgData
type: object
properties:
costCenter:
type: string
description: The cost center associated with the user. Requires $select to retrieve. Supports $filter.
nullable: true
division:
type: string
description: The name of the division in which the user works. Requires $select to retrieve. Supports $filter.
nullable: true
additionalProperties:
type: object
microsoft.graph.objectIdentity:
title: objectIdentity
type: object
properties:
issuer:
type: string
description: 'Specifies the issuer of the identity, for example facebook.com. 512 character limit. For local accounts (where signInType isn''t federated), this property is the local default domain name for the tenant, for example contoso.com. For guests from other Microsoft Entra organizations, this is the domain of the federated organization, for example contoso.com. For more information about filtering behavior for this property, see Filtering on the identities property of a user.'
nullable: true
issuerAssignedId:
type: string
description: 'Specifies the unique identifier assigned to the user by the issuer. 64 character limit. The combination of issuer and issuerAssignedId must be unique within the organization. Represents the sign-in name for the user, when signInType is set to emailAddress or userName (also known as local accounts).When signInType is set to: emailAddress (or a custom string that starts with emailAddress like emailAddress1), issuerAssignedId must be a valid email addressuserName, issuerAssignedId must begin with an alphabetical character or number, and can only contain alphanumeric characters and the following symbols: - or _ For more information about filtering behavior for this property, see Filtering on the identities property of a user.'
nullable: true
signInType:
type: string
description: 'Specifies the user sign-in types in your directory, such as emailAddress, userName, federated, or userPrincipalName. federated represents a unique identifier for a user from an issuer that can be in any format chosen by the issuer. Setting or updating a userPrincipalName identity updates the value of the userPrincipalName property on the user object. The validations performed on the userPrincipalName property on the user object, for example, verified domains and acceptable characters, are performed when setting or updating a userPrincipalName identity. Extra validation is enforced on issuerAssignedId when the sign-in type is set to emailAddress or userName. This property can also be set to any custom string. For more information about filtering behavior for this property, see Filtering on the identities property of a user.'
nullable: true
additionalProperties:
type: object
microsoft.graph.licenseAssignmentState:
title: licenseAssignmentState
type: object
properties:
assignedByGroup:
type: string
description: 'Indicates whether the license is directly-assigned or inherited from a group. If directly-assigned, this field is null; if inherited through a group membership, this field contains the ID of the group. Read-Only.'
nullable: true
disabledPlans:
type: array
items:
pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$'
type: string
format: uuid
nullable: true
description: The service plans that are disabled in this assignment. Read-Only.
error:
type: string
description: 'License assignment failure error. If the license is assigned successfully, this field will be Null. Read-Only. The possible values are CountViolation, MutuallyExclusiveViolation, DependencyViolation, ProhibitedInUsageLocationViolation, UniquenessViolation, and Other. For more information on how to identify and resolve license assignment errors, see here.'
nullable: true
lastUpdatedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: The timestamp when the state of the license assignment was last updated.
format: date-time
nullable: true
skuId:
pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$'
type: string
description: The unique identifier for the SKU. Read-Only.
format: uuid
nullable: true
state:
type: string
description: 'Indicate the current state of this assignment. Read-Only. The possible values are Active, ActiveWithError, Disabled, and Error.'
nullable: true
additionalProperties:
type: object
microsoft.graph.onPremisesExtensionAttributes:
title: onPremisesExtensionAttributes
type: object
properties:
extensionAttribute1:
type: string
description: First customizable extension attribute.
nullable: true
extensionAttribute10:
type: string
description: Tenth customizable extension attribute.
nullable: true
extensionAttribute11:
type: string
description: Eleventh customizable extension attribute.
nullable: true
extensionAttribute12:
type: string
description: Twelfth customizable extension attribute.
nullable: true
extensionAttribute13:
type: string
description: Thirteenth customizable extension attribute.
nullable: true
extensionAttribute14:
type: string
description: Fourteenth customizable extension attribute.
nullable: true
extensionAttribute15:
type: string
description: Fifteenth customizable extension attribute.
nullable: true
extensionAttribute2:
type: string
description: Second customizable extension attribute.
nullable: true
extensionAttribute3:
type: string
description: Third customizable extension attribute.
nullable: true
extensionAttribute4:
type: string
description: Fourth customizable extension attribute.
nullable: true
extensionAttribute5:
type: string
description: Fifth customizable extension attribute.
nullable: true
extensionAttribute6:
type: string
description: Sixth customizable extension attribute.
nullable: true
extensionAttribute7:
type: string
description: Seventh customizable extension attribute.
nullable: true
extensionAttribute8:
type: string
description: Eighth customizable extension attribute.
nullable: true
extensionAttribute9:
type: string
description: Ninth customizable extension attribute.
nullable: true
additionalProperties:
type: object
microsoft.graph.onPremisesProvisioningError:
title: onPremisesProvisioningError
type: object
properties:
category:
type: string
description: 'Category of the provisioning error. Note: Currently, there is only one possible value. Possible value: PropertyConflict - indicates a property value is not unique. Other objects contain the same value for the property.'
nullable: true
occurredDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: The date and time at which the error occurred.
format: date-time
nullable: true
propertyCausingError:
type: string
description: 'Name of the directory property causing the error. Current possible values: UserPrincipalName or ProxyAddress'
nullable: true
value:
type: string
description: Value of the property causing the error.
nullable: true
additionalProperties:
type: object
microsoft.graph.passwordProfile:
title: passwordProfile
type: object
properties:
forceChangePasswordNextSignIn:
type: boolean
description: true if the user must change their password on the next sign-in; otherwise false.
nullable: true
forceChangePasswordNextSignInWithMfa:
type: boolean
description: 'If true, at next sign-in, the user must perform a multifactor authentication (MFA) before being forced to change their password. The behavior is identical to forceChangePasswordNextSignIn except that the user is required to first perform a multifactor authentication before password change. After a password change, this property will be automatically reset to false. If not set, default is false.'
nullable: true
password:
type: string
description: 'The password for the user. This property is required when a user is created. It can be updated, but the user will be required to change the password on the next sign-in. The password must satisfy minimum requirements as specified by the user''s passwordPolicies property. By default, a strong password is required.'
nullable: true
additionalProperties:
type: object
microsoft.graph.userPrint:
title: userPrint
type: object
properties:
recentPrinterShares:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.printerShare'
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.provisionedPlan:
title: provisionedPlan
type: object
properties:
capabilityStatus:
type: string
description: 'Condition of the capability assignment. The possible values are Enabled, Warning, Suspended, Deleted, LockedOut. See a detailed description of each value.'
nullable: true
provisioningStatus:
type: string
description: 'The possible values are:Success - Service is fully provisioned.Disabled - Service is disabled.Error - The service plan isn''t provisioned and is in an error state.PendingInput - The service isn''t provisioned and is awaiting service confirmation.PendingActivation - The service is provisioned but requires explicit activation by an administrator (for example, Intune_O365 service plan)PendingProvisioning - Microsoft has added a new service to the product SKU and it isn''t activated in the tenant.'
nullable: true
service:
type: string
description: 'The name of the service; for example, ''AccessControlS2S''.'
nullable: true
additionalProperties:
type: object
microsoft.graph.serviceProvisioningError:
title: serviceProvisioningError
type: object
properties:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: The date and time at which the error occurred.
format: date-time
nullable: true
isResolved:
type: boolean
description: Indicates whether the error has been attended to.
nullable: true
serviceInstance:
type: string
description: 'Qualified service instance (for example, ''SharePoint/Dublin'') that published the service error information.'
nullable: true
additionalProperties:
type: object
microsoft.graph.signInActivity:
title: signInActivity
type: object
properties:
lastNonInteractiveSignInDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The last non-interactive sign-in date for a specific user. You can use this field to calculate the last time a client attempted (either successfully or unsuccessfully) to sign in to the directory on behalf of a user. Because some users may use clients to access tenant resources rather than signing into your tenant directly, you can use the non-interactive sign-in date to along with lastSignInDateTime to identify inactive users. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Microsoft Entra ID maintains non-interactive sign-ins going back to May 2020. For more information about using the value of this property, see Manage inactive user accounts in Microsoft Entra ID.'
format: date-time
nullable: true
lastNonInteractiveSignInRequestId:
type: string
description: Request identifier of the last non-interactive sign-in performed by this user.
nullable: true
lastSignInDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The last interactive sign-in date and time for a specific user. This property records the last time a user attempted an interactive sign-in to the directory—whether the attempt was successful or not. Note: Since unsuccessful attempts are also logged, this value might not accurately reflect actual system usage. For tracking actual account access, please use the lastSuccessfulSignInDateTime property. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.'
format: date-time
nullable: true
lastSignInRequestId:
type: string
description: Request identifier of the last interactive sign-in performed by this user.
nullable: true
lastSuccessfulSignInDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The date and time of the user''s most recent successful interactive or non-interactive sign-in. Use this property if you need to determine when the account was truly accessed. This field can be used to build reports, such as inactive users. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Microsoft Entra ID maintains interactive sign-ins going back to April 2020. For more information about using the value of this property, see Manage inactive user accounts in Microsoft Entra ID.'
format: date-time
nullable: true
lastSuccessfulSignInRequestId:
type: string
description: The request ID of the last successful sign-in.
nullable: true
additionalProperties:
type: object
microsoft.graph.userActivity:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: userActivity
type: object
properties:
activationUrl:
type: string
description: Required. URL used to launch the activity in the best native experience represented by the appId. Might launch a web-based app if no native app exists.
activitySourceHost:
type: string
description: 'Required. URL for the domain representing the cross-platform identity mapping for the app. Mapping is stored either as a JSON file hosted on the domain or configurable via Windows Dev Center. The JSON file is named cross-platform-app-identifiers and is hosted at root of your HTTPS domain, either at the top level domain or include a sub domain. For example: https://contoso.com or https://myapp.contoso.com but NOT https://myapp.contoso.com/somepath. You must have a unique file and domain (or sub domain) per cross-platform app identity. For example, a separate file and domain is needed for Word vs. PowerPoint.'
appActivityId:
type: string
description: Required. The unique activity ID in the context of the app - supplied by caller and immutable thereafter.
appDisplayName:
type: string
description: Optional. Short text description of the app used to generate the activity for use in cases when the app is not installed on the user’s local device.
nullable: true
contentInfo:
$ref: '#/components/schemas/microsoft.graph.Json'
contentUrl:
type: string
description: 'Optional. Used in the event the content can be rendered outside of a native or web-based app experience (for example, a pointer to an item in an RSS feed).'
nullable: true
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Set by the server. DateTime in UTC when the object was created on the server.
format: date-time
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Set by the server. DateTime in UTC when the object expired on the server.
format: date-time
nullable: true
fallbackUrl:
type: string
description: 'Optional. URL used to launch the activity in a web-based app, if available.'
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Set by the server. DateTime in UTC when the object was modified on the server.
format: date-time
nullable: true
status:
$ref: '#/components/schemas/microsoft.graph.status'
userTimezone:
type: string
description: Optional. The timezone in which the user's device used to generate the activity was located at activity creation time; values supplied as Olson IDs in order to support cross-platform representation.
nullable: true
visualElements:
$ref: '#/components/schemas/microsoft.graph.visualInfo'
historyItems:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.activityHistoryItem'
description: Optional. NavigationProperty/Containment; navigation property to the activity's historyItems.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.adhocCall:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: adhocCall
type: object
properties:
recordings:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.callRecording'
description: The recordings of a call. Read-only.
x-ms-navigationProperty: true
transcripts:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.callTranscript'
description: The transcripts of a call. Read-only.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.agreementAcceptance:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: agreementAcceptance
type: object
properties:
agreementFileId:
type: string
description: The identifier of the agreement file accepted by the user.
nullable: true
agreementId:
type: string
description: The identifier of the agreement.
nullable: true
deviceDisplayName:
type: string
description: The display name of the device used for accepting the agreement.
nullable: true
deviceId:
type: string
description: The unique identifier of the device used for accepting the agreement. Supports $filter (eq) and eq for null values.
nullable: true
deviceOSType:
type: string
description: The operating system used to accept the agreement.
nullable: true
deviceOSVersion:
type: string
description: The operating system version of the device used to accept the agreement.
nullable: true
expirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The expiration date time of the acceptance. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Supports $filter (eq, ge, le) and eq for null values.'
format: date-time
nullable: true
recordedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.'
format: date-time
nullable: true
state:
$ref: '#/components/schemas/microsoft.graph.agreementAcceptanceState'
userDisplayName:
type: string
description: Display name of the user when the acceptance was recorded.
nullable: true
userEmail:
type: string
description: Email of the user when the acceptance was recorded.
nullable: true
userId:
type: string
description: The identifier of the user who accepted the agreement. Supports $filter (eq).
nullable: true
userPrincipalName:
type: string
description: UPN of the user when the acceptance was recorded.
nullable: true
additionalProperties:
type: object
microsoft.graph.appRoleAssignment:
allOf:
- $ref: '#/components/schemas/microsoft.graph.directoryObject'
- title: appRoleAssignment
type: object
properties:
appRoleId:
pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$'
type: string
description: 'The identifier (id) for the app role that''s assigned to the principal. This app role must be exposed in the appRoles property on the resource application''s service principal (resourceId). If the resource application hasn''t declared any app roles, a default app role ID of 00000000-0000-0000-0000-000000000000 can be specified to signal that the principal is assigned to the resource app without any specific app roles. Required on create.'
format: uuid
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The time when the app role assignment was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.'
format: date-time
nullable: true
principalDisplayName:
type: string
description: 'The display name of the user, group, or service principal that was granted the app role assignment. Maximum length is 256 characters. Read-only. Supports $filter (eq and startswith).'
nullable: true
principalId:
pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$'
type: string
description: 'The unique identifier (id) for the user, security group, or service principal being granted the app role. Security groups with dynamic memberships are supported. Required on create.'
format: uuid
nullable: true
principalType:
type: string
description: 'The type of the assigned principal. This can either be User, Group, or ServicePrincipal. Read-only.'
nullable: true
resourceDisplayName:
type: string
description: The display name of the resource app's service principal to which the assignment is made. Maximum length is 256 characters.
nullable: true
resourceId:
pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$'
type: string
description: The unique identifier (id) for the resource service principal for which the assignment is made. Required on create. Supports $filter (eq only).
format: uuid
nullable: true
additionalProperties:
type: object
microsoft.graph.authentication:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: authentication
type: object
properties:
emailMethods:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.emailAuthenticationMethod'
description: The email address registered to a user for authentication.
x-ms-navigationProperty: true
externalAuthenticationMethods:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod'
description: Represents the external MFA registered to a user for authentication using an external identity provider.
x-ms-navigationProperty: true
fido2Methods:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.fido2AuthenticationMethod'
description: Represents the FIDO2 security keys registered to a user for authentication.
x-ms-navigationProperty: true
methods:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.authenticationMethod'
description: Represents all authentication methods registered to a user.
x-ms-navigationProperty: true
microsoftAuthenticatorMethods:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.microsoftAuthenticatorAuthenticationMethod'
description: The details of the Microsoft Authenticator app registered to a user for authentication.
x-ms-navigationProperty: true
operations:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.longRunningOperation'
description: 'Represents the status of a long-running operation, such as a password reset operation.'
x-ms-navigationProperty: true
passwordMethods:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.passwordAuthenticationMethod'
description: 'Represents the password registered to a user for authentication. For security, the password itself is never returned in the object, but action can be taken to reset a password.'
x-ms-navigationProperty: true
phoneMethods:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.phoneAuthenticationMethod'
description: The phone numbers registered to a user for authentication.
x-ms-navigationProperty: true
platformCredentialMethods:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.platformCredentialAuthenticationMethod'
description: Represents a platform credential instance registered to a user on Mac OS.
x-ms-navigationProperty: true
softwareOathMethods:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.softwareOathAuthenticationMethod'
description: The software OATH time-based one-time password (TOTP) applications registered to a user for authentication.
x-ms-navigationProperty: true
temporaryAccessPassMethods:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.temporaryAccessPassAuthenticationMethod'
description: Represents a Temporary Access Pass registered to a user for authentication through time-limited passcodes.
x-ms-navigationProperty: true
windowsHelloForBusinessMethods:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.windowsHelloForBusinessAuthenticationMethod'
description: Represents the Windows Hello for Business authentication method registered to a user for authentication.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.calendar:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: calendar
type: object
properties:
allowedOnlineMeetingProviders:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.onlineMeetingProviderType'
description: 'Represent the online meeting service providers that can be used to create online meetings in this calendar. The possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.'
canEdit:
type: boolean
description: 'true if the user can write to the calendar, false otherwise. This property is true for the user who created the calendar. This property is also true for a user who shared a calendar and granted write access.'
nullable: true
canShare:
type: boolean
description: 'true if the user has permission to share the calendar, false otherwise. Only the user who created the calendar can share it.'
nullable: true
canViewPrivateItems:
type: boolean
description: 'If true, the user can read calendar items that have been marked private, false otherwise.'
nullable: true
changeKey:
type: string
description: 'Identifies the version of the calendar object. Every time the calendar is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.'
nullable: true
color:
$ref: '#/components/schemas/microsoft.graph.calendarColor'
defaultOnlineMeetingProvider:
$ref: '#/components/schemas/microsoft.graph.onlineMeetingProviderType'
hexColor:
type: string
description: 'The calendar color, expressed in a hex color code of three hexadecimal values, each ranging from 00 to FF and representing the red, green, or blue components of the color in the RGB color space. If the user has never explicitly set a color for the calendar, this property is empty. Read-only.'
nullable: true
isDefaultCalendar:
type: boolean
description: 'true if this is the default calendar where new events are created by default, false otherwise.'
nullable: true
isRemovable:
type: boolean
description: Indicates whether this user calendar can be deleted from the user mailbox.
nullable: true
isTallyingResponses:
type: boolean
description: Indicates whether this user calendar supports tracking of meeting responses. Only meeting invites sent from users' primary calendars support tracking of meeting responses.
nullable: true
name:
type: string
description: The calendar name.
nullable: true
owner:
$ref: '#/components/schemas/microsoft.graph.emailAddress'
calendarPermissions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.calendarPermission'
description: The permissions of the users with whom the calendar is shared.
x-ms-navigationProperty: true
calendarView:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.event'
description: The calendar view for the calendar. Navigation property. Read-only.
x-ms-navigationProperty: true
events:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.event'
description: The events in the calendar. Navigation property. Read-only.
x-ms-navigationProperty: true
multiValueExtendedProperties:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty'
description: The collection of multi-value extended properties defined for the calendar. Read-only. Nullable.
x-ms-navigationProperty: true
singleValueExtendedProperties:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
description: The collection of single-value extended properties defined for the calendar. Read-only. Nullable.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.calendarGroup:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: calendarGroup
type: object
properties:
changeKey:
type: string
description: 'Identifies the version of the calendar group. Every time the calendar group is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.'
nullable: true
classId:
pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$'
type: string
description: The class identifier. Read-only.
format: uuid
nullable: true
name:
type: string
description: The group name.
nullable: true
calendars:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.calendar'
description: The calendars in the calendar group. Navigation property. Read-only. Nullable.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.event:
allOf:
- $ref: '#/components/schemas/microsoft.graph.outlookItem'
- title: event
type: object
properties:
allowNewTimeProposals:
type: boolean
description: 'true if the meeting organizer allows invitees to propose a new time when responding; otherwise, false. Optional. The default is true.'
nullable: true
attendees:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.attendee'
description: The collection of attendees for the event.
body:
$ref: '#/components/schemas/microsoft.graph.itemBody'
bodyPreview:
type: string
description: The preview of the message associated with the event. It's in text format.
nullable: true
cancelledOccurrences:
type: array
items:
type: string
description: 'Contains occurrenceId property values of canceled instances in a recurring series, if the event is the series master. Instances in a recurring series that are canceled are called canceled occurences.Requires $select to retrieve. Only returned in a Get operation that specifies the ID (seriesMasterId property value) of a series master event.'
end:
$ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone'
hasAttachments:
type: boolean
description: Set to true if the event has attachments.
nullable: true
hideAttendees:
type: boolean
description: 'When set to true, each attendee only sees themselves in the meeting request and meeting Tracking list. The default is false.'
nullable: true
iCalUId:
type: string
description: A unique identifier for an event across calendars. This ID is different for each occurrence in a recurring series. Read-only.
nullable: true
importance:
$ref: '#/components/schemas/microsoft.graph.importance'
isAllDay:
type: boolean
description: 'Set to true if the event lasts all day. If true, regardless of whether it''s a single-day or multi-day event, start, and endtime must be set to midnight and be in the same time zone.'
nullable: true
isCancelled:
type: boolean
description: Set to true if the event has been canceled.
nullable: true
isDraft:
type: boolean
description: 'Set to true if the user has updated the meeting in Outlook but hasn''t sent the updates to attendees. Set to false if all changes are sent, or if the event is an appointment without any attendees.'
nullable: true
isOnlineMeeting:
type: boolean
description: 'True if this event has online meeting information (that is, onlineMeeting points to an onlineMeetingInfo resource), false otherwise. Default is false (onlineMeeting is null). Optional. After you set isOnlineMeeting to true, Microsoft Graph initializes onlineMeeting. Subsequently, Outlook ignores any further changes to isOnlineMeeting, and the meeting remains available online.'
nullable: true
isOrganizer:
type: boolean
description: Set to true if the calendar owner (specified by the owner property of the calendar) is the organizer of the event (specified by the organizer property of the event). It also applies if a delegate organized the event on behalf of the owner.
nullable: true
isReminderOn:
type: boolean
description: Set to true if an alert is set to remind the user of the event.
nullable: true
location:
$ref: '#/components/schemas/microsoft.graph.location'
locations:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.location'
description: 'The locations where the event is held or attended from. The location and locations properties always correspond with each other. If you update the location property, any prior locations in the locations collection are removed and replaced by the new location value.'
onlineMeeting:
$ref: '#/components/schemas/microsoft.graph.onlineMeetingInfo'
onlineMeetingProvider:
$ref: '#/components/schemas/microsoft.graph.onlineMeetingProviderType'
onlineMeetingUrl:
type: string
description: 'A URL for an online meeting. The property is set only when an organizer specifies in Outlook that an event is an online meeting such as Skype. Read-only.To access the URL to join an online meeting, use joinUrl which is exposed via the onlineMeeting property of the event. The onlineMeetingUrl property will be deprecated in the future.'
nullable: true
organizer:
$ref: '#/components/schemas/microsoft.graph.recipient'
originalEndTimeZone:
type: string
description: The end time zone that was set when the event was created. A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook.
nullable: true
originalStart:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'Represents the start time of an event when it''s initially created as an occurrence or exception in a recurring series. This property is not returned for events that are single instances. Its date and time information is expressed in ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z'
format: date-time
nullable: true
originalStartTimeZone:
type: string
description: The start time zone that was set when the event was created. A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook.
nullable: true
recurrence:
$ref: '#/components/schemas/microsoft.graph.patternedRecurrence'
reminderMinutesBeforeStart:
maximum: 2147483647
minimum: -2147483648
type: number
description: The number of minutes before the event start time that the reminder alert occurs.
format: int32
nullable: true
responseRequested:
type: boolean
description: 'Default is true, which represents the organizer would like an invitee to send a response to the event.'
nullable: true
responseStatus:
$ref: '#/components/schemas/microsoft.graph.responseStatus'
sensitivity:
$ref: '#/components/schemas/microsoft.graph.sensitivity'
seriesMasterId:
type: string
description: 'The ID for the recurring series master item, if this event is part of a recurring series.'
nullable: true
showAs:
$ref: '#/components/schemas/microsoft.graph.freeBusyStatus'
start:
$ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone'
subject:
type: string
description: The text of the event's subject line.
nullable: true
transactionId:
type: string
description: 'A custom identifier specified by a client app for the server to avoid redundant POST operations in case of client retries to create the same event. It''s useful when low network connectivity causes the client to time out before receiving a response from the server for the client''s prior create-event request. After you set transactionId when creating an event, you can''t change transactionId in a subsequent update. This property is only returned in a response payload if an app has set it. Optional.'
nullable: true
type:
$ref: '#/components/schemas/microsoft.graph.eventType'
webLink:
type: string
description: 'The URL to open the event in Outlook on the web.Outlook on the web opens the event in the browser if you are signed in to your mailbox. Otherwise, Outlook on the web prompts you to sign in.This URL can''t be accessed from within an iFrame.'
nullable: true
attachments:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.attachment'
description: 'The collection of FileAttachment, ItemAttachment, and referenceAttachment attachments for the event. Navigation property. Read-only. Nullable.'
x-ms-navigationProperty: true
calendar:
$ref: '#/components/schemas/microsoft.graph.calendar'
exceptionOccurrences:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.event'
description: 'Contains the id property values of the event instances that are exceptions in a recurring series.Exceptions can differ from other occurrences in a recurring series, such as the subject, start or end times, or attendees. Exceptions don''t include canceled occurrences.Requires $select and $expand to retrieve. Only returned in a GET operation that specifies the ID (seriesMasterId property value) of a series master event.'
x-ms-navigationProperty: true
extensions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.extension'
description: The collection of open extensions defined for the event. Nullable.
x-ms-navigationProperty: true
instances:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.event'
description: 'The occurrences of a recurring series, if the event is a series master. This property includes occurrences that are part of the recurrence pattern, and exceptions modified, but doesn''t include occurrences canceled from the series. Navigation property. Read-only. Nullable.'
x-ms-navigationProperty: true
multiValueExtendedProperties:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty'
description: The collection of multi-value extended properties defined for the event. Read-only. Nullable.
x-ms-navigationProperty: true
singleValueExtendedProperties:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
description: The collection of single-value extended properties defined for the event. Read-only. Nullable.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.chat:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: chat
type: object
properties:
chatType:
$ref: '#/components/schemas/microsoft.graph.chatType'
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Date and time at which the chat was created. Read-only.
format: date-time
nullable: true
isHiddenForAllMembers:
type: boolean
description: Indicates whether the chat is hidden for all its members. Read-only.
nullable: true
lastUpdatedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Date and time at which the chat was renamed or the list of members was last changed. Read-only.
format: date-time
nullable: true
migrationMode:
$ref: '#/components/schemas/microsoft.graph.migrationMode'
onlineMeetingInfo:
$ref: '#/components/schemas/microsoft.graph.teamworkOnlineMeetingInfo'
originalCreatedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Timestamp of the original creation time for the chat. The value is null if the chat never entered migration mode.
format: date-time
nullable: true
tenantId:
type: string
description: The identifier of the tenant in which the chat was created. Read-only.
nullable: true
topic:
type: string
description: (Optional) Subject or topic for the chat. Only available for group chats.
nullable: true
viewpoint:
$ref: '#/components/schemas/microsoft.graph.chatViewpoint'
webUrl:
type: string
description: 'The URL for the chat in Microsoft Teams. The URL should be treated as an opaque blob, and not parsed. Read-only.'
nullable: true
installedApps:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.teamsAppInstallation'
description: A collection of all the apps in the chat. Nullable.
x-ms-navigationProperty: true
lastMessagePreview:
$ref: '#/components/schemas/microsoft.graph.chatMessageInfo'
members:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.conversationMember'
description: A collection of all the members in the chat. Nullable.
x-ms-navigationProperty: true
messages:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.chatMessage'
description: A collection of all the messages in the chat. Nullable.
x-ms-navigationProperty: true
permissionGrants:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.resourceSpecificPermissionGrant'
description: A collection of permissions granted to apps for the chat.
x-ms-navigationProperty: true
pinnedMessages:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.pinnedChatMessageInfo'
description: A collection of all the pinned messages in the chat. Nullable.
x-ms-navigationProperty: true
tabs:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.teamsTab'
description: A collection of all the tabs in the chat. Nullable.
x-ms-navigationProperty: true
targetedMessages:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.targetedChatMessage'
description: 'A collection of targeted messages in the chat that are visible only to specific users. Nullable. You can''t expand this relationship using $expand. Targeted messages can also be retrieved via the userTeamwork: getAllTargetedMessages API.'
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.cloudClipboardRoot:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: cloudClipboardRoot
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.cloudClipboardItem'
description: Represents a collection of Cloud Clipboard items.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.cloudPC:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: cloudPC
type: object
properties:
aadDeviceId:
type: string
description: 'The Microsoft Entra device ID for the Cloud PC, also known as the Azure Active Directory (Azure AD) device ID, that consists of 32 characters in a GUID format. Generated on a VM joined to Microsoft Entra ID. Read-only.'
nullable: true
displayName:
type: string
description: 'The display name for the Cloud PC. Maximum length is 64 characters. Read-only. You can use the cloudPC: rename API to modify the Cloud PC name.'
nullable: true
gracePeriodEndDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The date and time when the grace period ends and reprovisioning or deprovisioning happen. Required only if the status is inGracePeriod. The timestamp is shown in ISO 8601 format and Coordinated Universal Time (UTC). For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.'
format: date-time
nullable: true
imageDisplayName:
type: string
description: 'The name of the operating system image used for the Cloud PC. Maximum length is 50 characters. Only letters (A-Z, a-z), numbers (0-9), and special characters (-,,.) are allowed for this property. The property value can''t begin or end with an underscore. Read-only.'
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The last modified date and time of the Cloud PC. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.'
format: date-time
managedDeviceId:
type: string
description: The Intune enrolled device ID for the Cloud PC that consists of 32 characters in a GUID format. The managedDeviceId property of Windows 365 Business Cloud PCs is always null as Windows 365 Business Cloud PCs aren't Intune-enrolled automatically by Windows 365. Read-only.
nullable: true
managedDeviceName:
type: string
description: The Intune enrolled device name for the Cloud PC. The managedDeviceName property of Windows 365 Business Cloud PCs is always null as Windows 365 Business Cloud PCs aren't Intune-enrolled automatically by Windows 365. Read-only.
nullable: true
onPremisesConnectionName:
type: string
description: The on-premises connection that applied during the provisioning of Cloud PCs. Read-only.
nullable: true
provisioningPolicyId:
type: string
description: The provisioning policy ID for the Cloud PC that consists of 32 characters in a GUID format. A policy defines the type of Cloud PC the user wants to create. Read-only.
nullable: true
provisioningPolicyName:
type: string
description: The provisioning policy that applied during the provisioning of Cloud PCs. Maximum length is 120 characters. Read-only.
nullable: true
provisioningType:
$ref: '#/components/schemas/microsoft.graph.cloudPcProvisioningType'
servicePlanId:
type: string
description: 'The service plan ID for the Cloud PC that consists of 32 characters in a GUID format. For more information about service plans, see Product names and service plan identifiers for licensing. Read-only.'
nullable: true
servicePlanName:
type: string
description: The service plan name for the customer-facing Cloud PC entity. Read-only.
nullable: true
userPrincipalName:
type: string
description: 'The user principal name (UPN) of the user assigned to the Cloud PC. Maximum length is 113 characters. For more information on username policies, see Password policies and account restrictions in Microsoft Entra ID. Read-only.'
nullable: true
additionalProperties:
type: object
microsoft.graph.contactFolder:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: contactFolder
type: object
properties:
displayName:
type: string
description: The folder's display name.
nullable: true
parentFolderId:
type: string
description: The ID of the folder's parent folder.
nullable: true
childFolders:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.contactFolder'
description: The collection of child folders in the folder. Navigation property. Read-only. Nullable.
x-ms-navigationProperty: true
contacts:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.contact'
description: The contacts in the folder. Navigation property. Read-only. Nullable.
x-ms-navigationProperty: true
multiValueExtendedProperties:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty'
description: The collection of multi-value extended properties defined for the contactFolder. Read-only. Nullable.
x-ms-navigationProperty: true
singleValueExtendedProperties:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
description: The collection of single-value extended properties defined for the contactFolder. Read-only. Nullable.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.contact:
allOf:
- $ref: '#/components/schemas/microsoft.graph.outlookItem'
- title: contact
type: object
properties:
assistantName:
type: string
description: The name of the contact's assistant.
nullable: true
birthday:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The contact''s birthday. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z'
format: date-time
nullable: true
businessAddress:
$ref: '#/components/schemas/microsoft.graph.physicalAddress'
businessHomePage:
type: string
description: The business home page of the contact.
nullable: true
businessPhones:
type: array
items:
type: string
nullable: true
description: The contact's business phone numbers.
children:
type: array
items:
type: string
nullable: true
description: The names of the contact's children.
companyName:
type: string
description: The name of the contact's company.
nullable: true
department:
type: string
description: The contact's department.
nullable: true
displayName:
type: string
description: 'The contact''s display name. You can specify the display name in a create or update operation. Note that later updates to other properties may cause an automatically generated value to overwrite the displayName value you have specified. To preserve a pre-existing value, always include it as displayName in an update operation.'
nullable: true
emailAddresses:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.emailAddress'
description: The contact's email addresses.
fileAs:
type: string
description: The name the contact is filed under.
nullable: true
generation:
type: string
description: The contact's suffix.
nullable: true
givenName:
type: string
description: The contact's given name.
nullable: true
homeAddress:
$ref: '#/components/schemas/microsoft.graph.physicalAddress'
homePhones:
type: array
items:
type: string
nullable: true
description: The contact's home phone numbers.
imAddresses:
type: array
items:
type: string
nullable: true
description: The contact's instant messaging (IM) addresses.
initials:
type: string
description: The contact's initials.
nullable: true
jobTitle:
type: string
description: The contact’s job title.
nullable: true
manager:
type: string
description: The name of the contact's manager.
nullable: true
middleName:
type: string
description: The contact's middle name.
nullable: true
mobilePhone:
type: string
description: The contact's mobile phone number.
nullable: true
nickName:
type: string
description: The contact's nickname.
nullable: true
officeLocation:
type: string
description: The location of the contact's office.
nullable: true
otherAddress:
$ref: '#/components/schemas/microsoft.graph.physicalAddress'
parentFolderId:
type: string
description: The ID of the contact's parent folder.
nullable: true
personalNotes:
type: string
description: The user's notes about the contact.
nullable: true
primaryEmailAddress:
$ref: '#/components/schemas/microsoft.graph.emailAddress'
profession:
type: string
description: The contact's profession.
nullable: true
secondaryEmailAddress:
$ref: '#/components/schemas/microsoft.graph.emailAddress'
spouseName:
type: string
description: The name of the contact's spouse/partner.
nullable: true
surname:
type: string
description: The contact's surname.
nullable: true
tertiaryEmailAddress:
$ref: '#/components/schemas/microsoft.graph.emailAddress'
title:
type: string
description: The contact's title.
nullable: true
yomiCompanyName:
type: string
description: The phonetic Japanese company name of the contact.
nullable: true
yomiGivenName:
type: string
description: The phonetic Japanese given name (first name) of the contact.
nullable: true
yomiSurname:
type: string
description: The phonetic Japanese surname (last name) of the contact.
nullable: true
extensions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.extension'
description: The collection of open extensions defined for the contact. Read-only. Nullable.
x-ms-navigationProperty: true
multiValueExtendedProperties:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty'
description: The collection of multi-value extended properties defined for the contact. Read-only. Nullable.
x-ms-navigationProperty: true
photo:
$ref: '#/components/schemas/microsoft.graph.profilePhoto'
singleValueExtendedProperties:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
description: The collection of single-value extended properties defined for the contact. Read-only. Nullable.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.userDataSecurityAndGovernance:
allOf:
- $ref: '#/components/schemas/microsoft.graph.dataSecurityAndGovernance'
- title: userDataSecurityAndGovernance
type: object
properties:
activities:
$ref: '#/components/schemas/microsoft.graph.activitiesContainer'
protectionScopes:
$ref: '#/components/schemas/microsoft.graph.userProtectionScopeContainer'
additionalProperties:
type: object
microsoft.graph.deviceManagementTroubleshootingEvent:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: deviceManagementTroubleshootingEvent
type: object
properties:
correlationId:
type: string
description: Id used for tracing the failure in the service.
nullable: true
eventDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Time when the event occurred .
format: date-time
additionalProperties:
type: object
description: Event representing an general failure.
microsoft.graph.employeeExperienceUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: employeeExperienceUser
type: object
properties:
assignedRoles:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.engagementRole'
description: Represents the collection of Viva Engage roles assigned to a user.
x-ms-navigationProperty: true
learningCourseActivities:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.learningCourseActivity'
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.extension:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: extension
type: object
additionalProperties:
type: object
microsoft.graph.inferenceClassification:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: inferenceClassification
type: object
properties:
overrides:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.inferenceClassificationOverride'
description: 'A set of overrides for a user to always classify messages from specific senders in certain ways: focused, or other. Read-only. Nullable.'
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.itemInsights:
allOf:
- $ref: '#/components/schemas/microsoft.graph.officeGraphInsights'
- title: itemInsights
type: object
additionalProperties:
type: object
microsoft.graph.team:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: team
type: object
properties:
classification:
type: string
description: An optional label. Typically describes the data or business sensitivity of the team. Must match one of a preconfigured set in the tenant's directory.
nullable: true
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Timestamp at which the team was created.
format: date-time
nullable: true
description:
type: string
description: 'An optional description for the team. Maximum length: 1,024 characters.'
nullable: true
displayName:
type: string
description: The name of the team.
nullable: true
firstChannelName:
type: string
description: 'The name of the first channel in the team. This is an optional property, only used during team creation and isn''t returned in methods to get and list teams.'
nullable: true
funSettings:
$ref: '#/components/schemas/microsoft.graph.teamFunSettings'
guestSettings:
$ref: '#/components/schemas/microsoft.graph.teamGuestSettings'
internalId:
type: string
description: A unique ID for the team that was used in a few places such as the audit log/Office 365 Management Activity API.
nullable: true
isArchived:
type: boolean
description: Whether this team is in read-only mode.
nullable: true
memberSettings:
$ref: '#/components/schemas/microsoft.graph.teamMemberSettings'
messagingSettings:
$ref: '#/components/schemas/microsoft.graph.teamMessagingSettings'
specialization:
$ref: '#/components/schemas/microsoft.graph.teamSpecialization'
summary:
$ref: '#/components/schemas/microsoft.graph.teamSummary'
tenantId:
type: string
description: The ID of the Microsoft Entra tenant.
nullable: true
visibility:
$ref: '#/components/schemas/microsoft.graph.teamVisibilityType'
webUrl:
type: string
description: 'A hyperlink that goes to the team in the Microsoft Teams client. You get this URL when you right-click a team in the Microsoft Teams client and select Get link to team. This URL should be treated as an opaque blob, and not parsed.'
nullable: true
allChannels:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.channel'
description: List of channels either hosted in or shared with the team (incoming channels).
x-ms-navigationProperty: true
channels:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.channel'
description: The collection of channels and messages associated with the team.
x-ms-navigationProperty: true
group:
$ref: '#/components/schemas/microsoft.graph.group'
incomingChannels:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.channel'
description: List of channels shared with the team.
x-ms-navigationProperty: true
installedApps:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.teamsAppInstallation'
description: The apps installed in this team.
x-ms-navigationProperty: true
members:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.conversationMember'
description: Members and owners of the team.
x-ms-navigationProperty: true
operations:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.teamsAsyncOperation'
description: The async operations that ran or are running on this team.
x-ms-navigationProperty: true
permissionGrants:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.resourceSpecificPermissionGrant'
description: A collection of permissions granted to apps to access the team.
x-ms-navigationProperty: true
photo:
$ref: '#/components/schemas/microsoft.graph.profilePhoto'
primaryChannel:
$ref: '#/components/schemas/microsoft.graph.channel'
schedule:
$ref: '#/components/schemas/microsoft.graph.schedule'
tags:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.teamworkTag'
description: The tags associated with the team.
x-ms-navigationProperty: true
template:
$ref: '#/components/schemas/microsoft.graph.teamsTemplate'
additionalProperties:
type: object
microsoft.graph.licenseDetails:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: licenseDetails
type: object
properties:
servicePlans:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.servicePlanInfo'
description: Information about the service plans assigned with the license. Read-only. Not nullable.
skuId:
pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$'
type: string
description: Unique identifier (GUID) for the service SKU. Equal to the skuId property on the related subscribedSku object. Read-only.
format: uuid
nullable: true
skuPartNumber:
type: string
description: 'Unique SKU display name. Equal to the skuPartNumber on the related subscribedSku object; for example, AAD_Premium. Read-only.'
nullable: true
additionalProperties:
type: object
microsoft.graph.mailFolder:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: mailFolder
type: object
properties:
childFolderCount:
maximum: 2147483647
minimum: -2147483648
type: number
description: The number of immediate child mailFolders in the current mailFolder.
format: int32
nullable: true
displayName:
type: string
description: The mailFolder's display name.
nullable: true
isHidden:
type: boolean
description: Indicates whether the mailFolder is hidden. This property can be set only when creating the folder. Find more information in Hidden mail folders.
nullable: true
parentFolderId:
type: string
description: The unique identifier for the mailFolder's parent mailFolder.
nullable: true
totalItemCount:
maximum: 2147483647
minimum: -2147483648
type: number
description: The number of items in the mailFolder.
format: int32
nullable: true
unreadItemCount:
maximum: 2147483647
minimum: -2147483648
type: number
description: The number of items in the mailFolder marked as unread.
format: int32
nullable: true
childFolders:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.mailFolder'
description: The collection of child folders in the mailFolder.
x-ms-navigationProperty: true
messageRules:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.messageRule'
description: The collection of rules that apply to the user's Inbox folder.
x-ms-navigationProperty: true
messages:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.message'
description: The collection of messages in the mailFolder.
x-ms-navigationProperty: true
multiValueExtendedProperties:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty'
description: The collection of multi-value extended properties defined for the mailFolder. Read-only. Nullable.
x-ms-navigationProperty: true
singleValueExtendedProperties:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
description: The collection of single-value extended properties defined for the mailFolder. Read-only. Nullable.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.managedAppRegistration:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: managedAppRegistration
type: object
properties:
appIdentifier:
$ref: '#/components/schemas/microsoft.graph.mobileAppIdentifier'
applicationVersion:
type: string
description: App version
nullable: true
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Date and time of creation
format: date-time
deviceName:
type: string
description: Host device name
nullable: true
deviceTag:
type: string
description: 'App management SDK generated tag, which helps relate apps hosted on the same device. Not guaranteed to relate apps in all conditions.'
nullable: true
deviceType:
type: string
description: Host device type
nullable: true
flaggedReasons:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.managedAppFlaggedReason'
description: Zero or more reasons an app registration is flagged. E.g. app running on rooted device
lastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Date and time of last the app synced with management service.
format: date-time
managementSdkVersion:
type: string
description: App management SDK version
nullable: true
platformVersion:
type: string
description: Operating System version
nullable: true
userId:
type: string
description: The user Id to who this app registration belongs.
nullable: true
version:
type: string
description: Version of the entity.
nullable: true
appliedPolicies:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.managedAppPolicy'
description: Zero or more policys already applied on the registered app when it last synchronized with managment service.
x-ms-navigationProperty: true
intendedPolicies:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.managedAppPolicy'
description: Zero or more policies admin intended for the app as of now.
x-ms-navigationProperty: true
operations:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.managedAppOperation'
description: Zero or more long running operations triggered on the app registration.
x-ms-navigationProperty: true
additionalProperties:
type: object
description: The ManagedAppEntity is the base entity type for all other entity types under app management workflow.
microsoft.graph.managedDevice:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: managedDevice
type: object
properties:
activationLockBypassCode:
type: string
description: 'The code that allows the Activation Lock on managed device to be bypassed. Default, is Null (Non-Default property) for this property when returned as part of managedDevice entity in LIST call. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.'
nullable: true
readOnly: true
androidSecurityPatchLevel:
type: string
description: Android security patch level. This property is read-only.
nullable: true
readOnly: true
azureADDeviceId:
type: string
description: The unique identifier for the Azure Active Directory device. Read only. This property is read-only.
nullable: true
readOnly: true
azureADRegistered:
type: boolean
description: Whether the device is Azure Active Directory registered. This property is read-only.
nullable: true
readOnly: true
complianceGracePeriodExpirationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: The DateTime when device compliance grace period expires. This property is read-only.
format: date-time
readOnly: true
complianceState:
$ref: '#/components/schemas/microsoft.graph.complianceState'
configurationManagerClientEnabledFeatures:
$ref: '#/components/schemas/microsoft.graph.configurationManagerClientEnabledFeatures'
deviceActionResults:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.deviceActionResult'
description: List of ComplexType deviceActionResult objects. This property is read-only.
readOnly: true
deviceCategoryDisplayName:
type: string
description: Device category display name. Default is an empty string. Supports $filter operator 'eq' and 'or'. This property is read-only.
nullable: true
readOnly: true
deviceEnrollmentType:
$ref: '#/components/schemas/microsoft.graph.deviceEnrollmentType'
deviceHealthAttestationState:
$ref: '#/components/schemas/microsoft.graph.deviceHealthAttestationState'
deviceName:
type: string
description: Name of the device. This property is read-only.
nullable: true
readOnly: true
deviceRegistrationState:
$ref: '#/components/schemas/microsoft.graph.deviceRegistrationState'
easActivated:
type: boolean
description: Whether the device is Exchange ActiveSync activated. This property is read-only.
readOnly: true
easActivationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Exchange ActivationSync activation time of the device. This property is read-only.
format: date-time
readOnly: true
easDeviceId:
type: string
description: Exchange ActiveSync Id of the device. This property is read-only.
nullable: true
readOnly: true
emailAddress:
type: string
description: Email(s) for the user associated with the device. This property is read-only.
nullable: true
readOnly: true
enrolledDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Enrollment time of the device. Supports $filter operator 'lt' and 'gt'. This property is read-only.
format: date-time
readOnly: true
enrollmentProfileName:
type: string
description: 'Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only.'
nullable: true
readOnly: true
ethernetMacAddress:
type: string
description: 'Indicates Ethernet MAC Address of the device. Default, is Null (Non-Default property) for this property when returned as part of managedDevice entity. Individual get call with select query options is needed to retrieve actual values. Example: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Supports: $select. $Search is not supported. Read-only. This property is read-only.'
nullable: true
readOnly: true
exchangeAccessState:
$ref: '#/components/schemas/microsoft.graph.deviceManagementExchangeAccessState'
exchangeAccessStateReason:
$ref: '#/components/schemas/microsoft.graph.deviceManagementExchangeAccessStateReason'
exchangeLastSuccessfulSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Last time the device contacted Exchange. This property is read-only.
format: date-time
readOnly: true
freeStorageSpaceInBytes:
type: number
description: Free Storage in Bytes. Default value is 0. Read-only. This property is read-only.
format: int64
readOnly: true
iccid:
type: string
description: 'Integrated Circuit Card Identifier, it is A SIM card''s unique identification number. Default is an empty string. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.'
nullable: true
readOnly: true
imei:
type: string
description: IMEI. This property is read-only.
nullable: true
readOnly: true
isEncrypted:
type: boolean
description: Device encryption status. This property is read-only.
readOnly: true
isSupervised:
type: boolean
description: Device supervised status. This property is read-only.
readOnly: true
jailBroken:
type: string
description: Whether the device is jail broken or rooted. Default is an empty string. Supports $filter operator 'eq' and 'or'. This property is read-only.
nullable: true
readOnly: true
lastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: The date and time that the device last completed a successful sync with Intune. Supports $filter operator 'lt' and 'gt'. This property is read-only.
format: date-time
readOnly: true
managedDeviceName:
type: string
description: Automatically generated name to identify a device. Can be overwritten to a user friendly name.
nullable: true
managedDeviceOwnerType:
$ref: '#/components/schemas/microsoft.graph.managedDeviceOwnerType'
managementAgent:
$ref: '#/components/schemas/microsoft.graph.managementAgentType'
managementCertificateExpirationDate:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: Reports device management certificate expiration date. This property is read-only.
format: date-time
readOnly: true
managementState:
$ref: '#/components/schemas/microsoft.graph.managementState'
manufacturer:
type: string
description: Manufacturer of the device. This property is read-only.
nullable: true
readOnly: true
meid:
type: string
description: MEID. This property is read-only.
nullable: true
readOnly: true
model:
type: string
description: Model of the device. This property is read-only.
nullable: true
readOnly: true
notes:
type: string
description: 'Notes on the device created by IT Admin. Default is null. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. $Search is not supported.'
nullable: true
operatingSystem:
type: string
description: 'Operating system of the device. Windows, iOS, etc. This property is read-only.'
nullable: true
readOnly: true
osVersion:
type: string
description: Operating system version of the device. This property is read-only.
nullable: true
readOnly: true
partnerReportedThreatState:
$ref: '#/components/schemas/microsoft.graph.managedDevicePartnerReportedHealthState'
phoneNumber:
type: string
description: Phone number of the device. This property is read-only.
nullable: true
readOnly: true
physicalMemoryInBytes:
type: number
description: 'Total Memory in Bytes. Default is 0. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. Read-only. This property is read-only.'
format: int64
readOnly: true
remoteAssistanceSessionErrorDetails:
type: string
description: An error string that identifies issues when creating Remote Assistance session objects. This property is read-only.
nullable: true
readOnly: true
remoteAssistanceSessionUrl:
type: string
description: 'Url that allows a Remote Assistance session to be established with the device. Default is an empty string. To retrieve actual values GET call needs to be made, with device id and included in select parameter. This property is read-only.'
nullable: true
readOnly: true
requireUserEnrollmentApproval:
type: boolean
description: Reports if the managed iOS device is user approval enrollment. This property is read-only.
nullable: true
readOnly: true
serialNumber:
type: string
description: SerialNumber. This property is read-only.
nullable: true
readOnly: true
subscriberCarrier:
type: string
description: Subscriber Carrier. This property is read-only.
nullable: true
readOnly: true
totalStorageSpaceInBytes:
type: number
description: Total Storage in Bytes. This property is read-only.
format: int64
readOnly: true
udid:
type: string
description: 'Unique Device Identifier for iOS and macOS devices. Default is an empty string. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.'
nullable: true
readOnly: true
userDisplayName:
type: string
description: User display name. This property is read-only.
nullable: true
readOnly: true
userId:
type: string
description: Unique Identifier for the user associated with the device. This property is read-only.
nullable: true
readOnly: true
userPrincipalName:
type: string
description: Device user principal name. This property is read-only.
nullable: true
readOnly: true
wiFiMacAddress:
type: string
description: Wi-Fi MAC. This property is read-only.
nullable: true
readOnly: true
deviceCategory:
$ref: '#/components/schemas/microsoft.graph.deviceCategory'
deviceCompliancePolicyStates:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.deviceCompliancePolicyState'
description: Device compliance policy states for this device.
x-ms-navigationProperty: true
deviceConfigurationStates:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.deviceConfigurationState'
description: Device configuration states for this device.
x-ms-navigationProperty: true
logCollectionRequests:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.deviceLogCollectionResponse'
description: List of log collection requests
x-ms-navigationProperty: true
users:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.user'
description: The primary users associated with the managed device.
x-ms-navigationProperty: true
windowsProtectionState:
$ref: '#/components/schemas/microsoft.graph.windowsProtectionState'
additionalProperties:
type: object
description: 'Devices that are managed or pre-enrolled through Intune. Limited support for $filter: Only properties whose descriptions mention support for $filter may be used, and combinations of those filtered properties must use ''and'', not ''or''.'
microsoft.graph.message:
allOf:
- $ref: '#/components/schemas/microsoft.graph.outlookItem'
- title: message
type: object
properties:
bccRecipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.recipient'
description: 'The Bcc: recipients for the message.'
body:
$ref: '#/components/schemas/microsoft.graph.itemBody'
bodyPreview:
type: string
description: The first 255 characters of the message body. It is in text format.
nullable: true
ccRecipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.recipient'
description: 'The Cc: recipients for the message.'
conversationId:
type: string
description: The ID of the conversation the email belongs to.
nullable: true
conversationIndex:
type: string
description: Indicates the position of the message within the conversation.
format: base64url
nullable: true
flag:
$ref: '#/components/schemas/microsoft.graph.followupFlag'
from:
$ref: '#/components/schemas/microsoft.graph.recipient'
hasAttachments:
type: boolean
description: 'Indicates whether the message has attachments. This property doesn''t include inline attachments, so if a message contains only inline attachments, this property is false. To verify the existence of inline attachments, parse the body property to look for a src attribute, such as
.'
nullable: true
importance:
$ref: '#/components/schemas/microsoft.graph.importance'
inferenceClassification:
$ref: '#/components/schemas/microsoft.graph.inferenceClassificationType'
internetMessageHeaders:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.internetMessageHeader'
description: A collection of message headers defined by RFC5322. The set includes message headers indicating the network path taken by a message from the sender to the recipient. It can also contain custom message headers that hold app data for the message. Requires $select to retrieve. Read-only.
internetMessageId:
type: string
description: The message ID in the format specified by RFC2822.
nullable: true
isDeliveryReceiptRequested:
type: boolean
description: Indicates whether a read receipt is requested for the message.
nullable: true
isDraft:
type: boolean
description: Indicates whether the message is a draft. A message is a draft if it hasn't been sent yet.
nullable: true
isRead:
type: boolean
description: Indicates whether the message has been read.
nullable: true
isReadReceiptRequested:
type: boolean
description: Indicates whether a read receipt is requested for the message.
nullable: true
parentFolderId:
type: string
description: The unique identifier for the message's parent mailFolder.
nullable: true
receivedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The date and time the message was received. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.'
format: date-time
nullable: true
replyTo:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.recipient'
description: The email addresses to use when replying.
sender:
$ref: '#/components/schemas/microsoft.graph.recipient'
sentDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: 'The date and time the message was sent. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.'
format: date-time
nullable: true
subject:
type: string
description: The subject of the message.
nullable: true
toRecipients:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.recipient'
description: 'The To: recipients for the message.'
uniqueBody:
$ref: '#/components/schemas/microsoft.graph.itemBody'
webLink:
type: string
description: 'The URL to open the message in Outlook on the web.You can append an ispopout argument to the end of the URL to change how the message is displayed. If ispopout is not present or if it is set to 1, then the message is shown in a popout window. If ispopout is set to 0, the browser shows the message in the Outlook on the web review pane.The message opens in the browser if you are signed in to your mailbox via Outlook on the web. You are prompted to sign in if you are not already signed in with the browser.This URL cannot be accessed from within an iFrame.NOTE: When using this URL to access a message from a mailbox with delegate permissions, both the signed-in user and the target mailbox must be in the same database region. For example, an error is returned when a user with a mailbox in the EUR (Europe) region attempts to access messages from a mailbox in the NAM (North America) region.'
nullable: true
attachments:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.attachment'
description: The fileAttachment and itemAttachment attachments for the message.
x-ms-navigationProperty: true
extensions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.extension'
description: The collection of open extensions defined for the message. Nullable.
x-ms-navigationProperty: true
multiValueExtendedProperties:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty'
description: The collection of multi-value extended properties defined for the message. Nullable.
x-ms-navigationProperty: true
singleValueExtendedProperties:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
description: The collection of single-value extended properties defined for the message. Nullable.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.note:
allOf:
- $ref: '#/components/schemas/microsoft.graph.outlookItem'
- title: note
type: object
properties:
body:
$ref: '#/components/schemas/microsoft.graph.itemBody'
bodyPreview:
type: string
description: 'Auto-generated preview of the note body content (first ~255 characters, plain text). Read-only.'
nullable: true
readOnly: true
hasAttachments:
type: boolean
description: Indicates whether the note has file attachments. Supports $filter (eq). Read-only.
nullable: true
readOnly: true
isDeleted:
type: boolean
description: Indicates whether the note is soft-deleted. Read-only.
nullable: true
readOnly: true
subject:
type: string
description: 'The title of the note. Supports $filter (eq, ne, startsWith) and $orderby.'
nullable: true
attachments:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.attachment'
description: 'The file attachments for the note. Only inline image attachments (image/png, image/jpeg, image/gif, or image/bmp) are supported, with a maximum size of 3 MB per attachment. Use $expand to retrieve attachments.'
x-ms-navigationProperty: true
extensions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.extension'
description: The collection of open extensions defined for the note.
x-ms-navigationProperty: true
multiValueExtendedProperties:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty'
description: The collection of multi-value extended properties defined for the note.
x-ms-navigationProperty: true
singleValueExtendedProperties:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
description: The collection of single-value extended properties defined for the note.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.oAuth2PermissionGrant:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: oAuth2PermissionGrant
type: object
properties:
clientId:
type: string
description: The object id (not appId) of the client service principal for the application that's authorized to act on behalf of a signed-in user when accessing an API. Required. Supports $filter (eq only).
consentType:
type: string
description: 'Indicates if authorization is granted for the client application to impersonate all users or only a specific user. AllPrincipals indicates authorization to impersonate all users. Principal indicates authorization to impersonate a specific user. Consent on behalf of all users can be granted by an administrator. Nonadmin users might be authorized to consent on behalf of themselves in some cases, for some delegated permissions. Required. Supports $filter (eq only).'
nullable: true
principalId:
type: string
description: 'The id of the user on behalf of whom the client is authorized to access the resource, when consentType is Principal. If consentType is AllPrincipals this value is null. Required when consentType is Principal. Supports $filter (eq only).'
nullable: true
resourceId:
type: string
description: The id of the resource service principal to which access is authorized. This identifies the API that the client is authorized to attempt to call on behalf of a signed-in user. Supports $filter (eq only).
scope:
type: string
description: 'A space-separated list of the claim values for delegated permissions that should be included in access tokens for the resource application (the API). For example, openid User.Read GroupMember.Read.All. Each claim value should match the value field of one of the delegated permissions defined by the API, listed in the oauth2PermissionScopes property of the resource service principal. Must not exceed 3,850 characters in length.'
nullable: true
additionalProperties:
type: object
microsoft.graph.onenote:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: onenote
type: object
properties:
notebooks:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.notebook'
description: The collection of OneNote notebooks that are owned by the user or group. Read-only. Nullable.
x-ms-navigationProperty: true
operations:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.onenoteOperation'
description: 'The status of OneNote operations. Getting an operations collection isn''t supported, but you can get the status of long-running operations if the Operation-Location header is returned in the response. Read-only. Nullable.'
x-ms-navigationProperty: true
pages:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.onenotePage'
description: The pages in all OneNote notebooks that are owned by the user or group. Read-only. Nullable.
x-ms-navigationProperty: true
resources:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.onenoteResource'
description: 'The image and other file resources in OneNote pages. Getting a resources collection isn''t supported, but you can get the binary content of a specific resource. Read-only. Nullable.'
x-ms-navigationProperty: true
sectionGroups:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.sectionGroup'
description: The section groups in all OneNote notebooks that are owned by the user or group. Read-only. Nullable.
x-ms-navigationProperty: true
sections:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.onenoteSection'
description: The sections in all OneNote notebooks that are owned by the user or group. Read-only. Nullable.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.onlineMeeting:
allOf:
- $ref: '#/components/schemas/microsoft.graph.onlineMeetingBase'
- title: onlineMeeting
type: object
properties:
attendeeReport:
type: string
description: The content stream of the attendee report of a Microsoft Teams live event. Read-only.
format: base64url
nullable: true
broadcastSettings:
$ref: '#/components/schemas/microsoft.graph.broadcastMeetingSettings'
creationDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: The meeting creation time in UTC. Read-only.
format: date-time
nullable: true
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: The meeting end time in UTC. Required when you create an online meeting.
format: date-time
nullable: true
externalId:
type: string
description: The external ID that is a custom identifier. Optional.
nullable: true
isBroadcast:
type: boolean
description: Indicates whether this meeting is a Teams live event.
nullable: true
meetingTemplateId:
type: string
description: The ID of the meeting template.
nullable: true
participants:
$ref: '#/components/schemas/microsoft.graph.meetingParticipants'
startDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: The meeting start time in UTC.
format: date-time
nullable: true
recordings:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.callRecording'
description: The recordings of an online meeting. Read-only.
x-ms-navigationProperty: true
transcripts:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.callTranscript'
description: The transcripts of an online meeting. Read-only.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: onPremisesSyncBehavior
type: object
properties:
isCloudManaged:
type: boolean
additionalProperties:
type: object
microsoft.graph.outlookUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: outlookUser
type: object
properties:
masterCategories:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.outlookCategory'
description: A list of categories defined for the user.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.person:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: person
type: object
properties:
birthday:
type: string
description: The person's birthday.
nullable: true
companyName:
type: string
description: The name of the person's company.
nullable: true
department:
type: string
description: The person's department.
nullable: true
displayName:
type: string
description: The person's display name.
nullable: true
givenName:
type: string
description: The person's given name.
nullable: true
imAddress:
type: string
description: The instant message voice over IP (VOIP) session initiation protocol (SIP) address for the user. Read-only.
nullable: true
isFavorite:
type: boolean
description: True if the user has flagged this person as a favorite.
nullable: true
jobTitle:
type: string
description: The person's job title.
nullable: true
officeLocation:
type: string
description: The location of the person's office.
nullable: true
personNotes:
type: string
description: Free-form notes that the user has taken about this person.
nullable: true
personType:
$ref: '#/components/schemas/microsoft.graph.personType'
phones:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.phone'
description: The person's phone numbers.
postalAddresses:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.location'
description: The person's addresses.
profession:
type: string
description: The person's profession.
nullable: true
scoredEmailAddresses:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.scoredEmailAddress'
description: The person's email addresses.
surname:
type: string
description: The person's surname.
nullable: true
userPrincipalName:
type: string
description: 'The user principal name (UPN) of the person. The UPN is an Internet-style login name for the person based on the Internet standard RFC 822. By convention, this should map to the person''s email name. The general format is alias@domain.'
nullable: true
websites:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.website'
description: The person's websites.
yomiCompany:
type: string
description: The phonetic Japanese name of the person's company.
nullable: true
additionalProperties:
type: object
microsoft.graph.resourceSpecificPermissionGrant:
allOf:
- $ref: '#/components/schemas/microsoft.graph.directoryObject'
- title: resourceSpecificPermissionGrant
type: object
properties:
clientAppId:
type: string
description: ID of the service principal of the Microsoft Entra app that has been granted access. Read-only.
nullable: true
clientId:
type: string
description: ID of the Microsoft Entra app that has been granted access. Read-only.
nullable: true
permission:
type: string
description: The name of the resource-specific permission. Read-only.
nullable: true
permissionType:
type: string
description: 'The type of permission. The possible values are: Application, Delegated. Read-only.'
nullable: true
resourceAppId:
type: string
description: ID of the Microsoft Entra app that is hosting the resource. Read-only.
nullable: true
additionalProperties:
type: object
microsoft.graph.profilePhoto:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: profilePhoto
type: object
properties:
height:
maximum: 2147483647
minimum: -2147483648
type: number
description: The height of the photo. Read-only.
format: int32
nullable: true
width:
maximum: 2147483647
minimum: -2147483648
type: number
description: The width of the photo. Read-only.
format: int32
nullable: true
additionalProperties:
type: object
microsoft.graph.plannerUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: plannerUser
type: object
properties:
plans:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.plannerPlan'
description: Read-only. Nullable. Returns the plannerTasks assigned to the user.
x-ms-navigationProperty: true
tasks:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.plannerTask'
description: Read-only. Nullable. Returns the plannerPlans shared with the user.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.presence:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: presence
type: object
properties:
activity:
type: string
description: 'The supplemental information to a user''s availability. Possible values are available, away, beRightBack, busy, doNotDisturb, offline, outOfOffice, presenceUnknown.'
nullable: true
availability:
type: string
description: 'The base presence information for a user. Possible values are available, away, beRightBack, busy, doNotDisturb, focusing, inACall, inAMeeting, offline, presenting, presenceUnknown.'
nullable: true
outOfOfficeSettings:
$ref: '#/components/schemas/microsoft.graph.outOfOfficeSettings'
sequenceNumber:
type: string
description: The lexicographically sortable String stamp that represents the version of a presence object.
nullable: true
readOnly: true
statusMessage:
$ref: '#/components/schemas/microsoft.graph.presenceStatusMessage'
workLocation:
$ref: '#/components/schemas/microsoft.graph.userWorkLocation'
additionalProperties:
type: object
microsoft.graph.scopedRoleMembership:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: scopedRoleMembership
type: object
properties:
administrativeUnitId:
type: string
description: Unique identifier for the administrative unit that the directory role is scoped to
roleId:
type: string
description: Unique identifier for the directory role that the member is in.
roleMemberInfo:
$ref: '#/components/schemas/microsoft.graph.identity'
additionalProperties:
type: object
microsoft.graph.userSettings:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: userSettings
type: object
properties:
contributionToContentDiscoveryAsOrganizationDisabled:
type: boolean
description: 'Reflects the organization level setting controlling delegate access to the trending API. When set to true, the organization doesn''t have access to Office Delve. The relevancy of the content displayed in Microsoft 365, for example in Suggested sites in SharePoint Home and the Discover view in OneDrive for work or school is affected for the whole organization. This setting is read-only and can only be changed by administrators in the SharePoint admin center.'
contributionToContentDiscoveryDisabled:
type: boolean
description: 'When set to true, the delegate access to the user''s trending API is disabled. When set to true, documents in the user''s Office Delve are disabled. When set to true, the relevancy of the content displayed in Microsoft 365, for example in Suggested sites in SharePoint Home and the Discover view in OneDrive for work or school is affected. Users can control this setting in Office Delve.'
exchange:
$ref: '#/components/schemas/microsoft.graph.exchangeSettings'
itemInsights:
$ref: '#/components/schemas/microsoft.graph.userInsightsSettings'
shiftPreferences:
$ref: '#/components/schemas/microsoft.graph.shiftPreferences'
storage:
$ref: '#/components/schemas/microsoft.graph.userStorage'
windows:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.windowsSetting'
description: The Windows settings of the user stored in the cloud.
x-ms-navigationProperty: true
workHoursAndLocations:
$ref: '#/components/schemas/microsoft.graph.workHoursAndLocationsSetting'
additionalProperties:
type: object
microsoft.graph.userSolutionRoot:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: userSolutionRoot
type: object
properties:
workingTimeSchedule:
$ref: '#/components/schemas/microsoft.graph.workingTimeSchedule'
additionalProperties:
type: object
microsoft.graph.userTeamwork:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: userTeamwork
type: object
properties:
locale:
type: string
description: 'Represents the location that a user selected in Microsoft Teams and doesn''t follow the Office''s locale setting. A user''s locale is represented by their preferred language and country or region. For example, en-us. The language component follows two-letter codes as defined in ISO 639-1, and the country component follows two-letter codes as defined in ISO 3166-1 alpha-2.'
nullable: true
region:
type: string
description: 'Represents the region of the organization or the user. For users with multigeo licenses, the property contains the user''s region (if available). For users without multigeo licenses, the property contains the organization''s region.The region value can be any region supported by the Teams payload. The possible values are: Americas, Europe and MiddleEast, Asia Pacific, UAE, Australia, Brazil, Canada, Switzerland, Germany, France, India, Japan, South Korea, Norway, Singapore, United Kingdom, South Africa, Sweden, Qatar, Poland, Italy, Israel, Spain, Mexico, USGov Community Cloud, USGov Community Cloud High, USGov Department of Defense, and China.'
nullable: true
associatedTeams:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.associatedTeamInfo'
description: The list of associatedTeamInfo objects that a user is associated with.
x-ms-navigationProperty: true
installedApps:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.userScopeTeamsAppInstallation'
description: The apps installed in the personal scope of this user.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.todo:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: todo
type: object
properties:
lists:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.todoTaskList'
description: The task lists in the users mailbox.
x-ms-navigationProperty: true
additionalProperties:
type: object
microsoft.graph.automaticRepliesSetting:
title: automaticRepliesSetting
type: object
properties:
externalAudience:
$ref: '#/components/schemas/microsoft.graph.externalAudienceScope'
externalReplyMessage:
type: string
description: 'The automatic reply to send to the specified external audience, if Status is AlwaysEnabled or Scheduled.'
nullable: true
internalReplyMessage:
type: string
description: 'The automatic reply to send to the audience internal to the signed-in user''s organization, if Status is AlwaysEnabled or Scheduled.'
nullable: true
scheduledEndDateTime:
$ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone'
scheduledStartDateTime:
$ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone'
status:
$ref: '#/components/schemas/microsoft.graph.automaticRepliesStatus'
additionalProperties:
type: object
microsoft.graph.delegateMeetingMessageDeliveryOptions:
title: delegateMeetingMessageDeliveryOptions
enum:
- sendToDelegateAndInformationToPrincipal
- sendToDelegateAndPrincipal
- sendToDelegateOnly
type: string
microsoft.graph.localeInfo:
title: localeInfo
type: object
properties:
displayName:
type: string
description: 'A name representing the user''s locale in natural language, for example, ''English (United States)''.'
nullable: true
locale:
type: string
description: 'A locale representation for the user, which includes the user''s preferred language and country/region. For example, ''en-us''. The language component follows 2-letter codes as defined in ISO 639-1, and the country component follows 2-letter codes as defined in ISO 3166-1 alpha-2.'
nullable: true
additionalProperties:
type: object
microsoft.graph.userPurpose:
title: userPurpose
enum:
- user
- linked
- shared
- room
- equipment
- others
- unknownFutureValue
type: string
microsoft.graph.workingHours:
title: workingHours
type: object
properties:
daysOfWeek:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.dayOfWeek'
description: The days of the week on which the user works.
endTime:
pattern: '^([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?$'
type: string
description: The time of the day that the user stops working.
format: time
nullable: true
startTime:
pattern: '^([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?$'
type: string
description: The time of the day that the user starts working.
format: time
nullable: true
timeZone:
$ref: '#/components/schemas/microsoft.graph.timeZoneBase'
additionalProperties:
type: object
microsoft.graph.entity:
title: entity
type: object
properties:
id:
type: string
description: The unique identifier for an entity. Read-only.
additionalProperties:
type: object
microsoft.graph.itemActionStat:
title: itemActionStat
type: object
properties:
actionCount:
maximum: 2147483647
minimum: -2147483648
type: number
description: The number of times the action took place. Read-only.
format: int32
nullable: true
actorCount:
maximum: 2147483647
minimum: -2147483648
type: number
description: The number of distinct actors that performed the action. Read-only.
format: int32
nullable: true
additionalProperties:
type: object
microsoft.graph.incompleteData:
title: incompleteData
type: object
properties:
missingDataBeforeDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
description: The service does not have source data before the specified time.
format: date-time
nullable: true
wasThrottled:
type: boolean
description: Some data was not recorded due to excessive activity.
nullable: true
additionalProperties:
type: object
microsoft.graph.accessAction:
title: accessAction
type: object
additionalProperties:
type: object
microsoft.graph.contentTypeInfo:
title: contentTypeInfo
type: object
properties:
id:
type: string
description: The ID of the content type.
nullable: true
name:
type: string
description: The name of the content type.
nullable: true
additionalProperties:
type: object
microsoft.graph.documentSetVersionItem:
title: documentSetVersionItem
type: object
properties:
itemId:
type: string
description: The unique identifier for the item.
nullable: true
title:
type: string
description: The title of the item.
nullable: true
versionId:
type: string
description: The version ID of the item.
nullable: true
additionalProperties:
type: object
microsoft.graph.sharePointIdentitySet:
allOf:
- $ref: '#/components/schemas/microsoft.graph.identitySet'
- title: sharePointIdentitySet
type: object
properties:
group:
$ref: '#/components/schemas/microsoft.graph.identity'
sharePointGroup:
$ref: '#/components/schemas/microsoft.graph.sharePointGroupIdentity'
siteGroup:
$ref: '#/components/schemas/microsoft.graph.sharePointIdentity'
siteUser:
$ref: '#/components/schemas/microsoft.graph.sharePointIdentity'
additionalProperties:
type: object
microsoft.graph.sharingInvitation:
title: sharingInvitation
type: object
properties:
email:
type: string
description: The email address provided for the recipient of the sharing invitation. Read-only.
nullable: true
invitedBy:
$ref: '#/components/schemas/microsoft.graph.identitySet'
redeemedBy:
type: string
nullable: true
signInRequired:
type: boolean
description: If true the recipient of the invitation needs to sign in in order to access the shared item. Read-only.
nullable: true
additionalProperties:
type: object
microsoft.graph.sharingLink:
title: sharingLink
type: object
properties:
application:
$ref: '#/components/schemas/microsoft.graph.identity'
preventsDownload:
type: boolean
description: 'If true then the user can only use this link to view the item on the web, and cannot use it to download the contents of the item. Only for OneDrive for Business and SharePoint.'
nullable: true
scope:
type: string
description: 'The scope of the link represented by this permission. Value anonymous indicates the link is usable by anyone, organization indicates the link is only usable for users signed into the same tenant.'
nullable: true
type:
type: string
description: The type of the link created.
nullable: true
webHtml:
type: string
description: 'For embed links, this property contains the HTML code for an