Microsoft Graph Shares is the part of Microsoft Graph that lets apps access a OneDrive or SharePoint item by its sharing link or token, without needing to know the site, drive, or item IDs. Given a share URL, you can resolve it to a sharedDriveItem and then work with the underlying driveItem or listItem: read metadata, navigate folder children, fetch thumbnails, and download content—and, if the link grants edit rights, make changes.
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
descri
# --- truncated at 32 KB (420 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-graph/refs/heads/main/openapi/shares-openapi-original.yml