openapi: 3.1.0 info: title: Microsoft Graph Shares description: Needs a description. paths: /print/printers/{printer-id}/shares: description: >- Provides operations to manage the shares property of the microsoft.graph.printer entity. get: tags: - Print.printer summary: Microsoft Graph List printerShares for a printer description: Retrieve a list of printer shares associated with the printer. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printer-list-shares?view=graph-rest-1.0 operationId: print.printers.ListShares 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.printerShareCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation parameters: - name: printer-id in: path description: The unique identifier of printer required: true schema: type: string x-ms-docs-key-type: printer /print/printers/{printer-id}/shares/{printerShare-id}: description: >- Provides operations to manage the shares property of the microsoft.graph.printer entity. get: tags: - Print.printer summary: Microsoft Graph Get shares from print description: >- The list of printerShares that are associated with the printer. Currently, only one printerShare can be associated with the printer. Read-only. Nullable. operationId: print.printers.GetShares 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.printerShare' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: printer-id in: path description: The unique identifier of printer required: true schema: type: string x-ms-docs-key-type: printer - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare /print/printers/{printer-id}/shares/$count: description: Provides operations to count the resources in the collection. get: tags: - Print.printer summary: Microsoft Graph Get the number of the resource operationId: print.printers.shares.GetCount-5f30 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' parameters: - name: printer-id in: path description: The unique identifier of printer required: true schema: type: string x-ms-docs-key-type: printer /print/shares: description: >- Provides operations to manage the shares property of the microsoft.graph.print entity. get: tags: - print.printerShare summary: Microsoft Graph List shares description: Retrieve a list of printerShares. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/print-list-shares?view=graph-rest-1.0 operationId: print.ListShares 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.printerShareCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation post: tags: - print.printerShare summary: Microsoft Graph Create printerShare description: Create a new printerShare for the specified printer. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/print-post-shares?view=graph-rest-1.0 operationId: print.CreateShares requestBody: description: New navigation property content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printerShare' required: true responses: 2XX: description: Created navigation property. content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printerShare' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation /print/shares/{printerShare-id}: description: >- Provides operations to manage the shares property of the microsoft.graph.print entity. get: tags: - print.printerShare summary: Microsoft Graph Get printerShare description: Retrieve the properties and relationships of a printer share. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printershare-get?view=graph-rest-1.0 operationId: print.GetShares 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.printerShare' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - print.printerShare summary: Microsoft Graph Update printerShare description: >- Update the properties of a printer share. This method can be used to swap printers. For example, if a physical printer device breaks, an administrator can register a new printer device and update this printerShare to point to the new printer without requiring users to take any action. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printershare-update?view=graph-rest-1.0 operationId: print.UpdateShares requestBody: description: New navigation property values content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printerShare' required: true responses: 2XX: description: Success content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printerShare' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - print.printerShare summary: Microsoft Graph Delete printerShare description: >- Delete a printer share (unshare the associated printer). This action can't be undone. If the printer is shared again in the future, any Windows users who had previously installed the printer needs to discover and reinstall it. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printershare-delete?view=graph-rest-1.0 operationId: print.DeleteShares 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' x-ms-docs-operation-type: operation parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare /print/shares/{printerShare-id}/allowedGroups: description: >- Provides operations to manage the allowedGroups property of the microsoft.graph.printerShare entity. get: tags: - print.printerShare summary: Microsoft Graph List allowedGroups description: >- Retrieve a list of groups that have been granted access to submit print jobs to the associated printerShare. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printershare-list-allowedgroups?view=graph-rest-1.0 operationId: print.shares.ListAllowedGroups 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.groupCollectionResponse' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare /print/shares/{printerShare-id}/allowedGroups/{group-id}/$ref: description: Provides operations to manage the collection of print entities. delete: tags: - print.printerShare summary: Microsoft Graph Delete allowedGroup from printerShare description: >- Revoke the specified group's access to submit print jobs to the associated printerShare. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printershare-delete-allowedgroup?view=graph-rest-1.0 operationId: print.shares.allowedGroups.DeleteRefGroup 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' x-ms-docs-operation-type: operation parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: group-id in: path description: The unique identifier of group required: true schema: type: string x-ms-docs-key-type: group /print/shares/{printerShare-id}/allowedGroups/{group-id}/serviceProvisioningErrors: get: tags: - print.printerShare summary: Microsoft Graph Get serviceProvisioningErrors property value description: >- Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a group object. Supports $filter (eq, not, for isResolved and serviceInstance). operationId: print.shares.allowedGroups.ListServiceProvisioningErrors 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.serviceProvisioningErrorCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: group-id in: path description: The unique identifier of group required: true schema: type: string x-ms-docs-key-type: group /print/shares/{printerShare-id}/allowedGroups/{group-id}/serviceProvisioningErrors/$count: description: Provides operations to count the resources in the collection. get: tags: - print.printerShare summary: Microsoft Graph Get the number of the resource operationId: print.shares.allowedGroups.ServiceProvisioningErrors.GetCount-182d 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' parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: group-id in: path description: The unique identifier of group required: true schema: type: string x-ms-docs-key-type: group /print/shares/{printerShare-id}/allowedGroups/$count: description: Provides operations to count the resources in the collection. get: tags: - print.printerShare summary: Microsoft Graph Get the number of the resource operationId: print.shares.allowedGroups.GetCount-9181 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' parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare /print/shares/{printerShare-id}/allowedGroups/$ref: description: Provides operations to manage the collection of print entities. get: tags: - print.printerShare summary: Microsoft Graph List allowedGroups description: >- Retrieve a list of groups that have been granted access to submit print jobs to the associated printerShare. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printershare-list-allowedgroups?view=graph-rest-1.0 operationId: print.shares.ListRefAllowedGroups 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 responses: 2XX: $ref: '#/components/responses/StringCollectionResponse' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation post: tags: - print.printerShare summary: Microsoft Graph Create allowedGroup for printerShare description: >- Grant the specified group access to submit print jobs to the associated printerShare. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printershare-post-allowedgroups?view=graph-rest-1.0 operationId: print.shares.CreateRefAllowedGroups requestBody: $ref: '#/components/requestBodies/refPostBody' responses: '204': description: Success 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - print.printerShare summary: Microsoft Graph Delete allowedGroup from printerShare description: >- Revoke the specified group's access to submit print jobs to the associated printerShare. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printershare-delete-allowedgroup?view=graph-rest-1.0 operationId: print.shares.DeleteRefAllowedGroups parameters: - name: If-Match in: header description: ETag schema: type: string - name: '@id' in: query description: The delete Uri required: true schema: type: string responses: '204': description: Success 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare /print/shares/{printerShare-id}/allowedUsers: description: >- Provides operations to manage the allowedUsers property of the microsoft.graph.printerShare entity. get: tags: - print.printerShare summary: Microsoft Graph List allowedUsers description: >- Retrieve a list of users who have been granted access to submit print jobs to the associated printerShare. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printershare-list-allowedusers?view=graph-rest-1.0 operationId: print.shares.ListAllowedUsers 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.userCollectionResponse' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare /print/shares/{printerShare-id}/allowedUsers/{user-id}/$ref: description: Provides operations to manage the collection of print entities. delete: tags: - print.printerShare summary: Microsoft Graph Delete allowedUser from printerShare description: >- Revoke the specified user's access to submit print jobs to the associated printerShare. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printershare-delete-alloweduser?view=graph-rest-1.0 operationId: print.shares.allowedUsers.DeleteRefUser 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' x-ms-docs-operation-type: operation parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: user-id in: path description: The unique identifier of user required: true schema: type: string x-ms-docs-key-type: user /print/shares/{printerShare-id}/allowedUsers/{user-id}/mailboxSettings: get: tags: - print.printerShare summary: Microsoft Graph 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. Returned only on $select. operationId: print.shares.allowedUsers.GetMailboxSettings 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: Entity result. content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.mailboxSettings' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' patch: tags: - print.printerShare summary: Microsoft Graph Update property mailboxSettings value. operationId: print.shares.allowedUsers.UpdateMailboxSettings 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: user-id in: path description: The unique identifier of user required: true schema: type: string x-ms-docs-key-type: user /print/shares/{printerShare-id}/allowedUsers/{user-id}/serviceProvisioningErrors: get: tags: - print.printerShare summary: Microsoft Graph 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: print.shares.allowedUsers.ListServiceProvisioningErrors 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.serviceProvisioningErrorCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: user-id in: path description: The unique identifier of user required: true schema: type: string x-ms-docs-key-type: user /print/shares/{printerShare-id}/allowedUsers/{user-id}/serviceProvisioningErrors/$count: description: Provides operations to count the resources in the collection. get: tags: - print.printerShare summary: Microsoft Graph Get the number of the resource operationId: print.shares.allowedUsers.ServiceProvisioningErrors.GetCount-1213 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' parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: user-id in: path description: The unique identifier of user required: true schema: type: string x-ms-docs-key-type: user /print/shares/{printerShare-id}/allowedUsers/$count: description: Provides operations to count the resources in the collection. get: tags: - print.printerShare summary: Microsoft Graph Get the number of the resource operationId: print.shares.allowedUsers.GetCount-ee00 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' parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare /print/shares/{printerShare-id}/allowedUsers/$ref: description: Provides operations to manage the collection of print entities. get: tags: - print.printerShare summary: Microsoft Graph List allowedUsers description: >- Retrieve a list of users who have been granted access to submit print jobs to the associated printerShare. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printershare-list-allowedusers?view=graph-rest-1.0 operationId: print.shares.ListRefAllowedUsers 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 responses: 2XX: $ref: '#/components/responses/StringCollectionResponse' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation post: tags: - print.printerShare summary: Microsoft Graph Create allowedUser for printerShare description: >- Grant the specified user access to submit print jobs to the associated printerShare. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printershare-post-allowedusers?view=graph-rest-1.0 operationId: print.shares.CreateRefAllowedUsers requestBody: $ref: '#/components/requestBodies/refPostBody' responses: '204': description: Success 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - print.printerShare summary: Microsoft Graph Delete allowedUser from printerShare description: >- Revoke the specified user's access to submit print jobs to the associated printerShare. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printershare-delete-alloweduser?view=graph-rest-1.0 operationId: print.shares.DeleteRefAllowedUsers parameters: - name: If-Match in: header description: ETag schema: type: string - name: '@id' in: query description: The delete Uri required: true schema: type: string responses: '204': description: Success 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare /print/shares/{printerShare-id}/jobs: description: >- Provides operations to manage the jobs property of the microsoft.graph.printerBase entity. get: tags: - print.printerShare summary: Microsoft Graph List printJobs for a printerShare description: Retrieve a list of print jobs associated with the printerShare. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printershare-list-jobs?view=graph-rest-1.0 operationId: print.shares.ListJobs 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.printJobCollectionResponse' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation post: tags: - print.printerShare summary: Microsoft Graph Create printJob for a printerShare description: >- Create a new printJob for a printerShare. Also creates a new printDocument associated with the printJob. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printershare-post-jobs?view=graph-rest-1.0 operationId: print.shares.CreateJobs requestBody: description: New navigation property content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printJob' required: true responses: 2XX: description: Created navigation property. content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printJob' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare x-ms-docs-grouped-path: - /print/printers/{printer-id}/jobs /print/shares/{printerShare-id}/jobs/{printJob-id}: description: >- Provides operations to manage the jobs property of the microsoft.graph.printerBase entity. get: tags: - print.printerShare summary: Microsoft Graph Get jobs from print description: >- The list of jobs that are queued for printing by the printer/printerShare. operationId: print.shares.GetJobs 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.printJob' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - print.printerShare summary: Microsoft Graph Update the navigation property jobs in print operationId: print.shares.UpdateJobs requestBody: description: New navigation property values content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printJob' required: true responses: 2XX: description: Success content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printJob' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - print.printerShare summary: Microsoft Graph Delete navigation property jobs for print operationId: print.shares.DeleteJobs 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' x-ms-docs-operation-type: operation parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: printJob-id in: path description: The unique identifier of printJob required: true schema: type: string x-ms-docs-key-type: printJob x-ms-docs-grouped-path: - /print/printers/{printer-id}/jobs/{printJob-id} /print/shares/{printerShare-id}/jobs/{printJob-id}/documents: description: >- Provides operations to manage the documents property of the microsoft.graph.printJob entity. get: tags: - print.printerShare summary: Microsoft Graph Get documents from print operationId: print.shares.jobs.ListDocuments 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.printDocumentCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation post: tags: - print.printerShare summary: Microsoft Graph Create new navigation property to documents for print operationId: print.shares.jobs.CreateDocuments requestBody: description: New navigation property content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printDocument' required: true responses: 2XX: description: Created navigation property. content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printDocument' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: printJob-id in: path description: The unique identifier of printJob required: true schema: type: string x-ms-docs-key-type: printJob x-ms-docs-grouped-path: - /print/printers/{printer-id}/jobs/{printJob-id}/documents /print/shares/{printerShare-id}/jobs/{printJob-id}/documents/{printDocument-id}: description: >- Provides operations to manage the documents property of the microsoft.graph.printJob entity. get: tags: - print.printerShare summary: Microsoft Graph Get documents from print operationId: print.shares.jobs.GetDocuments 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.printDocument' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - print.printerShare summary: Microsoft Graph Update the navigation property documents in print operationId: print.shares.jobs.UpdateDocuments requestBody: description: New navigation property values content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printDocument' required: true responses: 2XX: description: Success content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printDocument' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - print.printerShare summary: Microsoft Graph Delete navigation property documents for print operationId: print.shares.jobs.DeleteDocuments 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' x-ms-docs-operation-type: operation parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: printJob-id in: path description: The unique identifier of printJob required: true schema: type: string x-ms-docs-key-type: printJob - name: printDocument-id in: path description: The unique identifier of printDocument required: true schema: type: string x-ms-docs-key-type: printDocument x-ms-docs-grouped-path: - >- /print/printers/{printer-id}/jobs/{printJob-id}/documents/{printDocument-id} /print/shares/{printerShare-id}/jobs/{printJob-id}/documents/{printDocument-id}/$value: description: Provides operations to manage the media for the print entity. get: tags: - print.printerShare summary: Microsoft Graph Get media content for the navigation property documents from print description: The unique identifier for an entity. Read-only. operationId: print.shares.jobs.GetDocumentsContent 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: - print.printerShare summary: Microsoft Graph Update media content for the navigation property documents in print description: The unique identifier for an entity. Read-only. operationId: print.shares.jobs.UpdateDocumentsContent requestBody: description: New media content. content: application/octet-stream: schema: type: string format: binary required: true responses: 2XX: description: Success 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' delete: tags: - print.printerShare summary: Microsoft Graph Delete media content for the navigation property documents in print description: The unique identifier for an entity. Read-only. operationId: print.shares.jobs.DeleteDocumentsContent 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' parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: printJob-id in: path description: The unique identifier of printJob required: true schema: type: string x-ms-docs-key-type: printJob - name: printDocument-id in: path description: The unique identifier of printDocument required: true schema: type: string x-ms-docs-key-type: printDocument /print/shares/{printerShare-id}/jobs/{printJob-id}/documents/{printDocument-id}/createUploadSession: description: Provides operations to call the createUploadSession method. post: tags: - print.printerShare summary: Microsoft Graph Invoke action createUploadSession description: >- Create an upload session that allows an app to iteratively upload ranges of a binary file linked to the print document. As part of the response, this action returns an upload URL that can be used in subsequent sequential PUT queries. Request headers for each PUT operation can be used to specify the exact range of bytes to be uploaded. This allows transfer to be resumed, in case the network connection is dropped during upload. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printdocument-createuploadsession?view=graph-rest-1.0 operationId: >- print.shares.printerShare.jobs.printJob.documents.printDocument.createUploadSession requestBody: description: Action parameters content: application/json: schema: type: object properties: properties: $ref: >- #/components/schemas/microsoft.graph.printDocumentUploadProperties required: true responses: 2XX: description: Success content: application/json: schema: anyOf: - $ref: '#/components/schemas/microsoft.graph.uploadSession' - type: object nullable: true 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: action parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: printJob-id in: path description: The unique identifier of printJob required: true schema: type: string x-ms-docs-key-type: printJob - name: printDocument-id in: path description: The unique identifier of printDocument required: true schema: type: string x-ms-docs-key-type: printDocument x-ms-docs-grouped-path: - >- /print/printers/{printer-id}/jobs/{printJob-id}/documents/{printDocument-id}/createUploadSession /print/shares/{printerShare-id}/jobs/{printJob-id}/documents/$count: description: Provides operations to count the resources in the collection. get: tags: - print.printerShare summary: Microsoft Graph Get the number of the resource operationId: print.shares.jobs.documents.GetCount-acc8 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' parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: printJob-id in: path description: The unique identifier of printJob required: true schema: type: string x-ms-docs-key-type: printJob /print/shares/{printerShare-id}/jobs/{printJob-id}/abort: description: Provides operations to call the abort method. post: tags: - print.printerShare summary: Microsoft Graph Invoke action abort description: >- Abort a print job. Only applications using application permissions can abort a print job. Aborting a print job will only succeed if there is a printTask in a processing state on the associated print job, started by a trigger that the requesting app created. For details about how to register a task trigger, see Extending Universal Print to support pull printing. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printjob-abort?view=graph-rest-1.0 operationId: print.shares.printerShare.jobs.printJob.abort requestBody: description: Action parameters content: application/json: schema: type: object properties: reason: type: string nullable: true required: true responses: '204': description: Success 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: action parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: printJob-id in: path description: The unique identifier of printJob required: true schema: type: string x-ms-docs-key-type: printJob x-ms-docs-grouped-path: - /print/printers/{printer-id}/jobs/{printJob-id}/abort /print/shares/{printerShare-id}/jobs/{printJob-id}/cancel: description: Provides operations to call the cancel method. post: tags: - print.printerShare summary: Microsoft Graph Invoke action cancel description: >- Cancel a print job. Print jobs can be canceled only on behalf of a user, using delegated permissions. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printjob-cancel?view=graph-rest-1.0 operationId: print.shares.printerShare.jobs.printJob.cancel responses: '204': description: Success 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: action parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: printJob-id in: path description: The unique identifier of printJob required: true schema: type: string x-ms-docs-key-type: printJob x-ms-docs-grouped-path: - /print/printers/{printer-id}/jobs/{printJob-id}/cancel /print/shares/{printerShare-id}/jobs/{printJob-id}/redirect: description: Provides operations to call the redirect method. post: tags: - print.printerShare summary: Microsoft Graph Invoke action redirect description: >- Redirect a print job to a different printer. Redirecting a print job will only succeed if there is a printTask in a processing state on the associated print job, started by a trigger that the requesting app created. For details about how to use this API to add pull printing support to Universal Print, see Extending Universal Print to support pull printing. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printjob-redirect?view=graph-rest-1.0 operationId: print.shares.printerShare.jobs.printJob.redirect requestBody: description: Action parameters content: application/json: schema: type: object properties: destinationPrinterId: type: string configuration: anyOf: - $ref: >- #/components/schemas/microsoft.graph.printJobConfiguration - type: object nullable: true required: true responses: 2XX: description: Success content: application/json: schema: anyOf: - $ref: '#/components/schemas/microsoft.graph.printJob' - type: object nullable: true 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: action parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: printJob-id in: path description: The unique identifier of printJob required: true schema: type: string x-ms-docs-key-type: printJob x-ms-docs-grouped-path: - /print/printers/{printer-id}/jobs/{printJob-id}/redirect /print/shares/{printerShare-id}/jobs/{printJob-id}/start: description: Provides operations to call the start method. post: tags: - print.printerShare summary: Microsoft Graph Invoke action start description: >- Submits the print job to the associated printer or printerShare. It will be printed after any existing pending jobs are completed, aborted, or canceled. externalDocs: description: Find more info here url: >- https://learn.microsoft.com/graph/api/printjob-start?view=graph-rest-1.0 operationId: print.shares.printerShare.jobs.printJob.start responses: 2XX: description: Success content: application/json: schema: anyOf: - $ref: '#/components/schemas/microsoft.graph.printJobStatus' - type: object nullable: true 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: action parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: printJob-id in: path description: The unique identifier of printJob required: true schema: type: string x-ms-docs-key-type: printJob x-ms-docs-grouped-path: - /print/printers/{printer-id}/jobs/{printJob-id}/start /print/shares/{printerShare-id}/jobs/{printJob-id}/tasks: description: >- Provides operations to manage the tasks property of the microsoft.graph.printJob entity. get: tags: - print.printerShare summary: Microsoft Graph Get tasks from print description: A list of printTasks that were triggered by this print job. operationId: print.shares.jobs.ListTasks 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.printTaskCollectionResponse' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation post: tags: - print.printerShare summary: Microsoft Graph Create new navigation property to tasks for print operationId: print.shares.jobs.CreateTasks requestBody: description: New navigation property content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printTask' required: true responses: 2XX: description: Created navigation property. content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printTask' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: printJob-id in: path description: The unique identifier of printJob required: true schema: type: string x-ms-docs-key-type: printJob x-ms-docs-grouped-path: - /print/printers/{printer-id}/jobs/{printJob-id}/tasks /print/shares/{printerShare-id}/jobs/{printJob-id}/tasks/{printTask-id}: description: >- Provides operations to manage the tasks property of the microsoft.graph.printJob entity. get: tags: - print.printerShare summary: Microsoft Graph Get tasks from print description: A list of printTasks that were triggered by this print job. operationId: print.shares.jobs.GetTasks 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.printTask' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - print.printerShare summary: Microsoft Graph Update the navigation property tasks in print operationId: print.shares.jobs.UpdateTasks requestBody: description: New navigation property values content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printTask' required: true responses: 2XX: description: Success content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printTask' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - print.printerShare summary: Microsoft Graph Delete navigation property tasks for print operationId: print.shares.jobs.DeleteTasks 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' x-ms-docs-operation-type: operation parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: printJob-id in: path description: The unique identifier of printJob required: true schema: type: string x-ms-docs-key-type: printJob - name: printTask-id in: path description: The unique identifier of printTask required: true schema: type: string x-ms-docs-key-type: printTask x-ms-docs-grouped-path: - /print/printers/{printer-id}/jobs/{printJob-id}/tasks/{printTask-id} /print/shares/{printerShare-id}/jobs/{printJob-id}/tasks/{printTask-id}/definition: description: >- Provides operations to manage the definition property of the microsoft.graph.printTask entity. get: tags: - print.printerShare summary: Microsoft Graph Get definition from print description: The printTaskDefinition that was used to create this task. Read-only. operationId: print.shares.jobs.tasks.GetDefinition 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.printTaskDefinition' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: printJob-id in: path description: The unique identifier of printJob required: true schema: type: string x-ms-docs-key-type: printJob - name: printTask-id in: path description: The unique identifier of printTask required: true schema: type: string x-ms-docs-key-type: printTask x-ms-docs-grouped-path: - >- /print/printers/{printer-id}/jobs/{printJob-id}/tasks/{printTask-id}/definition - >- /print/taskDefinitions/{printTaskDefinition-id}/tasks/{printTask-id}/definition /print/shares/{printerShare-id}/jobs/{printJob-id}/tasks/{printTask-id}/trigger: description: >- Provides operations to manage the trigger property of the microsoft.graph.printTask entity. get: tags: - print.printerShare summary: Microsoft Graph Get trigger from print description: The printTaskTrigger that triggered this task's execution. Read-only. operationId: print.shares.jobs.tasks.GetTrigger 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.printTaskTrigger' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: printJob-id in: path description: The unique identifier of printJob required: true schema: type: string x-ms-docs-key-type: printJob - name: printTask-id in: path description: The unique identifier of printTask required: true schema: type: string x-ms-docs-key-type: printTask x-ms-docs-grouped-path: - >- /print/printers/{printer-id}/jobs/{printJob-id}/tasks/{printTask-id}/trigger - >- /print/taskDefinitions/{printTaskDefinition-id}/tasks/{printTask-id}/trigger /print/shares/{printerShare-id}/jobs/{printJob-id}/tasks/$count: description: Provides operations to count the resources in the collection. get: tags: - print.printerShare summary: Microsoft Graph Get the number of the resource operationId: print.shares.jobs.tasks.GetCount-c052 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' parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare - name: printJob-id in: path description: The unique identifier of printJob required: true schema: type: string x-ms-docs-key-type: printJob /print/shares/{printerShare-id}/jobs/$count: description: Provides operations to count the resources in the collection. get: tags: - print.printerShare summary: Microsoft Graph Get the number of the resource operationId: print.shares.jobs.GetCount-d3ae 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' parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare /print/shares/{printerShare-id}/printer: description: >- Provides operations to manage the printer property of the microsoft.graph.printerShare entity. get: tags: - print.printerShare summary: Microsoft Graph Get printer from print description: The printer that this printer share is related to. operationId: print.shares.GetPrinter 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.printer' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: printerShare-id in: path description: The unique identifier of printerShare required: true schema: type: string x-ms-docs-key-type: printerShare /print/shares/$count: description: Provides operations to count the resources in the collection. get: tags: - print.printerShare summary: Microsoft Graph Get the number of the resource operationId: print.shares.GetCount-070b 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: description: Provides operations to manage the collection of sharedDriveItem entities. get: tags: - shares.sharedDriveItem 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. operationId: shares.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 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation post: tags: - shares.sharedDriveItem summary: Microsoft Graph Add new entity to shares operationId: shares.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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation /shares/{sharedDriveItem-id}: description: Provides operations to manage the collection of sharedDriveItem entities. get: tags: - shares.sharedDriveItem 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.sharedDriveItem.GetSharedDriveItem 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 entity content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.sharedDriveItem' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - shares.sharedDriveItem summary: Microsoft Graph Update entity in shares operationId: shares.sharedDriveItem.UpdateSharedDriveItem 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - shares.sharedDriveItem summary: Microsoft Graph Delete entity from shares operationId: shares.sharedDriveItem.DeleteSharedDriveItem 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' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/createdByUser: description: >- Provides operations to manage the createdByUser property of the microsoft.graph.baseItem entity. get: tags: - Shares.user summary: Microsoft Graph Get createdByUser from shares description: Identity of the user who created the item. Read-only. operationId: shares.GetCreatedByUser 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.user' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem x-ms-docs-grouped-path: - /shares/{sharedDriveItem-id}/list/createdByUser - /shares/{sharedDriveItem-id}/list/items/{listItem-id}/createdByUser /shares/{sharedDriveItem-id}/createdByUser/mailboxSettings: get: tags: - Shares.user summary: Microsoft Graph 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. Returned only on $select. operationId: shares.createdByUser.GetMailboxSettings 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: Entity result. content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.mailboxSettings' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' patch: tags: - Shares.user summary: Microsoft Graph Update property mailboxSettings value. operationId: shares.createdByUser.UpdateMailboxSettings 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/createdByUser/serviceProvisioningErrors: get: tags: - Shares.user summary: Microsoft Graph 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: shares.createdByUser.ListServiceProvisioningErrors 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.serviceProvisioningErrorCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/createdByUser/serviceProvisioningErrors/$count: description: Provides operations to count the resources in the collection. get: tags: - Shares.user summary: Microsoft Graph Get the number of the resource operationId: shares.createdByUser.ServiceProvisioningErrors.GetCount-abf4 parameters: - name: ConsistencyLevel in: header description: >- Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/driveItem: description: >- Provides operations to manage the driveItem property of the microsoft.graph.sharedDriveItem entity. 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 parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/driveItem/content: description: Provides operations to manage the media for the sharedDriveItem entity. 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/items: description: >- Provides operations to manage the items property of the microsoft.graph.sharedDriveItem entity. 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 parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/items/{driveItem-id}: description: >- Provides operations to manage the items property of the microsoft.graph.sharedDriveItem entity. 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 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 /shares/{sharedDriveItem-id}/items/{driveItem-id}/content: description: Provides operations to manage the media for the sharedDriveItem entity. 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' 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 /shares/{sharedDriveItem-id}/items/$count: description: Provides operations to count the resources in the collection. 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/lastModifiedByUser: description: >- Provides operations to manage the lastModifiedByUser property of the microsoft.graph.baseItem entity. get: tags: - Shares.user summary: Microsoft Graph Get lastModifiedByUser from shares description: Identity of the user who last modified the item. Read-only. operationId: shares.GetLastModifiedByUser 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.user' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem x-ms-docs-grouped-path: - /shares/{sharedDriveItem-id}/list/items/{listItem-id}/lastModifiedByUser - /shares/{sharedDriveItem-id}/list/lastModifiedByUser /shares/{sharedDriveItem-id}/lastModifiedByUser/mailboxSettings: get: tags: - Shares.user summary: Microsoft Graph 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. Returned only on $select. operationId: shares.lastModifiedByUser.GetMailboxSettings 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: Entity result. content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.mailboxSettings' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' patch: tags: - Shares.user summary: Microsoft Graph Update property mailboxSettings value. operationId: shares.lastModifiedByUser.UpdateMailboxSettings 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/lastModifiedByUser/serviceProvisioningErrors: get: tags: - Shares.user summary: Microsoft Graph 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: shares.lastModifiedByUser.ListServiceProvisioningErrors 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.serviceProvisioningErrorCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/lastModifiedByUser/serviceProvisioningErrors/$count: description: Provides operations to count the resources in the collection. get: tags: - Shares.user summary: Microsoft Graph Get the number of the resource operationId: shares.lastModifiedByUser.ServiceProvisioningErrors.GetCount-a885 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list: description: >- Provides operations to manage the list property of the microsoft.graph.sharedDriveItem entity. get: tags: - Shares.list summary: Microsoft Graph Get list from shares description: Used to access the underlying list operationId: shares.GetList 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.list' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - Shares.list summary: Microsoft Graph Update the navigation property list in shares operationId: shares.UpdateList 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - Shares.list summary: Microsoft Graph Delete navigation property list for shares operationId: shares.DeleteList 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' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/columns: description: >- Provides operations to manage the columns property of the microsoft.graph.list entity. get: tags: - Shares.list summary: Microsoft Graph Get columns from shares description: The collection of field definitions for this list. operationId: shares.list.ListColumns 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.columnDefinitionCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation post: tags: - Shares.list summary: Microsoft Graph Create new navigation property to columns for shares operationId: shares.list.CreateColumns 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/columns/{columnDefinition-id}: description: >- Provides operations to manage the columns property of the microsoft.graph.list entity. get: tags: - Shares.list summary: Microsoft Graph Get columns from shares description: The collection of field definitions for this list. operationId: shares.list.GetColumns 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.columnDefinition' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - Shares.list summary: Microsoft Graph Update the navigation property columns in shares operationId: shares.list.UpdateColumns 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - Shares.list summary: Microsoft Graph Delete navigation property columns for shares operationId: shares.list.DeleteColumns 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' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: columnDefinition-id in: path description: The unique identifier of columnDefinition required: true schema: type: string x-ms-docs-key-type: columnDefinition /shares/{sharedDriveItem-id}/list/columns/{columnDefinition-id}/sourceColumn: description: >- Provides operations to manage the sourceColumn property of the microsoft.graph.columnDefinition entity. get: tags: - Shares.list summary: Microsoft Graph Get sourceColumn from shares description: The source column for the content type column. operationId: shares.list.columns.GetSourceColumn 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.columnDefinition' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: columnDefinition-id in: path description: The unique identifier of columnDefinition required: true schema: type: string x-ms-docs-key-type: columnDefinition x-ms-docs-grouped-path: - >- /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columns/{columnDefinition-id}/sourceColumn /shares/{sharedDriveItem-id}/list/columns/$count: description: Provides operations to count the resources in the collection. get: tags: - Shares.list summary: Microsoft Graph Get the number of the resource operationId: shares.list.columns.GetCount-b936 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/contentTypes: description: >- Provides operations to manage the contentTypes property of the microsoft.graph.list entity. get: tags: - Shares.list summary: Microsoft Graph Get contentTypes from shares description: The collection of content types present in this list. operationId: shares.list.ListContentTypes 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.contentTypeCollectionResponse' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation post: tags: - Shares.list summary: Microsoft Graph Create new navigation property to contentTypes for shares operationId: shares.list.CreateContentTypes 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}: description: >- Provides operations to manage the contentTypes property of the microsoft.graph.list entity. get: tags: - Shares.list summary: Microsoft Graph Get contentTypes from shares description: The collection of content types present in this list. operationId: shares.list.GetContentTypes 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.contentType' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - Shares.list summary: Microsoft Graph Update the navigation property contentTypes in shares operationId: shares.list.UpdateContentTypes 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - Shares.list summary: Microsoft Graph Delete navigation property contentTypes for shares operationId: shares.list.DeleteContentTypes 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' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/base: description: >- Provides operations to manage the base property of the microsoft.graph.contentType entity. get: tags: - Shares.list summary: Microsoft Graph Get base from shares description: Parent contentType from which this content type is derived. operationId: shares.list.contentTypes.GetBase 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.contentType' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/baseTypes: description: >- Provides operations to manage the baseTypes property of the microsoft.graph.contentType entity. get: tags: - Shares.list summary: Microsoft Graph Get baseTypes from shares description: The collection of content types that are ancestors of this content type. operationId: shares.list.contentTypes.ListBaseTypes 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.contentTypeCollectionResponse' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/baseTypes/{contentType-id1}: description: >- Provides operations to manage the baseTypes property of the microsoft.graph.contentType entity. get: tags: - Shares.list summary: Microsoft Graph Get baseTypes from shares description: The collection of content types that are ancestors of this content type. operationId: shares.list.contentTypes.GetBaseTypes 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.contentType' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType - name: contentType-id1 in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/baseTypes/$count: description: Provides operations to count the resources in the collection. get: tags: - Shares.list summary: Microsoft Graph Get the number of the resource operationId: shares.list.contentTypes.baseTypes.GetCount-f23a 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columnLinks: description: >- Provides operations to manage the columnLinks property of the microsoft.graph.contentType entity. get: tags: - Shares.list summary: Microsoft Graph Get columnLinks from shares description: The collection of columns that are required by this content type. operationId: shares.list.contentTypes.ListColumnLinks 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.columnLinkCollectionResponse' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation post: tags: - Shares.list summary: Microsoft Graph Create new navigation property to columnLinks for shares operationId: shares.list.contentTypes.CreateColumnLinks 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columnLinks/{columnLink-id}: description: >- Provides operations to manage the columnLinks property of the microsoft.graph.contentType entity. get: tags: - Shares.list summary: Microsoft Graph Get columnLinks from shares description: The collection of columns that are required by this content type. operationId: shares.list.contentTypes.GetColumnLinks 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.columnLink' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - Shares.list summary: Microsoft Graph Update the navigation property columnLinks in shares operationId: shares.list.contentTypes.UpdateColumnLinks 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - Shares.list summary: Microsoft Graph Delete navigation property columnLinks for shares operationId: shares.list.contentTypes.DeleteColumnLinks 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' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType - name: columnLink-id in: path description: The unique identifier of columnLink required: true schema: type: string x-ms-docs-key-type: columnLink /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columnLinks/$count: description: Provides operations to count the resources in the collection. get: tags: - Shares.list summary: Microsoft Graph Get the number of the resource operationId: shares.list.contentTypes.columnLinks.GetCount-a211 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columnPositions: description: >- Provides operations to manage the columnPositions property of the microsoft.graph.contentType entity. get: tags: - Shares.list summary: Microsoft Graph Get columnPositions from shares description: Column order information in a content type. operationId: shares.list.contentTypes.ListColumnPositions 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.columnDefinitionCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columnPositions/{columnDefinition-id}: description: >- Provides operations to manage the columnPositions property of the microsoft.graph.contentType entity. get: tags: - Shares.list summary: Microsoft Graph Get columnPositions from shares description: Column order information in a content type. operationId: shares.list.contentTypes.GetColumnPositions 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.columnDefinition' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType - name: columnDefinition-id in: path description: The unique identifier of columnDefinition required: true schema: type: string x-ms-docs-key-type: columnDefinition /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columnPositions/$count: description: Provides operations to count the resources in the collection. get: tags: - Shares.list summary: Microsoft Graph Get the number of the resource operationId: shares.list.contentTypes.columnPositions.GetCount-1b55 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columns: description: >- Provides operations to manage the columns property of the microsoft.graph.contentType entity. get: tags: - Shares.list summary: Microsoft Graph Get columns from shares description: The collection of column definitions for this content type. operationId: shares.list.contentTypes.ListColumns 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.columnDefinitionCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation post: tags: - Shares.list summary: Microsoft Graph Create new navigation property to columns for shares operationId: shares.list.contentTypes.CreateColumns 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columns/{columnDefinition-id}: description: >- Provides operations to manage the columns property of the microsoft.graph.contentType entity. get: tags: - Shares.list summary: Microsoft Graph Get columns from shares description: The collection of column definitions for this content type. operationId: shares.list.contentTypes.GetColumns 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.columnDefinition' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - Shares.list summary: Microsoft Graph Update the navigation property columns in shares operationId: shares.list.contentTypes.UpdateColumns 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - Shares.list summary: Microsoft Graph Delete navigation property columns for shares operationId: shares.list.contentTypes.DeleteColumns 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' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType - name: columnDefinition-id in: path description: The unique identifier of columnDefinition required: true schema: type: string x-ms-docs-key-type: columnDefinition /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columns/{columnDefinition-id}/sourceColumn: description: >- Provides operations to manage the sourceColumn property of the microsoft.graph.columnDefinition entity. get: tags: - Shares.list summary: Microsoft Graph Get sourceColumn from shares description: The source column for the content type column. operationId: shares.list.contentTypes.columns.GetSourceColumn 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.columnDefinition' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType - name: columnDefinition-id in: path description: The unique identifier of columnDefinition required: true schema: type: string x-ms-docs-key-type: columnDefinition x-ms-docs-grouped-path: - >- /shares/{sharedDriveItem-id}/list/columns/{columnDefinition-id}/sourceColumn /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/columns/$count: description: Provides operations to count the resources in the collection. get: tags: - Shares.list summary: Microsoft Graph Get the number of the resource operationId: shares.list.contentTypes.columns.GetCount-db38 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/associateWithHubSites: description: Provides operations to call the associateWithHubSites method. post: tags: - Shares.list summary: Microsoft Graph 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: >- shares.sharedDriveItem.list.contentTypes.contentType.associateWithHubSites requestBody: description: Action parameters content: application/json: schema: type: object properties: hubSiteUrls: type: array items: type: string propagateToExistingLists: type: boolean default: false nullable: true required: true responses: '204': description: Success 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: action parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/copyToDefaultContentLocation: description: Provides operations to call the copyToDefaultContentLocation method. post: tags: - Shares.list summary: Microsoft Graph 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: >- shares.sharedDriveItem.list.contentTypes.contentType.copyToDefaultContentLocation requestBody: description: Action parameters content: application/json: schema: type: object properties: sourceFile: $ref: '#/components/schemas/microsoft.graph.itemReference' destinationFileName: type: string nullable: true required: true responses: '204': description: Success 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: action parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/isPublished(): description: Provides operations to call the isPublished method. get: tags: - Shares.list summary: Microsoft Graph 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: shares.sharedDriveItem.list.contentTypes.contentType.isPublished responses: 2XX: description: Success content: application/json: schema: type: object properties: value: type: boolean default: false 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: function parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/publish: description: Provides operations to call the publish method. post: tags: - Shares.list summary: Microsoft Graph 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: shares.sharedDriveItem.list.contentTypes.contentType.publish responses: '204': description: Success 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: action parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType /shares/{sharedDriveItem-id}/list/contentTypes/{contentType-id}/unpublish: description: Provides operations to call the unpublish method. post: tags: - Shares.list summary: Microsoft Graph 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: shares.sharedDriveItem.list.contentTypes.contentType.unpublish responses: '204': description: Success 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: action parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: contentType-id in: path description: The unique identifier of contentType required: true schema: type: string x-ms-docs-key-type: contentType /shares/{sharedDriveItem-id}/list/contentTypes/$count: description: Provides operations to count the resources in the collection. get: tags: - Shares.list summary: Microsoft Graph Get the number of the resource operationId: shares.list.contentTypes.GetCount-70f5 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/contentTypes/addCopy: description: Provides operations to call the addCopy method. post: tags: - Shares.list summary: Microsoft Graph 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: shares.sharedDriveItem.list.contentTypes.addCopy requestBody: description: Action parameters content: application/json: schema: type: object properties: contentType: type: string required: true responses: 2XX: description: Success content: application/json: schema: anyOf: - $ref: '#/components/schemas/microsoft.graph.contentType' - type: object nullable: true 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: action parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/contentTypes/addCopyFromContentTypeHub: description: Provides operations to call the addCopyFromContentTypeHub method. post: tags: - Shares.list summary: Microsoft Graph 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: shares.sharedDriveItem.list.contentTypes.addCopyFromContentTypeHub requestBody: description: Action parameters content: application/json: schema: type: object properties: contentTypeId: type: string required: true responses: 2XX: description: Success content: application/json: schema: anyOf: - $ref: '#/components/schemas/microsoft.graph.contentType' - type: object nullable: true 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: action parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/contentTypes/getCompatibleHubContentTypes(): description: Provides operations to call the getCompatibleHubContentTypes method. get: tags: - Shares.list summary: Microsoft Graph 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: shares.sharedDriveItem.list.contentTypes.getCompatibleHubContentTypes parameters: - $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 allOf: - $ref: '#/components/schemas/BaseCollectionPaginationCountResponse' - type: object properties: value: type: array items: $ref: '#/components/schemas/microsoft.graph.contentType' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: function x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/createdByUser: description: >- Provides operations to manage the createdByUser property of the microsoft.graph.baseItem entity. get: tags: - Shares.list summary: Microsoft Graph Get createdByUser from shares description: Identity of the user who created the item. Read-only. operationId: shares.list.GetCreatedByUser 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.user' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem x-ms-docs-grouped-path: - /shares/{sharedDriveItem-id}/createdByUser - /shares/{sharedDriveItem-id}/list/items/{listItem-id}/createdByUser /shares/{sharedDriveItem-id}/list/createdByUser/mailboxSettings: get: tags: - Shares.list summary: Microsoft Graph 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. Returned only on $select. operationId: shares.list.createdByUser.GetMailboxSettings 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: Entity result. content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.mailboxSettings' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' patch: tags: - Shares.list summary: Microsoft Graph Update property mailboxSettings value. operationId: shares.list.createdByUser.UpdateMailboxSettings 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/createdByUser/serviceProvisioningErrors: get: tags: - Shares.list summary: Microsoft Graph 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: shares.list.createdByUser.ListServiceProvisioningErrors 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.serviceProvisioningErrorCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/createdByUser/serviceProvisioningErrors/$count: description: Provides operations to count the resources in the collection. get: tags: - Shares.list summary: Microsoft Graph Get the number of the resource operationId: shares.list.createdByUser.ServiceProvisioningErrors.GetCount-7658 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/drive: description: >- Provides operations to manage the drive property of the microsoft.graph.list entity. get: tags: - Shares.list summary: Microsoft Graph Get drive from shares description: >- Allows access to the list as a drive resource with driveItems. Only present on document libraries. operationId: shares.list.GetDrive 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.drive' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/items: description: >- Provides operations to manage the items property of the microsoft.graph.list entity. get: tags: - Shares.list summary: Microsoft Graph Get items from shares description: All items contained in the list. operationId: shares.list.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.listItemCollectionResponse' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation post: tags: - Shares.list summary: Microsoft Graph Create new navigation property to items for shares operationId: shares.list.CreateItems 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/items/{listItem-id}: description: >- Provides operations to manage the items property of the microsoft.graph.list entity. get: tags: - Shares.list summary: Microsoft Graph Get items from shares description: All items contained in the list. operationId: shares.list.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.listItem' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - Shares.list summary: Microsoft Graph Update the navigation property items in shares operationId: shares.list.UpdateItems 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - Shares.list summary: Microsoft Graph Delete navigation property items for shares operationId: shares.list.DeleteItems 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' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem /shares/{sharedDriveItem-id}/list/items/{listItem-id}/analytics: description: >- Provides operations to manage the analytics property of the microsoft.graph.listItem entity. get: tags: - Shares.list summary: Microsoft Graph Get analytics from shares description: Analytics about the view activities that took place on this item. operationId: shares.list.items.GetAnalytics 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.itemAnalytics' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem /shares/{sharedDriveItem-id}/list/items/{listItem-id}/createdByUser: description: >- Provides operations to manage the createdByUser property of the microsoft.graph.baseItem entity. get: tags: - Shares.list summary: Microsoft Graph Get createdByUser from shares description: Identity of the user who created the item. Read-only. operationId: shares.list.items.GetCreatedByUser 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.user' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem x-ms-docs-grouped-path: - /shares/{sharedDriveItem-id}/createdByUser - /shares/{sharedDriveItem-id}/list/createdByUser /shares/{sharedDriveItem-id}/list/items/{listItem-id}/createdByUser/mailboxSettings: get: tags: - Shares.list summary: Microsoft Graph 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. Returned only on $select. operationId: shares.list.items.createdByUser.GetMailboxSettings 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: Entity result. content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.mailboxSettings' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' patch: tags: - Shares.list summary: Microsoft Graph Update property mailboxSettings value. operationId: shares.list.items.createdByUser.UpdateMailboxSettings 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem /shares/{sharedDriveItem-id}/list/items/{listItem-id}/createdByUser/serviceProvisioningErrors: get: tags: - Shares.list summary: Microsoft Graph 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: shares.list.items.createdByUser.ListServiceProvisioningErrors 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.serviceProvisioningErrorCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem /shares/{sharedDriveItem-id}/list/items/{listItem-id}/createdByUser/serviceProvisioningErrors/$count: description: Provides operations to count the resources in the collection. get: tags: - Shares.list summary: Microsoft Graph Get the number of the resource operationId: shares.list.items.createdByUser.ServiceProvisioningErrors.GetCount-1b79 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem /shares/{sharedDriveItem-id}/list/items/{listItem-id}/documentSetVersions: description: >- Provides operations to manage the documentSetVersions property of the microsoft.graph.listItem entity. get: tags: - Shares.list summary: Microsoft Graph Get documentSetVersions from shares description: Version information for a document set version created by a user. operationId: shares.list.items.ListDocumentSetVersions 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.documentSetVersionCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation post: tags: - Shares.list summary: Microsoft Graph Create new navigation property to documentSetVersions for shares operationId: shares.list.items.CreateDocumentSetVersions 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem /shares/{sharedDriveItem-id}/list/items/{listItem-id}/documentSetVersions/{documentSetVersion-id}: description: >- Provides operations to manage the documentSetVersions property of the microsoft.graph.listItem entity. get: tags: - Shares.list summary: Microsoft Graph Get documentSetVersions from shares description: Version information for a document set version created by a user. operationId: shares.list.items.GetDocumentSetVersions 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.documentSetVersion' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - Shares.list summary: Microsoft Graph Update the navigation property documentSetVersions in shares operationId: shares.list.items.UpdateDocumentSetVersions 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - Shares.list summary: Microsoft Graph Delete navigation property documentSetVersions for shares operationId: shares.list.items.DeleteDocumentSetVersions 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' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem - name: documentSetVersion-id in: path description: The unique identifier of documentSetVersion required: true schema: type: string x-ms-docs-key-type: documentSetVersion /shares/{sharedDriveItem-id}/list/items/{listItem-id}/documentSetVersions/{documentSetVersion-id}/fields: description: >- Provides operations to manage the fields property of the microsoft.graph.listItemVersion entity. get: tags: - Shares.list summary: Microsoft Graph Get fields from shares description: A collection of the fields and values for this version of the list item. operationId: shares.list.items.documentSetVersions.GetFields 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.fieldValueSet' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - Shares.list summary: Microsoft Graph Update the navigation property fields in shares operationId: shares.list.items.documentSetVersions.UpdateFields 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - Shares.list summary: Microsoft Graph Delete navigation property fields for shares operationId: shares.list.items.documentSetVersions.DeleteFields 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' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem - name: documentSetVersion-id in: path description: The unique identifier of documentSetVersion required: true schema: type: string x-ms-docs-key-type: documentSetVersion x-ms-docs-grouped-path: - >- /shares/{sharedDriveItem-id}/list/items/{listItem-id}/versions/{listItemVersion-id}/fields /shares/{sharedDriveItem-id}/list/items/{listItem-id}/documentSetVersions/{documentSetVersion-id}/restore: description: Provides operations to call the restore method. post: tags: - Shares.list summary: Microsoft Graph 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: >- shares.sharedDriveItem.list.items.listItem.documentSetVersions.documentSetVersion.restore responses: '204': description: Success 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: action parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem - name: documentSetVersion-id in: path description: The unique identifier of documentSetVersion required: true schema: type: string x-ms-docs-key-type: documentSetVersion /shares/{sharedDriveItem-id}/list/items/{listItem-id}/documentSetVersions/$count: description: Provides operations to count the resources in the collection. get: tags: - Shares.list summary: Microsoft Graph Get the number of the resource operationId: shares.list.items.documentSetVersions.GetCount-172d 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem /shares/{sharedDriveItem-id}/list/items/{listItem-id}/driveItem: description: >- Provides operations to manage the driveItem property of the microsoft.graph.listItem entity. get: tags: - Shares.list summary: Microsoft Graph Get driveItem from shares description: >- For document libraries, the driveItem relationship exposes the listItem as a driveItem operationId: shares.list.items.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 parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem /shares/{sharedDriveItem-id}/list/items/{listItem-id}/driveItem/content: description: Provides operations to manage the media for the sharedDriveItem entity. get: tags: - Shares.list summary: Microsoft Graph Get content for the navigation property driveItem from shares description: The content stream, if the item represents a file. operationId: shares.list.items.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.list summary: Microsoft Graph Update content for the navigation property driveItem in shares description: The content stream, if the item represents a file. operationId: shares.list.items.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.list summary: Microsoft Graph Delete content for the navigation property driveItem in shares description: The content stream, if the item represents a file. operationId: shares.list.items.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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem /shares/{sharedDriveItem-id}/list/items/{listItem-id}/fields: description: >- Provides operations to manage the fields property of the microsoft.graph.listItem entity. get: tags: - Shares.list summary: Microsoft Graph Get fields from shares description: The values of the columns set on this list item. operationId: shares.list.items.GetFields 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.fieldValueSet' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - Shares.list summary: Microsoft Graph Update the navigation property fields in shares operationId: shares.list.items.UpdateFields 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - Shares.list summary: Microsoft Graph Delete navigation property fields for shares operationId: shares.list.items.DeleteFields 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' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem /shares/{sharedDriveItem-id}/list/items/{listItem-id}/lastModifiedByUser: description: >- Provides operations to manage the lastModifiedByUser property of the microsoft.graph.baseItem entity. get: tags: - Shares.list summary: Microsoft Graph Get lastModifiedByUser from shares description: Identity of the user who last modified the item. Read-only. operationId: shares.list.items.GetLastModifiedByUser 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.user' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem x-ms-docs-grouped-path: - /shares/{sharedDriveItem-id}/lastModifiedByUser - /shares/{sharedDriveItem-id}/list/lastModifiedByUser /shares/{sharedDriveItem-id}/list/items/{listItem-id}/lastModifiedByUser/mailboxSettings: get: tags: - Shares.list summary: Microsoft Graph 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. Returned only on $select. operationId: shares.list.items.lastModifiedByUser.GetMailboxSettings 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: Entity result. content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.mailboxSettings' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' patch: tags: - Shares.list summary: Microsoft Graph Update property mailboxSettings value. operationId: shares.list.items.lastModifiedByUser.UpdateMailboxSettings 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem /shares/{sharedDriveItem-id}/list/items/{listItem-id}/lastModifiedByUser/serviceProvisioningErrors: get: tags: - Shares.list summary: Microsoft Graph 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: shares.list.items.lastModifiedByUser.ListServiceProvisioningErrors 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.serviceProvisioningErrorCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem /shares/{sharedDriveItem-id}/list/items/{listItem-id}/lastModifiedByUser/serviceProvisioningErrors/$count: description: Provides operations to count the resources in the collection. get: tags: - Shares.list summary: Microsoft Graph Get the number of the resource operationId: >- shares.list.items.lastModifiedByUser.ServiceProvisioningErrors.GetCount-401d 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem /shares/{sharedDriveItem-id}/list/items/{listItem-id}/createLink: description: Provides operations to call the createLink method. post: tags: - Shares.list summary: Microsoft Graph Invoke action createLink operationId: shares.sharedDriveItem.list.items.listItem.createLink 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 required: true responses: 2XX: description: Success content: application/json: schema: anyOf: - $ref: '#/components/schemas/microsoft.graph.permission' - type: object nullable: true 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: action parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem /shares/{sharedDriveItem-id}/list/items/{listItem-id}/getActivitiesByInterval(): description: Provides operations to call the getActivitiesByInterval method. get: tags: - Shares.list summary: Microsoft Graph Invoke function getActivitiesByInterval operationId: shares.sharedDriveItem.list.items.listItem.getActivitiesByInterval-4c35 parameters: - $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 allOf: - $ref: '#/components/schemas/BaseCollectionPaginationCountResponse' - type: object properties: value: type: array items: $ref: >- #/components/schemas/microsoft.graph.itemActivityStat 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: function x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem x-ms-docs-grouped-path: - >- /shares/{sharedDriveItem-id}/list/items/{listItem-id}/getActivitiesByInterval(startDateTime='{startDateTime}',endDateTime='{endDateTime}',interval='{interval}') ? /shares/{sharedDriveItem-id}/list/items/{listItem-id}/getActivitiesByInterval(startDateTime='{startDateTime}',endDateTime='{endDateTime}',interval='{interval}') : description: Provides operations to call the getActivitiesByInterval method. get: tags: - Shares.list summary: Microsoft Graph Invoke function getActivitiesByInterval operationId: shares.sharedDriveItem.list.items.listItem.getActivitiesByInterval-ad27 parameters: - $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 allOf: - $ref: '#/components/schemas/BaseCollectionPaginationCountResponse' - type: object properties: value: type: array items: $ref: >- #/components/schemas/microsoft.graph.itemActivityStat 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: function x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem - name: startDateTime in: path description: 'Usage: startDateTime=''{startDateTime}''' required: true schema: type: string nullable: true - name: endDateTime in: path description: 'Usage: endDateTime=''{endDateTime}''' required: true schema: type: string nullable: true - name: interval in: path description: 'Usage: interval=''{interval}''' required: true schema: type: string nullable: true x-ms-docs-grouped-path: - >- /shares/{sharedDriveItem-id}/list/items/{listItem-id}/getActivitiesByInterval() /shares/{sharedDriveItem-id}/list/items/{listItem-id}/versions: description: >- Provides operations to manage the versions property of the microsoft.graph.listItem entity. get: tags: - Shares.list summary: Microsoft Graph Get versions from shares description: The list of previous versions of the list item. operationId: shares.list.items.ListVersions 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.listItemVersionCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation post: tags: - Shares.list summary: Microsoft Graph Create new navigation property to versions for shares operationId: shares.list.items.CreateVersions 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem /shares/{sharedDriveItem-id}/list/items/{listItem-id}/versions/{listItemVersion-id}: description: >- Provides operations to manage the versions property of the microsoft.graph.listItem entity. get: tags: - Shares.list summary: Microsoft Graph Get versions from shares description: The list of previous versions of the list item. operationId: shares.list.items.GetVersions 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.listItemVersion' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - Shares.list summary: Microsoft Graph Update the navigation property versions in shares operationId: shares.list.items.UpdateVersions 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - Shares.list summary: Microsoft Graph Delete navigation property versions for shares operationId: shares.list.items.DeleteVersions 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' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem - name: listItemVersion-id in: path description: The unique identifier of listItemVersion required: true schema: type: string x-ms-docs-key-type: listItemVersion /shares/{sharedDriveItem-id}/list/items/{listItem-id}/versions/{listItemVersion-id}/fields: description: >- Provides operations to manage the fields property of the microsoft.graph.listItemVersion entity. get: tags: - Shares.list summary: Microsoft Graph Get fields from shares description: A collection of the fields and values for this version of the list item. operationId: shares.list.items.versions.GetFields 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.fieldValueSet' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - Shares.list summary: Microsoft Graph Update the navigation property fields in shares operationId: shares.list.items.versions.UpdateFields 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - Shares.list summary: Microsoft Graph Delete navigation property fields for shares operationId: shares.list.items.versions.DeleteFields 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' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem - name: listItemVersion-id in: path description: The unique identifier of listItemVersion required: true schema: type: string x-ms-docs-key-type: listItemVersion x-ms-docs-grouped-path: - >- /shares/{sharedDriveItem-id}/list/items/{listItem-id}/documentSetVersions/{documentSetVersion-id}/fields /shares/{sharedDriveItem-id}/list/items/{listItem-id}/versions/{listItemVersion-id}/restoreVersion: description: Provides operations to call the restoreVersion method. post: tags: - Shares.list summary: Microsoft Graph 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: >- shares.sharedDriveItem.list.items.listItem.versions.listItemVersion.restoreVersion responses: '204': description: Success 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: action parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem - name: listItemVersion-id in: path description: The unique identifier of listItemVersion required: true schema: type: string x-ms-docs-key-type: listItemVersion /shares/{sharedDriveItem-id}/list/items/{listItem-id}/versions/$count: description: Provides operations to count the resources in the collection. get: tags: - Shares.list summary: Microsoft Graph Get the number of the resource operationId: shares.list.items.versions.GetCount-0c45 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: listItem-id in: path description: The unique identifier of listItem required: true schema: type: string x-ms-docs-key-type: listItem /shares/{sharedDriveItem-id}/list/items/delta(): description: Provides operations to call the delta method. get: tags: - Shares.list summary: Microsoft Graph 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: shares.sharedDriveItem.list.items.delta-fa14 parameters: - $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 allOf: - $ref: '#/components/schemas/BaseDeltaFunctionResponse' - type: object properties: value: type: array items: $ref: '#/components/schemas/microsoft.graph.listItem' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: function x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem x-ms-docs-grouped-path: - /shares/{sharedDriveItem-id}/list/items/delta(token='{token}') /shares/{sharedDriveItem-id}/list/items/delta(token='{token}'): description: Provides operations to call the delta method. get: tags: - Shares.list summary: Microsoft Graph Invoke function delta operationId: shares.sharedDriveItem.list.items.delta-9846 parameters: - $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 allOf: - $ref: '#/components/schemas/BaseDeltaFunctionResponse' - type: object properties: value: type: array items: $ref: '#/components/schemas/microsoft.graph.listItem' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: function x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: token in: path description: 'Usage: token=''{token}''' required: true schema: type: string nullable: true x-ms-docs-grouped-path: - /shares/{sharedDriveItem-id}/list/items/delta() /shares/{sharedDriveItem-id}/list/lastModifiedByUser: description: >- Provides operations to manage the lastModifiedByUser property of the microsoft.graph.baseItem entity. get: tags: - Shares.list summary: Microsoft Graph Get lastModifiedByUser from shares description: Identity of the user who last modified the item. Read-only. operationId: shares.list.GetLastModifiedByUser 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.user' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem x-ms-docs-grouped-path: - /shares/{sharedDriveItem-id}/lastModifiedByUser - /shares/{sharedDriveItem-id}/list/items/{listItem-id}/lastModifiedByUser /shares/{sharedDriveItem-id}/list/lastModifiedByUser/mailboxSettings: get: tags: - Shares.list summary: Microsoft Graph 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. Returned only on $select. operationId: shares.list.lastModifiedByUser.GetMailboxSettings 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: Entity result. content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.mailboxSettings' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' patch: tags: - Shares.list summary: Microsoft Graph Update property mailboxSettings value. operationId: shares.list.lastModifiedByUser.UpdateMailboxSettings 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/lastModifiedByUser/serviceProvisioningErrors: get: tags: - Shares.list summary: Microsoft Graph 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: shares.list.lastModifiedByUser.ListServiceProvisioningErrors 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.serviceProvisioningErrorCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/lastModifiedByUser/serviceProvisioningErrors/$count: description: Provides operations to count the resources in the collection. get: tags: - Shares.list summary: Microsoft Graph Get the number of the resource operationId: shares.list.lastModifiedByUser.ServiceProvisioningErrors.GetCount-8cfb 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/operations: description: >- Provides operations to manage the operations property of the microsoft.graph.list entity. get: tags: - Shares.list summary: Microsoft Graph Get operations from shares description: The collection of long-running operations on the list. operationId: shares.list.ListOperations 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.richLongRunningOperationCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation post: tags: - Shares.list summary: Microsoft Graph Create new navigation property to operations for shares operationId: shares.list.CreateOperations 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/operations/{richLongRunningOperation-id}: description: >- Provides operations to manage the operations property of the microsoft.graph.list entity. get: tags: - Shares.list summary: Microsoft Graph Get operations from shares description: The collection of long-running operations on the list. operationId: shares.list.GetOperations 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.richLongRunningOperation' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - Shares.list summary: Microsoft Graph Update the navigation property operations in shares operationId: shares.list.UpdateOperations 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - Shares.list summary: Microsoft Graph Delete navigation property operations for shares operationId: shares.list.DeleteOperations 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' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: richLongRunningOperation-id in: path description: The unique identifier of richLongRunningOperation required: true schema: type: string x-ms-docs-key-type: richLongRunningOperation /shares/{sharedDriveItem-id}/list/operations/$count: description: Provides operations to count the resources in the collection. get: tags: - Shares.list summary: Microsoft Graph Get the number of the resource operationId: shares.list.operations.GetCount-5f90 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/subscriptions: description: >- Provides operations to manage the subscriptions property of the microsoft.graph.list entity. get: tags: - Shares.list summary: Microsoft Graph Get subscriptions from shares description: The set of subscriptions on the list. operationId: shares.list.ListSubscriptions 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.subscriptionCollectionResponse 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation post: tags: - Shares.list summary: Microsoft Graph Create new navigation property to subscriptions for shares operationId: shares.list.CreateSubscriptions 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/list/subscriptions/{subscription-id}: description: >- Provides operations to manage the subscriptions property of the microsoft.graph.list entity. get: tags: - Shares.list summary: Microsoft Graph Get subscriptions from shares description: The set of subscriptions on the list. operationId: shares.list.GetSubscriptions 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.subscription' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - Shares.list summary: Microsoft Graph Update the navigation property subscriptions in shares operationId: shares.list.UpdateSubscriptions 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - Shares.list summary: Microsoft Graph Delete navigation property subscriptions for shares operationId: shares.list.DeleteSubscriptions 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' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: subscription-id in: path description: The unique identifier of subscription required: true schema: type: string x-ms-docs-key-type: subscription /shares/{sharedDriveItem-id}/list/subscriptions/{subscription-id}/reauthorize: description: Provides operations to call the reauthorize method. post: tags: - Shares.list summary: Microsoft Graph 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: shares.sharedDriveItem.list.subscriptions.subscription.reauthorize responses: '204': description: Success 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: action parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem - name: subscription-id in: path description: The unique identifier of subscription required: true schema: type: string x-ms-docs-key-type: subscription /shares/{sharedDriveItem-id}/list/subscriptions/$count: description: Provides operations to count the resources in the collection. get: tags: - Shares.list summary: Microsoft Graph Get the number of the resource operationId: shares.list.subscriptions.GetCount-4363 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/listItem: description: >- Provides operations to manage the listItem property of the microsoft.graph.sharedDriveItem entity. get: tags: - shares.listItem summary: Microsoft Graph Get listItem from shares description: Used to access the underlying listItem operationId: shares.GetListItem 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.listItem' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/permission: description: >- Provides operations to manage the permission property of the microsoft.graph.sharedDriveItem entity. get: tags: - Shares.permission summary: Microsoft Graph Get permission from shares description: Used to access the permission representing the underlying sharing link operationId: shares.GetPermission 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.permission' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - Shares.permission summary: Microsoft Graph Update the navigation property permission in shares operationId: shares.UpdatePermission 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' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - Shares.permission summary: Microsoft Graph Delete navigation property permission for shares operationId: shares.DeletePermission 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' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/permission/grant: description: Provides operations to call the grant method. post: tags: - Shares.permission summary: Microsoft Graph 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: shares.sharedDriveItem.permission.grant 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' required: true responses: 2XX: description: Success content: application/json: schema: title: Collection of permission type: object allOf: - $ref: '#/components/schemas/BaseCollectionPaginationCountResponse' - type: object properties: value: type: array items: $ref: '#/components/schemas/microsoft.graph.permission' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: action x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/root: description: >- Provides operations to manage the root property of the microsoft.graph.sharedDriveItem entity. 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 parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/root/content: description: Provides operations to manage the media for the sharedDriveItem entity. 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' parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/{sharedDriveItem-id}/site: description: >- Provides operations to manage the site property of the microsoft.graph.sharedDriveItem entity. get: tags: - Shares.site summary: Microsoft Graph Get site from shares description: Used to access the underlying site operationId: shares.GetSite 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.site' 4XX: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation parameters: - name: sharedDriveItem-id in: path description: The unique identifier of sharedDriveItem required: true schema: type: string x-ms-docs-key-type: sharedDriveItem /shares/$count: description: Provides operations to count the resources in the collection. get: tags: - shares.sharedDriveItem summary: Microsoft Graph Get the number of the resource operationId: shares.GetCount-778c 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' components: schemas: microsoft.graph.printerShare: allOf: - $ref: '#/components/schemas/microsoft.graph.printerBase' - title: printerShare required: - '@odata.type' type: object properties: allowAllUsers: type: boolean description: >- If true, all users and groups will be granted access to this printer share. This supersedes the allow lists defined by the allowedUsers and allowedGroups navigation 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 DateTimeOffset when the printer share was created. Read-only. format: date-time viewPoint: anyOf: - $ref: '#/components/schemas/microsoft.graph.printerShareViewpoint' - type: object nullable: true description: >- Additional data for a printer share as viewed by the signed-in user. allowedGroups: type: array items: $ref: '#/components/schemas/microsoft.graph.group' description: The groups whose users have access to print using the printer. x-ms-navigationProperty: true allowedUsers: type: array items: $ref: '#/components/schemas/microsoft.graph.user' description: The users who have access to print using the printer. x-ms-navigationProperty: true printer: anyOf: - $ref: '#/components/schemas/microsoft.graph.printer' - type: object nullable: true description: The printer that this printer share is related to. x-ms-navigationProperty: true '@odata.type': type: string default: '#microsoft.graph.printerShare' x-ms-discriminator-value: '#microsoft.graph.printerShare' microsoft.graph.mailboxSettings: title: mailboxSettings required: - '@odata.type' type: object properties: archiveFolder: type: string description: Folder ID of an archive folder for the user. nullable: true automaticRepliesSetting: anyOf: - $ref: '#/components/schemas/microsoft.graph.automaticRepliesSetting' - type: object nullable: true description: >- Configuration settings to automatically notify the sender of an incoming email with a message from the signed-in user. dateFormat: type: string description: The date format for the user's mailbox. nullable: true delegateMeetingMessageDeliveryOptions: anyOf: - $ref: >- #/components/schemas/microsoft.graph.delegateMeetingMessageDeliveryOptions - type: object nullable: true description: >- If the user has a calendar delegate, this specifies whether the delegate, mailbox owner, or both receive meeting messages and meeting responses. The possible values are: sendToDelegateAndInformationToPrincipal, sendToDelegateAndPrincipal, sendToDelegateOnly. language: anyOf: - $ref: '#/components/schemas/microsoft.graph.localeInfo' - type: object nullable: true description: >- The locale information for the user, including the preferred language and country/region. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.userPurpose' - type: object nullable: true description: >- The purpose of the mailbox. Differentiates a mailbox for a single user from a shared mailbox and equipment mailbox in Exchange Online. The possible values are: user, linked, shared, room, equipment, others, unknownFutureValue. Read-only. workingHours: anyOf: - $ref: '#/components/schemas/microsoft.graph.workingHours' - type: object nullable: true description: >- The days of the week and hours in a specific time zone that the user works. '@odata.type': type: string microsoft.graph.printJob: allOf: - $ref: '#/components/schemas/microsoft.graph.entity' - title: printJob required: - '@odata.type' type: object properties: acknowledgedDateTime: 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 dateTimeOffset when the job was acknowledged. Read-only. format: date-time nullable: true configuration: $ref: '#/components/schemas/microsoft.graph.printJobConfiguration' createdBy: anyOf: - $ref: '#/components/schemas/microsoft.graph.userIdentity' - type: object 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 DateTimeOffset when the job was created. Read-only. format: date-time errorCode: maximum: 2147483647 minimum: -2147483648 type: number description: The error code of the print job. Read-only. format: int32 nullable: true isFetchable: type: boolean description: If true, document can be fetched by printer. redirectedFrom: type: string description: >- Contains the source job URL, if the job has been redirected from another printer. nullable: true redirectedTo: type: string description: >- Contains the destination job URL, if the job has been redirected to another printer. nullable: true status: $ref: '#/components/schemas/microsoft.graph.printJobStatus' documents: type: array items: $ref: '#/components/schemas/microsoft.graph.printDocument' x-ms-navigationProperty: true tasks: type: array items: $ref: '#/components/schemas/microsoft.graph.printTask' description: A list of printTasks that were triggered by this print job. x-ms-navigationProperty: true '@odata.type': type: string x-ms-discriminator-value: '#microsoft.graph.printJob' microsoft.graph.printDocument: allOf: - $ref: '#/components/schemas/microsoft.graph.entity' - title: printDocument required: - '@odata.type' type: object properties: contentType: type: string description: The document's content (MIME) type. Read-only. nullable: true displayName: type: string description: The document's name. Read-only. nullable: true downloadedDateTime: 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 the document was downloaded. Read-only format: date-time nullable: true size: type: number description: The document's size in bytes. Read-only. format: int64 uploadedDateTime: 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 the document was uploaded. Read-only format: date-time nullable: true '@odata.type': type: string x-ms-discriminator-value: '#microsoft.graph.printDocument' microsoft.graph.uploadSession: title: uploadSession required: - '@odata.type' 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 '@odata.type': type: string microsoft.graph.printJobStatus: title: printJobStatus required: - '@odata.type' type: object properties: description: type: string description: >- A human-readable description of the print job's current processing state. Read-only. details: type: array items: $ref: '#/components/schemas/microsoft.graph.printJobStateDetail' description: >- Additional details for print job state. Valid values are described in the following table. Read-only. isAcquiredByPrinter: type: boolean description: >- True if the job was acknowledged by a printer; false otherwise. Read-only. state: $ref: '#/components/schemas/microsoft.graph.printJobProcessingState' '@odata.type': type: string microsoft.graph.printTask: allOf: - $ref: '#/components/schemas/microsoft.graph.entity' - title: printTask required: - '@odata.type' type: object properties: parentUrl: type: string description: >- The URL for the print entity that triggered this task. For example, https://graph.microsoft.com/v1.0/print/printers/{printerId}/jobs/{jobId}. Read-only. status: $ref: '#/components/schemas/microsoft.graph.printTaskStatus' definition: $ref: '#/components/schemas/microsoft.graph.printTaskDefinition' trigger: $ref: '#/components/schemas/microsoft.graph.printTaskTrigger' '@odata.type': type: string x-ms-discriminator-value: '#microsoft.graph.printTask' microsoft.graph.printTaskDefinition: allOf: - $ref: '#/components/schemas/microsoft.graph.entity' - title: printTaskDefinition required: - '@odata.type' type: object properties: createdBy: $ref: '#/components/schemas/microsoft.graph.appIdentity' displayName: type: string description: The name of the printTaskDefinition. tasks: type: array items: $ref: '#/components/schemas/microsoft.graph.printTask' description: >- A list of tasks that have been created based on this definition. The list includes currently running tasks and recently completed tasks. Read-only. x-ms-navigationProperty: true '@odata.type': type: string x-ms-discriminator-value: '#microsoft.graph.printTaskDefinition' microsoft.graph.printTaskTrigger: allOf: - $ref: '#/components/schemas/microsoft.graph.entity' - title: printTaskTrigger required: - '@odata.type' type: object properties: event: $ref: '#/components/schemas/microsoft.graph.printEvent' definition: $ref: '#/components/schemas/microsoft.graph.printTaskDefinition' '@odata.type': type: string x-ms-discriminator-value: '#microsoft.graph.printTaskTrigger' microsoft.graph.printer: allOf: - $ref: '#/components/schemas/microsoft.graph.printerBase' - title: printer required: - '@odata.type' type: object properties: hasPhysicalDevice: type: boolean description: >- True if the printer has a physical device for printing. Read-only. isShared: type: boolean description: True if the printer is shared; false otherwise. Read-only. lastSeenDateTime: 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 most recent dateTimeOffset when a printer interacted with Universal Print. Read-only. format: date-time nullable: true registeredDateTime: 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 DateTimeOffset when the printer was registered. Read-only. format: date-time connectors: type: array items: $ref: '#/components/schemas/microsoft.graph.printConnector' description: The connectors that are associated with the printer. x-ms-navigationProperty: true shares: type: array items: $ref: '#/components/schemas/microsoft.graph.printerShare' description: >- The list of printerShares that are associated with the printer. Currently, only one printerShare can be associated with the printer. Read-only. Nullable. x-ms-navigationProperty: true taskTriggers: type: array items: $ref: '#/components/schemas/microsoft.graph.printTaskTrigger' description: A list of task triggers that are associated with the printer. x-ms-navigationProperty: true '@odata.type': type: string default: '#microsoft.graph.printer' x-ms-discriminator-value: '#microsoft.graph.printer' microsoft.graph.sharedDriveItem: allOf: - $ref: '#/components/schemas/microsoft.graph.baseItem' - title: sharedDriveItem required: - '@odata.type' type: object properties: owner: anyOf: - $ref: '#/components/schemas/microsoft.graph.identitySet' - type: object nullable: true description: Information about the owner of the shared item being referenced. driveItem: anyOf: - $ref: '#/components/schemas/microsoft.graph.driveItem' - type: object nullable: true description: Used to access the underlying driveItem x-ms-navigationProperty: true 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.list' - type: object nullable: true description: Used to access the underlying list x-ms-navigationProperty: true listItem: anyOf: - $ref: '#/components/schemas/microsoft.graph.listItem' - type: object nullable: true description: Used to access the underlying listItem x-ms-navigationProperty: true permission: anyOf: - $ref: '#/components/schemas/microsoft.graph.permission' - type: object nullable: true description: >- Used to access the permission representing the underlying sharing link x-ms-navigationProperty: true root: anyOf: - $ref: '#/components/schemas/microsoft.graph.driveItem' - type: object nullable: true description: >- Used to access the underlying driveItem. Deprecated -- use driveItem instead. x-ms-navigationProperty: true site: anyOf: - $ref: '#/components/schemas/microsoft.graph.site' - type: object nullable: true description: Used to access the underlying site x-ms-navigationProperty: true '@odata.type': type: string default: '#microsoft.graph.sharedDriveItem' x-ms-discriminator-value: '#microsoft.graph.sharedDriveItem' microsoft.graph.user: allOf: - $ref: '#/components/schemas/microsoft.graph.directoryObject' - title: user required: - '@odata.type' type: object properties: aboutMe: type: string description: >- A freeform text entry field for the user to describe themselves. Returned only on $select. nullable: true accountEnabled: type: boolean description: >- true if the account is enabled; otherwise, false. This property is required when a user is created. Returned only on $select. Supports $filter (eq, ne, not, and in). 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. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. Supports $filter (eq and not). authorizationInfo: anyOf: - $ref: '#/components/schemas/microsoft.graph.authorizationInfo' - type: object 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 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. Returned only on $select. 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). city: type: string description: >- The city where the user is located. Maximum length is 128 characters. Returned only on $select. 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.Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. 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.Returned only on $select. Supports $filter (eq, ne, not, in). nullable: true customSecurityAttributes: anyOf: - $ref: >- #/components/schemas/microsoft.graph.customSecurityAttributeValue - type: object nullable: true description: >- An open complex type that holds the value of a custom security attribute that is assigned to a directory object. Nullable. Returned only on $select. Supports $filter (eq, ne, not, startsWith). The filter value is case-sensitive. To read this property, the calling app must be assigned the CustomSecAttributeAssignment.Read.All permission. To write this property, the calling app must be assigned the CustomSecAttributeAssignment.ReadWrite.All permissions. To read or write this property in delegated scenarios, the admin must be assigned the Attribute Assignment Administrator role. department: type: string description: >- The name of the department in which the user works. Maximum length is 64 characters. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.employeeOrgData' - type: object nullable: true description: >- Represents organization data (for example, division and costCenter) associated with a user. Returned only on $select. Supports $filter (eq, ne, not , ge, le, in). employeeType: type: string description: >- Captures enterprise worker type. For example, Employee, Contractor, Consultant, or Vendor. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. Supports $filter (eq, ne, not , in). format: date-time nullable: true faxNumber: type: string description: >- The fax number of the user. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. Supports $filter (eq) with limitations. 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. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.mailboxSettings' - type: object nullable: true 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. Returned only on $select. 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. Returned only on $select. 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. nullable: true mySite: type: string description: The URL for the user's site. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. nullable: true onPremisesExtensionAttributes: anyOf: - $ref: >- #/components/schemas/microsoft.graph.onPremisesExtensionAttributes - type: object nullable: true description: >- Contains extensionAttributes1-15 for the user. These extension attributes are also known as Exchange custom attributes 1-15. Each attribute can store up to 1024 characters. For an onPremisesSyncEnabled user, the source of authority for this set of properties is the on-premises and is read-only. For a cloud-only user (where onPremisesSyncEnabled is false), these properties can be set during the creation or update of a user object. For a cloud-only user previously synced from on-premises Active Directory, these properties are read-only in Microsoft Graph but can be fully managed through the Exchange Admin Center or the Exchange Online V2 module in PowerShell. Returned only on $select. Supports $filter (eq, ne, not, in). 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. Returned only on $select. Supports $filter (eq, ne, not, ge, le, in). 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. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). 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. Returned only on $select. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.passwordProfile' - type: object nullable: true description: >- Specifies the password profile for the user. The profile contains the user's password. This property is required when a user is created. The password in the profile must satisfy minimum requirements as specified by the passwordPolicies property. By default, a strong password is required. Returned only on $select. Supports $filter (eq, ne, not, in, and eq on null values). To update this property: User-PasswordProfile.ReadWrite.All is the least privileged permission to update this property. In delegated scenarios, the User Administrator Microsoft Entra role is the least privileged admin role supported to update this property for nonadmin users. Privileged Authentication Administrator is the least privileged role that's allowed to update this property for all administrators in the tenant. In general, the signed-in user must have a higher privileged administrator role as indicated in Who can reset passwords. In app-only scenarios, the calling app must be assigned a supported permission and at least the User Administrator Microsoft Entra role. pastProjects: type: array items: type: string nullable: true description: >- A list for the user to enumerate their past projects. Returned only on $select. 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. Returned only on $select. 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.Returned only on $select. nullable: true print: anyOf: - $ref: '#/components/schemas/microsoft.graph.userPrint' - type: object nullable: true provisionedPlans: type: array items: $ref: '#/components/schemas/microsoft.graph.provisionedPlan' description: >- The plans that are provisioned for the user. Read-only. Not nullable. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. schools: type: array items: type: string nullable: true description: >- A list for the user to enumerate the schools they attended. Returned only on $select. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.signInActivity' - type: object nullable: true description: >- Get the last signed-in date and request ID of the sign-in for a given user. Read-only.Returned only on $select. Supports $filter (eq, ne, not, ge, le) but not with any other filterable properties. Note: Details for this property require a Microsoft Entra ID P1 or P2 license and the AuditLog.Read.All permission.This property isn't returned for a user who never signed in or last signed in before April 2020. 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. Returned only on $select. format: date-time nullable: true skills: type: array items: type: string nullable: true description: >- A list for the user to enumerate their skills. Returned only on $select. state: type: string description: >- The state or province in the user's address. Maximum length is 128 characters. Returned only on $select. 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. Returned only on $select. 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. Returned only on $select. 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. 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. Returned only on $select. 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 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.authentication' - type: object nullable: true description: The authentication methods that are supported for the user. x-ms-navigationProperty: true calendar: anyOf: - $ref: '#/components/schemas/microsoft.graph.calendar' - type: object nullable: true description: The user's primary calendar. Read-only. x-ms-navigationProperty: true 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.cloudClipboardRoot' - type: object nullable: true x-ms-navigationProperty: true 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: anyOf: - $ref: >- #/components/schemas/microsoft.graph.userDataSecurityAndGovernance - type: object nullable: true description: >- The data security and governance settings for the user. Read-only. Nullable. x-ms-navigationProperty: true 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.drive' - type: object nullable: true description: The user's OneDrive. Read-only. x-ms-navigationProperty: true 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.employeeExperienceUser' - type: object nullable: true x-ms-navigationProperty: true 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.inferenceClassification' - type: object nullable: true description: >- Relevance classification of the user's messages based on explicit designations that override inferred relevance or importance. x-ms-navigationProperty: true insights: anyOf: - $ref: '#/components/schemas/microsoft.graph.itemInsights' - type: object nullable: true description: >- Represents relationships between a user and items such as OneDrive for work or school documents, calculated using advanced analytics and machine learning techniques. Read-only. Nullable. x-ms-navigationProperty: true 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.directoryObject' - type: object nullable: true description: >- The user or contact that is this user's manager. Read-only. Supports $expand. x-ms-navigationProperty: true 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 oauth2PermissionGrants: type: array items: $ref: '#/components/schemas/microsoft.graph.oAuth2PermissionGrant' x-ms-navigationProperty: true onenote: anyOf: - $ref: '#/components/schemas/microsoft.graph.onenote' - type: object nullable: true x-ms-navigationProperty: true 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 outlook: anyOf: - $ref: '#/components/schemas/microsoft.graph.outlookUser' - type: object nullable: true x-ms-navigationProperty: true 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.profilePhoto' - type: object nullable: true description: The user's profile photo. Read-only. x-ms-navigationProperty: true 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.plannerUser' - type: object nullable: true description: >- Entry-point to the Planner resource that might exist for a user. Read-only. x-ms-navigationProperty: true presence: anyOf: - $ref: '#/components/schemas/microsoft.graph.presence' - type: object nullable: true x-ms-navigationProperty: true 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.userSettings' - type: object nullable: true x-ms-navigationProperty: true solutions: anyOf: - $ref: '#/components/schemas/microsoft.graph.userSolutionRoot' - type: object nullable: true description: >- The identifier that relates the user to the working time schedule triggers. Read-Only. Nullable 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.userTeamwork' - type: object nullable: true description: >- A container for Microsoft Teams features available for the user. Read-only. Nullable. x-ms-navigationProperty: true todo: anyOf: - $ref: '#/components/schemas/microsoft.graph.todo' - type: object nullable: true description: Represents the To Do services available to a user. x-ms-navigationProperty: true 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 '@odata.type': type: string default: '#microsoft.graph.user' description: Represents a Microsoft Entra user account. x-ms-discriminator-value: '#microsoft.graph.user' microsoft.graph.driveItem: allOf: - $ref: '#/components/schemas/microsoft.graph.baseItem' - title: driveItem required: - '@odata.type' type: object properties: audio: anyOf: - $ref: '#/components/schemas/microsoft.graph.audio' - type: object nullable: true description: >- Audio metadata, if the item is an audio file. Read-only. Read-only. Only on OneDrive Personal. bundle: anyOf: - $ref: '#/components/schemas/microsoft.graph.bundle' - type: object nullable: true description: Bundle metadata, if the item is a bundle. Read-only. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.deleted' - type: object nullable: true description: Information about the deleted state of the item. Read-only. file: anyOf: - $ref: '#/components/schemas/microsoft.graph.file' - type: object nullable: true description: File metadata, if the item is a file. Read-only. fileSystemInfo: anyOf: - $ref: '#/components/schemas/microsoft.graph.fileSystemInfo' - type: object nullable: true description: File system information on client. Read-write. folder: anyOf: - $ref: '#/components/schemas/microsoft.graph.folder' - type: object nullable: true description: Folder metadata, if the item is a folder. Read-only. image: anyOf: - $ref: '#/components/schemas/microsoft.graph.image' - type: object nullable: true description: Image metadata, if the item is an image. Read-only. location: anyOf: - $ref: '#/components/schemas/microsoft.graph.geoCoordinates' - type: object nullable: true description: Location metadata, if the item has location data. Read-only. malware: anyOf: - $ref: '#/components/schemas/microsoft.graph.malware' - type: object nullable: true description: >- Malware metadata, if the item was detected to contain malware. Read-only. package: anyOf: - $ref: '#/components/schemas/microsoft.graph.package' - type: object nullable: true description: >- If present, indicates that this item is a package instead of a folder or file. Packages are treated like files in some contexts and folders in others. Read-only. pendingOperations: anyOf: - $ref: '#/components/schemas/microsoft.graph.pendingOperations' - type: object nullable: true description: >- If present, indicates that one or more operations that might affect the state of the driveItem are pending completion. Read-only. photo: anyOf: - $ref: '#/components/schemas/microsoft.graph.photo' - type: object nullable: true description: Photo metadata, if the item is a photo. Read-only. publication: anyOf: - $ref: '#/components/schemas/microsoft.graph.publicationFacet' - type: object nullable: true description: >- Provides information about the published or checked-out state of an item, in locations that support such actions. This property isn't returned by default. Read-only. remoteItem: anyOf: - $ref: '#/components/schemas/microsoft.graph.remoteItem' - type: object nullable: true description: >- Remote item data, if the item is shared from a drive other than the one being accessed. Read-only. root: anyOf: - $ref: '#/components/schemas/microsoft.graph.root' - type: object nullable: true description: >- If this property is non-null, it indicates that the driveItem is the top-most driveItem in the drive. searchResult: anyOf: - $ref: '#/components/schemas/microsoft.graph.searchResult' - type: object nullable: true description: Search metadata, if the item is from a search result. Read-only. shared: anyOf: - $ref: '#/components/schemas/microsoft.graph.shared' - type: object nullable: true description: >- Indicates that the item was shared with others and provides information about the shared state of the item. Read-only. sharepointIds: anyOf: - $ref: '#/components/schemas/microsoft.graph.sharepointIds' - type: object nullable: true description: >- Returns identifiers useful for SharePoint REST compatibility. Read-only. size: type: number description: Size of the item in bytes. Read-only. format: int64 nullable: true specialFolder: anyOf: - $ref: '#/components/schemas/microsoft.graph.specialFolder' - type: object nullable: true description: >- If the current item is also available as a special folder, this facet is returned. Read-only. video: anyOf: - $ref: '#/components/schemas/microsoft.graph.video' - type: object nullable: true description: Video metadata, if the item is a video. Read-only. webDavUrl: type: string description: WebDAV compatible URL for the item. nullable: true analytics: anyOf: - $ref: '#/components/schemas/microsoft.graph.itemAnalytics' - type: object nullable: true description: >- Analytics about the view activities that took place on this item. x-ms-navigationProperty: true 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.listItem' - type: object nullable: true description: >- For drives in SharePoint, the associated document library list item. Read-only. Nullable. 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 retentionLabel: anyOf: - $ref: '#/components/schemas/microsoft.graph.itemRetentionLabel' - type: object nullable: true description: >- Information about retention label and settings enforced on the driveItem. Read-write. x-ms-navigationProperty: true 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.workbook' - type: object nullable: true description: >- For files that are Excel spreadsheets, access to the workbook API to work with the spreadsheet's contents. Nullable. x-ms-navigationProperty: true '@odata.type': type: string default: '#microsoft.graph.driveItem' x-ms-discriminator-value: '#microsoft.graph.driveItem' microsoft.graph.list: allOf: - $ref: '#/components/schemas/microsoft.graph.baseItem' - title: list required: - '@odata.type' type: object properties: displayName: type: string description: The displayable title of the list. nullable: true list: anyOf: - $ref: '#/components/schemas/microsoft.graph.listInfo' - type: object nullable: true description: Contains more details about the list. sharepointIds: anyOf: - $ref: '#/components/schemas/microsoft.graph.sharepointIds' - type: object nullable: true description: >- Returns identifiers useful for SharePoint REST compatibility. Read-only. system: anyOf: - $ref: '#/components/schemas/microsoft.graph.systemFacet' - type: object nullable: true description: >- If present, indicates that the list is system-managed. Read-only. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.drive' - type: object nullable: true description: >- Allows access to the list as a drive resource with driveItems. Only present on document libraries. x-ms-navigationProperty: true 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 subscriptions: type: array items: $ref: '#/components/schemas/microsoft.graph.subscription' description: The set of subscriptions on the list. x-ms-navigationProperty: true '@odata.type': type: string default: '#microsoft.graph.list' x-ms-discriminator-value: '#microsoft.graph.list' microsoft.graph.columnDefinition: allOf: - $ref: '#/components/schemas/microsoft.graph.entity' - title: columnDefinition required: - '@odata.type' type: object properties: boolean: anyOf: - $ref: '#/components/schemas/microsoft.graph.booleanColumn' - type: object nullable: true description: This column stores Boolean values. calculated: anyOf: - $ref: '#/components/schemas/microsoft.graph.calculatedColumn' - type: object nullable: true description: This column's data is calculated based on other columns. choice: anyOf: - $ref: '#/components/schemas/microsoft.graph.choiceColumn' - type: object nullable: true description: This column stores data from a list of choices. columnGroup: type: string description: >- For site columns, the name of the group this column belongs to. Helps organize related columns. nullable: true contentApprovalStatus: anyOf: - $ref: >- #/components/schemas/microsoft.graph.contentApprovalStatusColumn - type: object nullable: true description: This column stores content approval status. currency: anyOf: - $ref: '#/components/schemas/microsoft.graph.currencyColumn' - type: object nullable: true description: This column stores currency values. dateTime: anyOf: - $ref: '#/components/schemas/microsoft.graph.dateTimeColumn' - type: object nullable: true description: This column stores DateTime values. defaultValue: anyOf: - $ref: '#/components/schemas/microsoft.graph.defaultColumnValue' - type: object nullable: true description: The default value for this column. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.geolocationColumn' - type: object nullable: true description: This column stores a geolocation. hidden: type: boolean description: Specifies whether the column is displayed in the user interface. nullable: true hyperlinkOrPicture: anyOf: - $ref: >- #/components/schemas/microsoft.graph.hyperlinkOrPictureColumn - type: object nullable: true description: This column stores hyperlink or picture values. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.lookupColumn' - type: object nullable: true description: This column's data is looked up from another source in the site. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.numberColumn' - type: object nullable: true description: This column stores number values. personOrGroup: anyOf: - $ref: '#/components/schemas/microsoft.graph.personOrGroupColumn' - type: object nullable: true description: This column stores Person or Group values. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.contentTypeInfo' - type: object nullable: true description: >- ContentType from which this column is inherited from. Present only in contentTypes columns response. Read-only. term: anyOf: - $ref: '#/components/schemas/microsoft.graph.termColumn' - type: object nullable: true description: This column stores taxonomy terms. text: anyOf: - $ref: '#/components/schemas/microsoft.graph.textColumn' - type: object nullable: true description: This column stores text values. thumbnail: anyOf: - $ref: '#/components/schemas/microsoft.graph.thumbnailColumn' - type: object nullable: true description: This column stores thumbnail values. type: anyOf: - $ref: '#/components/schemas/microsoft.graph.columnTypes' - type: object nullable: true description: For site columns, the type of column. Read-only. validation: anyOf: - $ref: '#/components/schemas/microsoft.graph.columnValidation' - type: object nullable: true description: >- This column stores validation formula and message for the column. sourceColumn: anyOf: - $ref: '#/components/schemas/microsoft.graph.columnDefinition' - type: object nullable: true description: The source column for the content type column. x-ms-navigationProperty: true '@odata.type': type: string x-ms-discriminator-value: '#microsoft.graph.columnDefinition' microsoft.graph.contentType: allOf: - $ref: '#/components/schemas/microsoft.graph.entity' - title: contentType required: - '@odata.type' 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.documentSet' - type: object nullable: true description: Document Set metadata. documentTemplate: anyOf: - $ref: '#/components/schemas/microsoft.graph.documentSetContent' - type: object nullable: true description: >- Document template metadata. To make sure that documents have consistent content across a site and its subsites, you can associate a Word, Excel, or PowerPoint template with a site content type. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.itemReference' - type: object nullable: true description: >- If this content type is inherited from another scope (like a site), provides a reference to the item where the content type is defined. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.contentTypeOrder' - type: object nullable: true description: >- Specifies the order in which the content type appears in the selection UI. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.contentType' - type: object nullable: true description: Parent contentType from which this content type is derived. x-ms-navigationProperty: true 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 '@odata.type': type: string x-ms-discriminator-value: '#microsoft.graph.contentType' microsoft.graph.columnLink: allOf: - $ref: '#/components/schemas/microsoft.graph.entity' - title: columnLink required: - '@odata.type' type: object properties: name: type: string description: The name of the column in this content type. nullable: true '@odata.type': type: string x-ms-discriminator-value: '#microsoft.graph.columnLink' microsoft.graph.itemReference: title: itemReference required: - '@odata.type' 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.sharepointIds' - type: object nullable: true description: >- Returns identifiers useful for SharePoint REST compatibility. Read-only. 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 '@odata.type': type: string BaseCollectionPaginationCountResponse: title: Base collection pagination and count responses type: object properties: '@odata.count': type: integer format: int64 nullable: true '@odata.nextLink': type: string nullable: true microsoft.graph.drive: allOf: - $ref: '#/components/schemas/microsoft.graph.baseItem' - title: drive required: - '@odata.type' 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.identitySet' - type: object nullable: true description: Optional. The user account that owns the drive. Read-only. quota: anyOf: - $ref: '#/components/schemas/microsoft.graph.quota' - type: object nullable: true description: >- Optional. Information about the drive's storage space quota. Read-only. sharePointIds: anyOf: - $ref: '#/components/schemas/microsoft.graph.sharepointIds' - type: object nullable: true system: anyOf: - $ref: '#/components/schemas/microsoft.graph.systemFacet' - type: object nullable: true description: >- If present, indicates that it's a system-managed drive. Read-only. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.list' - type: object nullable: true description: >- For drives in SharePoint, the underlying document library list. Read-only. Nullable. x-ms-navigationProperty: true root: anyOf: - $ref: '#/components/schemas/microsoft.graph.driveItem' - type: object nullable: true description: The root folder of the drive. Read-only. x-ms-navigationProperty: true 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 '@odata.type': type: string default: '#microsoft.graph.drive' x-ms-discriminator-value: '#microsoft.graph.drive' microsoft.graph.listItem: allOf: - $ref: '#/components/schemas/microsoft.graph.baseItem' - title: listItem required: - '@odata.type' type: object properties: contentType: anyOf: - $ref: '#/components/schemas/microsoft.graph.contentTypeInfo' - type: object nullable: true description: The content type of this list item sharepointIds: anyOf: - $ref: '#/components/schemas/microsoft.graph.sharepointIds' - type: object nullable: true description: >- Returns identifiers useful for SharePoint REST compatibility. Read-only. analytics: anyOf: - $ref: '#/components/schemas/microsoft.graph.itemAnalytics' - type: object nullable: true description: >- Analytics about the view activities that took place on this item. x-ms-navigationProperty: true 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.driveItem' - type: object nullable: true description: >- For document libraries, the driveItem relationship exposes the listItem as a driveItem x-ms-navigationProperty: true fields: anyOf: - $ref: '#/components/schemas/microsoft.graph.fieldValueSet' - type: object nullable: true description: The values of the columns set on this list item. 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 '@odata.type': type: string default: '#microsoft.graph.listItem' x-ms-discriminator-value: '#microsoft.graph.listItem' microsoft.graph.itemAnalytics: allOf: - $ref: '#/components/schemas/microsoft.graph.entity' - title: itemAnalytics required: - '@odata.type' type: object properties: allTime: anyOf: - $ref: '#/components/schemas/microsoft.graph.itemActivityStat' - type: object nullable: true x-ms-navigationProperty: true itemActivityStats: type: array items: $ref: '#/components/schemas/microsoft.graph.itemActivityStat' x-ms-navigationProperty: true lastSevenDays: anyOf: - $ref: '#/components/schemas/microsoft.graph.itemActivityStat' - type: object nullable: true x-ms-navigationProperty: true '@odata.type': type: string x-ms-discriminator-value: '#microsoft.graph.itemAnalytics' microsoft.graph.documentSetVersion: allOf: - $ref: '#/components/schemas/microsoft.graph.listItemVersion' - title: documentSetVersion required: - '@odata.type' type: object properties: comment: type: string description: Comment about the captured version. nullable: true createdBy: anyOf: - $ref: '#/components/schemas/microsoft.graph.identitySet' - type: object nullable: true description: User who captured the version. 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 '@odata.type': type: string default: '#microsoft.graph.documentSetVersion' x-ms-discriminator-value: '#microsoft.graph.documentSetVersion' microsoft.graph.fieldValueSet: allOf: - $ref: '#/components/schemas/microsoft.graph.entity' - title: fieldValueSet required: - '@odata.type' type: object properties: '@odata.type': type: string x-ms-discriminator-value: '#microsoft.graph.fieldValueSet' microsoft.graph.driveRecipient: title: driveRecipient required: - '@odata.type' 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 '@odata.type': type: string microsoft.graph.permission: allOf: - $ref: '#/components/schemas/microsoft.graph.entity' - title: permission required: - '@odata.type' 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.identitySet' - type: object nullable: true description: >- For user type permissions, the details of the users and applications for this permission. Read-only. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.sharePointIdentitySet' - type: object nullable: true description: >- For user type permissions, the details of the users and applications for this permission. Read-only. 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.itemReference' - type: object nullable: true description: >- Provides a reference to the ancestor of the current permission, if it's inherited from an ancestor. Read-only. invitation: anyOf: - $ref: '#/components/schemas/microsoft.graph.sharingInvitation' - type: object nullable: true description: >- Details of any associated sharing invitation for this permission. Read-only. link: anyOf: - $ref: '#/components/schemas/microsoft.graph.sharingLink' - type: object nullable: true description: >- Provides the link details of the current permission, if it's a link type permission. Read-only. 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 '@odata.type': type: string x-ms-discriminator-value: '#microsoft.graph.permission' microsoft.graph.listItemVersion: allOf: - $ref: '#/components/schemas/microsoft.graph.baseItemVersion' - title: listItemVersion required: - '@odata.type' type: object properties: fields: anyOf: - $ref: '#/components/schemas/microsoft.graph.fieldValueSet' - type: object nullable: true description: >- A collection of the fields and values for this version of the list item. x-ms-navigationProperty: true '@odata.type': type: string default: '#microsoft.graph.listItemVersion' discriminator: propertyName: '@odata.type' mapping: '#microsoft.graph.documentSetVersion': '#/components/schemas/microsoft.graph.documentSetVersion' BaseDeltaFunctionResponse: title: Base delta function response type: object properties: '@odata.nextLink': type: string nullable: true '@odata.deltaLink': type: string nullable: true microsoft.graph.richLongRunningOperation: allOf: - $ref: '#/components/schemas/microsoft.graph.longRunningOperation' - title: richLongRunningOperation required: - '@odata.type' type: object properties: error: anyOf: - $ref: '#/components/schemas/microsoft.graph.publicError' - type: object nullable: true description: Error that caused the operation to fail. 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 '@odata.type': type: string description: The status of a long-running operation. x-ms-discriminator-value: '#microsoft.graph.richLongRunningOperation' microsoft.graph.subscription: allOf: - $ref: '#/components/schemas/microsoft.graph.entity' - title: subscription required: - '@odata.type' 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. '@odata.type': type: string x-ms-discriminator-value: '#microsoft.graph.subscription' microsoft.graph.site: allOf: - $ref: '#/components/schemas/microsoft.graph.baseItem' - title: site required: - '@odata.type' type: object properties: displayName: type: string description: The full title for the site. Read-only. nullable: true error: anyOf: - $ref: '#/components/schemas/microsoft.graph.publicError' - type: object nullable: true isPersonalSite: type: boolean description: Identifies whether the site is personal or not. Read-only. nullable: true root: anyOf: - $ref: '#/components/schemas/microsoft.graph.root' - type: object nullable: true description: >- If present, provides the root site in the site collection. Read-only. sharepointIds: anyOf: - $ref: '#/components/schemas/microsoft.graph.sharepointIds' - type: object nullable: true description: >- Returns identifiers useful for SharePoint REST compatibility. Read-only. siteCollection: anyOf: - $ref: '#/components/schemas/microsoft.graph.siteCollection' - type: object nullable: true description: >- Provides details about the site's site collection. Available only on the root site. Read-only. analytics: anyOf: - $ref: '#/components/schemas/microsoft.graph.itemAnalytics' - type: object nullable: true description: >- Analytics about the view activities that took place on this site. x-ms-navigationProperty: true 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.drive' - type: object nullable: true description: The default drive (document library) for this site. x-ms-navigationProperty: true 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.onenote' - type: object nullable: true description: Calls the OneNote service for notebook related operations. x-ms-navigationProperty: true 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: anyOf: - $ref: '#/components/schemas/microsoft.graph.termStore.store' - type: object nullable: true description: The default termStore under this site. x-ms-navigationProperty: true termStores: type: array items: $ref: '#/components/schemas/microsoft.graph.termStore.store' description: The collection of termStores under this site. x-ms-navigationProperty: true '@odata.type': type: string default: '#microsoft.graph.site' x-ms-discriminator-value: '#microsoft.graph.site' parameters: top: name: $top in: query description: Show only the first n items style: form explode: false schema: minimum: 0 type: integer example: 50 skip: name: $skip in: query description: Skip the first n items style: form explode: false schema: minimum: 0 type: integer search: name: $search in: query description: Search items by search phrases style: form explode: false schema: type: string filter: name: $filter in: query description: Filter items by property values style: form explode: false schema: type: string count: name: $count in: query description: Include count of items style: form explode: false schema: type: boolean examples: {} responses: error: description: error content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.ODataErrors.ODataError' ODataCountResponse: description: The count of the resource content: text/plain: schema: $ref: '#/components/schemas/ODataCountResponse' microsoft.graph.groupCollectionResponse: description: Retrieved collection content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.groupCollectionResponse' StringCollectionResponse: description: Retrieved collection content: application/json: schema: $ref: '#/components/schemas/StringCollectionResponse' microsoft.graph.userCollectionResponse: description: Retrieved collection content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.userCollectionResponse' microsoft.graph.printJobCollectionResponse: description: Retrieved collection content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printJobCollectionResponse' microsoft.graph.printTaskCollectionResponse: description: Retrieved collection content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.printTaskCollectionResponse' microsoft.graph.driveItemCollectionResponse: description: Retrieved collection content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.driveItemCollectionResponse' microsoft.graph.contentTypeCollectionResponse: description: Retrieved collection content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.contentTypeCollectionResponse' microsoft.graph.columnLinkCollectionResponse: description: Retrieved collection content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.columnLinkCollectionResponse' microsoft.graph.listItemCollectionResponse: description: Retrieved collection content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.listItemCollectionResponse' tags: - name: Print.printer - name: print.printerShare - name: shares.driveItem - name: Shares.list - name: shares.listItem - name: Shares.permission - name: shares.sharedDriveItem - name: Shares.site - name: Shares.user