Microsoft Graph shares.driveItem API

openapi: 3.2.0
info:
  title: Microsoft Graph Admin Admin.admin Shares.drive Item API
  description: 'Microsoft Graph API for managing administrative resources in Microsoft Entra ID.

    This API enables administrators to manage Microsoft Edge browser settings, Internet Explorer mode configurations,

    site lists, shared browser sites, Microsoft 365 Apps installation options, people insights, service announcements,

    SharePoint settings, Copilot administration, directory administrative units, and admin consent policies.'
  version: 1.0.0
  contact:
    name: Microsoft Graph API Support
    url: https://developer.microsoft.com/graph
servers:
- url: https://graph.microsoft.com/v1.0
  description: Microsoft Graph API v1.0 endpoint
tags:
- name: shares.driveItem
  x-ms-docs-toc-type: page
paths:
  /shares/{sharedDriveItem-id}/driveItem:
    description: Provides operations to manage the driveItem property of the microsoft.graph.sharedDriveItem entity.
    parameters:
    - name: sharedDriveItem-id
      in: path
      description: The unique identifier of sharedDriveItem
      required: true
      schema:
        type: string
      x-ms-docs-key-type: sharedDriveItem
    get:
      tags:
      - shares.driveItem
      summary: Microsoft Graph 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: shares.GetDriveItem
      parameters:
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: 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'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /shares/{sharedDriveItem-id}/driveItem/content:
    description: Provides operations to manage the media for the sharedDriveItem entity.
    parameters:
    - name: sharedDriveItem-id
      in: path
      description: The unique identifier of sharedDriveItem
      required: true
      schema:
        type: string
      x-ms-docs-key-type: sharedDriveItem
    get:
      tags:
      - shares.driveItem
      summary: Microsoft Graph Get content for the navigation property driveItem from shares
      description: The content stream, if the item represents a file.
      operationId: shares.GetDriveItemContent
      parameters:
      - name: $format
        in: query
        description: Format of the content
        schema:
          type: string
      responses:
        2XX:
          description: Retrieved media content
          content:
            application/octet-stream:
              schema:
                type: string
                format: binary
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
    put:
      tags:
      - shares.driveItem
      summary: Microsoft Graph Update content for the navigation property driveItem in shares
      description: The content stream, if the item represents a file.
      operationId: shares.UpdateDriveItemContent
      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'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
    delete:
      tags:
      - shares.driveItem
      summary: Microsoft Graph Delete content for the navigation property driveItem in shares
      description: The content stream, if the item represents a file.
      operationId: shares.DeleteDriveItemContent
      parameters:
      - name: If-Match
        in: header
        description: ETag
        schema:
          type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
  /shares/{sharedDriveItem-id}/items:
    description: Provides operations to manage the items property of the microsoft.graph.sharedDriveItem entity.
    parameters:
    - name: sharedDriveItem-id
      in: path
      description: The unique identifier of sharedDriveItem
      required: true
      schema:
        type: string
      x-ms-docs-key-type: sharedDriveItem
    get:
      tags:
      - shares.driveItem
      summary: Microsoft Graph Get items from shares
      description: All driveItems contained in the sharing root. This collection cannot be enumerated.
      operationId: shares.ListItems
      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.driveItemCollectionResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
  /shares/{sharedDriveItem-id}/items/{driveItem-id}:
    description: Provides operations to manage the items property of the microsoft.graph.sharedDriveItem entity.
    parameters:
    - name: sharedDriveItem-id
      in: path
      description: The unique identifier of sharedDriveItem
      required: true
      schema:
        type: string
      x-ms-docs-key-type: sharedDriveItem
    - name: driveItem-id
      in: path
      description: The unique identifier of driveItem
      required: true
      schema:
        type: string
      x-ms-docs-key-type: driveItem
    get:
      tags:
      - shares.driveItem
      summary: Microsoft Graph Get items from shares
      description: All driveItems contained in the sharing root. This collection cannot be enumerated.
      operationId: shares.GetItems
      parameters:
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: 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'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /shares/{sharedDriveItem-id}/items/{driveItem-id}/content:
    description: Provides operations to manage the media for the sharedDriveItem entity.
    parameters:
    - name: sharedDriveItem-id
      in: path
      description: The unique identifier of sharedDriveItem
      required: true
      schema:
        type: string
      x-ms-docs-key-type: sharedDriveItem
    - name: driveItem-id
      in: path
      description: The unique identifier of driveItem
      required: true
      schema:
        type: string
      x-ms-docs-key-type: driveItem
    get:
      tags:
      - shares.driveItem
      summary: Microsoft Graph Get content for the navigation property items from shares
      description: The content stream, if the item represents a file.
      operationId: shares.GetItemsContent
      parameters:
      - name: $format
        in: query
        description: Format of the content
        schema:
          type: string
      responses:
        2XX:
          description: Retrieved media content
          content:
            application/octet-stream:
              schema:
                type: string
                format: binary
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
    put:
      tags:
      - shares.driveItem
      summary: Microsoft Graph Update content for the navigation property items in shares
      description: The content stream, if the item represents a file.
      operationId: shares.UpdateItemsContent
      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'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
    delete:
      tags:
      - shares.driveItem
      summary: Microsoft Graph Delete content for the navigation property items in shares
      description: The content stream, if the item represents a file.
      operationId: shares.DeleteItemsContent
      parameters:
      - name: If-Match
        in: header
        description: ETag
        schema:
          type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
  /shares/{sharedDriveItem-id}/items/$count:
    description: Provides operations to count the resources in the collection.
    parameters:
    - name: sharedDriveItem-id
      in: path
      description: The unique identifier of sharedDriveItem
      required: true
      schema:
        type: string
      x-ms-docs-key-type: sharedDriveItem
    get:
      tags:
      - shares.driveItem
      summary: Microsoft Graph Get the number of the resource
      operationId: shares.items.GetCount-245c
      parameters:
      - $ref: '#/components/parameters/search'
      - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
  /shares/{sharedDriveItem-id}/root:
    description: Provides operations to manage the root property of the microsoft.graph.sharedDriveItem entity.
    parameters:
    - name: sharedDriveItem-id
      in: path
      description: The unique identifier of sharedDriveItem
      required: true
      schema:
        type: string
      x-ms-docs-key-type: sharedDriveItem
    get:
      tags:
      - shares.driveItem
      summary: Microsoft Graph Get root from shares
      description: Used to access the underlying driveItem. Deprecated -- use driveItem instead.
      operationId: shares.GetRoot
      parameters:
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: 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'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /shares/{sharedDriveItem-id}/root/content:
    description: Provides operations to manage the media for the sharedDriveItem entity.
    parameters:
    - name: sharedDriveItem-id
      in: path
      description: The unique identifier of sharedDriveItem
      required: true
      schema:
        type: string
      x-ms-docs-key-type: sharedDriveItem
    get:
      tags:
      - shares.driveItem
      summary: Microsoft Graph Get content for the navigation property root from shares
      description: The content stream, if the item represents a file.
      operationId: shares.GetRootContent
      parameters:
      - name: $format
        in: query
        description: Format of the content
        schema:
          type: string
      responses:
        2XX:
          description: Retrieved media content
          content:
            application/octet-stream:
              schema:
                type: string
                format: binary
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
    put:
      tags:
      - shares.driveItem
      summary: Microsoft Graph Update content for the navigation property root in shares
      description: The content stream, if the item represents a file.
      operationId: shares.UpdateRootContent
      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'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
    delete:
      tags:
      - shares.driveItem
      summary: Microsoft Graph Delete content for the navigation property root in shares
      description: The content stream, if the item represents a file.
      operationId: shares.DeleteRootContent
      parameters:
      - name: If-Match
        in: header
        description: ETag
        schema:
          type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
components:
  schemas:
    microsoft.graph.listInfo:
      title: listInfo
      required:
      - '@odata.type'
      type: object
      properties:
        contentTypesEnabled:
          type: boolean
          description: If true, indicates that content types are enabled for this list.
          nullable: true
        hidden:
          type: boolean
          description: If true, indicates that the list isn't normally visible in the SharePoint user experience.
          nullable: true
        template:
          type: string
          description: An enumerated value that represents the base list template used in creating the list. Possible values include documentLibrary, genericList, task, survey, announcements, contacts, and more.
          nullable: true
        '@odata.type':
          type: string
    microsoft.graph.sizeRange:
      title: sizeRange
      required:
      - '@odata.type'
      type: object
      properties:
        maximumSize:
          maximum: 2147483647
          minimum: -2147483648
          type: number
          description: The maximum size (in kilobytes) that an incoming message must have in order for a condition or exception to apply.
          format: int32
          nullable: true
        minimumSize:
          maximum: 2147483647
          minimum: -2147483648
          type: number
          description: The minimum size (in kilobytes) that an incoming message must have in order for a condition or exception to apply.
          format: int32
          nullable: true
        '@odata.type':
          type: string
    microsoft.graph.virtualEventExternalRegistrationInformation:
      title: virtualEventExternalRegistrationInformation
      required:
      - '@odata.type'
      type: object
      properties:
        referrer:
          type: string
          description: A URL or string that represents the location from which the registrant registered. Optional.
          nullable: true
        registrationId:
          type: string
          description: The identifier for a virtualEventExternalRegistrationInformation object. Optional. If set, the maximum supported length is 256 characters.
          nullable: true
        '@odata.type':
          type: string
    microsoft.graph.windowsDeviceHealthState:
      title: windowsDeviceHealthState
      enum:
      - clean
      - fullScanPending
      - rebootPending
      - manualStepsPending
      - offlineScanPending
      - critical
      type: string
      description: Computer endpoint protection state
      x-ms-enum-flags:
        isFlags: true
      x-ms-enum:
        name: windowsDeviceHealthState
        modelAsString: false
        values:
        - value: clean
          description: Computer is clean and no action is required
          name: clean
        - value: fullScanPending
          description: Computer is in pending full scan state
          name: fullScanPending
        - value: rebootPending
          description: Computer is in pending reboot state
          name: rebootPending
        - value: manualStepsPending
          description: Computer is in pending manual steps state
          name: manualStepsPending
        - value: offlineScanPending
          description: Computer is in pending offline scan state
          name: offlineScanPending
        - value: critical
          description: Computer is in critical failure state
          name: critical
    microsoft.graph.identity:
      title: identity
      required:
      - '@odata.type'
      type: object
      properties:
        displayName:
          type: string
          description: The display name of the identity.For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta.
          nullable: true
        id:
          type: string
          description: Unique identifier for the identity or actor. For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review.
          nullable: true
        '@odata.type':
          type: string
      discriminator:
        propertyName: '@odata.type'
        mapping:
          '#microsoft.graph.azureCommunicationServicesUserIdentity': '#/components/schemas/microsoft.graph.azureCommunicationServicesUserIdentity'
          '#microsoft.graph.communicationsApplicationIdentity': '#/components/schemas/microsoft.graph.communicationsApplicationIdentity'
          '#microsoft.graph.communicationsApplicationInstanceIdentity': '#/components/schemas/microsoft.graph.communicationsApplicationInstanceIdentity'
          '#microsoft.graph.communicationsEncryptedIdentity': '#/components/schemas/microsoft.graph.communicationsEncryptedIdentity'
          '#microsoft.graph.communicationsGuestIdentity': '#/components/schemas/microsoft.graph.communicationsGuestIdentity'
          '#microsoft.graph.communicationsPhoneIdentity': '#/components/schemas/microsoft.graph.communicationsPhoneIdentity'
          '#microsoft.graph.communicationsUserIdentity': '#/components/schemas/microsoft.graph.communicationsUserIdentity'
          '#microsoft.graph.emailIdentity': '#/components/schemas/microsoft.graph.emailIdentity'
          '#microsoft.graph.initiator': '#/components/schemas/microsoft.graph.initiator'
          '#microsoft.graph.provisionedIdentity': '#/components/schemas/microsoft.graph.provisionedIdentity'
          '#microsoft.graph.provisioningServicePrincipal': '#/components/schemas/microsoft.graph.provisioningServicePrincipal'
          '#microsoft.graph.provisioningSystem': '#/components/schemas/microsoft.graph.provisioningSystem'
          '#microsoft.graph.servicePrincipalIdentity': '#/components/schemas/microsoft.graph.servicePrincipalIdentity'
          '#microsoft.graph.sharePointIdentity': '#/components/schemas/microsoft.graph.sharePointIdentity'
          '#microsoft.graph.teamworkApplicationIdentity': '#/components/schemas/microsoft.graph.teamworkApplicationIdentity'
          '#microsoft.graph.teamworkConversationIdentity': '#/components/schemas/microsoft.graph.teamworkConversationIdentity'
          '#microsoft.graph.teamworkTagIdentity': '#/components/schemas/microsoft.graph.teamworkTagIdentity'
          '#microsoft.graph.teamworkUserIdentity': '#/components/schemas/microsoft.graph.teamworkUserIdentity'
          '#microsoft.graph.userIdentity': '#/components/schemas/microsoft.graph.userIdentity'
          '#microsoft.graph.callRecords.userIdentity': '#/components/schemas/microsoft.graph.callRecords.userIdentity'
    microsoft.graph.appLogUploadState:
      title: appLogUploadState
      enum:
      - pending
      - completed
      - failed
      - unknownFutureValue
      type: string
      description: AppLogUploadStatus
      x-ms-enum:
        name: appLogUploadState
        modelAsString: false
        values:
        - value: pending
          description: Default. Indicates that request is waiting to be processed or under processing.
          name: pending
        - value: completed
          description: Indicates that request is completed with file uploaded to Azure blob for download.
          name: completed
        - value: failed
          description: Indicates that request is completed with file uploaded to Azure blob for download.
          name: failed
        - value: unknownFutureValue
          description: Evolvable enumeration sentinel value. Do not use.
          name: unknownFutureValue
    microsoft.graph.specialFolder:
      title: specialFolder
      required:
      - '@odata.type'
      type: object
      properties:
        name:
          type: string
          description: The unique identifier for this item in the /drive/special collection
          nullable: true
        '@odata.type':
          type: string
    microsoft.graph.workbookIcon:
      title: workbookIcon
      required:
      - '@odata.type'
      type: object
      properties:
        index:
          maximum: 2147483647
          minimum: -2147483648
          type: number
          description: The index of the icon in the given set.
          format: int32
        set:
          type: string
          description: 'The set that the icon is part of. The possible values are: Invalid, ThreeArrows, ThreeArrowsGray, ThreeFlags, ThreeTrafficLights1, ThreeTrafficLights2, ThreeSigns, ThreeSymbols, ThreeSymbols2, FourArrows, FourArrowsGray, FourRedToBlack, FourRating, FourTrafficLights, FiveArrows, FiveArrowsGray, FiveRating, FiveQuarters, ThreeStars, ThreeTriangles, FiveBoxes.'
        '@odata.type':
          type: string
    microsoft.graph.operationStatus:
      title: operationStatus
      enum:
      - NotStarted
      - Running
      - Completed
      - Failed
      type: string
    microsoft.graph.scopedRoleMembership:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: scopedRoleMembership
        required:
        - '@odata.type'
        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'
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.scopedRoleMembership'
    microsoft.graph.sensitivityLabel:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: sensitivityLabel
        required:
        - '@odata.type'
        type: object
        properties:
          actionSource:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.labelActionSource'
            - type: object
              nullable: true
          autoTooltip:
            type: string
            nullable: true
          description:
            type: string
            nullable: true
          displayName:
            type: string
            nullable: true
          isDefault:
            type: boolean
            nullable: true
          isEndpointProtectionEnabled:
            type: boolean
            nullable: true
          isScopedToUser:
            type: boolean
            nullable: true
          locale:
            type: string
            nullable: true
          name:
            type: string
            nullable: true
          priority:
            maximum: 2147483647
            minimum: -2147483648
            type: number
            format: int32
            nullable: true
          toolTip:
            type: string
            nullable: true
          rights:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.usageRightsIncluded'
            - type: object
              nullable: true
            x-ms-navigationProperty: true
          sublabels:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.sensitivityLabel'
            x-ms-navigationProperty: true
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.sensitivityLabel'
    microsoft.graph.calendarRoleType:
      title: calendarRoleType
      enum:
      - none
      - freeBusyRead
      - limitedRead
      - read
      - write
      - delegateWithoutPrivateEventAccess
      - delegateWithPrivateEventAccess
      - custom
      type: string
    microsoft.graph.workbookOperation:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: workbookOperation
        required:
        - '@odata.type'
        type: object
        properties:
          error:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.workbookOperationError'
            - type: object
              nullable: true
            description: The error returned by the operation.
          resourceLocation:
            type: string
            description: The resource URI for the result.
            nullable: true
          status:
            $ref: '#/components/schemas/microsoft.graph.workbookOperationStatus'
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.workbookOperation'
    microsoft.graph.chatType:
      title: chatType
      enum:
      - oneOnOne
      - group
      - meeting
      - unknownFutureValue
      type: string
    microsoft.graph.workbookTableSort:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: workbookTableSort
        required:
        - '@odata.type'
        type: object
        properties:
          fields:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.workbookSortField'
            description: The list of the current conditions last used to sort the table. Read-only.
          matchCase:
            type: boolean
            description: Indicates whether the casing impacted the last sort of the table. Read-only.
          method:
            type: string
            description: 'The Chinese character ordering method last used to sort the table. The possible values are: PinYin, StrokeCount. Read-only.'
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.workbookTableSort'
    microsoft.graph.teamVisibilityType:
      title: teamVisibilityType
      enum:
      - private
      - public
      - hiddenMembership
      - unknownFutureValue
      type: string
    microsoft.graph.oAuth2PermissionGrant:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: oAuth2PermissionGrant
        required:
        - '@odata.type'
        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
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.oAuth2PermissionGrant'
    microsoft.graph.shiftItem:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.scheduleEntity'
      - title: shiftItem
        required:
        - '@odata.type'
        type: object
        properties:
          activities:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.shiftActivity'
            description: An incremental part of a shift which can cover details of when and where an employee is during their shift. For example, an assignment or a scheduled break or lunch. Required.
          displayName:
            type: strin

# --- truncated at 32 KB (1008 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-graph/refs/heads/main/openapi/microsoft-graph-shares-driveitem-api-openapi.yml