Updates from: 03/06/2021 04:13:19
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Application Post Onlinemeetings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-post-onlinemeetings.md
Title: "Create onlineMeeting" description: "Create an online meeting on behalf of a user specified in the request body."-+ localization_priority: Priority ms.prod: "cloud-communications" doc_type: apiPageType
v1.0 Ediscovery Reviewsetquery Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-reviewsetquery-update.md
The following is an example of the request.
}--> ```http
-PATCH https://graph.microsoft.com/beta/compliance/ediscovery/cases/2eef613a-ca2d-42f4-89fe-84d5198ddedf/reviewSets('b26888b3-e1f5-47c5-bdf2-33d1b90cb2e8/queries/6b5358b0-2ce2-4369-b9cf-65392fe56807
+PATCH https://graph.microsoft.com/beta/compliance/ediscovery/cases/2eef613a-ca2d-42f4-89fe-84d5198ddedf/reviewSets/b26888b3-e1f5-47c5-bdf2-33d1b90cb2e8/queries/6b5358b0-2ce2-4369-b9cf-65392fe56807
Content-type: application/json {
v1.0 Ediscovery Usersource Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-usersource-get.md
If successful, this method returns a `200 OK` response code and a [microsoft.gra
--> ``` http
-GET https://graph.microsoft.com/beta/compliance/ediscovery/cases4c8f8f70-7785-4bd4-b296-c98376a2c5e1/custodians/2192ca408ea2410eba3bec8ae873be6b/userSources/46384443-4137-3032-3437-363939433735
+GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/4c8f8f70-7785-4bd4-b296-c98376a2c5e1/custodians/2192ca408ea2410eba3bec8ae873be6b/userSources/46384443-4137-3032-3437-363939433735
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-usersource-csharp-snippets.md)]
v1.0 Educationsubmission Recall https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationsubmission-recall.md
- Title: "educationSubmission: recall"
-description: "Indicates that a student wants to take back a submission. This action can only be done by a student. "
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# educationSubmission: recall
-
-Namespace: microsoft.graph
--
-Indicates that a student wants to take back a submission. This action can only be done by a student. It will change the status of the submission from "submitted" back to "working".
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-| Permission type | Permissions (from least to most privileged) |
-| :- | : |
-| Delegated (work or school account) | EduAssignments.ReadWriteBasic, EduAssignments.ReadWrite |
-| Delegated (personal Microsoft account) | Not supported |
-| Application | Not supported. |
-
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-```http
-POST /education/classes/{id}/assignments/{id}/submissions/{id}/recall
-```
-
-## Request headers
-
-| Header | Value |
-| : | : |
-| Authorization | Bearer {token}. Required. |
-
-## Response
-
-If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
-
-## Example
-
-The following example shows how to call this API.
-
-##### Request
-
-The following is an example of the request.
-
-<!-- {
- "blockType": "request",
- "name": "educationsubmission_recall"
-}-->
-
-```http
-POST https://graph.microsoft.com/beta/education/classes/11021/assignments/19002/submissions/850f51b7/recall
-```
-
-##### Response
-
-The following is an example of the response.
-
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.educationAssignment"
-} -->
-
-```http
-HTTP/1.1 204 No Content
-```
-
-<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
-2015-10-25 14:57:30 UTC -->
-<!--
-{
- "type": "#page.annotation",
- "description": "educationSubmission: recall",
- "keywords": "",
- "section": "documentation",
- "tocPath": "",
- "suppressions": []
-}
>--
v1.0 Educationsubmission Release https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationsubmission-release.md
- Title: "educationSubmission: release"
-description: " and indicates that grading is done. This action can only be done by the teacher."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# educationSubmission: release
-
-Namespace: microsoft.graph
--
-This action makes the [educationOutcome](../resources/educationoutcome.md) including any grades or feedback associated with this submission available to the student. This will change the status of the submission from "submitted" to "released" and indicates that grading is done. This action can only be done by the teacher.
-
-## Permissions
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type | Permissions (from least to most privileged) |
-|:--|:|
-|Delegated (work or school account) | EduAssignments.ReadWriteBasic, EduAssignments.ReadWrite |
-|Delegated (personal Microsoft account) | Not supported. |
-|Application | Not supported. |
-
-## HTTP request
-<!-- { "blockType": "ignored" } -->
-```http
-POST /education/classes/{id}/assignments/{id}/submissions/{id}/release
-
-```
-## Request headers
-| Header | Value |
-|:|:--|
-| Authorization | Bearer {token}. Required. |
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this method returns `204 No Content` response code. It does not return anything in the response body.
-
-## Example
-The following example shows how to call this API.
-##### Request
-The following is an example of the request.
-<!-- {
- "blockType": "request",
- "name": "educationsubmission_release"
-}-->
-
-```http
-POST https://graph.microsoft.com/beta/education/classes/11021/assignments/19002/submissions/850f51b7/release
-```
-
-##### Response
-The following is an example of the response.
-
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.educationAssignment"
-} -->
-```http
-HTTP/1.1 204 No Content
-```
-
-<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
-2015-10-25 14:57:30 UTC -->
-<!--
-{
- "type": "#page.annotation",
- "description": "educationSubmission: release",
- "keywords": "",
- "section": "documentation",
- "tocPath": "",
- "suppressions": []
-}
>--
v1.0 Emailauthenticationmethodconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/emailauthenticationmethodconfiguration-get.md
For delegated scenarios the administrator needs one of the following [roles](/az
--> ```http
-GET https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfiguration/email
+GET https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/email
``` ## Request headers
If successful, this method returns a `200 OK` response code and an [emailAuthent
--> ```http
-GET /policies/authenticationMethodsPolicy/email
+GET /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/email
``` ### Response
v1.0 Emailauthenticationmethodconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/emailauthenticationmethodconfiguration-update.md
For delegated scenarios, the administrator needs one of the following [roles](/a
--> ```http
-PATCH /policies/authenticationMethodsPolicy/email
+PATCH /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/email
``` ## Request headers
If successful, this method returns a `204 No Content` response code. It does not
--> ```http
-PATCH https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfiguration/email
+PATCH https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/email
Content-Type: application/json Content-length: 147
v1.0 Get Device Command Status https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/get-device-command-status.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET me/devices/{id}/command/{id}/responsePayload
+GET me/devices/{id}/commands/{id}/responsePayload
``` ### Request headers
v1.0 Identitycontainer Post B2xuserflows https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/identitycontainer-post-b2xuserflows.md
The work or school account needs to belong to one of the following roles:
<!-- { "blockType": "ignored" } --> ```http
-POST /identity/b2xUserFlow
+POST /identity/b2xUserFlows
``` ## Request headers
v1.0 Onlinemeeting Createorget https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/onlinemeeting-createorget.md
Title: "onlineMeeting: createOrGet" description: "Create an online meeting with a custom specified external ID. If the external ID already exists, this API will return the onlineMeeting object with that external ID."-+ localization_priority: Normal ms.prod: "cloud-communications" doc_type: apiPageType
v1.0 Onlinemeeting Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/onlinemeeting-delete.md
Title: "Delete onlineMeeting" description: "Delete an online meeting."-+ localization_priority: Normal ms.prod: "cloud-communications" doc_type: apiPageType
The following example shows the request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
+ "sampleKeys": ["550fae72-d251-43ec-868c-373732c2704f_19:meeting_M2IzYzczNTItYmY3OC00MDlmLWJjMzUtYmFiMjNlOTY4MGEz@thread.skype"],
"name": "delete-call" }--> ```http
v1.0 Onlinemeeting Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/onlinemeeting-get.md
Title: "Get onlineMeeting" description: "Retrieve the properties and relationships of an onlineMeeting object."-+ localization_priority: Normal ms.prod: "cloud-communications" doc_type: apiPageType
If successful, this method returns a `200 OK` response code. The method also inc
# [HTTP](#tab/http) <!-- { "blockType": "request",
+ "sampleKeys": ["123456789"],
"name": "get-onlineMeeting" }--> ```msgraph-interactive
The following example shows a request to download an attendee report.
# [HTTP](#tab/http) <!-- { "blockType": "request",
+ "sampleKeys": ["dc74d9bb-6afe-433d-8eaa-e39d80d3a647", "dc17674c-81d9-4adb-bfb2-8f6a442e4622_19:meeting_ZWE0YzQwMzItYjEyNi00NjJjLWE4MjYtOTUxYjE1NmFjYWIw@thread.v2"],
"name": "get-attendeeReport" }--> ```msgraph-interactive
The following example shows a request to download a recording.
# [HTTP](#tab/http) <!-- { "blockType": "request",
+ "sampleKeys": ["dc74d9bb-6afe-433d-8eaa-e39d80d3a647", "dc17674c-81d9-4adb-bfb2-8f6a442e4622_19:meeting_ZWE0YzQwMzItYjEyNi00NjJjLWE4MjYtOTUxYjE1NmFjYWIw@thread.v2"],
"name": "get-recording" }--> ```msgraph-interactive
v1.0 Onlinemeeting Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/onlinemeeting-update.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Update the **startDateTime**, **endDateTime**, **participants**, and **subject** properties of the specified [onlineMeeting](../resources/onlinemeeting.md).
+Update the properties of the specified [onlineMeeting](../resources/onlinemeeting.md) object.
+
+Please see [Request body](#request-body) section for the list of properties that support updating.
## Permissions
PATCH /users/{userId}/onlineMeetings/{meetingId}
| Content-type | application/json. Required. | ## Request body
-In the request body, supply a JSON representation of the [onlineMeeting](../resources/onlinemeeting.md) object. Only the **startDateTime**, **endDateTime**, **participants**, and **subject** properties can be modified. The **startDateTime** and **endDateTime** must appear in pairs.
+The table below lists the properties that can be updated. In the request body, include only the properties that need updating, with the following exceptions:
+
+- Adjusting the start or end date/time of an online meeting always requires both **startDateTime** and **endDateTime** properties in the request body.
+- Adjusting the **attendees** field of the **participants** property, such as adding or removing an attendee to the meeting, always requires the full list of attendees in the request body.
+
+| Property | Type | Description |
+|-|--||
+| startDateTime | DateTime | The meeting start time in UTC. |
+| endDateTime | DateTime | The meeting end time in UTC. |
+| subject | String | The subject of the online meeting. |
+| participants | [meetingParticipants](../resources/meetingparticipants.md) | The participants associated with the online meeting. This includes the organizer and the attendees. |
+| isEntryExitAnnounced | Boolean | Whether or not to announce when callers join or leave. |
+| lobbyBypassSettings | [lobbyBypassSettings](../resources/lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. |
+| allowedPresenters | onlineMeetingPresenters | Specifies who can be a presenter in a meeting. Possible values are everyone, organization, roleIsPresenter, organizer, and unknownFutureValue. |
## Response If successful, this method returns a `200 OK` response code and an [onlineMeeting](../resources/onlinemeeting.md) object in the response body. ## Examples
-### Request
+### Example 1: Update the startDateTime, endDateTime and subject
+
+#### Request
+
+> **Note:** The meeting ID has been truncated for readability.
-# [HTTP](#tab/http)
<!-- { "blockType": "request",
- "name": "patch_onlinemeeting_request"
+ "sampleKeys": ["MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi"],
+ "name": "update_start_end_subject"
}--> ```http
-PATCH https://graph.microsoft.com/beta/me/onlineMeetings/{id}
+PATCH https://graph.microsoft.com/beta/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
Content-Type: application/json {
Content-Type: application/json
"subject": "Patch Meeting Subject" } ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--
+#### Response
-### Response
-
->**Note:** The response object shown here might be shortened for readability.
+> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "microsoft.graph.channel"
+ "@odata.type": "microsoft.graph.onlineMeeting"
} --> ```http
HTTP/1.1 200 OK
Content-Type: application/json {
- "id":"{id}",
+ "id":"MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi",
"creationDateTime":"2020-07-03T00:23:39.444642Z", "startDateTime":"2020-09-09T21:33:30.8546353Z", "endDateTime":"2020-09-09T22:03:30.8566356Z",
Content-Type: application/json
}, "audioConferencing":{ "conferenceId":"id",
- "tollNumber":"number",
- "tollFreeNumber":null,
+ "tollNumber":"+1-900-555-0100",
+ "tollFreeNumber":"+1-800-555-0100",
"dialinUrl":"url" } } ```
+#### Example 2: Update the lobbyBypassSettings
+> **Note:** The meeting ID has been truncated for readability.
+
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi"],
+ "name": "update_lobbyBypassSettings"
+}-->
+```http
+PATCH https://graph.microsoft.com/beta/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
+Content-Type: application/json
+
+{
+ "lobbyBypassSettings": {
+ "isDialInBypassEnabled": true
+ }
+}
+```
+
+#### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.onlineMeeting"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "id": "MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi",
+ "creationDateTime":"2020-07-03T00:23:39.444642Z",
+ "startDateTime":"2020-09-09T21:33:30.8546353Z",
+ "endDateTime":"2020-09-09T22:03:30.8566356Z",
+ "joinWebUrl":"(redacted)",
+ "subject":"Patch Meeting Subject",
+ "autoAdmittedUsers": "EveryoneInCompany",
+ "isEntryExitAnnounced": true,
+ "allowedPresenters": "everyone",
+ "videoTeleconferenceId": "(redacted)",
+ "participants": {
+ "organizer": {
+ "upn": "(redacted)",
+ "role": "presenter",
+ "identity": {
+ "user": {
+ "id": "dc17674c-81d9-4adb-bfb2-8f6a442e4622",
+ "displayName": null,
+ "tenantId": "909c6581-5130-43e9-88f3-fcb3582cde38",
+ "identityProvider": "AAD"
+ }
+ }
+ },
+ "attendees": [],
+ },
+ "lobbyBypassSettings": {
+ "scope": "organization",
+ "isDialInBypassEnabled": true
+ }
+}
+```
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2020-7-16 14:57:30 UTC --> <!--
v1.0 Printjob Abort https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/printjob-abort.md
In addition to the following permissions, the app's tenant must have an active U
|:|:--| |Delegated (work or school account)| Not Supported | |Delegated (personal Microsoft account)|Not Supported.|
-|Application| PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.AllΓÇ»|
+|Application| PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.All, PrintJob.Manage.AllΓÇ»|
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Printjob Update Configuration https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/printjob-update-configuration.md
- Title: Update printJob configuration
-description: Update the configuration of a print job
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Update printJob configuration
-
-Namespace: microsoft.graph
--
-Update the [configuration](../resources/printjobconfiguration.md) property of a [print job](../resources/printjob.md).
-
-Updating a print job configuration will only succeed if there is a [printTask](../resources/printTask.md) in `processing` state on the associated print job, started by a trigger that requesting app created. For details about how to register a task trigger, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
-
-## Permissions
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, either the Printer.Read.All or Printer.ReadWrite.All application permission, and one of the permissions listed in the following table.
-
-|Permission type | Permissions (from least to most privileged) |
-|:|:--|
-|Delegated (work or school account)| Not supported. |
-|Delegated (personal Microsoft account)|Not Supported.|
-|Application| PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.AllΓÇ»|
-
-## HTTP request
-<!-- { "blockType": "ignored" } -->
-```http
-PATCH /print/printers/{id}/jobs/{id}/configuration
-```
-## Request headers
-| Name | Description |
-|:--|:--|
-| Authorization | Bearer {token}. Required. |
-
-## Request body
-In the request body, supply the values of the relevant [printJobConfiguration](../resources/printjobconfiguration.md) fields. Existing properties that are not included in the request body will maintain their previous values.
-
-## Response
-If successful, this method returns a `204 No Content` response code.
-
-## Example
-The following example shows how to call this API.
-### Request
-The following is an example of the request.
--
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "printjob-update-configuration"
-}-->
-```http
-PATCH https://graph.microsoft.com/beta/print/printers/d5ef6ec4-07ca-4212-baf9-d45be126bfbb/jobs/44353/configuration
-
-{
- "feedOrientation": "longEdgeFirst",
- "pageRanges": [
- {
- "start": 1,
- "end": 1
- }
- ],
- "quality": "medium",
- "dpi": 600,
- "orientation": "landscape",
- "copies": 1,
- "duplexMode": "oneSided",
- "colorMode": "blackAndWhite",
- "inputBin": "by-pass-tray",
- "outputBin": "output-tray",
- "mediaSize": "A4",
- "margin": {
- "top": 0,
- "bottom": 0,
- "left": 0,
- "right": 0
- },
- "mediaType": "stationery",
- "finishings": null,
- "pagesPerSheet": 1,
- "multipageLayout": "clockwiseFromBottomLeft",
- "collate": false,
- "scaling": "shrinkToFit",
- "fitPdfToPage": false
-}
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
-------
-### Response
-The following is an example of the response.
-<!-- {
- "blockType": "response",
- "truncated": true
-} -->
-```http
-HTTP/1.1 204 No Content
-```
-
-<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
-2015-10-25 14:57:30 UTC -->
-<!-- {
- "type": "#page.annotation",
- "description": "Update print job configuration",
- "keywords": "",
- "section": "documentation",
- "tocPath": ""
-}-->
--
v1.0 Printjob Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/printjob-update.md
+
+ Title: Update printJob
+description: Update the configuration of a print job.
+
+localization_priority: Normal
++
+# Update printJob
+
+Namespace: microsoft.graph
++
+Update a [print job](../resources/printjob.md). Only the **configuration** property can be updated.
+
+Updating a print job will only succeed if a [printTask](../resources/printTask.md) in a `processing` state, started by a trigger that the requesting app created, is associated with the print job. For details about how to register a task trigger, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, either the Printer.Read.All or Printer.ReadWrite.All application permission, and one of the permissions listed in the following table.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Not supported. |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.All, PrintJob.Manage.AllΓÇ»|
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+PATCH /print/printers/{id}/jobs/{id}
+```
+## Request headers
+| Name | Description |
+|:--|:--|
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+In the request body, supply the values of the relevant [printJob](../resources/printjob.md) fields. Existing properties that are not included in the request body will maintain their previous values.
+Only the "configuration" property can be updated.
+
+## Response
+If successful, this method returns a `200 OK` response code with an updated [printJob](../resources/printjob.md) object in the response body.
+
+## Example
+The following example shows how to call this API.
+### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "printjob-update"
+}-->
+```http
+PATCH https://graph.microsoft.com/beta/print/printers/d5ef6ec4-07ca-4212-baf9-d45be126bfbb/jobs/44353
+
+{
+ "configuration": {
+ "feedOrientation": "longEdgeFirst",
+ "pageRanges": [
+ {
+ "start": 1,
+ "end": 1
+ }
+ ],
+ "quality": "medium",
+ "dpi": 600,
+ "orientation": "landscape",
+ "copies": 1,
+ "duplexMode": "oneSided",
+ "colorMode": "blackAndWhite",
+ "inputBin": "by-pass-tray",
+ "outputBin": "output-tray",
+ "mediaSize": "A4",
+ "margin": {
+ "top": 0,
+ "bottom": 0,
+ "left": 0,
+ "right": 0
+ },
+ "mediaType": "stationery",
+ "finishings": null,
+ "pagesPerSheet": 1,
+ "multipageLayout": "clockwiseFromBottomLeft",
+ "collate": false,
+ "scaling": "shrinkToFit",
+ "fitPdfToPage": false
+ }
+}
+```
+
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printJob"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+Content-length: 225
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#print/printers('d5ef6ec4-07ca-4212-baf9-d45be126bfbb')/jobs/$entity",
+ "id": "44353",
+ "createdDateTime": "2020-06-26T04:20:06.5715544Z",
+ "createdBy": {
+ "id": "",
+ "displayName": "",
+ "userPrincipalName": ""
+ },
+ "status": {
+ "state": "paused",
+ "description": "The job is not a candidate for processing yet."
+ },
+ "configuration": {
+ "feedOrientation": "longEdgeFirst",
+ "pageRanges": [
+ {
+ "start": 1,
+ "end": 1
+ }
+ ],
+ "quality": "medium",
+ "dpi": 600,
+ "orientation": "landscape",
+ "copies": 1,
+ "duplexMode": "oneSided",
+ "colorMode": "blackAndWhite",
+ "inputBin": "by-pass-tray",
+ "outputBin": "output-tray",
+ "mediaSize": "A4",
+ "margin": {
+ "top": 0,
+ "bottom": 0,
+ "left": 0,
+ "right": 0
+ },
+ "mediaType": "stationery",
+ "finishings": null,
+ "pagesPerSheet": 1,
+ "multipageLayout": "clockwiseFromBottomLeft",
+ "collate": false,
+ "scaling": "shrinkToFit",
+ "fitPdfToPage": false
+ }
+}
+```
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2015-10-25 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "Update print job",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
++
v1.0 Printusagesummarybyprinter Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/printusagesummarybyprinter-get.md
To use the Universal Print service, the user or app's tenant must have an active
<!-- { "blockType": "ignored" } --> ```http GET /reports/dailyPrintUsageSummariesByPrinter/{id}
-GET /reports/monhtlyPrintUsageSummariesByPrinter/{id}
+GET /reports/monthlyPrintUsageSummariesByPrinter/{id}
GET /print/reports/dailyPrintUsageSummariesByPrinter/{id} GET /print/reports/monthlyPrintUsageSummariesByPrinter/{id} ```
v1.0 Profilephoto Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/profilephoto-update.md
To update the photo for a team:
<!-- { "blockType": "ignored" } --> ```http
-PUT /groups/{teamId}/photo/$value`
+PUT /groups/{teamId}/photo/$value
``` ## Request headers
v1.0 Shiftpreferences Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/shiftpreferences-get.md
The following is an example of the request.
"name": "shift-get" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/users/871dbd5c-3a6a-4392-bfe1-042452793a50/shiftPreferences
+GET https://graph.microsoft.com/beta/users/871dbd5c-3a6a-4392-bfe1-042452793a50/settings/shiftPreferences
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/shift-get-csharp-snippets.md)]
v1.0 User List Calendars https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list-calendars.md
GET /me/calendars
GET /users/{id | userPrincipalName}/calendars ```
-The user's calendars in the default [calendarGroup](../resources/calendargroup.md).
-```http
-GET /me/calendars
-GET /users/{id | userPrincipalName}/calendars
-```
- The user's calendars in a specific [calendarGroup](../resources/calendargroup.md). ```http GET /me/calendarGroups/{calendar_group_id}/calendars
v1.0 Userteamwork Sendactivitynotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/userteamwork-sendactivitynotification.md
Content-Type: application/json
} ] }- ``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/userteamwork-sendactivitynotification-csharp-snippets.md)]
v1.0 Audioconferencing https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/audioconferencing.md
Represents phone access information for an [onlineMeeting](onlinemeeting.md).
| Property | Type | Description | |:--|:--|:-| | dialinUrl | String | A URL to the externally-accessible web page that contains dial-in information. |
-| ConferenceId | String | The conference id of the online meeting. |
+| conferenceId | String | The conference id of the online meeting. |
| tollFreeNumber | String | The toll-free number that connects to the Audio Conference Provider. | | tollNumber | String | The toll number that connects to the Audio Conference Provider. |
The following is a JSON representation of the resource.
```json { "dialinUrl": "String",
- "ConferenceId": "String",
+ "conferenceId": "String",
"tollFreeNumber": "String", "tollNumber": "String" }
v1.0 B2xidentityuserflow https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/b2xidentityuserflow.md
Title: "b2xIdentityUserFlow resource type"
-description: "Represents a user flow within an Azure Active Directory tenant."
+description: "Represents a self-service sign up user flow within an Azure Active Directory tenant."
localization_priority: Priority doc_type: resourcePageType ms.prod: "identity-and-sign-in"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents a user flow within an Azure Active Directory tenant.
+Represents a self-service sign up user flow within an Azure Active Directory tenant.
User flows are used to enable a [self-service sign up](/azure/active-directory/external-identities/self-service-sign-up-overview) experience for guest users on an application. User flows define the experience the end user sees while signing up, including which [identity providers](/azure/active-directory/external-identities/identity-providers) they can use to authenticate, along with which attributes are collected as part of the sign up process.
User flows are used to enable a [self-service sign up](/azure/active-directory/e
| Method | Return Type |Description| |:|:--|:-|
-|[List user flows](../api/identitycontainer-list-b2xuserflows.md)|b2xIdentityUserFlow collection|Retrieve all B2X user flows.|
-|[Get user flow](../api/b2xidentityuserflow-get.md)|b2xIdentityUserFlow|Retrieve properties of a B2X user flow.|
-|[Create user flow](../api/identitycontainer-post-b2xuserflows.md)|b2xIdentityUserFlow|Create a new B2X user flow.|
-|[Delete user flow](../api/b2xidentityuserflow-delete.md)|None|Delete a B2X user flow.|
-|[List identity providers](../api/b2xidentityuserflow-list-identityproviders.md)|[identityProvider](../resources/identityProvider.md) collection|Retrieve all identity providers in a B2X user flow.|
-|[Add identity provider](../api/b2xidentityuserflow-post-identityproviders.md)|None|Add an identity provider to a B2X user flow.|
-|[Remove identity provider](../api/b2xidentityuserflow-delete-identityproviders.md)|None|Remove an identity provider from a B2X user flow.|
-|[List user attribute assignments](../api/b2xidentityuserflow-list-userattributeassignments.md)|[identityUserFlowAttributeAssignment](../resources/identityuserflowattributeassignment.md) collection|Retrieve all user attribute assignments in a B2X user flow.|
-|[Create user attribute assignment](../api/b2xidentityuserflow-post-userattributeassignments.md)|[identityUserFlowAttributeAssignment](../resources/identityuserflowattributeassignment.md)|Create a user attribute assignment in a B2X user flow.|
-|[List languages](../api/b2xidentityuserflow-list-languages.md)|[userFlowLanguageConfiguration](../resources/userflowlanguageconfiguration.md) collection|Retrieve all languages within a B2X user flow.|
-|[Get API connectors configuration for user flow](../api/b2xidentityuserflow-get-apiConnectorConfiguration.md)|[userFlowApiConnectorConfiguration](../resources/userflowapiconnectorconfiguration.md)| Get the configuration for API connectors used in the user flow. The $expand query parameter is not supported for this method.|
-|[Configure an API connector in a user flow](../api/b2xidentityuserflow-put-apiConnectorConfiguration.md)|None| Configure an API connector for specific steps in a user flow by updating the [apiConnectorConfiguration](../resources/userflowapiconnectorconfiguration.md) property.|
+|[List user flows](../api/identitycontainer-list-b2xuserflows.md)|b2xIdentityUserFlow collection|Retrieve all self-service sign up user flows.|
+|[Get user flow](../api/b2xidentityuserflow-get.md)|b2xIdentityUserFlow|Retrieve properties of a self-service sign up user flow.|
+|[Create user flow](../api/identitycontainer-post-b2xuserflows.md)|b2xIdentityUserFlow|Create a new self-service sign up user flow.|
+|[Delete user flow](../api/b2xidentityuserflow-delete.md)|None|Delete a self-service sign up user flow.|
+|[List identity providers](../api/b2xidentityuserflow-list-identityproviders.md)|[identityProvider](../resources/identityProvider.md) collection|Retrieve all identity providers in a self-service sign up user flow.|
+|[Add identity provider](../api/b2xidentityuserflow-post-identityproviders.md)|None|Add an identity provider to a self-service sign up user flow.|
+|[Remove identity provider](../api/b2xidentityuserflow-delete-identityproviders.md)|None|Remove an identity provider from a self-service sign up user flow.|
+|[List user attribute assignments](../api/b2xidentityuserflow-list-userattributeassignments.md)|[identityUserFlowAttributeAssignment](../resources/identityuserflowattributeassignment.md) collection|Retrieve all user attribute assignments in a self-service sign up user flow.|
+|[Create user attribute assignment](../api/b2xidentityuserflow-post-userattributeassignments.md)|[identityUserFlowAttributeAssignment](../resources/identityuserflowattributeassignment.md)|Create a user attribute assignment in a self-service sign up user flow.|
+|[List languages](../api/b2xidentityuserflow-list-languages.md)|[userFlowLanguageConfiguration](../resources/userflowlanguageconfiguration.md) collection|Retrieve all languages within a self-service sign up user flow.|
+|[Get API connectors configuration for user flow](../api/b2xidentityuserflow-get-apiConnectorConfiguration.md)|[userFlowApiConnectorConfiguration](../resources/userflowapiconnectorconfiguration.md)| Get the configuration for API connectors used in the self-service sign up user flow. The $expand query parameter is not supported for this method.|
+|[Configure an API connector in a user flow](../api/b2xidentityuserflow-put-apiConnectorConfiguration.md)|None| Configure an API connector for specific steps in a self-service sign up user flow by updating the [apiConnectorConfiguration](../resources/userflowapiconnectorconfiguration.md) property.|
## Properties
User flows are used to enable a [self-service sign up](/azure/active-directory/e
|:|:--|:-| |id|String|The name of the user flow. This is a required value and is immutable after it's created. The name will be prefixed with the value of `B2X_1_` after creation.| |userFlowType|userFlowType|The type of user flow. For self-service sign up user flows, the value can only be `signUpOrSignIn` and cannot be modified after creation.|
-|userFlowTypeVersion|Single|The version of the user flow. For B2X user flows, the version is always `1`.|
-|apiConnectorConfiguration|[userFlowApiConnectorConfiguration](../resources/userflowapiconnectorconfiguration.md)|Configuration for enabling an API connector for use as part of the user flow. You can only obtain the value of this object using [Get userFlowApiConnectorConfiguration](../api/b2xidentityuserflow-get-apiConnectorConfiguration.md).|
+|userFlowTypeVersion|Single|The version of the user flow. For self-service sign up user flows, the version is always `1`.|
+|apiConnectorConfiguration|[userFlowApiConnectorConfiguration](../resources/userflowapiconnectorconfiguration.md)|Configuration for enabling an API connector for use as part of the self-service sign up user flow. You can only obtain the value of this object using [Get userFlowApiConnectorConfiguration](../api/b2xidentityuserflow-get-apiConnectorConfiguration.md).|
## Relationships
User flows are used to enable a [self-service sign up](/azure/active-directory/e
|:|:--|:-| |identityProviders|[identityProvider](../resources/identityprovider.md) collection|The identity providers included in the user flow.| |userAttributeAssignments|[identityUserFlowAttributeAssignment](../resources/identityuserflowattributeassignment.md) collection|The user attribute assignments included in the user flow.|
-|languages|[userFlowLanguageConfiguration](../resources/userflowlanguageconfiguration.md) collection|The languages supported for customization within the user flow. Language customization is enabled by default in B2X user flow. You cannot create custom languages in B2X user flows.|
+|languages|[userFlowLanguageConfiguration](../resources/userflowlanguageconfiguration.md) collection|The languages supported for customization within the user flow. Language customization is enabled by default in self-service sign up user flow. You cannot create custom languages in self-service sign up user flows.|
## JSON representation
v1.0 Onlinemeeting https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/onlinemeeting.md
Contains information about a meeting, including the URL used to join a meeting,
| :-- | :-- | :- | | [Create](../api/application-post-onlineMeetings.md) | [onlineMeeting](onlinemeeting.md) | Create an online meeting. | | [Get](../api/onlinemeeting-get.md) | [onlineMeeting](onlinemeeting.md) | Read the properties and relationships of an **onlineMeeting** object. |
+| [Update](../api/onlinemeeting-update.md) | [onlineMeeting](onlinemeeting.md) | Update the properties of an **onlineMeeting** object. |
+| [Delete](../api/onlinemeeting-delete.md) | None | Delete an **onlineMeeting** object. |
| [Create or get onlineMeeting](../api/onlinemeeting-createorget.md) | [onlineMeeting](onlinemeeting.md) | Create an online meeting with a custom, external ID. If the meeting already exists, retrieve its properties. |
-| [Update](../api/onlinemeeting-update.md) | [onlineMeeting](onlinemeeting.md) | Update the **startDateTime**, **endDateTime**, **subject**, and **participants** properties of an online meeting. |
-| [Delete](../api/onlinemeeting-delete.md) | None | Delete an **onlineMeeting** resource. |
## Properties | Property | Type | Description | | :-- | :-- | :- |
+| allowedPresenters | onlineMeetingPresenters | Specifies who can be a presenter in a meeting. Possible values are `everyone`, `organization`, `roleIsPresenter`, `organizer`, and `unknownFutureValue`. |
+| alternativeRecording | Stream | The content stream of the alternative recording of a live event. Read-only. |
+| attendeeReport | Stream | The content stream of the attendee report of a live event. Read-only. |
| autoAdmittedUsers | String | The setting that specifies the type of participants that will automatically be allowed into the online meeting. Possible values are: `everyone`, `everyoneInSameAndFederatedCompany`, `everyoneInCompany`, `invitedUsersInCompany`, `organizer`. Read-only. | | audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for an online meeting. Read-only. |
+| broadcastSettings | [broadcastMeetingSettings](broadcastMeetingSettings.md) | Settings related to a live event* |
| chatInfo | [chatInfo](chatinfo.md) | The chat information associated with this online meeting. | | creationDateTime | DateTime | The meeting creation time in UTC. Read-only. |
-| startDateTime | DateTime | The meeting start time in UTC. |
+| capabilities | String collection | The list of meeting capabilities. Possible values are: `questionAndAnswer`. |
| endDateTime | DateTime | The meeting end time in UTC. |
+| externalId | String | The external ID. A custom ID. Optional. |
| id | String | The default ID associated with the online meeting. Read-only. |
+| isBroadcast | Boolean | Indicates if this is a live event. |
+| isEntryExitAnnounced | Boolean | Whether or not to announce when callers join or leave. |
| joinWebUrl | String | The join URL of the online meeting. Read-only. |
-| participants | [meetingParticipants](meetingparticipants.md) | The participants associated with the online meeting. This includes the organizer and the attendees. |
-| subject | String | The subject of the online meeting. |
-| capabilities | String collection | The list of meeting capabilities. Possible values are: `questionAndAnswer`. |
-| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. |
| joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in 'Accept-Language' request HTTP header. Read-only |
-| externalId | String | The external ID. A custom ID. Optional. |
-| isEntryExitAnnounced | Boolean | Whether or not to announce when callers join or leave. |
| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. |
-| allowedPresenters | onlineMeetingPresenters | Specifies who can be a presenter in a meeting. Possible values are `everyone`, `organization`, `roleIsPresenter`, `organizer`, and `unknownFutureValue`. |
-| isBroadcast | Boolean | Indicates if this is a live event. |
-| broadcastSettings | [broadcastMeetingSettings](broadcastMeetingSettings.md) | Settings related to a live event* |
-| attendeeReport | Stream | The content stream of the attendee report of a live event. Read-only. |
+| participants | [meetingParticipants](meetingparticipants.md) | The participants associated with the online meeting. This includes the organizer and the attendees. |
| recording | Stream | The content stream of the recording of a live event. Read-only. |
-| alternativeRecording | Stream | The content stream of the alternative recording of a live event. Read-only. |
+| startDateTime | DateTime | The meeting start time in UTC. |
+| subject | String | The subject of the online meeting. |
+| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. |
> [!IMPORTANT] > The **autoAdmittedUsers** property is obsolete. Use **lobbyBypassSettings.scope** instead for meeting option configurations.
Contains information about a meeting, including the URL used to join a meeting,
}--> ```json {
- "audioConferencing": {"@odata.type": "#microsoft.graph.audioConferencing"},
- "chatInfo": {"@odata.type": "#microsoft.graph.chatInfo"},
+ "audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"},
+ "chatInfo": {"@odata.type": "microsoft.graph.chatInfo"},
"creationDateTime": "String (timestamp)", "endDateTime": "String (timestamp)", "id": "String (identifier)", "joinWebUrl": "String",
- "participants": {"@odata.type": "#microsoft.graph.meetingParticipants"},
+ "participants": {"@odata.type": "microsoft.graph.meetingParticipants"},
"startDateTime": "String (timestamp)", "subject": "String", "capabilities": [ "questionAndAnswer" ], "videoTeleconferenceId": "String", "isEntryExitAnnounced": "Boolean",
- "lobbyBypassSettings": {"@odata.type": "#microsoft.graph.lobbyBypassSettings"},
+ "lobbyBypassSettings": {"@odata.type": "microsoft.graph.lobbyBypassSettings"},
"allowedPresenters": "String", "isBroadcast": "Boolean",
- "broadcastSettings": {"@odata.type": "#microsoft.graph.broadcastSettings"}
+ "broadcastSettings": {"@odata.type": "microsoft.graph.broadcastSettings"}
} ```
v1.0 Presence https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/presence.md
ms.prod: "cloud-communications"
Namespace: microsoft.graph + Contains information about a user's presence, including their availability and user activity. > **Note:** This resource is currently only supported for Microsoft Teams users.
v1.0 Printjob https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/printjob.md
Represents a print job that has been queued for a printer.
|:-|:|:| | [Get](../api/printjob-get.md) | [printJob](printjob.md) | Read properties and relationships of printJob object. | | [Create](../api/printer-post-jobs.md) | [printJob](printjob.md) | Create a new print job object. |
+| [Update](../api/printjob-update.md) | [printJob](printjob.md) | Update a print job object. |
| [Start](../api/printjob-start.md)|None|Start the print job.| | [Cancel](../api/printjob-cancel.md)|None|Cancel the print job.| | [Abort](../api/printjob-abort.md)|None|Abort the print job.|
v1.0 Application Post Onlinemeetings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/application-post-onlinemeetings.md
Title: "Create onlineMeeting" description: "Create an online meeting on behalf of a user specified in the request body."-+ localization_priority: Priority ms.prod: "cloud-communications" doc_type: apiPageType
v1.0 Attachment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/attachment-get.md
GET /groups/{id}/events/{id}/attachments/{id}
GET /groups/{id}/calendar/events/{id}/attachments/{id} -->
-Attachments for an [event](../resources/event.md) in a [calendar](../resources/calendar.md) belonging to the user's default [calendarGroup](../resources/calendargroup.md).
-<!-- { "blockType": "ignored" } -->
-```http
-GET /me/calendars/{id}/events/{id}/attachments/{id}
-GET /users/{id | userPrincipalName}/calendars/{id}/events/{id}/attachments/{id}
-
-GET /me/calendars/{id}/events/{id}/attachments/{id}/$value
-GET /users/{id | userPrincipalName}/calendars/{id}/events/{id}/attachments/{id}/$value
-```
Attachments for an [event](../resources/event.md) in a [calendar](../resources/calendar.md) belonging to a user's [calendarGroup](../resources/calendargroup.md). <!-- { "blockType": "ignored" } --> ```http
v1.0 Channel Get Message https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/channel-get-message.md
One of the following permissions is required to call this API. To learn more, in
||-| |Delegated (work or school account)| ChannelMessage.Read.All | |Delegated (personal Microsoft account)|Not supported.|
-|Application| ChannelMessage.Read.Group* |
+|Application| ChannelMessage.Read.Group*, ChannelMessage.Read.All |
> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc).
v1.0 Channel Get Messagereply https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/channel-get-messagereply.md
One of the following permissions is required to call this API. To learn more, in
||-| |Delegated (work or school account)| ChannelMessage.Read.All | |Delegated (personal Microsoft account)|Not supported.|
-|Application| ChannelMessage.Read.Group* |
+|Application| ChannelMessage.Read.Group*, ChannelMessage.Read.All |
> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc).
v1.0 Channel List Messagereplies https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/channel-list-messagereplies.md
One of the following permissions is required to call this API. To learn more, in
||-| |Delegated (work or school account)| ChannelMessage.Read.All | |Delegated (personal Microsoft account)|Not supported.|
-|Application| ChannelMessage.Read.Group* |
+|Application| ChannelMessage.Read.Group*, ChannelMessage.Read.All |
> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc).
v1.0 Channel List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/channel-list-messages.md
One of the following permissions is required to call this API. To learn more, in
||-| |Delegated (work or school account)| ChannelMessage.Read.All | |Delegated (personal Microsoft account)|Not supported.|
-|Application| ChannelMessage.Read.Group* |
+|Application| ChannelMessage.Read.Group*, ChannelMessage.Read.All |
> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc).
v1.0 Chatmessage Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/chatmessage-delta.md
One of the following permissions is required to call this API. To learn more, in
||| |Delegated (work or school account)| ChannelMessage.Read.All | |Delegated (personal Microsoft account)|Not supported.|
-|Application| Not supported. |
+|Application| ChannelMessage.Read.Group*, ChannelMessage.Read.All |
> **Note**: Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc).
v1.0 Chatmessage Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/chatmessage-update.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http PATCH /teams/(team-id)/channels/{channel-id}/messages/{message-id}
-PATCH /chats/{chatThread-id}/messages/{message-id}
``` ## Request headers
v1.0 Conversationmember Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/conversationmember-get.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http GET /chats/{id}/members/{id}
-GET /users/{id}/chats/{id}/members/{id}
GET /teams/{id}/channels/{id}/members/{id} ```
v1.0 Conversationmember List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/conversationmember-list.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http GET /chats/{id}/members
-GET /users/{id}/chats/{id}/members
``` ## Optional query parameters
The following is an example of the request.
"name": "list_conversation_members" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/me/chats/{id}/members
+GET https://graph.microsoft.com/v1.0/chats/{id}/members
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/list-conversation-members-csharp-snippets.md)]
v1.0 Onlinemeeting Createorget https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/onlinemeeting-createorget.md
Title: "onlineMeeting: createOrGet" description: "Create an online meeting with a custom specified external ID. If the external ID already exists, this API will return the **onlineMeeting** object with that external ID."-+ localization_priority: Normal ms.prod: "cloud-communications" doc_type: apiPageType
v1.0 Onlinemeeting Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/onlinemeeting-delete.md
Title: "Delete onlineMeeting" description: "Delete an online meeting."-+ localization_priority: Normal ms.prod: "cloud-communications" doc_type: apiPageType
The following example shows the request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
+ "sampleKeys": ["550fae72-d251-43ec-868c-373732c2704f_19:meeting_M2IzYzczNTItYmY3OC00MDlmLWJjMzUtYmFiMjNlOTY4MGEz@thread.skype"],
"name": "delete-call" }--> ```http
v1.0 Onlinemeeting Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/onlinemeeting-get.md
Title: "Get onlineMeeting" description: "Retrieve the properties and relationships of an online meeting object."-+ localization_priority: Normal ms.prod: "cloud-communications" doc_type: apiPageType
The following example shows the request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
+ "sampleKeys": ["123456789"],
"name": "get-onlineMeeting" }--> ```msgraph-interactive
v1.0 Onlinemeeting Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/onlinemeeting-update.md
+
+ Title: "Update onlineMeeting"
+description: "Update the properties of an online meeting."
+
+localization_priority: Normal
++
+# Update onlineMeeting
+
+Namespace: microsoft.graph
+
+Update the properties of the specified [onlineMeeting](../resources/onlinemeeting.md) object.
+
+Please see [Request body](#request-body) section for the list of properties that support updating.
+
+## Permissions
+
+| Permission type | Permissions (from least to most privileged) |
+| :- | : |
+| Delegated (work or school account) | OnlineMeetings.ReadWrite |
+| Delegated (personal Microsoft account) | Not Supported. |
+| Application | OnlineMeetings.ReadWrite.All* |
+
+> [!IMPORTANT]
+> \* Administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and grant it to a user, authorizing the app configured in the policy to update an online meeting on behalf of that user (user ID specified in the request path).
+
+## HTTP request
+To update the specified onlineMeeting by meeting ID with delegated token:
+<!-- { "blockType": "ignored" } -->
+```http
+PATCH /me/onlineMeetings/{meetingId}
+```
+
+To update the specified onlineMeeting by meeting ID with application token:
+<!-- { "blockType": "ignored" } -->
+```http
+PATCH /users/{userId}/onlineMeetings/{meetingId}
+```
+
+> **Notes:**
+> - `userId` is the object ID of a user in [Azure user management portal](https://portal.azure.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [application access policy](/graph/cloud-communication-online-meeting-application-access-policy).
+> - `meetingId` is the **id** of an [onlineMeeting](../resources/onlinemeeting.md) object.
+
+## Request headers
+| Name | Description |
+| : | :-- |
+| Authorization | Bearer {token}. Required. |
+| Content-type | application/json. Required. |
+
+## Request body
+The table below lists the properties that can be updated. In the request body, include only the properties that need updating, with the following exceptions:
+
+- Adjusting the start or end date/time of an online meeting always requires both **startDateTime** and **endDateTime** properties in the request body.
+- Adjusting the **attendees** field of the **participants** property, such as adding or removing an attendee to the meeting, always requires the full list of attendees in the request body.
+
+| Property | Type | Description |
+|-|--||
+| startDateTime | DateTime | The meeting start time in UTC. |
+| endDateTime | DateTime | The meeting end time in UTC. |
+| subject | String | The subject of the online meeting. |
+| participants | [meetingParticipants](../resources/meetingparticipants.md) | The participants associated with the online meeting. This includes the organizer and the attendees. |
+| isEntryExitAnnounced | Boolean | Whether or not to announce when callers join or leave. |
+| lobbyBypassSettings | [lobbyBypassSettings](../resources/lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. |
+| allowedPresenters | onlineMeetingPresenters | Specifies who can be a presenter in a meeting. Possible values are everyone, organization, roleIsPresenter, organizer, and unknownFutureValue. |
+
+## Response
+If successful, this method returns a `200 OK` response code and an [onlineMeeting](../resources/onlinemeeting.md) object in the response body.
+
+## Examples
+
+### Example 1: Update the startDateTime, endDateTime and subject
+
+#### Request
+
+> **Note:** The meeting ID has been truncated for readability.
+
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi"],
+ "name": "update_start_end_subject"
+}-->
+```http
+PATCH https://graph.microsoft.com/v1.0/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
+Content-Type: application/json
+
+{
+ "startDateTime": "2020-09-09T14:33:30.8546353-07:00",
+ "endDateTime": "2020-09-09T15:03:30.8566356-07:00",
+ "subject": "Patch Meeting Subject"
+}
+```
+
+#### Response
+
+> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.onlineMeeting"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "id":"MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi",
+ "creationDateTime":"2020-07-03T00:23:39.444642Z",
+ "startDateTime":"2020-09-09T21:33:30.8546353Z",
+ "endDateTime":"2020-09-09T22:03:30.8566356Z",
+ "joinWebUrl":"url",
+ "subject":"Patch Meeting Subject",
+ "isBroadcast":false,
+ "autoAdmittedUsers":"EveryoneInCompany",
+ "outerMeetingAutoAdmittedUsers":null,
+ "participants":{
+ "organizer":{
+ "upn":"upn",
+ "role": "presenter",
+ "identity":{
+ "azureApplicationInstance":null,
+ "applicationInstance":null,
+ "application":null,
+ "device":null,
+ "user":{
+ "id":"8716745d-77a9-4be3-afff-009e4b81658e",
+ "displayName":null,
+ "tenantId":"0823831b-1f1b-424b-b90a-1caa345a742a",
+ "identityProvider":"AAD"
+ }
+ }
+ }
+ },
+ "audioConferencing":{
+ "conferenceId":"id",
+ "tollNumber":"+1-900-555-0100",
+ "tollFreeNumber":"+1-800-555-0100",
+ "dialinUrl":"url"
+ }
+}
+```
+
+#### Example 2: Update the lobbyBypassSettings
+> **Note:** The meeting ID has been truncated for readability.
+
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi"],
+ "name": "update_lobbyBypassSettings"
+}-->
+```http
+PATCH https://graph.microsoft.com/v1.0/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
+Content-Type: application/json
+
+{
+ "lobbyBypassSettings": {
+ "isDialInBypassEnabled": true
+ }
+}
+```
+
+#### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.onlineMeeting"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "id": "MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi",
+ "creationDateTime":"2020-07-03T00:23:39.444642Z",
+ "startDateTime":"2020-09-09T21:33:30.8546353Z",
+ "endDateTime":"2020-09-09T22:03:30.8566356Z",
+ "joinWebUrl":"(redacted)",
+ "subject":"Patch Meeting Subject",
+ "autoAdmittedUsers": "EveryoneInCompany",
+ "isEntryExitAnnounced": true,
+ "allowedPresenters": "everyone",
+ "videoTeleconferenceId": "(redacted)",
+ "participants": {
+ "organizer": {
+ "upn": "(redacted)",
+ "role": "presenter",
+ "identity": {
+ "user": {
+ "id": "dc17674c-81d9-4adb-bfb2-8f6a442e4622",
+ "displayName": null,
+ "tenantId": "909c6581-5130-43e9-88f3-fcb3582cde38",
+ "identityProvider": "AAD"
+ }
+ }
+ },
+ "attendees": [],
+ },
+ "lobbyBypassSettings": {
+ "scope": "organization",
+ "isDialInBypassEnabled": true
+ }
+}
+```
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2020-7-16 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Patch online meeting",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ ]
+}
+-->
++
v1.0 Print Delete Taskdefinition https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/print-delete-taskdefinition.md
+
+ Title: Delete taskDefinition
+description: Delete a task definition.
+
+localization_priority: Normal
++
+# Delete printTaskDefinition
+Namespace: microsoft.graph
++
+Delete a **taskDefinition**.
+
+For details about how to use this API to add pull printing support to Universal Print, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Not supported. |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| PrintTaskDefinition.ReadWrite.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /print/taskDefinitions/{printTaskDefinitionId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "delete_printtaskdefinition"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/v1.0/print/taskDefinitions/{printTaskDefinitionId}
+```
++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Print Get Settings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/print-get-settings.md
+
+ Title: Get printSettings
+description: Retrieve tenant-wide settings for the Universal Print service.
+
+localization_priority: Normal
++
+# Get printSettings
+
+Namespace: microsoft.graph
++
+Retrieve tenant-wide settings for the Universal Print service.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrintSettings.Read.All, PrintSettings.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/settings
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+| Name |Description|
+|:-|:-|
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and a [printSettings](../resources/printsettings.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_printsettings"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/settings
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printSettings"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/settings",
+ "documentConversionEnabled": true
+}
+```
+
v1.0 Print List Connectors https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/print-list-connectors.md
+
+ Title: List printConnectors
+description: Retrieve a list of connectors.
+
+localization_priority: Normal
++
+# List printConnectors
+Namespace: microsoft.graph
++
+Retrieve a list of print connectors.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrintConnector.Read.All, PrintConnector.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| Not Supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/connectors
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+### Exceptions
+Some operators are not supported: `$count`, `$search`, `$filter`.
+
+## Request headers
+| Name |Description|
+|:-|:-|
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [printConnector](../resources/printconnector.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_printconnector"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/connectors
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.printConnector)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/connectors",
+ "value": [
+ {
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "displayName": "Connector1",
+ "fullyQualifiedDomainName": "connector1@redmond.corp.microsoft.com",
+ "operatingSystem": "Microsoft Windows 10 Enterprise Insider Preview | 10.0.19555",
+ "appVersion": "0.19.7338.23496",
+ "registeredDateTime": "2020-02-04T07:00:00.0000000",
+ "location": {
+ "latitude": 1.1,
+ "longitude": 2.2,
+ "altitudeInMeters": 3,
+ "streetAddress": "One Microsoft Way",
+ "subUnit": [
+ "Main Plaza",
+ "Unit 400"
+ ],
+ "city": "Redmond",
+ "postalCode": "98052",
+ "countryOrRegion": "USA",
+ "site": "Puget Sound",
+ "building": "Studio E",
+ "floor": "1",
+ "floorDescription": "First Floor",
+ "roomName": "1234",
+ "roomDescription": "First floor copy room",
+ "organization": [
+ "C+AI",
+ "Microsoft Graph"
+ ],
+ "subdivision": [
+ "King County",
+ "Red West"
+ ],
+ "stateOrProvince": "Washington"
+ }
+ }
+ ]
+}
+```
+
v1.0 Print List Printers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/print-list-printers.md
+
+ Title: List printers
+description: Retrieve the list of printers that are registered in the tenant.
+
+localization_priority: Normal
++
+# List printers
+Namespace: microsoft.graph
++
+Retrieve the list of **printers** that are registered in the tenant.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Printer.Read.All, Printer.ReadWrite.All, Printer.FullControl.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| Not Supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/printers
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+### Exceptions
+* The `$expand` and `select` operators are supported for the `share` navigation property, but not for `jobs`.
+* Some operators are not supported: `$count`, `$search`.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [printer](../resources/printer.md) objects in the response body.
+
+>**Note**: The response will not contain 'defaults' and 'capabilities' properties. These properties can be queried using [Get Printer](printer-get.md) request.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_printer"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/printers
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.printer)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers",
+ "value": [
+ {
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "displayName": "PrinterName",
+ "manufacturer": "PrinterManufacturer",
+ "model": "PrinterModel",
+ "isShared": true,
+ "registeredDateTime": "2020-02-04T00:00:00.0000000Z",
+ "isAcceptingJobs": true,
+ "status": {
+ "state": "stopped",
+ "details": [
+ "disconnected"
+ ],
+ "description": ""
+ },
+ "defaults": {
+ "copiesPerJob": 1,
+ "finishings": [
+ "none"
+ ],
+ "mediaColor": "Unknown",
+ "mediaType": "stationery",
+ "mediaSize": "North America Letter",
+ "pagesPerSheet": 1,
+ "orientation": "portrait",
+ "outputBin": "auto",
+ "inputBin": "auto",
+ "contentType": "application/oxps",
+ "fitPdfToPage": false,
+ "multipageLayout": null,
+ "colorMode": "color",
+ "quality": "medium",
+ "duplexMode": "oneSided",
+ "dpi": 600,
+ "scaling": null
+ },
+ "location": {
+ "latitude": 1.1,
+ "longitude": 2.2,
+ "altitudeInMeters": 3,
+ "streetAddress": "One Microsoft Way",
+ "subUnit": [
+ "Main Plaza",
+ "Unit 400"
+ ],
+ "city": "Redmond",
+ "postalCode": "98052",
+ "countryOrRegion": "USA",
+ "site": "Puget Sound",
+ "building": "Studio E",
+ "floor": "1",
+ "floorDescription": "First Floor",
+ "roomName": "1234",
+ "roomDescription": "First floor copy room",
+ "organization": [
+ "C+AI",
+ "Microsoft Graph"
+ ],
+ "subdivision": [
+ "King County",
+ "Red West"
+ ],
+ "stateOrProvince": "Washington"
+ }
+ }
+ ]
+}
+```
+
v1.0 Print List Services https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/print-list-services.md
+
+ Title: List printServices
+description: Retrieve a list of printService objects that represent the services available to your tenant.
+
+localization_priority: Normal
++
+# List printServices
+Namespace: microsoft.graph
++
+Retrieve a list of **printService** objects that represent the services available to your tenant.
+
+## Permissions
+One of the **delegated** Universal Print [permissions](/graph/permissions-reference#universal-print-permissions) is required to call this API.
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/services
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [printService](../resources/printservice.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_printservice"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/services
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.printService)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/services",
+ "value": [
+ {
+ "id": "f4cfee8b-4117-4773-a2f0-3807beb282b9",
+ "endpoints": [
+ {
+ "id": "mpsdiscovery",
+ "displayName": "Microsoft Universal Print Discovery Service",
+ "uri": "https://discovery.print.microsoft.com"
+ }
+ ]
+ }
+ ]
+}
+```
+
v1.0 Print List Shares https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/print-list-shares.md
+
+ Title: List shares
+description: Retrieve a list of printer shares.
+
+localization_priority: Normal
++
+# List shares
+Namespace: microsoft.graph
++
+Retrieve a list of **printerShares**.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrinterShare.Read.All, PrinterShare.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/shares
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+To see a list of each printer share's capabilities, include the optional `$select=capabilities` query parameter.
+
+### Exceptions
+Some operators are not supported: `$count`, `$orderby`, `$search`.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [printerShare](../resources/printershare.md) objects in the response body.
+
+>**Note**: The response will not contain the **defaults** and **capabilities** properties. You can get these properties via a [Get printerShare](printershare-get.md) request.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_printershare"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/shares
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.printerShare)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/shares",
+ "id": "d837c17b-3296-4384-a053-828d56e10f50",
+ "displayName": "PrinterShare Name",
+ "createdDateTime": "2020-02-04T00:00:00.0000000Z",
+ "isAcceptingJobs": true,
+ "allowAllUsers": false,
+ "status": {
+ "state": "stopped",
+ "details": [
+ "disconnected"
+ ],
+ "description": ""
+ },
+ "defaults": {
+ "copiesPerJob": 1,
+ "finishings": [
+ "none"
+ ],
+ "mediaColor": "Unknown",
+ "mediaType": "stationery",
+ "mediaSize": "North America Letter",
+ "pagesPerSheet": 1,
+ "orientation": "portrait",
+ "outputBin": "auto",
+ "inputBin": "auto",
+ "contentType": "application/oxps",
+ "fitPdfToPage": false,
+ "multipageLayout": null,
+ "colorMode": "color",
+ "quality": "medium",
+ "duplexMode": "oneSided",
+ "dpi": 600,
+ "scaling": null
+ },
+ "location": {
+ "latitude": 47.6450,
+ "longitude": -122.1409,
+ "altitudeInMeters": 3,
+ "streetAddress": "One Microsoft Way",
+ "subUnit": [
+ "Main Plaza",
+ "Unit 400"
+ ],
+ "city": "Redmond",
+ "postalCode": "98052",
+ "countryOrRegion": "USA",
+ "site": "Puget Sound",
+ "building": "Studio E",
+ "floor": "1",
+ "floorDescription": "First Floor",
+ "roomName": "1234",
+ "roomDescription": "First floor copy room",
+ "organization": [
+ "C+AI",
+ "Microsoft Graph"
+ ],
+ "subdivision": [
+ "King County",
+ "Red West"
+ ],
+ "stateOrProvince": "Washington"
+ }
+ }
+ ]
+}
+```
+
v1.0 Print List Taskdefinitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/print-list-taskdefinitions.md
+
+ Title: List taskDefinitions
+description: Retrieve a list of task definitions that the requesting app defined in the tenant.
+
+localization_priority: Normal
++
+# List taskDefinitions
+Namespace: microsoft.graph
++
+Retrieve a list of [task definitions](../resources/printtaskdefinition.md) that the requesting app defined in the tenant.
+
+For details about how to use this API to add pull printing support to Universal Print, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Not supported. |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| PrintTaskDefinition.ReadWrite.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/taskDefinitions
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+### Exceptions
+Some operators are not supported: `$count`, `$format`, `$search`, `$select`, `$skip`, `$top`.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [printTaskDefinition](../resources/printtaskdefinition.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_printtaskdefinition"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/taskDefinitions
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.printTaskDefinition)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/taskDefinitions",
+ "value": [
+ {
+ "id": "fab143fd-ee61-4358-8558-2c7dee953982",
+ "displayName": "Test TaskDefinitionName",
+ "createdBy": {
+ "appId": "815f204f-c791-4ee6-9098-614ecdb003f6",
+ "displayName": "Requesting App Display Name"
+ }
+ }
+ ]
+}
+```
+
v1.0 Print Post Shares https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/print-post-shares.md
+
+ Title: Create printerShare
+description: Creates a new printer share for the specified printer.
+
+localization_priority: Normal
++
+# Create printerShare
+Namespace: microsoft.graph
++
+Create a new **printerShare** for the specified [printer](../resources/printer.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrinterShare.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /print/shares
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the [printerShare](../resources/printershare.md) object.
+
+The following table shows the properties that can be provided when you create the [printerShare](../resources/printershare.md).
+
+|Property|Type|Description|Required?|
+|:|:|:|:|
+|printer|microsoft.graph.printer|The printer that this printer share is related to. Use the `printer@odata.bind` syntax, as shown in the following example.|Yes|
+|displayName|String|The name of the printer share that print clients should display. Maximum length allowed is 50 characters.|Yes|
+|allowAllUsers|Boolean|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.|No|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [printerShare](../resources/printershare.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "create_printershare_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/print/shares
+Content-Type: application/json
+Content-length: 509
+
+{
+ "displayName": "ShareName",
+ "allowAllUsers": false,
+ "printer@odata.bind": "https://graph.microsoft.com/v1.0/print/printers/{printerId}"
+}
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printerShare"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/shares/$entity",
+ "id": "d837c17b-3296-4384-a053-828d56e10f50",
+ "displayName": "ShareName",
+ "createdDateTime": "2020-02-04T00:00:00.0000000Z",
+ "isAcceptingJobs": true,
+ "allowAllUsers": false,
+ "status": {
+ "state": "ready",
+ "details": [],
+ "description": ""
+ }
+}
+```
+
v1.0 Print Post Taskdefinitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/print-post-taskdefinitions.md
+
+ Title: Create printTaskDefinition
+description: Create a new task definition.
+
+localization_priority: Normal
++
+# Create printTaskDefinition
+Namespace: microsoft.graph
++
+Create a new task definition.
+
+For details about how to use this API to add pull printing support to Universal Print, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Not supported. |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| PrintTaskDefinition.ReadWrite.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /print/taskDefinitions
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of [printTaskDefinition](../resources/printtaskdefinition.md) object.
+
+The **id** and **createdBy.appId** properties of the [printTaskDefinition](../resources/printtaskdefinition.md) object are set automatically upon resource creation.
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [printTaskDefinition](../resources/printtaskdefinition.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "create_printtaskdefinition_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/print/taskDefinitions
+Content-Type: application/json
+Content-length: 163
+
+{
+ "displayName": "Test TaskDefinitionName",
+ "createdBy": {
+ "displayName": "Requesting App Display Name"
+ }
+}
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printTaskDefinition"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/taskDefinitions/$entity",
+ "id": "fab143fd-ee61-4358-8558-2c7dee953982",
+ "displayName": "Test TaskDefinitionName",
+ "createdBy": {
+ "appId": "815f204f-c791-4ee6-9098-614ecdb003f6",
+ "displayName": "Requesting App Display Name"
+ }
+}
+```
+
v1.0 Print Update Settings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/print-update-settings.md
+
+ Title: Update printSettings
+description: Update tenant-wide settings for the Universal Print service.
+
+localization_priority: Normal
++
+# Update printSettings
+Namespace: microsoft.graph
++
+Update tenant-wide settings for the Universal Print service.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrintSettings.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /print/settings
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply the values for the relevant [printSettings](../resources/printsettings.md) fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+
+| Property | Type | Description |
+|:-|:|:|
+|documentConversionEnabled|Boolean|Specifies whether document conversion is enabled for the tenant. If document conversion is enabled, Universal Print service will automatically convert documents into a format compatible with the printer (for example, XPS to PDF) when needed.|
+
+## Response
+
+If successful, this method returns a `204 No Content` response code and an empty response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "update_printsettings"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/v1.0/print/settings
+Content-type: application/json
+
+{
+ "documentConversionEnabled": true
+}
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printSettings"
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Print Update Taskdefinition https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/print-update-taskdefinition.md
+
+ Title: Update printTaskDefinition
+description: Update a task definition.
+
+localization_priority: Normal
++
+# Update printTaskDefinition
+
+Namespace: microsoft.graph
++
+Update a task definition.
+
+For details about how to use this API to add pull printing support to Universal Print, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Not supported. |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| PrintTaskDefinition.ReadWrite.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /print/taskDefinitions/{printTaskDefinitionId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply the values for the relevant [printTaskDefinition](../resources/printtaskdefinition.md) fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+
+| Property | Type | Description |
+|:-|:|:|
+|displayName|String|The name of the **printTaskDefinition**.|
+|createdBy|String|Information about the app that created the task definition. Only the `createdBy.displayName` property can be updated.|
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [printTaskDefinition](../resources/printtaskdefinition.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "update_printtaskdefinition"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/v1.0/print/taskDefinitions/{printTaskDefinitionId}
+Content-Type: application/json
+Content-length: 163
+
+{
+ "displayName": "Test TaskDefinitionName",
+ "createdBy": {
+ "displayName": "Requesting App Display Name"
+ }
+}
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printTaskDefinition"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/taskDefinitions/$entity",
+ "id": "fab143fd-ee61-4358-8558-2c7dee953982",
+ "displayName": "Test TaskDefinitionName",
+ "createdBy": {
+ "appId" : "479688a0-cc3a-4993-ab24-54c7c80b047e",
+ "displayName": "Requesting App Display Name"
+ }
+}
+```
+
v1.0 Printconnector Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printconnector-delete.md
+
+ Title: Delete printConnector
+description: Delete (unregister) a printConnector.
+
+localization_priority: Normal
++
+# Delete printConnector
+Namespace: microsoft.graph
++
+Delete (unregister) a **printConnector**.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrintConnector.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /print/connectors/{printConnectorId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+### Error conditions and messages
+
+|Scenario|Method|Code|Message|
+|--||-|-|
+|User attempts to delete a connector that has one or more printers registered|DELETE|409|Before deleting the connector, please unregister the associated printers.|
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "delete_printconnector"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/v1.0/print/connectors/{printConnectorId}
+```
++
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Printconnector Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printconnector-get.md
+
+ Title: Get printConnector
+description: Retrieve the properties and relationships of a connector object.
+
+localization_priority: Normal
++
+# Get printConnector
+Namespace: microsoft.graph
++
+Retrieve the properties and relationships of a **printConnector** object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrintConnector.Read.All, PrintConnector.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/connectors/{printConnectorId}
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [printConnector](../resources/printconnector.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_printconnector"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/connectors/{printConnectorId}
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printConnector"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/connectors/$entity",
+ "id": "9953d245-3f6e-418c-a438-67f50e69a430",
+ "displayName": "ConnectorName",
+ "fullyQualifiedDomainName": "CONNECTOR-MACHINE",
+ "operatingSystem": "Microsoft Windows 10 Enterprise Insider Preview | 10.0.19555",
+ "appVersion": "0.19.7338.23496",
+ "registeredDateTime": "2020-02-04T00:00:00.0000000Z",
+ "location": {
+ "latitude": 1.1,
+ "longitude": 2.2,
+ "altitudeInMeters": 3,
+ "streetAddress": "One Microsoft Way",
+ "subUnit": [
+ "Main Plaza",
+ "Unit 400"
+ ],
+ "city": "Redmond",
+ "postalCode": "98052",
+ "countryOrRegion": "USA",
+ "site": "Puget Sound",
+ "building": "Studio E",
+ "floor": "1",
+ "floorDescription": "First Floor",
+ "roomName": "1234",
+ "roomDescription": "First floor copy room",
+ "organization": [
+ "C+AI",
+ "Microsoft Graph"
+ ],
+ "subdivision": [
+ "King County",
+ "Red West"
+ ],
+ "stateOrProvince": "Washington"
+ }
+}
+```
+
v1.0 Printconnector Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printconnector-update.md
+
+ Title: Update printConnector
+description: Update the properties of a printConnector object.
+
+localization_priority: Normal
++
+# Update printConnector
+Namespace: microsoft.graph
++
+Update the properties of a **printConnector** object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrintConnector.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /print/connectors/{printConnectorId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+
+## Response
+If successful, this method returns a `200 OK` response code and an updated [printConnector](../resources/printConnector.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "update_printconnector"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/v1.0/print/connectors/{printConnectorId}
+Content-Type: application/json
+Content-length: 308
+
+{
+ "displayName": "ConnectorName",
+ "fullyQualifiedDomainName": "CONNECTOR-MACHINE",
+ "operatingSystem": "Microsoft Windows 10 Enterprise Insider Preview | 10.0.19555",
+ "appVersion": "0.19.7338.23496",
+ "location": {
+ "latitude": 1.1,
+ "longitude": 2.2,
+ "altitudeInMeters": 3
+ }
+}
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printConnector"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/connectors/$entity",
+ "id": "9953d245-3f6e-418c-a438-67f50e69a430",
+ "displayName": "ConnectorName",
+ "fullyQualifiedDomainName": "CONNECTOR-MACHINE",
+ "operatingSystem": "Microsoft Windows 10 Enterprise Insider Preview | 10.0.19555",
+ "appVersion": "0.19.7338.23496",
+ "registeredDateTime": "2020-02-04T00:00:00.0000000Z",
+ "location": {
+ "latitude": 1.1,
+ "longitude": 2.2,
+ "altitudeInMeters": 3,
+ "streetAddress": "One Microsoft Way",
+ "subUnit": [
+ "Main Plaza",
+ "Unit 400"
+ ],
+ "city": "Redmond",
+ "postalCode": "98052",
+ "countryOrRegion": "USA",
+ "site": "Puget Sound",
+ "building": "Studio E",
+ "floor": "1",
+ "floorDescription": "First Floor",
+ "roomName": "1234",
+ "roomDescription": "First floor copy room",
+ "organization": [
+ "C+AI",
+ "Microsoft Graph"
+ ],
+ "subdivision": [
+ "King County",
+ "Red West"
+ ],
+ "stateOrProvince": "Washington"
+ }
+}
+```
+
v1.0 Printdocument Createuploadsession https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printdocument-createuploadsession.md
+
+ Title: "printDocument: createUploadSession"
+description: "Create an upload session to iteratively upload ranges of binary file of printDocument."
+localization_priority: Normal
+++
+# printDocument: createUploadSession
+Namespace: microsoft.graph
++
+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.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user or app's tenant must have an active Universal Print subscription and have a permission that grants [Get printer](printer-get.md) or [Get printerShare](printershare-get.md) access depending upon whether printer or printerShare is being used.
+
+| Permission type | Permissions (from least to most privileged) |
+|:|:--|
+| Delegated (work or school account) | PrintJob.Create, PrintJob.ReadWrite, PrintJob.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not Supported. |
+| Application | PrintJob.ReadWrite.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+To create an upload session using **printer**:
+
+<!-- { "blockType": "ignored" } -->
+```http
+POST /print/printers/{id}/jobs/{id}/documents/{id}/createUploadSession
+```
+
+To create an upload session using **printerShare**:
+
+<!-- { "blockType": "ignored" } -->
+```http
+POST /print/shares/{id}/jobs/{id}/documents/{id}/createUploadSession
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, provide a JSON object with the following parameters.
+
+| Parameter | Type | Description |
+|:-|:|:|
+|properties|[printDocumentUploadProperties](../resources/printDocumentUploadProperties.md)|Represents properties of the binary file to be uploaded.|
+
+The value of the **contentType** property in the request body should be supported by the printer/printerShare. You can get the supported content types by getting [printerCapabilities](../resources/printercapabilities.md) of the printer/printerShare.
+
+For **OXPS to PDF** conversion, you need to pass `application/oxps` as contentType for printer/printerShare that supports `application/pdf`.
+Universal Print converts **OXPS to PDF**, when **all** the following conditions are met:
+1. The printer/printer share supports `application/pdf` in **printerCapabilities**.
+2. The printer/printer share does NOT support `application/oxps` in **printerCapabilities**.
+3. The value for the **contentType** property in the request body is `application/oxps`.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a new [uploadSession](../resources/uploadsession.md) object in the response body.
+
+>**Note**: The **uploadUrl** property returned as part of the **uploadSession** response object is an opaque URL for subsequent `PUT` queries to upload byte ranges of the file. It contains the appropriate auth token for subsequent `PUT` queries that expire by **expirationDateTime**. Do not change this URL.
+
+## Examples
+
+The following example shows how to create an upload session that you can use in subsequent file upload operations to the specified printDocument.
+
+### Request
+<!-- {
+ "blockType": "request"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/print/printers/{printerId}/jobs/{printJobId}/documents/{printDocumentId}/createUploadSession
+Content-Type: application/json
+Content-length: 96
+
+{
+ "properties": {
+ "documentName": "TestFile.pdf",
+ "contentType": "application/pdf",
+ "size": 4533322
+ }
+}
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.uploadSession"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.uploadSession",
+ "uploadUrl": "https://print.print.microsoft.com/uploadSessions/5400be13-5a4e-4c20-be70-90c85bfe5d6e?tempauthtoken={token}",
+ "expirationDateTime": "2020-10-25T02:19:38.1694207Z",
+ "nextExpectedRanges": [
+ "0-4533321"
+ ]
+}
+```
+
v1.0 Printdocument Get File https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printdocument-get-file.md
+
+ Title: "Download printDocument binary file"
+description: Download the binary file associated with the document.
+
+localization_priority: Normal
++
+# Download printDocument binary file
+
+Namespace: microsoft.graph
++
+Download the binary file associated with a [printDocument](../resources/printdocument.md). Calling this method yields a redirect response with a pre-authenticated URL that can be used to download the payload.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user or app's tenant must have an active Universal Print subscription and have a permission that grants grants [Get printer](printer-get.md) access.
+
+| Permission type | Permissions (from least to most privileged) |
+| :- | :-- |
+| Delegated (work or school account) | PrintJob.Read, PrintJob.Read.All, PrintJob.ReadWrite, PrintJob.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not Supported. |
+| Application | PrintJob.Read.All, PrintJob.ReadWrite.All |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+GET /print/printers/{printerId}/jobs/{printJobId}/documents/{printDocumentId}/$value
+```
+## Request headers
+| Name | Description |
+| : | : |
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns `302 Found` and the pre-authenticated download URL in the Location header.
+
+## Examples
+The following example shows how to call this API to acquire a pre-authenticated download URL. To start the download, follow the redirect URL in the response.
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_document_value"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/print/printers/{printerId}/jobs/{printJobId}/documents/{printDocumentId}/$value
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+} -->
+```http
+HTTP/1.1 302 Found
+Location: https://print.print.microsoft.com/downloads/bd260b1a-044e-4ca6-afa9-17d9a587d254?tempauthtoken={accesstoken}
+```
v1.0 Printer Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printer-create.md
+
+ Title: "printer: create"
+description: Create (register) a printer with the Universal Print service.
+
+localization_priority: Normal
++
+# printer: create
+Namespace: microsoft.graph
++
+Create (register) a printer with the Universal Print service. This is a long-running operation and as such, it returns a [printerCreateOperation](../resources/printercreateoperation.md) that can be used to track and verify the registration of the printer.
+
+For help creating the required Certificate Signing Request (CSR) for creating printer, see the [CSR generation code sample](/universal-print/hardware/universal-print-oem-certificate-signing-request).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Printer.Create, Printer.ReadWrite.All, Printer.FullControl.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| Not supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /print/printers/create
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+| Parameter | Type |Description| Required? |
+|:|:--|:-|:-|
+|displayName|String|The display name to assign to the printer.|Yes|
+|manufacturer|String|The manufacturer of the printer.|Yes|
+|model|String|The model of the printer.|Yes|
+|physicalDeviceId|String|The physical device UUID of the printer. Required if the `hasPhysicalDevice` property is true.|No|
+|hasPhysicalDevice|Boolean|True if the printer has physical output device, false otherwise. If omitted, the default value is true.|No|
+|certificateSigningRequest|[printCertificateSigningRequest](../resources/printcertificatesigningrequest.md)|The X.509 Certificate Signing Request (CSR) for the certificate created and used by the printer to identify itself.|Yes|
+|connectorId|String|ID of the connector acting as proxy to the printer.|No|
+
+## Response
+If successful, this method returns a `202 Accepted` response code and a link to the associated [printerCreateOperation](../resources/printercreateoperation.md) in the `Operation-Location` header.
+
+You make a GET request to the linked URL to get the status of an ongoing printer registration. After printer registration has completed successfully, a GET request to the linked URL will contain the created printer object and registered certificate.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "printer_create"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/print/printers/create
+Content-Type: application/json
+Content-length: 287
+
+{
+ "displayName": "Test Printer",
+ "manufacturer": "Test Printer Manufacturer",
+ "model": "Test Printer Model",
+ "physicalDeviceId": null,
+ "hasPhysicalDevice": false,
+ "certificateSigningRequest": {
+ "content": "{content}",
+ "transportKey": "{sampleTransportKey}"
+ },
+ "connectorId": null
+}
+```
++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 202 Accepted
+Operation-Location: https://graph.microsoft.com/v1.0/print/operations/f221760a-52e8-4c11-b8c5-5dfaef3a49db
+Retry-After: 5
+```
+
v1.0 Printer Delete Tasktrigger https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printer-delete-tasktrigger.md
+
+ Title: Delete printTaskTrigger
+description: Delete a printer's task trigger.
+
+localization_priority: Normal
++
+# Delete printTaskTrigger
+Namespace: microsoft.graph
++
+Delete the [task trigger](../resources/printtasktrigger.md) of a [printer](../resources/printer.md) to prevent related print events from triggering tasks on the specified printer.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Printer.ReadWrite.All, Printer.FullControl.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /print/printers/{printerId}/taskTriggers/{printTaskTriggerId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "delete_printtasktrigger"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/v1.0/print/printers/{printerId}/taskTriggers/{printTaskTriggerId}
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Printer Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printer-delete.md
+
+ Title: Delete printer
+description: Delete (unregister) a printer.
+
+localization_priority: Normal
++
+# Delete printer
+Namespace: microsoft.graph
++
+Delete (unregister) a [printer](../resources/printer.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Printer.FullControl.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /print/printers/{printerId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "delete_printer"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/v1.0/print/printers/{printerId}
+```
++
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Printer Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printer-get.md
+
+ Title: Get printer
+description: Retrieve the properties and relationships of a printer object.
+
+localization_priority: Normal
++
+# Get printer
+Namespace: microsoft.graph
++
+Retrieve the properties and relationships of a [printer](../resources/printer.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Printer.Read.All, Printer.ReadWrite.All, Printer.FullControl.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| Printer.Read.All, Printer.ReadWrite.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/printers/{id}
+GET /print/shares/{id}/printer
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters, including `$select` and `$expand`, to help customize the response. For example:
+
+```http
+GET /print/printers/{id}?$select=id,displayName,capabilities
+```
+For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and a [printer](../resources/printer.md) object in the response body.
+By default, the response will not contain [printerCapabilities](../resources/printerCapabilities.md). To get **printerCapabilities**, use the `$select` query parameter.
+
+## Examples
+
+### Example 1: Get a printer
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_printer"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/printers/{printerId}
+```
+
+#### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printer"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers/$entity",
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "displayName": "PrinterName",
+ "manufacturer": "PrinterManufacturer",
+ "model": "PrinterModel",
+ "isShared": true,
+ "registeredDateTime": "2020-02-04T00:00:00.0000000Z",
+ "isAcceptingJobs": true,
+ "status": {
+ "state": "stopped",
+ "details": [
+ "disconnected"
+ ],
+ "description": ""
+ },
+ "defaults": {
+ "copiesPerJob": 1,
+ "finishings": [
+ "none"
+ ],
+ "mediaColor": "Unknown",
+ "mediaType": "stationery",
+ "mediaSize": "North America Letter",
+ "pagesPerSheet": 1,
+ "orientation": "portrait",
+ "outputBin": "auto",
+ "inputBin": "auto",
+ "contentType": "application/oxps",
+ "fitPdfToPage": false,
+ "multipageLayout": null,
+ "colorMode": "color",
+ "quality": "medium",
+ "duplexMode": "oneSided",
+ "dpi": 600,
+ "scaling": null
+ },
+ "location": {
+ "latitude": 1.1,
+ "longitude": 2.2,
+ "altitudeInMeters": 3,
+ "streetAddress": "One Microsoft Way",
+ "subUnit": [
+ "Main Plaza",
+ "Unit 400"
+ ],
+ "city": "Redmond",
+ "postalCode": "98052",
+ "countryOrRegion": "USA",
+ "site": "Puget Sound",
+ "building": "Studio E",
+ "floor": "1",
+ "floorDescription": "First Floor",
+ "roomName": "1234",
+ "roomDescription": "First floor copy room",
+ "organization": [
+ "C+AI",
+ "Microsoft Graph"
+ ],
+ "subdivision": [
+ "King County",
+ "Red West"
+ ],
+ "stateOrProvince": "Washington"
+ }
+}
+```
+
+### Example 2: Get a printer and its capabilities
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_printer_capabilities"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/printers/{printerId}?$select=id,displayName,capabilities
+```
+
+#### Response
+
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printer"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers/$entity",
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "displayName": "PrinterName",
+ "capabilities": {
+ "isColorPrintingSupported": true,
+ "supportsFitPdfToPage": false,
+ "contentTypes": [
+ "application/pdf",
+ "image/pwg-raster",
+ "application/PCLm"
+ ],
+ "isPageRangeSupported": false,
+ "qualities": [
+ "medium"
+ ],
+ "dpis": [
+ 600
+ ],
+ "duplexModes": [
+ "oneSided",
+ "flipOnLongEdge",
+ "flipOnShortEdge"
+ ],
+ "finishings": [
+ "none"
+ ],
+ "mediaTypes": [
+ "stationery"
+ ],
+ "mediaSizes": [
+ "North America Letter"
+ ],
+ "outputBins": [
+ "tray-1"
+ ],
+ "colorModes": [
+ "grayscale",
+ "color"
+ ],
+ "inputBins": [
+ "tray-1"
+ ],
+ "collation": true,
+ "scalings": [
+ "fill"
+ ],
+ "copiesPerJob": {
+ "start": 1,
+ "end": 38
+ }
+ }
+}
+```
+
v1.0 Printer List Connectors https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printer-list-connectors.md
+
+ Title: List printConnectors for printer
+description: Retrieve a list of connectors associated with the printer.
+
+localization_priority: Normal
++
+# List printConnectors for a printer
+Namespace: microsoft.graph
++
+Retrieve a list of [printConnectors](../resources/printconnector.md) associated with the [printer](../resources/printer.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, a permission that grants [Get printer](printer-get.md) access, and one of the permissions listed in the following table.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrintConnector.Read.All, PrintConnector.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| Not Supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/printers/{printerId}/connectors
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [printConnector](../resources/printconnector.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_printconnector"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/printers/{printerId}/connectors
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.printConnector)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers('2f3453b7-4686-4b5b-9575-4f1e5b909ba7')/connectors",
+ "value": [
+ {
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "name": "Connector1",
+ "fullyQualifiedDomainName": "connector1@redmond.corp.microsoft.com",
+ "operatingSystem": "Microsoft Windows 10 Enterprise Insider Preview | 10.0.19555",
+ "appVersion": "0.19.7338.23496",
+ "registeredDateTime": "2020-02-04T07:00:00.0000000",
+ "location": {
+ "latitude": 1.1,
+ "longitude": 2.2,
+ "altitudeInMeters": 3,
+ "streetAddress": "One Microsoft Way",
+ "subUnit": [
+ "Main Plaza",
+ "Unit 400"
+ ],
+ "city": "Redmond",
+ "postalCode": "98052",
+ "countryOrRegion": "USA",
+ "site": "Puget Sound",
+ "building": "Studio E",
+ "floor": "1",
+ "floorDescription": "First Floor",
+ "roomName": "1234",
+ "roomDescription": "First floor copy room",
+ "organization": [
+ "C+AI",
+ "Microsoft Graph"
+ ],
+ "subdivision": [
+ "King County",
+ "Red West"
+ ],
+ "stateOrProvince": "Washington"
+ }
+ }
+ ]
+}
+```
+
v1.0 Printer List Jobs https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printer-list-jobs.md
+
+ Title: List printJobs for a printer
+description: Retrieve a list of print jobs associated with the printer.
+
+localization_priority: Normal
++
+# List printJobs for a printer
+Namespace: microsoft.graph
++
+Retrieve a list of print jobs associated with the [printer](../resources/printer.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, a permission that grants [Get printer](printer-get.md) access, and one of the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+To read print jobs from another user, the signed in user needs to be a print administrator and have the PrintJob.ReadBasic.All, PrintJob.Read.All, PrintJob.ReadWriteBasic.All, or PrintJob.ReadWrite.All permission.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrintJob.ReadBasic, PrintJob.Read, PrintJob.ReadBasic.All, PrintJob.Read.All, PrintJob.ReadWriteBasic, PrintJob.ReadWrite, PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| PrintJob.ReadBasic.All, PrintJob.Read.All, PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.AllΓÇ»|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/printers/{printerId}/jobs
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+* The **documents** property is omitted from the response by default. To also return a list of [printDocuments](../resources/printdocument.md) for each print job, use `$expand=documents`.
+* This method supports filtering print jobs by the user who created them. Use `$filter=createdBy/userPrincipalName eq '{upn}'`, where **{upn}** is the [user principal name](/azure/active-directory/hybrid/plan-connect-userprincipalname#what-is-userprincipalname) of the associated user.
+
+### Exceptions
+Some operators are not supported: `$count`, `$search`.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [printJob](../resources/printjob.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_printjob"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/printers/{printerId}/jobs
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.printJob)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers('2f3453b7-4686-4b5b-9575-4f1e5b909ba7')/jobs",
+ "value": [
+ {
+ "id": "103",
+ "createdDateTime": "2020-02-04T00:00:00.0000000Z",
+ "createdBy": {
+ },
+ "status": {
+ "state": "completed",
+ "description": "The print job has completed successfully and no further processing will take place.",
+ "details": [
+ ],
+ "isAcquiredByPrinter": true
+ },
+ "configuration": {
+ },
+ "redirectedTo": null,
+ "redirectedFrom": null,
+ "isFetchable": false
+ }
+ ]
+}
+```
+
v1.0 Printer List Shares https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printer-list-shares.md
+
+ Title: List printerShares for a printer
+description: Retrieve a list of printerShares associated with the printer.
+
+localization_priority: Normal
++
+# List printerShares for a printer
+Namespace: microsoft.graph
++
+Retrieve a list of printer shares associated with the [printer](../resources/printer.md).
+>**Note:** Currently, only **one** printer share per printer is supported.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, a permission that grants [Get printer](printer-get.md) access, and one of the permissions listed in the following table.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrinterShare.ReadBasic.All, PrinterShare.Read.All, PrinterShare.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| Not Supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/printers/{printerId}/shares
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [printerShare](../resources/printershare.md) objects in the response body.
+
+>**Note**: The response will not contain the **defaults** and **capabilities** properties. These properties can be queried using a [Get printerShare](printerShare-get.md) request.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_printershare"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/printers/{printerId}/shares
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.printerShare)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers('2f3453b7-4686-4b5b-9575-4f1e5b909ba7')/shares",
+ "id": "d837c17b-3296-4384-a053-828d56e10f50",
+ "displayName": "PrinterShare Name",
+ "createdDateTime": "2020-02-04T00:00:00.0000000Z",
+ "isAcceptingJobs": true,
+ "allowAllUsers": false,
+ "status": {
+ "state": "stopped",
+ "details": [
+ "disconnected"
+ ],
+ "description": ""
+ },
+ "defaults": {
+ "copiesPerJob": 1,
+ "finishings": [
+ "none"
+ ],
+ "mediaColor": "Unknown",
+ "mediaType": "stationery",
+ "mediaSize": "North America Letter",
+ "pagesPerSheet": 1,
+ "orientation": "portrait",
+ "outputBin": "auto",
+ "inputBin": "auto",
+ "contentType": "application/oxps",
+ "fitPdfToPage": false,
+ "multipageLayout": null,
+ "colorMode": "color",
+ "quality": "medium",
+ "duplexMode": "oneSided",
+ "dpi": 600,
+ "scaling": null
+ },
+ "location": {
+ "latitude": 47.6450,
+ "longitude": -122.1409,
+ "altitudeInMeters": 3,
+ "streetAddress": "One Microsoft Way",
+ "subUnit": [
+ "Main Plaza",
+ "Unit 400"
+ ],
+ "city": "Redmond",
+ "postalCode": "98052",
+ "countryOrRegion": "USA",
+ "site": "Puget Sound",
+ "building": "Studio E",
+ "floor": "1",
+ "floorDescription": "First Floor",
+ "roomName": "1234",
+ "roomDescription": "First floor copy room",
+ "organization": [
+ "C+AI",
+ "Microsoft Graph"
+ ],
+ "subdivision": [
+ "King County",
+ "Red West"
+ ],
+ "stateOrProvince": "Washington"
+ }
+ }
+ ]
+}
+```
+
v1.0 Printer List Tasktriggers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printer-list-tasktriggers.md
+
+ Title: List taskTriggers
+description: Retrieve a list of task triggers associated with the printer.
+
+localization_priority: Normal
++
+# List taskTriggers
+Namespace: microsoft.graph
++
+Retrieve a list of [task triggers](../resources/printtasktrigger.md) associated with the [printer](../resources/printer.md). The list of task triggers defines which tasks will be triggered as a result of events that occur during printing.
+
+For details about how to use this API to add pull printing support to Universal Print, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Printer.Read.All, Printer.ReadWrite.All, Printer.FullControl.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| Not supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/printers/{printerId}/taskTriggers
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+### Exceptions
+Some operators are not supported: `$count`, `$format`, `$search`, `$select`, `$skip`, `$top`.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [printTaskTrigger](../resources/printtasktrigger.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_printtasktrigger"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/printers/{printerId}/taskTriggers
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.printTaskTrigger)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers('fcc7fe6a-5ba7-4059-8017-702f3a41c8a4')/taskTriggers",
+ "value": [
+ {
+ "id": "b6a843ca-e60e-4e20-a222-a58d85eead6d",
+ "event": "jobStarted"
+ }
+ ]
+}
+```
+
v1.0 Printer Post Jobs https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printer-post-jobs.md
+
+ Title: Create printJob
+description: Create a new printJob for a printer.
+
+localization_priority: Normal
++
+# Create printJob
+Namespace: microsoft.graph
++
+Create a new [printJob](../resources/printJob.md) for a [printer](../resources/printer.md).
+
+Also creates a new [printDocument](../resources/printDocument.md) associated with the printJob.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user or app's tenant must have an active Universal Print subscription and have a permission that grants [Get printer](printer-get.md) access. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrintJob.Create, PrintJob.ReadWriteBasic, PrintJob.ReadWrite, PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| Not Supported.ΓÇ»|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /print/printers/{printerId}/jobs
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of a [printJob](../resources/printjob.md) object. The printJob object should only contain a **configuration** property. All properties of **configuration** are nullable. All other fields, including job and document IDs, are set automatically during resource creation and should not be provided in request.
+
+Right now, Universal Print supports only one **printDocument** per **printJob** object.
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [printJob](../resources/printjob.md) object and associated [printDocument](../resources/printDocument.md) in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "create_printjob_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/print/printers/{printerId}/jobs
+Content-Type: application/json
+Content-length: 376
+
+{
+ "configuration": {
+ "@odata.type": "microsoft.graph.printJobConfiguration",
+ "feedOrientation": "longEdgeFirst",
+ "pageRanges": [
+ {
+ "@odata.type": "microsoft.graph.integerRange",
+ "start": 1,
+ "end": 1
+ }
+ ],
+ "quality": "medium",
+ "dpi": 600,
+ "orientation": "landscape",
+ "copies": 1,
+ "duplexMode": "oneSided",
+ "colorMode": "blackAndWhite",
+ "inputBin": "by-pass-tray",
+ "outputBin": "output-tray",
+ "mediaSize": "A4",
+ "margin": {
+ "top": 0,
+ "bottom": 0,
+ "left": 0,
+ "right": 0
+ },
+ "mediaType": "stationery",
+ "finishings": null,
+ "pagesPerSheet": 1,
+ "multipageLayout": "clockwiseFromBottomLeft",
+ "collate": false,
+ "scaling": "shrinkToFit",
+ "fitPdfToPage": false
+ }
+}
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printJob"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printJobs/$entity",
+ "id": "1825",
+ "createdDateTime": "2020-10-14T05:16:49-07:00",
+ "isFetchable": false,
+ "redirectedFrom": null,
+ "redirectedTo": null,
+ "createdBy": {
+ "id": "{userId}",
+ "displayName": "{username}",
+ "ipAddress": null,
+ "userPrincipalName": "{userupn}"
+ },
+ "status": {
+ "state": "paused",
+ "description": "The job is not a candidate for processing yet.",
+ "isAcquiredByPrinter": false,
+ "details": [
+ "uploadPending"
+ ]
+ },
+ "configuration": {
+ "quality": "medium",
+ "dpi": 600,
+ "feedOrientation": "longEdgeFirst",
+ "orientation": "landscape",
+ "duplexMode": "oneSided",
+ "copies": 1,
+ "colorMode": "blackAndWhite",
+ "inputBin": "by-pass-tray",
+ "outputBin": "output-tray",
+ "mediaSize": "A4",
+ "mediaType": "stationery",
+ "finishings": null,
+ "pagesPerSheet": 1,
+ "multipageLayout": "clockwiseFromBottomLeft",
+ "collate": false,
+ "scaling": "shrinkToFit",
+ "fitPdfToPage": false,
+ "pageRanges": [
+ {
+ "start": 1,
+ "end": 1
+ }
+ ],
+ "margin": {
+ "top": 0,
+ "bottom": 0,
+ "left": 0,
+ "right": 0
+ }
+ },
+ "documents": [
+ {
+ "id": "1477576d-5dab-4ea9-865c-c0b82cd70bd5",
+ "displayName": "",
+ "contentType": "",
+ "size": 0
+ }
+ ]
+}
+```
+
v1.0 Printer Post Tasktriggers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printer-post-tasktriggers.md
+
+ Title: Create printTaskTrigger
+description: Create a new task trigger on the specified printer.
+
+localization_priority: Normal
++
+# Create printTaskTrigger
+Namespace: microsoft.graph
++
+Create a new [task trigger](../resources/printtasktrigger.md) on the specified [printer](../resources/printer.md). Currently, only **one** task trigger can be specified per printer, but this limit may be removed in the future.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Printer.ReadWrite.All, Printer.FullControl.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /print/printers/{printerId}/taskTriggers
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of a [printTaskTrigger](../resources/printtasktrigger.md) object. Supply a reference to a [printTaskDefinition](../resources/printtaskdefinition.md) by using the `@odata.bind` format, as shown in the following example.
+
+## Response
+If successful, this method returns a `201 Created` response code and a [printTaskTrigger](../resources/printtasktrigger.md) in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "create_printtasktrigger_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/print/printers/{printerId}/taskTriggers
+Content-Type: application/json
+Content-length: 80
+
+{
+ "event": "jobStarted",
+ "definition@odata.bind": "https://graph.microsoft.com/v1.0/print/taskDefinitions/{taskDefinitionId}"
+}
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printTaskTrigger"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.print.microsoft.com/v1.0/$metadata#Collection(Microsoft.Graph.PrintTaskTrigger)",
+ "id": "b6a843ca-e60e-4e20-a222-a58d85eead6d",
+ "event": "jobStarted"
+}
+```
+
v1.0 Printer Restorefactorydefaults https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printer-restorefactorydefaults.md
+
+ Title: "printer: restoreFactoryDefaults"
+description: Reset a printer's default settings.
+
+localization_priority: Normal
++
+# printer: restoreFactoryDefaults
+Namespace: microsoft.graph
++
+Restore a [printer](../resources/printer.md)'s default settings to the values specified by the manufacturer.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Printer.ReadWrite.All, Printer.FullControl.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| Not Supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /print/printers/{printerId}/restoreFactoryDefaults
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "printer_restorefactorydefaults"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/print/printers/{printerId}/restoreFactoryDefaults
+```
++
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Printer Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printer-update.md
+
+ Title: Update printer
+description: Update the properties of a printer object.
+
+localization_priority: Normal
++
+# Update printer
+Namespace: microsoft.graph
++
+Update the properties of a [printer](../resources/printer.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+>**Note:** Only the app that registered the printer is allowed to update the printer using application permissions.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Printer.ReadWrite.All, Printer.FullControl.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| Printer.ReadWrite.All |
+
+>**Note:** Right now, only printers that don't have physical device can be updated using application permissions.
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /print/printers/{printerId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+### Delegated permissions and JSON payload
+
+If using delegated permissions, in the request body, supply the values for the relevant [printer](../resources/printer.md) fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+
+The following properties can be updated using delegated permissions.
+
+| Property | Type | Description |
+|:-|:|:|
+|defaults|[printerDefaults](../resources/printerdefaults.md)|The printer's default print settings.|
+|location|[printerLocation](../resources/printerlocation.md)|The physical and/or organizational location of the printer.|
+|displayName|String|The name of the printer.|
+
+### Application permissions and JSON payload
+In the request body, supply the values for the relevant [printer](../resources/printer.md) fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+
+The following properties can be updated using application permissions.
+
+| Property | Type | Description |
+|:-|:|:|
+|defaults|[printerDefaults](../resources/printerdefaults.md)|The printer's default print settings.|
+|capabilities|[printerCapabilities](../resources/printerCapabilities.md)|The capabilities of the printer associated with this printer share.|
+|displayName|String|The name of the printer.|
+|manufacturer|String|The manufacturer of the printer.|
+|model|String|The model name of the printer.|
+|status|[printerStatus](../resources/printerstatus.md)|The processing status of the printer, including any errors.|
+|isAcceptingJobs|Boolean|Whether the printer is currently accepting new print jobs.|
+
+### Application permissions and IPP payload
+
+With application permissions, a printer can also be updated using an Internet Printing Protocol (IPP) payload. In this case, the request body contains a binary stream that represents the Printer Attributes group in [IPP encoding](https://tools.ietf.org/html/rfc8010).
+
+The client MUST supply a set of Printer attributes with one or more values (including explicitly allowed out-of-band values) as defined in [RFC8011 section 5.2](https://tools.ietf.org/html/rfc8011#section-5.2) Job Template Attributes ("xxx-default", "xxx-supported", and "xxx-ready" attributes), [Section 5.4](https://tools.ietf.org/html/rfc8011#section-5.4) Printer Description Attributes, and any attribute extensions supported by the Printer. The value(s) of each Printer attribute
+supplied replaces the value(s) of the corresponding Printer attribute on the target Printer object. For attributes that can have multiple values (1setOf), all values supplied by the client replace all values of the corresponding Printer object attribute.
+
+## Response
+
+### Delegated permissions and JSON payload
+
+If using delegated permissions, if successful, this method returns a `200 OK` response code and an updated [printer](../resources/printer.md) object in the response body.
+
+### Application permissions and JSON payload
+
+If using delegated permissions, if successful, this method returns a `200 OK` response code and an updated [printer](../resources/printer.md) object in the response body.
+
+### Application permissions and IPP payload
+
+If using application permissions, if successful, this method returns `204 No content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "update_printer"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/v1.0/print/printers/{printerId}
+Content-Type: application/json
+Content-length: 581
+
+{
+ "name": "PrinterName",
+ "location": {
+ "latitude": 1.1,
+ "longitude": 2.2,
+ "altitudeInMeters": 3
+ }
+}
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printer"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers/$entity",
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "displayName": "PrinterName",
+ "manufacturer": "PrinterManufacturer",
+ "model": "PrinterModel",
+ "isShared": true,
+ "registeredDateTime": "2020-02-04T00:00:00.0000000Z",
+ "isAcceptingJobs": true,
+ "status": {
+ "state": "idle",
+ "details": [],
+ "description": ""
+ },
+ "defaults": {
+ "copiesPerJob":1,
+ "contentType": "application/oxps",
+ "finishings": ["none"],
+ "mediaType": "stationery"
+ },
+ "location": {
+ "latitude": 1.1,
+ "longitude": 2.2,
+ "altitudeInMeters": 3,
+ "streetAddress": "One Microsoft Way",
+ "subUnit": [
+ "Main Plaza",
+ "Unit 400"
+ ],
+ "city": "Redmond",
+ "postalCode": "98052",
+ "countryOrRegion": "USA",
+ "site": "Puget Sound",
+ "building": "Studio E",
+ "floor": "1",
+ "floorDescription": "First Floor",
+ "roomName": "1234",
+ "roomDescription": "First floor copy room",
+ "organization": [
+ "C+AI",
+ "Microsoft Graph"
+ ],
+ "subdivision": [
+ "King County",
+ "Red West"
+ ],
+ "stateOrProvince": "Washington"
+ }
+}
+```
+
v1.0 Printershare Delete Allowedgroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printershare-delete-allowedgroup.md
+
+ Title: Delete allowedGroup from printerShare
+description: Revoke the specified group's access to submit print jobs to the associated printer share.
+
+localization_priority: Normal
++
+# Delete allowedGroup from printerShare
+
+Namespace: microsoft.graph
++
+Revoke the specified group's access to submit print jobs to the associated [printerShare](../resources/printershare.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrinterShare.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+DELETE /print/shares/{printerShareId}/allowedGroups/{groupId}/$ref
+```
+## Request headers
+| Name | Description |
+|:--|:--|
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+### Request
+The following is an example of the request.
+<!-- {
+ "blockType": "request",
+ "name": "delete_allowedgroup"
+}-->
+```http
+DELETE https://graph.microsoft.com/v1.0/print/shares/{printerShareId}/allowedGroups/{groupId}/$ref
+```
+### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+} -->
+```http
+HTTP/1.1 204 No Content
+```
+
v1.0 Printershare Delete Alloweduser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printershare-delete-alloweduser.md
+
+ Title: Delete allowedUser from printerShare
+description: Revoke the specified user's access to submit print jobs to the associated printer share.
+
+localization_priority: Normal
++
+# Delete allowedUser from printerShare
+
+Namespace: microsoft.graph
++
+Revoke the specified user's access to submit print jobs to the associated [printerShare](../resources/printershare.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrinterShare.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+DELETE /print/printerShare/{printerShareId}/allowedUsers/{userId}/$ref
+```
+## Request headers
+| Name | Description |
+|:--|:--|
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Example
+### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_alloweduser"
+}-->
+```http
+DELETE https://graph.microsoft.com/v1.0/print/printerShare/{printerShareId}/allowedUsers/{userId}/$ref
+```
+
+### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+} -->
+```http
+HTTP/1.1 204 No Content
+```
v1.0 Printershare Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printershare-delete.md
+
+ Title: Delete printerShare
+description: Delete a printer share (unshare the associated printer). This action cannot be undone. If the printer is shared again in the future, any Windows users who had previously installed the printer will need to discover and re-install it.
+
+localization_priority: Normal
+++
+# Delete printerShare
+Namespace: microsoft.graph
++
+Delete a printer share (unshare the associated [printer](../resources/printer.md)). This action cannot be undone. If the [printer](../resources/printer.md) is shared again in the future, any Windows users who had previously installed the [printer](../resources/printer.md) will need to discover and reinstall it.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrinterShare.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /print/shares/{printerShareId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "delete_printershare"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/v1.0/print/shares/{printerShareId}
+```
++
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Printershare Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printershare-get.md
+
+ Title: Get printerShare
+description: Retrieve the properties and relationships of a printer share.
+
+localization_priority: Normal
++
+# Get printerShare
+Namespace: microsoft.graph
++
+Retrieve the properties and relationships of a printer share.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user or app's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrinterShare.ReadBasic.All, PrinterShare.Read.All, PrinterShare.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/shares/{printerShareId}
+GET /print/printers/{printerId}/shares/{printerShareId}
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters, including `$select` and `$expand`, to help customize the response. For example:
+
+e.g.
+```http
+GET /print/printers/{id}?$select=id,displayName,capabilities
+```
+For general information, see [OData query parameters](/graph/query-parameters).
+
+### Exceptions
+* The `$count` operator is not supported.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+## Response
+If successful, this method returns a `200 OK` response code and a [printerShare](../resources/printershare.md) object in the response body.
+By default, the response will not contain [printerCapabilities](../resources/printerCapabilities.md). To get **printerCapabilities**, use the `$select` query parameter.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [printerShare](../resources/printershare.md) object in the response body.
+
+## Examples
+
+### Example 1: Get a printerShare
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_printershare"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/shares/{printerShareId}
+```
+
+#### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printerShare"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/shares/$entity",
+ "id": "d837c17b-3296-4384-a053-828d56e10f50",
+ "displayName": "PrinterShare Name",
+ "createdDateTime": "2020-02-04T00:00:00.0000000Z",
+ "isAcceptingJobs": true,
+ "allowAllUsers": false,
+ "status": {
+ "state": "stopped",
+ "details": [
+ "disconnected"
+ ],
+ "description": ""
+ },
+ "defaults": {
+ "copiesPerJob": 1,
+ "finishings": [
+ "none"
+ ],
+ "mediaColor": "Unknown",
+ "mediaType": "stationery",
+ "mediaSize": "North America Letter",
+ "pagesPerSheet": 1,
+ "orientation": "portrait",
+ "outputBin": "auto",
+ "inputBin": "auto",
+ "contentType": "application/oxps",
+ "fitPdfToPage": false,
+ "multipageLayout": null,
+ "colorMode": "color",
+ "quality": "medium",
+ "duplexMode": "oneSided",
+ "dpi": 600,
+ "scaling": null
+ },
+ "location": {
+ "latitude": 47.6450,
+ "longitude": -122.1409,
+ "altitudeInMeters": 3,
+ "streetAddress": "One Microsoft Way",
+ "subUnit": [
+ "Main Plaza",
+ "Unit 400"
+ ],
+ "city": "Redmond",
+ "postalCode": "98052",
+ "countryOrRegion": "USA",
+ "site": "Puget Sound",
+ "building": "Studio E",
+ "floor": "1",
+ "floorDescription": "First Floor",
+ "roomName": "1234",
+ "roomDescription": "First floor copy room",
+ "organization": [
+ "C+AI",
+ "Microsoft Graph"
+ ],
+ "subdivision": [
+ "King County",
+ "Red West"
+ ],
+ "stateOrProvince": "Washington"
+ }
+}
+```
+
+### Example 2: Get a printerShare and its capabilities
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_printershare_capabilities"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/shares/{printerShareId}?$select=id,displayName,capabilities
+```
+
+#### Response
+
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printerShare"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/shares/$entity",
+ "id": "d837c17b-3296-4384-a053-828d56e10f50",
+ "displayName": "PrinterShare Name",
+ "capabilities": {
+ "isColorPrintingSupported": true,
+ "supportsFitPdfToPage": false,
+ "contentTypes": [
+ "application/pdf",
+ "image/pwg-raster",
+ "application/PCLm"
+ ],
+ "isPageRangeSupported": false,
+ "qualities": [
+ "medium"
+ ],
+ "dpis": [
+ 600
+ ],
+ "duplexModes": [
+ "oneSided",
+ "flipOnLongEdge",
+ "flipOnShortEdge"
+ ],
+ "finishings": [
+ "none"
+ ],
+ "mediaTypes": [
+ "stationery"
+ ],
+ "mediaSizes": [
+ "North America Letter"
+ ],
+ "outputBins": [
+ "tray-1"
+ ],
+ "colorModes": [
+ "grayscale",
+ "color"
+ ],
+ "inputBins": [
+ "tray-1"
+ ],
+ "collation": true,
+ "scalings": [
+ "fill"
+ ],
+ "copiesPerJob": {
+ "start": 1,
+ "end": 38
+ }
+ }
+}
+```
v1.0 Printershare List Allowedgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printershare-list-allowedgroups.md
+
+ Title: List allowedGroups for printerShare
+description: Retrieve a list of groups that have been granted access to submit print jobs to the associated printer share.
+
+localization_priority: Normal
++
+# List allowedGroups
+Namespace: microsoft.graph
++
+Retrieve a list of groups that have been granted access to submit print jobs to the associated [printerShare](../resources/printershare.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user or app's tenant must have an active Universal Print subscription and have a permission that grants [List groups](group-list.md) access. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrinterShare.Read.All, PrinterShare.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/shares/{printerShareId}/allowedGroups
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [group](../resources/group.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_group"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/shares/{printerShareId}/allowedGroups
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.group)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.group)",
+ "value": [
+ {
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "displayName": "GroupName"
+ }
+ ]
+}
+```
+
v1.0 Printershare List Allowedusers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printershare-list-allowedusers.md
+
+ Title: List allowedUsers for printerShare
+description: Retrieve a list of users who have been granted access to submit print jobs to the associated printer share.
+
+localization_priority: Normal
++
+# List allowedUsers
+Namespace: microsoft.graph
++
+Retrieve a list of users who have been granted access to submit print jobs to the associated [printerShare](../resources/printershare.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user or app's tenant must have an active Universal Print subscription and have a permission that grants [List users](user-list.md) access. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrinterShare.Read.All, PrinterShare.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/shares/{printerShareId}/allowedUsers
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [user](../resources/user.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_user"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/shares/{printerShareId}/allowedUsers
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.user)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.user)",
+ "value": [
+ {
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "displayName": "UserName",
+ "userPrincipalName": "username@contoso.com"
+ }
+ ]
+}
+```
+
v1.0 Printershare List Jobs https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printershare-list-jobs.md
+
+ Title: List printJobs for a printerShare
+description: Retrieve a list of print jobs associated with the printe share.
+
+localization_priority: Normal
++
+# List printJobs for a printerShare
+Namespace: microsoft.graph
++
+Retrieve a list of print jobs associated with the [printerShare](../resources/printershare.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, a permission that grants [Get printerShare](printershare-get.md) access, and one of the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+To read print jobs from another user, the signed in user needs to be a print administrator and have the PrintJob.ReadBasic.All, PrintJob.Read.All, PrintJob.ReadWriteBasic.All, or PrintJob.ReadWrite.All permission.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrintJob.ReadBasic, PrintJob.Read, PrintJob.ReadBasic.All, PrintJob.Read.All, PrintJob.ReadWriteBasic, PrintJob.ReadWrite, PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| PrintJob.ReadBasic.All, PrintJob.Read.All, PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.AllΓÇ»|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/shares/{printerShareId}/jobs
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+* The **documents** property is omitted from the response by default. To also return a list of [printDocuments](../resources/printdocument.md) for each print job, use `$expand=documents`.
+* This method supports filtering print jobs by the user who created them. Use `$filter=createdBy/userPrincipalName eq '{upn}'`, where **{upn}** is the [user principal name](/azure/active-directory/hybrid/plan-connect-userprincipalname#what-is-userprincipalname) of the associated user.
+
+### Exceptions
+Some operators are not supported: `$count`, `$search`.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [printJob](../resources/printjob.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_printjob"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/shares/{printerShareId}/jobs
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.printJob)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/shares('f37141d9-0afb-484f-96d3-0ef0a679e6c1')/jobs",
+ "value": [
+ {
+ "id": "103",
+ "createdDateTime": "2020-02-04T00:00:00.0000000Z",
+ "createdBy": {
+ },
+ "status": {
+ "state": "completed",
+ "description": "The print job has completed successfully and no further processing will take place.",
+ "details": [
+ ],
+ "isAcquiredByPrinter": true
+ },
+ "configuration": {
+ },
+ "redirectedTo": null,
+ "redirectedFrom": null,
+ "isFetchable": false
+ }
+ ]
+}
+```
+
v1.0 Printershare Post Allowedgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printershare-post-allowedgroups.md
+
+ Title: Create allowedGroup for printerShare
+description: Grant the specified group access to submit print jobs to the associated printer.
+
+localization_priority: Normal
++
+# Create allowedGroup for printerShare
+Namespace: microsoft.graph
++
+Grant the specified group access to submit print jobs to the associated [printerShare](../resources/printershare.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrinterShare.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /print/printers/{printerShareId}/allowedGroups/$ref
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a reference to a group entity by using the `@odata.id` format, as shown in the following example.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "create_group_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/print/shares/{printerShareId}/allowedGroups/$ref
+Content-Type: application/json
+Content-length: 47
+
+{
+ "@odata.id": "https://graph.microsoft.com/v1.0/groups/{groupId}"
+}
+```
++
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.group"
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Printershare Post Allowedusers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printershare-post-allowedusers.md
+
+ Title: Create allowedUser for printerShare
+description: Grant the specified user access to submit print jobs to the associated printer share.
+
+localization_priority: Normal
++
+# Create allowedUser for printerShare
+Namespace: microsoft.graph
++
+Grant the specified user access to submit print jobs to the associated [printerShare](../resources/printershare.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrinterShare.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /print/shares/{printerShareId}/allowedUsers/$ref
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a reference to a user entity by using the `@odata.id` format, as shown in the following example.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "create_user_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/print/shares/{printerShareId}/allowedUsers/$ref
+Content-Type: application/json
+Content-length: 46
+
+{
+ "@odata.id": "https://graph.microsoft.com/v1.0/users/{userId}"
+}
+```
++
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.user"
+}
+-->
+```http
+HTTP/1.1 204 No Content
+```
+
v1.0 Printershare Post Jobs https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printershare-post-jobs.md
+
+ Title: Create printJob for a printerShare
+description: Create a new printJob for a printerShare.
+
+localization_priority: Normal
++
+# Create printJob for a printerShare
+Namespace: microsoft.graph
++
+Create a new [printJob](../resources/printJob.md) for a [printerShare](../resources/printerShare.md).
+
+Also creates a new [printDocument](../resources/printDocument.md) associated with the printJob.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user or app's tenant must have an active Universal Print subscription and have a permission that grants [Get printerShare](printerShare-get.md) access. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrintJob.ReadWriteBasic, PrintJob.ReadWrite, PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| Not Supported.ΓÇ»|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /print/shares/{printerShareId}/jobs
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of a [printJob](../resources/printjob.md) object. The printJob object should only contain **configuration** property. All properties of **configuration** are nullable. All other fields, including job and document IDs, are set automatically during resource creation and should not be provided in request.
+
+Right now, Universal Print supports only one **printDocument** per **printJob** object.
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [printJob](../resources/printjob.md) object and associated [printDocument](../resources/printDocument.md) in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "create_printjob_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/print/shares/{printerShareId}/jobs
+Content-Type: application/json
+Content-length: 376
+
+{
+ "configuration": {
+ "feedOrientation": "longEdgeFirst",
+ "pageRanges": [
+ {
+ "start": 1,
+ "end": 1
+ }
+ ],
+ "quality": "medium",
+ "dpi": 600,
+ "orientation": "landscape",
+ "copies": 1,
+ "duplexMode": "oneSided",
+ "colorMode": "blackAndWhite",
+ "inputBin": "by-pass-tray",
+ "outputBin": "output-tray",
+ "mediaSize": "A4",
+ "margin": {
+ "top": 0,
+ "bottom": 0,
+ "left": 0,
+ "right": 0
+ },
+ "mediaType": "stationery",
+ "finishings": null,
+ "pagesPerSheet": 1,
+ "multipageLayout": "clockwiseFromBottomLeft",
+ "collate": false,
+ "scaling": "shrinkToFit",
+ "fitPdfToPage": false
+ }
+}
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printJob"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printJobs/$entity",
+ "id": "1825",
+ "createdDateTime": "2020-10-14T05:16:49-07:00",
+ "isFetchable": false,
+ "redirectedFrom": null,
+ "redirectedTo": null,
+ "createdBy": {
+ "id": "{userId}",
+ "displayName": "{username}",
+ "ipAddress": null,
+ "userPrincipalName": "{userupn}"
+ },
+ "status": {
+ "state": "paused",
+ "description": "The job is not a candidate for processing yet.",
+ "isAcquiredByPrinter": false,
+ "details": [
+ "uploadPending"
+ ]
+ },
+ "configuration": {
+ "quality": "medium",
+ "dpi": 600,
+ "feedOrientation": "longEdgeFirst",
+ "orientation": "landscape",
+ "duplexMode": "oneSided",
+ "copies": 1,
+ "colorMode": "blackAndWhite",
+ "inputBin": "by-pass-tray",
+ "outputBin": "output-tray",
+ "mediaSize": "A4",
+ "mediaType": "stationery",
+ "finishings": null,
+ "pagesPerSheet": 1,
+ "multipageLayout": "clockwiseFromBottomLeft",
+ "collate": false,
+ "scaling": "shrinkToFit",
+ "fitPdfToPage": false,
+ "pageRanges": [
+ {
+ "start": 1,
+ "end": 1
+ }
+ ],
+ "margin": {
+ "top": 0,
+ "bottom": 0,
+ "left": 0,
+ "right": 0
+ }
+ },
+ "documents": [
+ {
+ "id": "1477576d-5dab-4ea9-865c-c0b82cd70bd5",
+ "displayName": "",
+ "contentType": "",
+ "size": 0
+ }
+ ]
+}
+```
+
v1.0 Printershare Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printershare-update.md
+
+ Title: Update printershare
+description: Update the properties of printer share. This method can be used to "swap" printers.
+
+localization_priority: Normal
++
+# Update printerShare
+Namespace: microsoft.graph
++
+Update the properties of a printer share. This method can be used to swap [printers](../resources/printer.md).
+
+For example, if a physical printer device breaks, an administrator can register a new [printer](../resources/printer.md) device and update this [printerShare](../resources/printerShare.md) to point to the new printer without requiring users to take any action.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user or app's tenant must have an active Universal Print subscription. The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrinterShare.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /print/shares/{printerShareId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply the values for relevant [printerShare](../resources/printershare.md) fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+
+Following properties can be updated:
+
+| Property | Type | Description |
+|:-|:|:|
+|printer|microsoft.graph.printer|The printer that this printer share is related to. Use the `printer@odata.bind` syntax as shown in the following example to update which printer this printer share is associated with.|
+|displayName|String|The name of the printer share that print clients should display.|
+|allowAllUsers|Boolean| 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.|
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [printerShare](../resources/printershare.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "update_printershare"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/v1.0/print/shares/{printerShareId}
+Content-Type: application/json
+Content-length: 509
+
+{
+ "displayName": "PrinterShare Name",
+ "printer@odata.bind": "https://graph.microsoft.com/v1.0/print/printers/{printerId}",
+ "allowAllUsers": false
+}
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printerShare"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/shares/$entity",
+ "id": "d837c17b-3296-4384-a053-828d56e10f50",
+ "displayName": "PrinterShare Name",
+ "createdDateTime": "2020-02-04T00:00:00.0000000Z",
+ "isAcceptingJobs": true,
+ "allowAllUsers": false,
+ "status": {
+ "state": "stopped",
+ "details": ["disconnected"],
+ "description": ""
+ }
+}
+```
+
v1.0 Printjob Abort https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printjob-abort.md
+
+ Title: "printJob: abort"
+description: Abort a print job.
+
+localization_priority: Normal
++
+# printJob: abort
+
+Namespace: microsoft.graph
++
+Abort a print job. Only applications using application permissions can abort a print job.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the app's tenant must have an active Universal Print subscription and have either the Printer.Read.All or Printer.ReadWrite.All application permission.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Not Supported |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.All, PrintJob.Manage.AllΓÇ»|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /print/printers/{printerId}/jobs/{printJobId}/abort
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+In the request body, you can optionally provide the reason why the job is being aborted.
+
+| Property | Type | Description |
+|:-|:|:|
+|reason|String|Reason why job is being aborted.|
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "printjob_abort"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/print/printers/{printerId}/jobs/{printJobId}/abort
+Content-Type: application/json
+Content-length: 26
+
+{
+ "reason": "String"
+}
+```
+
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Printjob Cancel https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printjob-cancel.md
+
+ Title: "printJob: cancel"
+description: Cancel a print job.
+
+localization_priority: Normal
++
+# printJob: cancel
+Namespace: microsoft.graph
++
+Cancel a print job. Print jobs can be canceled only on behalf of a user, using delegated permissions.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user or app's tenant must have an active Universal Print subscription and have a permission that grants [Get printer](printer-get.md) access.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrintJob.ReadWriteBasic, PrintJob.ReadWrite, PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| Not Supported.ΓÇ»|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /print/printers/{printerId}/jobs/{printJobId}/cancel
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "printjob_cancel"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/print/printers/{printerId}/jobs/{printJobId}/cancel
+```
+
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Printjob Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printjob-get.md
+
+ Title: Get printJob
+description: Retrieve the properties and relationships of a print job.
+
+localization_priority: Normal
++
+# Get printJob
+Namespace: microsoft.graph
++
+Retrieve the properties and relationships of a print job.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user or app's tenant must have an active Universal Print subscription and have a permission that grants [Get printer](printer-get.md) or [Get printerShare](printershare-get.md) access depending upon whether printer or printerShare is being used.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrintJob.ReadBasic, PrintJob.Read, PrintJob.ReadBasic.All, PrintJob.Read.All, PrintJob.ReadWriteBasic, PrintJob.ReadWrite, PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| PrintJob.ReadBasic.All, PrintJob.Read.All, PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.AllΓÇ»|
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+To get a job from a printer:
+```http
+GET /print/printers/{id}/jobs/{id}
+```
+
+To get a job from a printer share:
+```http
+GET /print/shares/{id}/jobs/{id}
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [printJob](../resources/printjob.md) object in the response body.
+
+## Examples
+
+### Example 1: Get print job
+
+#### Request
+The following is an example of a request to get metadata for a print job.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_printjob"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/print/printers/{printerId}/jobs/{printJobId}
+```
+
+#### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printJob"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers('c05f3726-0d4b-4aa1-8fe9-2eb981bb26fb')/jobs/$entity",
+ "id": "5182",
+ "createdDateTime": "2020-02-04T00:00:00.0000000Z",
+ "createdBy": {
+ },
+ "configuration": {
+ },
+ "status": {
+ "state": "completed",
+ "description": "The print job has completed successfully and no further processing will take place.",
+ "details": [
+ ],
+ "isAcquiredByPrinter": true
+ },
+ "redirectedTo": null,
+ "redirectedFrom": null,
+ "isFetchable": false
+}
+```
+
+### Example 2: Get print job with task list
+
+#### Request
+The following is a request to get a print job and any [tasks](../resources/printtask.md) that are executing, or have executed, against it.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_printjob_withtasks"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/print/printers/{printerId}/jobs/{printJobId}?$expand=tasks
+```
+
+#### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printJob"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers('c05f3726-0d4b-4aa1-8fe9-2eb981bb26fb')/jobs/$entity",
+ "id": "5182",
+ "createdDateTime": "2020-02-04T00:00:00.0000000Z",
+ "createdBy": {
+ },
+ "configuration": {
+ },
+ "status": {
+ "state": "completed",
+ "description": "The print job has completed successfully and no further processing will take place.",
+ "details": [
+ ],
+ "isAcquiredByPrinter": true
+ },
+ "redirectedTo": null,
+ "redirectedFrom": null,
+ "isFetchable": false,
+ "tasks": [
+ {
+ "id": "d036638b-1272-4bba-9227-732463823ed3",
+ "parentUrl": "https://graph.microsoft.com/v1.0/print/printers/c05f3726-0d4b-4aa1-8fe9-2eb981bb26fb/jobs/5182",
+ "status": {
+ "state": "processing",
+ "description": "The task is being processed."
+ }
+ }
+ ]
+}
+```
+
+### Example 3: Get a print job and its associated document data
+
+#### Request
+The following is an example of a request to get a print job and its associated document data.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_printjob_withdocumentdata"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/print/printers/{printerId}/jobs/{printJobId}?$expand=documents
+```
+
+#### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printJob"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers('c05f3726-0d4b-4aa1-8fe9-2eb981bb26fb')/jobs/$entity",
+ "id": "5182",
+ "createdDateTime": "2020-02-04T00:00:00.0000000Z",
+ "createdBy": {
+ },
+ "configuration": {
+ },
+ "status": {
+ "state": "completed",
+ "description": "The print job has completed successfully and no further processing will take place.",
+ "details": [
+ ],
+ "isAcquiredByPrinter": true
+ },
+ "redirectedTo": null,
+ "redirectedFrom": null,
+ "isFetchable": false,
+ "documents@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers('c05f3726-0d4b-4aa1-8fe9-2eb981bb26fb')/jobs('5182')/documents",
+ "documents": [
+ {
+ "id": "ca96c367-c3ad-478a-bbce-fbd1cd856e73",
+ "displayName": "",
+ "contentType": "application/oxps",
+ "size": 276604
+ }
+ ]
+}
+```
v1.0 Printjob Redirect https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printjob-redirect.md
+
+ Title: "printJob: redirect"
+description: Redirect a print job to a different printer.
+
+localization_priority: Normal
++
+# printJob: redirect
+Namespace: microsoft.graph
++
+Redirect a [print job](../resources/printjob.md) to a different [printer](../resources/printer.md).
+
+For details about how to use this API to add pull printing support to Universal Print, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, a permission that grants [Get printer](printer-get.md) access, and one of the permissions listed in the following table.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Not supported. |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| PrintJob.Manage.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /print/printers/{printerId}/jobs/{printJobId}/redirect
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply the ID of the printer that the print job should be redirected to.
+
+| Property | Type | Description |
+|:-|:|:|
+|destinationPrinterId|String|The ID of the printer the print job should be redirected to.|
+|configuration|microsoft.graph.printJobConfiguration|Updated configuration of print job.|
+
+## Response
+If successful, this method returns a `200 OK` response code and a [printJob](../resources/printjob.md) object queued for the destination printer.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "printjob_redirect"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/print/printers/{printerId}/jobs/{printJobId}/redirect
+Content-Type: application/json
+Content-length: 128
+
+{
+ "destinationPrinterId": "9a3b3956-ce5b-4d06-a605-5b0bd3e9ddea",
+ "configuration": {
+ "feedOrientation": "longEdgeFirst",
+ "pageRanges": [
+ {
+ "start": 1,
+ "end": 1
+ }
+ ],
+ "quality": "medium",
+ "dpi": 600,
+ "orientation": "landscape",
+ "copies": 1,
+ "duplexMode": "oneSided",
+ "colorMode": "blackAndWhite",
+ "inputBin": "by-pass-tray",
+ "outputBin": "output-tray",
+ "mediaSize": "A4",
+ "margin": {
+ "top": 0,
+ "bottom": 0,
+ "left": 0,
+ "right": 0
+ },
+ "mediaType": "stationery",
+ "finishings": null,
+ "pagesPerSheet": 1,
+ "multipageLayout": "clockwiseFromBottomLeft",
+ "collate": false,
+ "scaling": "shrinkToFit",
+ "fitPdfToPage": false
+ }
+}
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printJob"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers('9a3b3956-ce5b-4d06-a605-5b0bd3e9ddea')/jobs/$entity",
+ "id": "24123",
+ "createdDateTime": "2020-06-26T04:20:06.5715544Z",
+ "createdBy": {
+ "id": "",
+ "displayName": "",
+ "userPrincipalName": ""
+ },
+ "status": {
+ "state": "processing",
+ "description": "The print job is currently being processed by the printer.",
+ "details": ["interpreting"]
+ },
+ "configuration": {
+ "feedOrientation": "longEdgeFirst",
+ "pageRanges": [
+ {
+ "start": 1,
+ "end": 1
+ }
+ ],
+ "quality": "medium",
+ "dpi": 600,
+ "orientation": "landscape",
+ "copies": 1,
+ "duplexMode": "oneSided",
+ "colorMode": "blackAndWhite",
+ "inputBin": "by-pass-tray",
+ "outputBin": "output-tray",
+ "mediaSize": "A4",
+ "margin": {
+ "top": 0,
+ "bottom": 0,
+ "left": 0,
+ "right": 0
+ },
+ "mediaType": "stationery",
+ "finishings": null,
+ "pagesPerSheet": 1,
+ "multipageLayout": "clockwiseFromBottomLeft",
+ "collate": false,
+ "scaling": "shrinkToFit",
+ "fitPdfToPage": false
+ }
+}
+```
+
v1.0 Printjob Start https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printjob-start.md
+
+ Title: "printJob: start"
+description: Submits the print job to the associated printer or printerShare. It will be printed once any existing pending jobs are completed, aborted or canceled.
+
+localization_priority: Normal
++
+# printJob: start
+Namespace: microsoft.graph
++
+Submits the print job to the associated [printer](../resources/printer.md) or [printerShare](../resources/printershare.md). It will be printed after any existing pending **jobs** are completed, aborted, or canceled.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user or app's tenant must have an active Universal Print subscription and have a permission that grants [Get printer](printer-get.md) or [Get printerShare](printershare-get.md) depending upon whether printer or printerShare is being used.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| PrintJob.Create, PrintJob.ReadWriteBasic, PrintJob.ReadWrite, PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| Not Supported.ΓÇ»|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /print/shares/{printerShareId}/jobs/{printJobId}/start
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and a [printJobStatus](../resources/printjobstatus.md) object in the body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "printjob_start"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/print/shares/{printerShareId}/jobs/{printJobId}/start
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printJobStatus"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "state": "processing",
+ "description": "The print job is currently being processed.",
+ "isAcquiredByPrinter": false,
+ "details": ["interpreting"]
+}
+```
+
v1.0 Printjob Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printjob-update.md
+
+ Title: Update printJob
+description: Update print job
+
+localization_priority: Normal
++
+# Update printJob
+Namespace: microsoft.graph
++
+Update a [print job](../resources/printjob.md). Only the **configuration** property can be updated.
+
+Updating a print job will only succeed if there is a [printTask](../resources/printTask.md) 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](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, either the Printer.Read.All or Printer.ReadWrite.All application permission, and one of the permissions listed in the following table.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Not supported. |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.All, PrintJob.Manage.AllΓÇ»|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /print/printers/{printerId}/jobs/{printJobId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply the values of the relevant [printJob](../resources/printjob.md) fields. Existing properties that are not included in the request body will maintain their previous values.
+
+Only the **configuration** property can be updated.
+
+## Response
+
+If successful, this method returns a `200 OK` response code with an updated [printJob](../resources/printjob.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "update_printjob"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/v1.0/print/printers/{printerId}/jobs/{printJobId}
+Content-Type: application/json
+Content-length: 376
+
+{
+ "configuration": {
+ "feedOrientation": "longEdgeFirst",
+ "pageRanges": [
+ {
+ "start": 1,
+ "end": 1
+ }
+ ],
+ "quality": "medium",
+ "dpi": 600,
+ "orientation": "landscape",
+ "copies": 1,
+ "duplexMode": "oneSided",
+ "colorMode": "blackAndWhite",
+ "inputBin": "by-pass-tray",
+ "outputBin": "output-tray",
+ "mediaSize": "A4",
+ "margin": {
+ "top": 0,
+ "bottom": 0,
+ "left": 0,
+ "right": 0
+ },
+ "mediaType": "stationery",
+ "finishings": null,
+ "pagesPerSheet": 1,
+ "multipageLayout": "clockwiseFromBottomLeft",
+ "collate": false,
+ "scaling": "shrinkToFit",
+ "fitPdfToPage": false
+ }
+}
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printJob"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers('d5ef6ec4-07ca-4212-baf9-d45be126bfbb')/jobs/$entity",
+ "id": "44353",
+ "createdDateTime": "2020-06-26T04:20:06.5715544Z",
+ "createdBy": {
+ "id": "",
+ "displayName": "",
+ "userPrincipalName": ""
+ },
+ "status": {
+ "state": "paused",
+ "description": "The job is not a candidate for processing yet."
+ },
+ "configuration": {
+ "feedOrientation": "longEdgeFirst",
+ "pageRanges": [
+ {
+ "start": 1,
+ "end": 1
+ }
+ ],
+ "quality": "medium",
+ "dpi": 600,
+ "orientation": "landscape",
+ "copies": 1,
+ "duplexMode": "oneSided",
+ "colorMode": "blackAndWhite",
+ "inputBin": "by-pass-tray",
+ "outputBin": "output-tray",
+ "mediaSize": "A4",
+ "margin": {
+ "top": 0,
+ "bottom": 0,
+ "left": 0,
+ "right": 0
+ },
+ "mediaType": "stationery",
+ "finishings": null,
+ "pagesPerSheet": 1,
+ "multipageLayout": "clockwiseFromBottomLeft",
+ "collate": false,
+ "scaling": "shrinkToFit",
+ "fitPdfToPage": false
+ }
+}
+```
+
v1.0 Printoperation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printoperation-get.md
+
+ Title: Get printOperation
+description: Retrieve a printOperation.
+
+localization_priority: Normal
++
+# Get printOperation
+Namespace: microsoft.graph
++
+Retrieve the properties and relationships of a [printOperation](../resources/printoperation.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+The signed in user must be a [Printer Administrator](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#printer-administrator).
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Printer.Create, Printer.ReadWrite.All, Printer.FullControl.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| Not supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/operations/{printOperationId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and a [printOperation](../resources/printOperation.md) object (or a derivative of **printOperation**) in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_printoperation"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/operations/{printOperationId}
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printOperation"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/operations/$entity",
+ "@odata.type": "#microsoft.graph.printerCreateOperation",
+ "id": "81f4cca3-b3b7-47ea-9f88-7ddbf7208ef4",
+ "createdDateTime": "2020-06-15T22:27:03.031849Z",
+ "certificate": "{ceritificate}",
+ "status": {
+ "state": "succeeded",
+ "description": "The operation has completed successfully."
+ },
+ "printer": {
+ "registeredDateTime": "2020-06-15T22:27:12.0920077Z",
+ "isShared": false,
+ "id": "e56f9cdd-acec-486f-a05e-b622ff0bcc7d",
+ "displayName": "Test Printer",
+ "manufacturer": "Test Printer Manufacturer",
+ "model": "Test Printer Model",
+ "isAcceptingJobs": null,
+ "status": {
+ "state": "unknown",
+ "details": [],
+ "description": ""
+ },
+ "location": {
+ "latitude": null,
+ "longitude": null
+ }
+ }
+}
+```
+
v1.0 Printservice Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printservice-get.md
+
+ Title: Get printService
+description: Retrieve the properties and relationships of a print service.
+
+localization_priority: Normal
++
+# Get printService
+Namespace: microsoft.graph
++
+Retrieve the properties and relationships of a print service.
+
+## Permissions
+One of the **delegated** Universal Print [permissions](/graph/permissions-reference#universal-print-permissions) is required to call this API.
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/services/{printServiceId}
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [printService](../resources/printservice.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_printservice"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/services/{printServiceId}
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printService"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/services/$entity",
+ "id": "f4cfee8b-4117-4773-a2f0-3807beb282b9",
+ "endpoints": [
+ {
+ "id": "mpsdiscovery",
+ "displayName": "Microsoft Universal Print Discovery Service",
+ "uri": "https://discovery.print.microsoft.com"
+ }
+ ]
+}
+```
+
v1.0 Printservice List Endpoints https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printservice-list-endpoints.md
+
+ Title: List printServiceEndpoints
+description: Retrieve a list of endpoints exposed by a print service.
+
+localization_priority: Normal
++
+# List endpoints
+Namespace: microsoft.graph
++
+Retrieve a list of endpoints exposed by a print service.
+
+## Permissions
+One of the **delegated** Universal Print [permissions](/graph/permissions-reference#universal-print-permissions) is required to call this API.
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/services/{printServiceId}/endpoints
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [printServiceEndpoint](../resources/printserviceendpoint.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_printserviceendpoint"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/services/{printServiceId}/endpoints
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.printServiceEndpoint)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.printServiceEndpoint)",
+ "value": [
+ {
+ "id": "mpsdiscovery",
+ "displayName": "Microsoft Universal Print Discovery Service",
+ "uri": "https://discovery.print.microsoft.com"
+ }
+ ]
+}
+```
+
v1.0 Printserviceendpoint Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printserviceendpoint-get.md
+
+ Title: Get printServiceEndpoint
+description: Retrieve the properties and relationships of a print service endpoint.
+
+localization_priority: Normal
++
+# Get printServiceEndpoint
+Namespace: microsoft.graph
++
+Retrieve the properties and relationships of a print service endpoint.
+
+## Permissions
+One of the **delegated** Universal Print [permissions](/graph/permissions-reference#universal-print-permissions) is required to call this API.
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/services/{printServiceId}/endpoints/{printServiceEndpointId}
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [printServiceEndpoint](../resources/printserviceendpoint.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_printserviceendpoint"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/services/{printServiceId}/endpoints/{printServiceEndpointId}
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printServiceEndpoint"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.printServiceEndpoint)",
+ "id": "mpsdiscovery",
+ "displayName": "Microsoft Universal Print Discovery Service",
+ "uri": "https://discovery.print.microsoft.com"
+}
+```
+
v1.0 Printtask Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printtask-get.md
+
+ Title: Get task
+description: Get details about a print task.
+
+localization_priority: Normal
++
+# Get printTask
+Namespace: microsoft.graph
++
+Get details about a print task.
+
+For details about how to use this API to add pull printing support to Universal Print, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Not supported. |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| PrintTaskDefinition.ReadWrite.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/taskDefinitions/{taskDefinitionId}/tasks/{taskId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [printTask](../resources/printtask.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_printtask"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/taskDefinitions/{taskDefinitionId}/tasks/{taskId}
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printTask"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/taskDefinitions('3203656e-6069-4e10-8147-d25290b00a3c')/tasks/$entity",
+ "id": "d036638b-1272-4bba-9227-732463823ed3",
+ "parentUrl": "https://graph.microsoft.com/v1.0/print/printers/d5ef6ec4-07ca-4212-baf9-d45be126bfbb/jobs/44353",
+ "status": {
+ "state": "completed",
+ "description": "completed"
+ }
+}
+```
+
v1.0 Printtaskdefinition Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printtaskdefinition-get.md
+
+ Title: Get taskDefinition
+description: Get details about a task definition.
+
+localization_priority: Normal
++
+# Get printTaskDefinition
+
+Namespace: microsoft.graph
++
+Get details about a task definition.
+
+For details about how to use this API to add pull printing support to Universal Print, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Not supported. |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| PrintTaskDefinition.ReadWrite.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/taskDefinitions/{printTaskDefinitionId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [printTaskDefinition](../resources/printtaskdefinition.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_printtaskdefinition"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/taskDefinitions/{printTaskDefinitionId}
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printTaskDefinition"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/taskDefinitions/$entity",
+ "@odata.type": "#microsoft.graph.printTaskDefinition",
+ "id": "fab143fd-ee61-4358-8558-2c7dee953982",
+ "displayName": "Test TaskDefinitionName",
+ "createdBy": {
+ "appId": "815f204f-c791-4ee6-9098-614ecdb003f6",
+ "displayName": "Requesting App Display Name"
+ }
+}
+```
+
v1.0 Printtaskdefinition List Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printtaskdefinition-list-tasks.md
+
+ Title: List tasks
+description: Retrieve a list of task associated with a task definition.
+
+localization_priority: Normal
++
+# List tasks
+Namespace: microsoft.graph
++
+Retrieve a list of [tasks](../resources/printtask.md) associated with a [task definition](../resources/printtaskdefinition.md).
+
+For details about how to use this API to add pull printing support to Universal Print, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Not supported. |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| PrintTaskDefinition.ReadWrite.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/taskDefinitions/{taskDefinitionId}/tasks
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+### Exceptions
+Some operators are not supported: `$count`, `$format`, `$search`, `$select`, `$skip`, `$top`.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [printTask](../resources/printtask.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_printtask"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/taskDefinitions/{taskDefinitionId}/tasks
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.printTask)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.printTask)",
+ "value": [
+ {
+ "id": "d036638b-1272-4bba-9227-732463823ed3",
+ "parentUrl": "https://graph.microsoft.com/v1.0/print/printers/d5ef6ec4-07ca-4212-baf9-d45be126bfbb/jobs/44353",
+ "status": {
+ "state": "processing",
+ "description": "The task is being processed."
+ }
+ }
+ ]
+}
+```
+
v1.0 Printtaskdefinition Update Task https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printtaskdefinition-update-task.md
+
+ Title: Update task
+description: Update a print task.
+
+localization_priority: Normal
++
+# Update printTask
+Namespace: microsoft.graph
++
+Update a print task.
+
+For details about how to use this API to add pull printing support to Universal Print, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Not supported. |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application| PrintTaskDefinition.ReadWrite.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /print/taskDefinitions/{taskDefinitionId}/tasks/{taskId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, supply the values for the relevant [printTask](../resources/printtask.md) fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+
+| Property | Type | Description |
+|:-|:|:|
+|status|String|Include `state` and `description` values that describe the current state of the task.|
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [printTask](../resources/printtask.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "update_printtask"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/v1.0/print/taskDefinitions/{taskDefinitionId}/tasks/{taskId}
+Content-Type: application/json
+Content-length: 152
+
+{
+ "status": {
+ "state": "completed",
+ "description": "completed"
+ }
+}
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printTask"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "id": "d036638b-1272-4bba-9227-732463823ed3",
+ "parentUrl": "https://graph.microsoft.com/v1.0/print/printers/d5ef6ec4-07ca-4212-baf9-d45be126bfbb/jobs/44353",
+ "status": {
+ "state": "completed",
+ "description": "Task execution is completed."
+ }
+}
+```
+
v1.0 Printtasktrigger Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printtasktrigger-get.md
+
+ Title: Get taskTrigger
+description: Get a task trigger from a printer.
+
+localization_priority: Normal
++
+# Get printTaskTrigger
+
+Namespace: microsoft.graph
++
+Get a [task trigger](../resources/printtasktrigger.md) from a [printer](../resources/printer.md).
+
+For details about how to use this API to add pull printing support to Universal Print, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Printer.Read.All, Printer.ReadWrite.All, Printer.FullControl.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /print/printers/{printerId}/taskTriggers/{printTaskTriggerId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [printTaskTrigger](../resources/printtasktrigger.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_printtasktrigger"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/print/printers/{printerId}/taskTriggers/{printTaskTriggerId}
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printTaskTrigger"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers/taskTriggers/$entity",
+ "id": "b6a843ca-e60e-4e20-a222-a58d85eead6d",
+ "event": "jobStarted"
+}
+```
+
v1.0 Printusagebyprinter Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printusagebyprinter-get.md
+
+ Title: Get printUsageByPrinter
+description: Retrieve a printer's usage summary for a particular time period.
+
+localization_priority: Normal
++
+# Get printUsageByPrinter
+Namespace: microsoft.graph
++
+Retrieve a usage summary for a [printer](../resources/printer.md) for a particular time period. For descriptions of each of the endpoints, see [printUsageByPrinter](../resources/printUsageByPrinter.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Reports.Read.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /reports/dailyPrintUsageByPrinter/{id}
+GET /reports/monthlyPrintUsageByPrinter/{id}
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [printUsageByPrinter](../resources/printusagebyprinter.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_printusagebyprinter"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/reports/dailyPrintUsageByPrinter/{id}
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printUsageByPrinter"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "printerId": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "usageDate": "Date",
+ "completedBlackAndWhiteJobCount": 42,
+ "completedColorJobCount": 0,
+ "incompleteJobCount": 6
+}
+```
+
v1.0 Printusagebyuser Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/printusagebyuser-get.md
+
+ Title: Get printUsageByUser
+description: Retrieve a user's usage summary for a particular time period.
+
+localization_priority: Normal
++
+# Get printUsageByUser
+Namespace: microsoft.graph
++
+Retrieve a user's usage summary for a particular time period. For descriptions of each endpoint, see [printUsageByUser](../resources/printUsageByUser.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, in addition to the permissions listed in the following table.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Reports.Read.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /reports/dailyPrintUsageByUser/{id}
+GET /reports/monthlyPrintUsageByUser/{id}
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [printUsageByUser](../resources/printusagebyuser.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_printusagebyuser"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/reports/dailyPrintUsageByUser/{id}
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.printUsageByUser"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "userPrincipalName": "username@contoso.com",
+ "usageDate": "Date",
+ "completedBlackAndWhiteJobCount": 42,
+ "completedColorJobCount": 0,
+ "incompleteJobCount": 6
+}
+```
+
v1.0 Reportroot List Dailyprintusagebyprinter https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/reportroot-list-dailyprintusagebyprinter.md
+
+ Title: List dailyPrintUsageByPrinter
+description: Retrieve a list of daily print usage summaries, grouped by printer.
+
+localization_priority: Normal
++
+# List dailyPrintUsageByPrinter
+Namespace: microsoft.graph
++
+Retrieve a list of daily print usage summaries, grouped by [printer](../resources/printer.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Reports.Read.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /reports/dailyPrintUsageByPrinter
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [printUsageByPrinter](../resources/printusagebyprinter.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_printusagebyprinter"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/reports/dailyPrintUsageByPrinter
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.printUsageByPrinter)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "printerId": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "usageDate": "Date",
+ "completedBlackAndWhiteJobCount": 42,
+ "completedColorJobCount": 0,
+ "incompleteJobCount": 6
+ }
+ ]
+}
+```
+
v1.0 Reportroot List Dailyprintusagebyuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/reportroot-list-dailyprintusagebyuser.md
+
+ Title: List dailyPrintUsageByUser
+description: Retrieve a list of daily print usage summaries, grouped by user.
+
+localization_priority: Normal
++
+# List dailyPrintUsageByUser
+Namespace: microsoft.graph
++
+Retrieve a list of daily print usage summaries, grouped by user.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Reports.Read.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /reports/dailyPrintUsageByUser
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [printUsageByUser](../resources/printusagebyuser.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_printusagebyuser"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/reports/dailyPrintUsageByUser
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.printUsageByUser)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "userPrincipalName": "username@contoso.com",
+ "usageDate": "Date",
+ "completedBlackAndWhiteJobCount": 42,
+ "completedColorJobCount": 0,
+ "incompleteJobCount": 6
+ }
+ ]
+}
+```
+
v1.0 Reportroot List Monthlyprintusagebyprinter https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/reportroot-list-monthlyprintusagebyprinter.md
+
+ Title: List monthlyPrintUsageByPrinter
+description: Retrieve a list of monthly print usage summaries, grouped by printer.
+
+localization_priority: Normal
++
+# List monthlyPrintUsageByPrinter
+Namespace: microsoft.graph
++
+Retrieve a list of monthly print usage summaries, grouped by [printer](../resources/printer.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Reports.Read.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /reports/monthlyPrintUsageByPrinter
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [printUsageByPrinter](../resources/printusagebyprinter.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_printusagebyprinter"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/reports/monthlyPrintUsageByPrinter
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.printUsageByPrinter)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "printerId": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "usageDate": "Date",
+ "completedBlackAndWhiteJobCount": 42,
+ "completedColorJobCount": 0,
+ "incompleteJobCount": 6
+ }
+ ]
+}
+```
+
v1.0 Reportroot List Monthlyprintusagebyuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/reportroot-list-monthlyprintusagebyuser.md
+
+ Title: List monthlyPrintUsageByUser
+description: Retrieve a list of monthly print usage summaries, grouped by user.
+
+localization_priority: Normal
++
+# List monthlyPrintUsageByUser
+Namespace: microsoft.graph
++
+Retrieve a list of monthly print usage summaries, grouped by user.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Reports.Read.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /reports/monthlyPrintUsageByUser
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [printUsageByUser](../resources/printusagebyuser.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_printusagebyuser"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/reports/monthlyPrintUsageByUser
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.printUsageByUser)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "userPrincipalName": "username@contoso.com",
+ "usageDate": "Date",
+ "completedBlackAndWhiteJobCount": 42,
+ "completedColorJobCount": 0,
+ "incompleteJobCount": 6
+ }
+ ]
+}
+```
+
v1.0 Reports Getgrouparchivedprintjobs https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/reports-getgrouparchivedprintjobs.md
+
+ Title: "reports: getGroupArchivedPrintJobs"
+description: Get a list of archived print jobs for a particular group.
+
+localization_priority: Normal
++
+# reportRoot: getGroupArchivedPrintJobs
+Namespace: microsoft.graph
++
+Get a list of archived print jobs for a particular group.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Reports.Read.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /reports/getGroupArchivedPrintJobs
+```
+
+## Function parameters
+
+| Parameter | Type | Required? | Description |
+||-|--|-|
+| `groupId` | `Edm.String` | Yes | The ID of the group to return data for. |
+| `startDateTime` | `Edm.DateTimeOffset` | No | The start date (inclusive) for the time period to include data from. |
+| `endDateTime` | `Edm.DateTimeOffset` | No | The end date (inclusive) for the time period to include data from. |
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this function returns a `200 OK` response code and a [archivedPrintJob](../resources/archivedprintjob.md) collection in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "reports_getgrouparchivedprintjobs"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/reports/getGroupArchivedPrintJobs(groupId='{id}',startDateTime=<timestamp>,endDateTime=<timestamp>)
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.archivedPrintJob)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "printerId": "fe6ff85a-f0d3-4c4f-aec6-b9d5154356a1",
+ "createdBy": {},
+ "processingState": "completed"
+ }
+ ]
+}
+```
+
v1.0 Reports Getprinterarchivedprintjobs https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/reports-getprinterarchivedprintjobs.md
+
+ Title: "reports: getPrinterArchivedPrintJobs"
+description: Get a list of archived print jobs that were queued for particular printer.
+
+localization_priority: Normal
++
+# reportRoot: getPrinterArchivedPrintJobs
+Namespace: microsoft.graph
++
+Get a list of archived print jobs that were queued for particular [printer](../resources/printer.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Reports.Read.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /reports/getPrinterArchivedPrintJobs
+```
+
+## Function parameters
+
+| Parameter | Type | Required? | Description |
+||-|--|-|
+| `printerId` | `Edm.String` | Yes | The ID of the printer to return data for. |
+| `startDateTime` | `Edm.DateTimeOffset` | No | The start date (inclusive) for the time period to include data from. |
+| `endDateTime` | `Edm.DateTimeOffset` | No | The end date (inclusive) for the time period to include data from. |
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this function returns a `200 OK` response code and a [archivedPrintJob](../resources/archivedprintjob.md) collection in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "reportroot_getprinterarchivedprintjobs"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/reports/getPrinterArchivedPrintJobs(printerId='{id}',startDateTime=<timestamp>,endDateTime=<timestamp>)
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.archivedPrintJob)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "printerId": "fe6ff85a-f0d3-4c4f-aec6-b9d5154356a1",
+ "createdBy": {},
+ "processingState": "completed"
+ }
+ ]
+}
+```
+
v1.0 Reports Getuserarchivedprintjobs https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/reports-getuserarchivedprintjobs.md
+
+ Title: "reports: getUserArchivedPrintJobs"
+description: Get a list of archived print jobs for a particular user.
+
+localization_priority: Normal
++
+# reportRoot: getUserArchivedPrintJobs
+Namespace: microsoft.graph
++
+Get a list of archived print jobs for a particular user.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:--|
+|Delegated (work or school account)| Reports.Read.All |
+|Delegated (personal Microsoft account)|Not Supported.|
+|Application|Not Supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /reports/getUserArchivedPrintJobs
+```
+
+## Function Parameters
+
+| Parameter | Type | Required? | Description |
+||-|--|-|
+| `userId` | `Edm.String` | Yes | The ID of the user to return data for. |
+| `startDateTime` | `Edm.DateTimeOffset` | No | The start date (inclusive) for the time period to include data from. |
+| `endDateTime` | `Edm.DateTimeOffset` | No | The end date (inclusive) for the time period to include data from. |
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this function returns a `200 OK` response code and a [archivedPrintJob](../resources/archivedprintjob.md) collection in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "reportroot_getuserarchivedprintjobs"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/reports/getUserArchivedPrintJobs(userId='{id}',startDateTime=<timestamp>,endDateTime=<timestamp>)
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.archivedPrintJob)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
+ "printerId": "fe6ff85a-f0d3-4c4f-aec6-b9d5154356a1",
+ "createdBy": {},
+ "processingState": "completed"
+ }
+ ]
+}
+```
+
v1.0 Shiftpreferences Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/shiftpreferences-get.md
If successful, this method returns a `200 OK` response code and a [shiftPreferen
The following is an example of the request. -
-# [HTTP](#tab/http)
<!-- { "blockType": "request",
- "name": "shift-get"
+ "name": "get_shiftpreferences"
}-->
-```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/users/871dbd5c-3a6a-4392-bfe1-042452793a50/shiftPreferences
+```http
+GET https://graph.microsoft.com/v1.0/users/871dbd5c-3a6a-4392-bfe1-042452793a50/settings/shiftPreferences
```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
----- ### Response
v1.0 User List Calendars https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-list-calendars.md
GET /me/calendars
GET /users/{id | userPrincipalName}/calendars ```
-The user's calendars in the default [calendarGroup](../resources/calendargroup.md).
-```http
-GET /me/calendars
-GET /users/{id | userPrincipalName}/calendars
-```
- The user's calendars in a specific [calendarGroup](../resources/calendargroup.md). ```http GET /me/calendarGroups/{calendar_group_id}/calendars
v1.0 Link Validation Config.Json https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/config/link-validation-config.json a/api-reference/v1.0/config/link-validation-config.json
"/previous-versions", "/skypeforbusiness", "/sharepoint",
+ "/universal-print",
"/windows", "/windows-hardware" ]
v1.0 Archivedprintjob https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/archivedprintjob.md
+
+ Title: archivedPrintJob resource type
+description: A record of a "final state" (completed, aborted or failed) print job that is used for reporting purposes. This is not an active print job.
+
+localization_priority: Normal
++
+# archivedPrintJob resource type
+
+Namespace: microsoft.graph
+
+A record of a "final state" (completed, aborted or failed) print job that is used for reporting purposes. This is not an active print job.
+
+## Properties
+| Property | Type | Description |
+|:-|:|:|
+|id|String|The archived print job's GUID. Read-only.|
+|printerId|String|The printer ID that the job was queued for. Read-only.|
+|processingState|printJobProcessingState|The print job's final processing state. Read-only.|
+|createdDateTime|DateTimeOffset|The dateTimeOffset when the job was created. Read-only.|
+|acquiredDateTime|DateTimeOffset|The dateTimeOffset when the job was acquired by the printer, if any. Read-only.|
+|completionDateTime|DateTimeOffset|The dateTimeOffset when the job was completed, canceled or aborted. Read-only.|
+|acquiredByPrinter|Boolean|True if the job was acquired by a printer; false otherwise. Read-only.|
+|copiesPrinted|Int32|The number of copies that were printed. Read-only.|
+|createdBy|[userIdentity](useridentity.md)|The user who created the print job. Read-only.|
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [
+
+ ],
+ "@odata.type": "microsoft.graph.archivedPrintJob"
+}-->
+```json
+ {
+ "@odata.type": "#microsoft.graph.archivedPrintJob",
+ "id": "String (identifier)",
+ "printerId": "String",
+ "processingState": "String",
+ "createdDateTime": "String (timestamp)",
+ "acquiredDateTime": "String (timestamp)",
+ "completionDateTime": "String (timestamp)",
+ "acquiredByPrinter": "Boolean",
+ "copiesPrinted": "Integer",
+ "createdBy": {
+ "@odata.type": "microsoft.graph.userIdentity"
+ }
+}
+```
v1.0 Audioconferencing https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/audioconferencing.md
Represents phone access information for an [onlineMeeting](onlinemeeting.md).
| Property | Type | Description | |:--|:--|:-| | dialinUrl | String | A URL to the externally-accessible web page that contains dial-in information. |
-| ConferenceId | String | The conference id of the online meeting. |
+| conferenceId | String | The conference id of the online meeting. |
| tollFreeNumber | String | The toll-free number that connects to the Audio Conference Provider. | | tollNumber | String | The toll number that connects to the Audio Conference Provider. |
The following is a JSON representation of the resource.
```json { "dialinUrl": "String",
- "ConferenceId": "String",
+ "conferenceId": "String",
"tollFreeNumber": "String", "tollNumber": "String" }
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/enums.md
Possible values for user account types (group membership), per Windows definitio
| application | delegated | delegatedUserConsentable+
+### printColorMode values
+
+|Member|
+|:|
+|blackAndWhite|
+|grayscale|
+|color|
+|auto|
+|unknownFutureValue|
+
+### printDuplexMode values
+
+|Member|
+|:|
+|flipOnLongEdge|
+|flipOnShortEdge|
+|oneSided|
+|unknownFutureValue|
+
+### printerFeedOrientation values
+
+|Member|
+|:|
+|longEdgeFirst|
+|shortEdgeFirst|
+|unknownFutureValue|
+
+### printFinishing values
+
+|Member|
+|:|
+|none|
+|staple|
+|punch|
+|cover|
+|bind|
+|saddleStitch|
+|stitchEdge|
+|stapleTopLeft|
+|stapleBottomLeft|
+|stapleTopRight|
+|stapleBottomRight|
+|stitchLeftEdge|
+|stitchTopEdge|
+|stitchRightEdge|
+|stitchBottomEdge|
+|stapleDualLeft|
+|stapleDualTop|
+|stapleDualRight|
+|stapleDualBottom|
+|unknownFutureValue|
+
+### printMultipageLayout values
+
+|Member|
+|:|
+|clockwiseFromTopLeft|
+|counterclockwiseFromTopLeft|
+|counterclockwiseFromTopRight|
+|clockwiseFromTopRight|
+|counterclockwiseFromBottomLeft|
+|clockwiseFromBottomLeft|
+|counterclockwiseFromBottomRight|
+|clockwiseFromBottomRight|
+|unknownFutureValue|
+
+### printOrientation values
+
+|Member|
+|:|
+|portrait|
+|landscape|
+|reverseLandscape|
+|reversePortrait|
+|unknownFutureValue|
+
+### printQuality values
+
+|Member|
+|:|
+|low|
+|medium|
+|high|
+|unknownFutureValue|
+
+### printScaling values
+
+|Member|
+|:|
+|auto|
+|shrinkToFit|
+|fill|
+|fit|
+|none|
+|unknownFutureValue|
v1.0 Integerrange https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/integerrange.md
+
+ Title: integerRange resource type
+description: Represents an inclusive range of integers described by two Int64 boundaries.
+
+localization_priority: Normal
++
+# integerRange resource type
+
+Namespace: microsoft.graph
+
+Represents an inclusive range of integers described by two Int64 boundaries.
+
+## Properties
+| Property | Type | Description |
+|:-|:|:|
+|start|Int64|The inclusive lower bound of the integer range.|
+|end|Int64|The inclusive upper bound of the integer range.|
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.integerRange"
+}
+-->
+```json
+{
+ "start": 12345,
+ "end": 12345
+}
+```
v1.0 Onlinemeeting https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/onlinemeeting.md
Contains information about a meeting, including the URL used to join a meeting,
| :-- | :-- | :-- | | [Create onlineMeeting](../api/application-post-onlineMeetings.md) | [onlineMeeting](onlinemeeting.md) | Create an online meeting. | | [Get onlineMeeting](../api/onlinemeeting-get.md) | [onlineMeeting](onlinemeeting.md) | Read the properties and relationships of an **onlineMeeting** object. |
-| [Delete onlineMeeting](../api/onlinemeeting-delete.md) | None | Delete an online meeting. |
-| [Create or get onlineMeeting](../api/onlinemeeting-createorget.md) | [onlineMeeting](onlinemeeting.md) | Create an online meeting with a custom, external ID. If the meeting already exists, retrieve its properties. |
+| [Update](../api/onlinemeeting-update.md) | [onlineMeeting](onlinemeeting.md) | Update the properties of an **onlineMeeting** object. |
+| [Delete onlineMeeting](../api/onlinemeeting-delete.md) | None | Delete an **onlineMeeting** object. |
+| [Create or get onlineMeeting](../api/onlinemeeting-createorget.md) | [onlineMeeting](onlinemeeting.md) | Create an **onlineMeeting** object with a custom, external ID. If the meeting already exists, retrieve its properties. |
## Properties | Property | Type | Description | | :-- | :-- | :- |
+| allowedPresenters | onlineMeetingPresenters | Specifies who can be a presenter in a meeting. Possible values are listed in the following table. |
| audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for an online meeting. Read-only. | | chatInfo | [chatInfo](chatinfo.md) | The chat information associated with this online meeting. | | creationDateTime | DateTime | The meeting creation time in UTC. Read-only. |
-| startDateTime | DateTime | The meeting start time in UTC. |
| endDateTime | DateTime | The meeting end time in UTC. | | id | String | The default ID associated with the online meeting. Read-only. |
+| isEntryExitAnnounced | Boolean | Whether or not to announce when callers join or leave. |
+| joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in the `Accept-Language` request HTTP header. Read-only. |
| joinWebUrl | String | The join URL of the online meeting. Read-only. |
+| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. |
| participants | [meetingParticipants](meetingparticipants.md) | The participants associated with the online meeting. This includes the organizer and the attendees. |
+| startDateTime | DateTime | The meeting start time in UTC. |
| subject | String | The subject of the online meeting. | | videoTeleconferenceId | String | The video teleconferencing ID. Read-only. |
-| joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in the `Accept-Language` request HTTP header. Read-only. |
-| isEntryExitAnnounced | Boolean | Whether or not to announce when callers join or leave. |
-| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. |
-| allowedPresenters | onlineMeetingPresenters | Specifies who can be a presenter in a meeting. Possible values are listed in the following table. |
### onlineMeetingPresenters values
Contains information about a meeting, including the URL used to join a meeting,
}--> ```json {
- "audioConferencing": {"@odata.type": "#microsoft.graph.audioConferencing"},
- "chatInfo": {"@odata.type": "#microsoft.graph.chatInfo"},
+ "audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"},
+ "chatInfo": {"@odata.type": "microsoft.graph.chatInfo"},
"creationDateTime": "String (timestamp)", "endDateTime": "String (timestamp)", "id": "String (identifier)", "joinWebUrl": "String",
- "participants": {"@odata.type": "#microsoft.graph.meetingParticipants"},
+ "participants": {"@odata.type": "microsoft.graph.meetingParticipants"},
"startDateTime": "String (timestamp)", "subject": "String", "videoTeleconferenceId": "String", "isEntryExitAnnounced": "Boolean",
- "lobbyBypassSettings": {"@odata.type": "#microsoft.graph.lobbyBypassSettings"},
+ "lobbyBypassSettings": {"@odata.type": "microsoft.graph.lobbyBypassSettings"},
"allowedPresenters": "String" } ```
v1.0 Print https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/print.md
+
+ Title: print resource type
+description: When accompanied by a Universal Print subscription, the Print feature enables management of printers and discovery of printServiceEndpoints that can be used to manage printers and print jobs within Universal Print.
+
+localization_priority: Normal
++
+# print resource type
+
+Namespace: microsoft.graph
++
+When accompanied by a Universal Print subscription, the Print feature enables management of printers and discovery of [printServiceEndpoints](printserviceendpoint.md) that can be used to manage printers and print jobs within Universal Print.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+| [List connectors](../api/print-list-connectors.md) | [printConnector](printconnector.md) collection | Get a list of print connectors. |
+| [List printers](../api/print-list-printers.md) | [printer](printer.md) collection | Get a list of printers. |
+| [List shares](../api/print-list-shares.md) | [printerShare](printershare.md) collection | Get a list of printer shares. |
+| [List services](../api/print-list-services.md) | [printService](printservice.md) collection | Get a list of services. |
+| [Create printerShare](../api/print-post-shares.md) | [printerShare](printershare.md) | Create a new printer share by posting to the **shares** collection. |
+| [Create printer](../api/printer-create.md) | [printerCreateOperation](printerCreateOperation.md) | Create (register) a new printer with Universal Print. |
+| [Update settings](../api/print-update-settings.md) | [printSettings](printsettings.md) | Updates tenant-wide settings for the Universal Print service. |
+| [List taskDefinitions](../api/print-list-taskdefinitions.md) | [printTaskDefinition](printtaskdefinition.md) collection | Get a tenant-wide list of printTaskDefinitions created within Universal Print. |
+| [Create taskDefinition](../api/print-post-taskdefinitions.md) | [printTaskDefinition](printtaskdefinition.md) | Create a new printTaskDefinition. |
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|settings|[printSettings](../resources/printsettings.md)|Tenant-wide settings for the Universal Print service.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|services|[printService](printservice.md) collection|The list of available Universal Print service endpoints.|
+|printers|[printer](printer.md) collection|The list of printers registered in the tenant.|
+|shares|[printerShare](printershare.md) collection|The list of printer shares registered in the tenant.|
+|connectors|[printConnector](printconnector.md) collection|The list of available print connectors.|
+|operations|[printOperation](../resources/printoperation.md) collection|The list of print long running operations.|
+|services|[printService](../resources/printservice.md) collection|The list of print service instances for various components of the printing infrastructure.|
+|taskDefinitions|[printTaskDefinition](../resources/printtaskdefinition.md) collection|List of abstract definition for a task that can be triggered when various events occur within Universal Print.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.print",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.print",
+ "settings": {
+ "@odata.type": "microsoft.graph.printSettings"
+ }
+}
+```
+
v1.0 Printcertificatesigningrequest https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printcertificatesigningrequest.md
+
+ Title: printCertificateSigningRequest resource type
+description: The certificate signing request (CSR) to be used during registration of a printer with the Universal Print service.
+
+localization_priority: Normal
+
+# printCertificateSigningRequest resource type
+
+Namespace: microsoft.graph
++
+The certificate signing request (CSR) to be used during registration of a printer with the Universal Print service.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|content|String|A base64-encoded pkcs10 certificate request. Read-only.|
+|transportKey|String|The base64-encoded public portion of an asymmetric key that is generated by the client. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.printCertificateSigningRequest"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printCertificateSigningRequest",
+ "content": "String",
+ "transportKey": "String"
+}
+```
+
v1.0 Printconnector https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printconnector.md
+
+ Title: printConnector resource type
+description: Represents a print connector that has been registered by using a Universal Print subscription. The printConnector resource can be used to view connector status and update properties.
+
+localization_priority: Normal
++
+# printConnector resource type
+
+Namespace: microsoft.graph
++
+Represents a print connector that has been registered by using a Universal Print subscription. The printConnector resource can be used to view connector status and update properties.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+| [Get connector](../api/printconnector-get.md) | [printConnector](printconnector.md) | Read the properties and relationships of the connector object. |
+| [Update connector](../api/printconnector-update.md) | [printConnector](printconnector.md) | Update the connector object. |
+| [Delete connector](../api/printconnector-delete.md) | None | Unregister the connector from the Universal Print service. |
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String| Read-only.|
+|displayName|String|The name of the connector.|
+|fullyQualifiedDomainName|String|The connector machine's hostname.|
+|operatingSystem|String|The connector machine's operating system version.|
+|appVersion|String|The connector's version.|
+|location|[printerLocation](printerlocation.md)|The physical and/or organizational location of the connector.|
+|registeredDateTime|DateTimeOffset|The DateTimeOffset when the connector was registered.|
+|registeredBy|[userIdentity](useridentity.md)|The user who registered the connector.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.printConnector",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printConnector",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "fullyQualifiedDomainName": "String",
+ "operatingSystem": "String",
+ "appVersion": "String",
+ "location": {
+ "@odata.type": "microsoft.graph.printerLocation"
+ },
+ "registeredDateTime": "String (timestamp)"
+}
+```
v1.0 Printdocument https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printdocument.md
+
+ Title: printDocument resource type
+description: Represents a document being printed.
+
+localization_priority: Normal
++
+# printDocument resource type
+
+Namespace: microsoft.graph
++
+Represents a document being printed.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+| [Create upload session](../api/printdocument-createuploadsession.md) | [uploadSession](uploadsession.md) | Create an upload session to iteratively upload ranges of binary file of the **printDocument**. |
+| [Download binary file](../api/printdocument-get-file.md) | Download Url | Download the binary file associated with the **printDocument**. |
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The document's identifier. Read-only.|
+|displayName|String|The document's name. Read-only.|
+|contentType|String|The document's content (MIME) type. Read-only.|
+|size|Int64|The document's size in bytes. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.printDocument",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printDocument",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "contentType": "String",
+ "size": "Integer"
+}
+```
v1.0 Printdocumentuploadproperties https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printdocumentuploadproperties.md
++
+description: "Represents information for print document upload"
+ Title: "printDocumentUploadProperties resource type"
+localization_priority: Normal
++
+# printDocumentUploadProperties resource type
+
+Namespace: microsoft.graph
++
+Describes the document that is being uploaded
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|contentType|String|The document's content (MIME) type.|
+|documentName|String|The document's name.|
+|size|Int64|The document's size in bytes.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.printDocumentUploadProperties"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printDocumentUploadProperties",
+ "contentType": "String",
+ "documentName": "String",
+ "size": "Integer"
+}
+```
+
v1.0 Printer https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printer.md
+
+ Title: printer resource type
+description: Represents a physical printer device that has been registered with the Universal Print service. Printer resources can be used to manage print jobs, printer settings, printer metadata and registration status.
+
+localization_priority: Normal
++
+# printer resource type
+
+Namespace: microsoft.graph
++
+Represents a printer device that has been registered with the Universal Print service. Printer resources can be used to manage print jobs, printer settings, printer metadata and registration status.
+
+This resource supports:
+* [Subscribing to change notifications](/graph/universal-print-webhook-notifications).
+
+Inherits from [printerBase](../resources/printerbase.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+| [Create](../api/printer-create.md) | [printerCreateOperation](printerCreateOperation.md) | Create (register) a new printer with Universal Print. |
+| [Get](../api/printer-get.md) | [printer](printer.md) | Read the properties and relationships of the printer object. |
+| [Update](../api/printer-update.md) | [printer](printer.md) | Update the printer object. |
+| [Delete](../api/printer-delete.md) | None | Unregister the physical printer from the Universal Print service. |
+| [restoreFactoryDefaults](../api/printer-restorefactorydefaults.md) | None | Restore a printer's default settings to the values specified by the manufacturer. |
+| [List jobs](../api/printer-list-jobs.md) | [printJob](printjob.md) collection | Get a list of print jobs that are queued for processing by the printer. |
+| [Create job](../api/printer-post-jobs.md) | [printJob](printjob.md) | Create a new print job for the printer. To start printing the job, use [start](../api/printjob-start.md). |
+| [List connectors](../api/printer-list-connectors.md) | [printConnector](printconnector.md) collection | Get a list of connectors that this printer is associated with. |
+| [List shares](../api/printer-list-shares.md) | [printerShare](printerShare.md) collection | Get a list of printerShares that this printer is associated with. Currently, only one printerShare can be associated with a printer. |
+| [List taskTriggers](../api/printer-list-tasktriggers.md) | None | List [printTaskTriggers](printtasktrigger.md) associated with this printer. |
+| [Create taskTrigger](../api/printer-post-tasktriggers.md) | [printTaskTrigger](printtasktrigger.md) | Create a [printTaskTrigger](printtasktrigger.md) that runs when print events occur. |
+| [Delete taskTrigger](../api/printer-delete-tasktrigger.md) | None | Delete a [printTaskTrigger](printtasktrigger.md) that is associated with the printer. |
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The document's identifier. Inherited from [printerBase](../resources/printerbase.md). Read-only.|
+|displayName|String|The name of the printer. Inherited from [printerBase](../resources/printerbase.md).|
+|manufacturer|String|The manufacturer reported by the printer. Inherited from [printerBase](../resources/printerbase.md).|
+|model|String|The model name reported by the printer. Inherited from [printerBase](../resources/printerbase.md).|
+|registeredDateTime|DateTimeOffset|The DateTimeOffset when the printer was registered. Read-only.|
+|status|[printerStatus](printerstatus.md)|The processing status of the printer, including any errors. Inherited from [printerBase](../resources/printerbase.md).|
+|isShared|Boolean|True if the printer is shared; false otherwise. Read-only.|
+|hasPhysicalDevice|Boolean|True if the printer has a physical device for printing. Read-only.|
+|isAcceptingJobs|Boolean|Whether the printer is currently accepting new print jobs. Inherited from [printerBase](../resources/printerbase.md).|
+|location|[printerLocation](printerlocation.md)|The physical and/or organizational location of the printer. Inherited from [printerBase](../resources/printerbase.md).|
+|defaults|[printerDefaults](printerdefaults.md)|The printer's default print settings. Inherited from [printerBase](../resources/printerbase.md).|
+|capabilities|[printerCapabilities](printercapabilities.md)|The capabilities of the printer associated with this printer share. Inherited from [printerBase](../resources/printerbase.md).|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|jobs|[printJob](printjob.md) collection| The list of jobs that are queued for printing by the printer. Inherited from [printerBase](../resources/printerbase.md).|
+|shares|[printerShare](printershare.md) collection| The list of printerShares that are associated with the printer. Currently, only one printerShare can be associated with the printer. Read-only. Nullable.|
+|connectors|[printConnector](printconnector.md)|The connectors that are associated with the printer.|
+|taskTriggers|[printTaskTrigger](printtasktrigger.md) collection|A list of task triggers that are associated with the printer.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.printer",
+ "baseType": "microsoft.graph.printerBase",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printer",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "manufacturer": "String",
+ "model": "String",
+ "isAcceptingJobs": "Boolean",
+ "defaults": {
+ "@odata.type": "microsoft.graph.printerDefaults"
+ },
+ "location": {
+ "@odata.type": "microsoft.graph.printerLocation"
+ },
+ "capabilities": {
+ "@odata.type": "microsoft.graph.printerCapabilities"
+ },
+ "status": {
+ "@odata.type": "microsoft.graph.printerStatus"
+ },
+ "registeredDateTime": "String (timestamp)",
+ "isShared": "Boolean",
+ "hasPhysicalDevice": "Boolean"
+}
+```
+
v1.0 Printerbase https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printerbase.md
+
+ Title: printerBase resource type
+description: Represents base type for printer and printer share
+
+localization_priority: Normal
+
+# printerBase resource type
+
+Namespace: microsoft.graph
++
+Represents a base type for [printer](printer.md) and [printerShare](printerShare.md) entity types.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|capabilities|[printerCapabilities](printercapabilities.md)|The capabilities of the printer/printerShare.|
+|defaults|[printerDefaults](printerdefaults.md)|The default print settings of printer/printerShare.|
+|displayName|String|The name of the printer/printerShare.|
+|id|String|The identifier.|
+|isAcceptingJobs|Boolean|Whether the printer/printerShare is currently accepting new print jobs.|
+|location|[printerLocation](printerlocation.md)|The physical and/or organizational location of the printer/printerShare.|
+|manufacturer|String|The manufacturer of the printer/printerShare.|
+|model|String|The model name of the printer/printerShare.|
+|status|[printerStatus](printerstatus.md)|The processing status of the printer/printerShare, including any errors.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|jobs|[printJob](printjob.md) collection|The list of jobs that are queued for printing by the printer/printerShare.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.printerBase",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printerBase",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "manufacturer": "String",
+ "model": "String",
+ "isAcceptingJobs": "Boolean",
+ "defaults": {
+ "@odata.type": "microsoft.graph.printerDefaults"
+ },
+ "location": {
+ "@odata.type": "microsoft.graph.printerLocation"
+ },
+ "capabilities": {
+ "@odata.type": "microsoft.graph.printerCapabilities"
+ },
+ "status": {
+ "@odata.type": "microsoft.graph.printerStatus"
+ }
+}
+```
+
v1.0 Printercapabilities https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printercapabilities.md
+
+ Title: printerCapabilities complex type
+description: Represents the capabilities reported by a printer.
+
+localization_priority: Normal
++
+# printerCapabilities resource type
+
+Namespace: microsoft.graph
++
+Represents the capabilities reported by a printer/printerShare.
+
+## Properties
+| Property | Type | Description |
+|:-|:|:|
+|contentTypes|String collection|A list of supported content (MIME) types that the printer supports. It is not guaranteed that the Universal Print service supports printing all of these MIME types.|
+|isColorPrintingSupported|Boolean|True if color printing is supported by the printer; false otherwise. Read-only.|
+|feedOrientations|printerFeedOrientation collection|The list of feed orientations that are supported by the printer.|
+|isPageRangeSupported|Boolean|True if the printer supports printing by page ranges; false otherwise.|
+|qualities|[printQuality](enums.md#printquality-values) collection|The print qualities supported by the printer.|
+|dpis|Int32 collection|The list of print resolutions in DPI that are supported by the printer.|
+|duplexModes|[printDuplexMode](enums.md#printduplexmode-values) collection|The list of duplex modes that are supported by the printer. Valid values are described in the following table.|
+|queueBufferSizeInBytes|Int32|The maximum print job queue size that can be stored by the printer.|
+|copiesPerJob|[integerRange](integerrange.md)|The range of copies per job supported by the printer.|
+|finishings|[printFinishing](enums.md#printfinishing-values) collection|Finishing processes the printer supports for a printed document.|
+|mediaColors|String collection|The media (i.e., paper) colors supported by the printer.|
+|mediaTypes|String collection|The media types supported by the printer. Valid values are described in the following table.|
+|mediaSizes|String collection|The media sizes supported by the printer. Supports standard size names for ISO and ANSI media sizes, along with any custom sizes supported by the associated printer.|
+|pagesPerSheet|Int32 collection|Supported number of Input Pages to impose upon a single Impression.|
+|orientations|[printOrientation](enums.md#printorientation-values) collection|The print orientations supported by the printer. Valid values are described in the following table.|
+|inputBins|String collection|Supported input bins for the printer.|
+|outputBins|String collection|The printer's supported output bins (trays).|
+|supportsFitPdfToPage|Boolean|True if the printer supports scaling PDF pages to match the print media size; false otherwise.|
+|multipageLayouts|[printMultipageLayout](enums.md#printmultipagelayout-values) collection|The presentation directions supported by the printer. Supported values are described in the following table.|
+|colorModes|[printColorMode](enums.md#printcolormode-values) collection|The color modes supported by the printer. Valid values are described in the following table.|
+|topMargins|Int32 collection|A list of supported top margins(in microns) for the printer.|
+|bottomMargins|Int32 collection|A list of supported bottom margins(in microns) for the printer.|
+|rightMargins|Int32 collection|A list of supported right margins(in microns) for the printer.|
+|leftMargins|Int32 collection|A list of supported left margins(in microns) for the printer.|
+|collation|Boolean|True if the printer supports collating when printing muliple copies of a multi-page document; false otherwise.|
+|scalings|[printScaling](enums.md#printscaling-values) collection|Supported print scalings.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.printerCapabilities"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printerCapabilities",
+ "contentTypes": [
+ "String"
+ ],
+ "isColorPrintingSupported": "Boolean",
+ "feedOrientations": [
+ "String"
+ ],
+ "isPageRangeSupported": "Boolean",
+ "qualities": [
+ "String"
+ ],
+ "dpis": [
+ "Integer"
+ ],
+ "duplexModes": [
+ "String"
+ ],
+ "copiesPerJob": {
+ "@odata.type": "microsoft.graph.integerRange"
+ },
+ "finishings": [
+ "String"
+ ],
+ "mediaColors": [
+ "String"
+ ],
+ "mediaTypes": [
+ "String"
+ ],
+ "mediaSizes": [
+ "String"
+ ],
+ "pagesPerSheet": [
+ "Integer"
+ ],
+ "orientations": [
+ "String"
+ ],
+ "outputBins": [
+ "String"
+ ],
+ "supportsFitPdfToPage": "Boolean",
+ "multipageLayouts": [
+ "String"
+ ],
+ "colorModes": [
+ "String"
+ ],
+ "inputBins": [
+ "String"
+ ],
+ "topMargins": [
+ "Integer"
+ ],
+ "bottomMargins": [
+ "Integer"
+ ],
+ "rightMargins": [
+ "Integer"
+ ],
+ "leftMargins": [
+ "Integer"
+ ],
+ "collation": "Boolean",
+ "scalings": [
+ "String"
+ ]
+}
+```
+
v1.0 Printercreateoperation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printercreateoperation.md
+
+ Title: printerCreateOperation resource type
+description: Represents a long-running printer registration operation. Derived from printOperation.
+
+localization_priority: Normal
++
+# printerCreateOperation resource type
+
+Namespace: microsoft.graph
++
+Represents a long-running printer registration operation. Derived from [printOperation](printoperation.md).
+
+Inherits from [printOperation](printoperation.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+| [Get operation](../api/printoperation-get.md) | [printOperation](printoperation.md) | Retrieve a long-running operation within current user or app's tenant. |
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The operation's identifier. Read-only.|
+|status|[printOperationStatus](printoperationstatus.md)|The status of the registration operation. Contains the operation's progress and whether it completed successfully. Read-only.|
+|createdDateTime|DateTimeOffset|The DateTimeOffset when the operation was created. Read-only.|
+|certificate|String|The signed certificate created during the registration process. Read-only.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|printer|[printer](printer.md)|The created printer entity. Read-only.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.printerCreateOperation",
+ "baseType": "microsoft.graph.printOperation",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printerCreateOperation",
+ "id": "String (identifier)",
+ "status": {
+ "@odata.type": "microsoft.graph.printOperationStatus"
+ },
+ "createdDateTime": "String (timestamp)",
+ "certificate": "String"
+}
+```
+
v1.0 Printerdefaults https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printerdefaults.md
+
+ Title: printerDefaults resource type
+description: Represents the printer's default settings. Check the printer's capabilities to see all the values that it supports.
+
+localization_priority: Normal
++
+# printerDefaults resource type
+
+Namespace: microsoft.graph
++
+Represents the printer's default settings. Check the printer's [capabilities](printercapabilities.md) to see all the values that it supports.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|copiesPerJob|Int32|The default number of copies printed per job.|
+|contentType|String|The default content (MIME) type to use when processing documents.|
+|finishings|[printFinishing](enums.md#printfinishing-values) collection|The default set of finishings to apply to print jobs. Valid values are described in the following table.|
+|mediaColor|String|The default media (such as paper) color to print the document on.
+|mediaType|String|The default media (such as paper) type to print the document on. Valid values are described in the following table.|
+|mediaSize|String|The default media size to use. Supports standard size names for ISO and ANSI media sizes, along with any custom sizes supported by the associated printer.
+|pagesPerSheet|Int32|The default number of document pages to print on each sheet.
+|orientation|[printOrientation](enums.md#printorientation-values)|The default orientation to use when printing the document. Valid values are described in the following table.|
+|outputBin|String|The default output bin to place completed prints into. See the printer's [capabilities](printercapabilities.md) for a list of supported output bins.|
+|fitPdfToPage|Boolean|The default fitPdfToPage setting. True to fit each page of a PDF document to a physical sheet of media; false to let the printer decide how to lay out impressions.|
+|multipageLayout|[printMultipageLayout](enums.md#printmultipagelayout-values)|The default direction to lay out pages when multiple pages are being printed per sheet. Valid values are described in the following table.|
+|colorMode|[printColorMode](enums.md#printcolormode-values)|The default color mode to use when printing the document. Valid values are described in the following table.|
+|quality|[printQuality](enums.md#printquality-values)|The default quality to use when printing the document. Valid values are described in the following table.|
+|duplexMode|[printDuplexMode](enums.md#printduplexmode-values)|The default duplex (double-sided) configuration to use when printing a document. Valid values are described in the following table.|
+|dpi|Int32|The default resolution in DPI to use when printing the job.|
+|scaling|[printScaling](enums.md#printscaling-values)|Specifies how the printer scales the document data to fit the requested media. Valid values are described in the following table.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.printerDefaults"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printerDefaults",
+ "copiesPerJob": "Integer",
+ "contentType": "String",
+ "finishings": [
+ "String"
+ ],
+ "mediaColor": "String",
+ "mediaType": "String",
+ "mediaSize": "String",
+ "pagesPerSheet": "Integer",
+ "orientation": "String",
+ "outputBin": "String",
+ "inputBin": "String",
+ "fitPdfToPage": "Boolean",
+ "multipageLayout": "String",
+ "colorMode": "String",
+ "quality": "String",
+ "duplexMode": "String",
+ "dpi": "Integer",
+ "scaling": "String"
+}
+```
+
v1.0 Printerlocation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printerlocation.md
+
+ Title: printerLocation resource type
+description: Represents the physical and hierarchical location of a printer.
+
+localization_priority: Normal
++
+# printerLocation resource type
+
+Namespace: microsoft.graph
++
+Represents the physical and hierarchical location of a printer.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|latitude|Double|The latitude that the printer is located at.|
+|longitude|Double|The longitude that the printer is located at.|
+|altitudeInMeters|Int32|The altitude, in meters, that the printer is located at.|
+|streetAddress|String|The street address where the printer is located.|
+|subUnit|String collection|The subunit hierarchy where the printer is located. The elements should be in hierarchical order. For example, if a campus is divided into different sections, the hierarchy might look like this: `["East Wing", "Block A"]`|
+|city|String|The city that the printer is located in.|
+|postalCode|String|The postal code that the printer is located in.|
+|countryOrRegion|String|The country or region that the printer is located in.|
+|site|String|The site that the printer is located in.|
+|building|String|The building that the printer is located in.|
+|floor|String|The floor that the printer is located on. Only numerical values are supported right now.|
+|floorDescription|String|The description of the floor that the printer is located on.|
+|roomName|String|The room that the printer is located in. Only numerical values are supported right now.|
+|roomDescription|String|The description of the room that the printer is located in.|
+|organization|String collection|The organizational hierarchy that the printer belongs to. The elements should be in hierarchical order.|
+|subdivision|String collection|The subdivision that the printer is located in. The elements should be in hierarchical order.|
+|stateOrProvince|String|The state or province that the printer is located in.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.printerLocation"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printerLocation",
+ "latitude": "Double",
+ "longitude": "Double",
+ "altitudeInMeters": "Integer",
+ "streetAddress": "String",
+ "subunit": [
+ "String"
+ ],
+ "city": "String",
+ "postalCode": "String",
+ "countryOrRegion": "String",
+ "site": "String",
+ "building": "String",
+ "floor": "String",
+ "floorDescription": "String",
+ "roomName": "String",
+ "roomDescription": "String",
+ "organization": [
+ "String"
+ ],
+ "subdivision": [
+ "String"
+ ],
+ "stateOrProvince": "String"
+}
+```
+
v1.0 Printershare https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printershare.md
+
+ Title: printerShare resource type
+description: Represents a printer that is intended to be discoverable by users and printing applications.
+
+localization_priority: Normal
++
+# printerShare resource type
+
+Namespace: microsoft.graph
++
+Represents a printer that is intended to be discoverable by users and printing applications.
+
+Inherits from [printerBase](../resources/printerbase.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+| [List](../api/print-list-shares.md) | [printerShare](printershare.md) collection | Get a list of printer shares in the tenant. |
+| [Get](../api/printershare-get.md) | [printerShare](printershare.md) | Read properties and relationships of a **printerShare** object. |
+| [Update](../api/printershare-update.md) | [printerShare](printershare.md) | Update a **printerShare** object. |
+| [Delete](../api/printershare-delete.md) | None | Unshare a printer. |
+| [List jobs](../api/printershare-list-jobs.md) | [printJob](printjob.md) collection | Get a list of print jobs that are queued for processing by the printerShare. |
+| [Create job](../api/printershare-post-jobs.md) | [printJob](printjob.md) | Create a new print job for the printerShare. To start printing the job, use [start](../api/printjob-start.md). |
+| [List allowedUsers](../api/printershare-list-allowedusers.md) | [user](user.md) collection | Retrieve a list of users who have been granted access to submit print jobs to the associated printer share. |
+| [Add allowedUser](../api/printershare-post-allowedusers.md) | None | Grant the specified user access to submit print jobs to the associated printer share. |
+| [Remove allowedUser](../api/printershare-delete-alloweduser.md) | None | Revoke printer share access from the specified user. |
+| [List allowedGroups](../api/printershare-list-allowedgroups.md) | [group](group.md) collection | Retrieve a list of groups that have been granted access to submit print jobs to the associated printer share. |
+| [Add allowedGroup](../api/printershare-post-allowedgroups.md) | None | Grant the specified group access to submit print jobs to the associated printer share. |
+| [Remove allowedGroup](../api/printershare-delete-allowedgroup.md) | None | Revoke printer share access from the specified group. |
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String| The printerShare's identifier. Inherited from [printerBase](../resources/printerbase.md). Read-only.|
+|displayName|String|The name of the printer share that print clients should display. Inherited from [printerBase](../resources/printerbase.md).|
+|createdDateTime|DateTimeOffset|The DateTimeOffset when the printer share was created. Read-only.|
+|manufacturer|String|The manufacturer reported by the printer associated with this printer share. Inherited from [printerBase](../resources/printerbase.md). Read-only.|
+|model|String|The model name reported by the printer associated with this printer share. Inherited from [printerBase](../resources/printerbase.md). Read-only.|
+|isAcceptingJobs|Boolean|Whether the printer associated with this printer share is currently accepting new print jobs. Inherited from [printerBase](../resources/printerbase.md).|
+|defaults|[printerDefaults](printerdefaults.md)|The default print settings of the printer associated with this printer share. Inherited from [printerBase](../resources/printerbase.md).|
+|capabilities|[printerCapabilities](printercapabilities.md)|The capabilities of the printer associated with this printer share. Inherited from [printerBase](../resources/printerbase.md).|
+|location|[printerLocation](printerlocation.md)|The physical and/or organizational location of the printer associated with this printer share. Inherited from [printerBase](../resources/printerbase.md).|
+|status|[printerStatus](printerstatus.md)|The processing status, including any errors, of the printer associated with this printer share.Inherited from [printerBase](../resources/printerbase.md). Read-only.|
+|allowAllUsers|Boolean|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.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|printer|[printer](printer.md)|The printer that this printer share is related to. |
+|allowedUsers|[user](user.md) collection|The users who have access to print using the printer.|
+|allowedGroups|[group](group.md)|The groups whose users have access to print using the printer.|
+|jobs|[printJob](printjob.md) collection| The list of jobs that are queued for printing by the printer associated with this printer share.|
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.printerShare",
+ "baseType": "microsoft.graph.printerBase",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printerShare",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "manufacturer": "String",
+ "model": "String",
+ "isAcceptingJobs": "Boolean",
+ "defaults": {
+ "@odata.type": "microsoft.graph.printerDefaults"
+ },
+ "location": {
+ "@odata.type": "microsoft.graph.printerLocation"
+ },
+ "capabilities": {
+ "@odata.type": "microsoft.graph.printerCapabilities"
+ },
+ "status": {
+ "@odata.type": "microsoft.graph.printerStatus"
+ },
+ "allowAllUsers": "Boolean",
+ "createdDateTime": "String (timestamp)"
+}
+```
+
v1.0 Printerstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printerstatus.md
+
+ Title: printerStatus resource type
+description: Represents the processing status of the printer, including any errors.
+
+localization_priority: Normal
++
+# printerStatus resource type
+
+Namespace: microsoft.graph
++
+Represents the processing status of the printer, including any errors.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|state|printerProcessingState|The current processing state. Valid values are described in the following table. Read-only.|
+|details|printerProcessingStateDetail collection|The list of details describing why the printer is in the current state. Valid values are described in the following table. Read-only.|
+|description|String|A human-readable description of the printer's current processing state. Read-only.|
+
+### printerProcessingState values
+
+|Member|Value|Description|
+|:|:|:|
+|unknown|0|The processing state reported by the printer is unknown.|
+|idle|1|The printer is idle and ready to accept new print jobs.|
+|processing|2|The printer is currently processing a print job and will process any pending jobs upon completion.|
+|stopped|3|The printer encountered an issue (for example, ran out of paper in the active tray) and cannot continue the current print job until the issue is addressed. See the **details** value(s) or the **description** value for more information.|
+|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.|
+
+### printerProcessingStateDetail values
+
+|Member|Value|Description|
+|:|:|:|
+|paused|0| An ongoing print job was paused.|
+|mediaJam|2|Media in one or more trays is jammed.|
+|mediaNeeded|3|Media in the currently-used input tray needs to be replaced before the job can continue.|
+|mediaLow|4|Media in one or more trays is almost exhausted.|
+|mediaEmpty|5|Media in one or more trays is exhausted.|
+|coverOpen|6|One or more covers are open.|
+|interlockOpen|7|One or more interlock devices are open.|
+|outputTrayMissing|9|One or more output trays are missing.|
+|outputAreaFull|10|One or more output trays are full and cannot accept more media.|
+|markerSupplyLow|11|One or more marker sources (for example, ink, toner or ribbon) are low.|
+|markerSupplyEmpty|12|One or more marker sources (for example, ink, toner or ribbon) are exhausted.|
+|inputTrayMissing|13|One or more input trays are not in the device.|
+|outputAreaAlmostFull|14|One or more output area is almost full (for example, tray, stacker, collator).|
+|markerWasteAlmostFull|15|The device marker supply waste receptacle is almost full.|
+|markerWasteFull|16|The device marker supply waste receptacle is full.|
+|fuserOverTemp|17|The fuser temperature is above normal.|
+|fuserUnderTemp|18|The fuser temperature is below normal.|
+|other|19|Any other reason that does not fall in rest of the reasons.|
+|none|20|No reasons.|
+|movingToPaused|21|Someone paused the Printer using the Pause-Printer operation.|
+|shutdown|22|Someone removed a Printer object from service, and the device may be powered down or physically removed.|
+|connectingToDevice|23|Printer is in the process of connecting to a shared network Output Device.|
+|timedOut|24|The server was unable to get a response from the output device.|
+|stopping|25|The Printer object is in the process of stopping the device.|
+|stoppedPartially|26|One or more output devices are stopped.|
+|tonerLow|27|The device is low on toner.|
+|tonerEmpty|28|The device is out of toner.|
+|spoolAreaFull|29|The limit of persistent storage allocated for spooling has been reached.|
+|doorOpen|30|One or more doors on the device are open.|
+|opticalPhotoConductorNearEndOfLife|31|The optical photo conductor is near end of life.|
+|opticalPhotoConductorLifeOver|32|The optical photo conductor is no longer functioning.|
+|developerLow|33|The device is low on developer.|
+|developerEmpty|34|The device is out of developer.|
+|interpreterResourceUnavailable|35|An interpreter resource is unavailable (e.g. font, form).|
+|unknownFutureValue|36|Evolvable enumeration sentinel value. Do not use.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.printerStatus"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printerStatus",
+ "state": "String",
+ "details": [
+ "String"
+ ],
+ "description": "String"
+}
+```
+
v1.0 Printjob https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printjob.md
+
+ Title: printJob resource type
+description: Represents a print job that has been queued for a printer.
+
+localization_priority: Normal
++
+# printJob resource type
+
+Namespace: microsoft.graph
++
+Represents a print job that has been queued for a printer.
+
+## Methods
+| Method | Return Type | Description |
+|:-|:|:|
+| [Get](../api/printjob-get.md) | [printJob](printjob.md) | Read properties and relationships of printJob object. |
+| [Create](../api/printer-post-jobs.md) | [printJob](printjob.md) | Create a new print job object. |
+| [Update](../api/printjob-update.md) | [printJob](printjob.md) | Update a print job object. |
+| [Start](../api/printjob-start.md)|None|Start the print job.|
+| [Cancel](../api/printjob-cancel.md)|None|Cancel the print job.|
+| [Abort](../api/printjob-abort.md)|None|Abort the print job.|
+| [Redirect (to another printer)](../api/printjob-redirect.md) | [printJob](printjob.md) | A print job that is queued for the destination printer. |
++
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The printer's GUID. Read-only.|
+|createdDateTime|DateTimeOffset|The DateTimeOffset when the job was created. Read-only.|
+|status|[printJobStatus](printjobstatus.md)|The status of the print job. Read-only.|
+|configuration|[printJobConfiguration](printJobConfiguration.md)|A group of settings that a printer should use to print a job.|
+|isFetchable|Edm.Boolean|If true, document can be fetched by printer.|
+|redirectedFrom|Edm.String|Contains the source job URL, if the job has been redirected from another printer.|
+|redirectedTo|Edm.String|Contains the destination job URL, if the job has been redirected to another printer.|
+|createdBy|[userIdentity](useridentity.md)| Read-only. Nullable.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|documents|[printDocument](printdocument.md) collection| Read-only.|
+|tasks|[printTask](printtask.md) collection|A list of [printTasks](printtask.md) that were triggered by this print job.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.printJob",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printJob",
+ "id": "String (identifier)",
+ "createdDateTime": "String (timestamp)",
+ "status": {
+ "@odata.type": "microsoft.graph.printJobStatus"
+ },
+ "createdBy": {
+ "@odata.type": "microsoft.graph.userIdentity"
+ },
+ "configuration": {
+ "@odata.type": "microsoft.graph.printJobConfiguration"
+ },
+ "redirectedTo": "String",
+ "redirectedFrom": "String",
+ "isFetchable": "Boolean"
+}
+```
+
v1.0 Printjobconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printjobconfiguration.md
+
+ Title: printJobConfiguration resource type
+description: A group of settings that a printer should use to print a job.
+
+localization_priority: Normal
++
+# printJobConfiguration resource type
+
+Namespace: microsoft.graph
++
+A group of settings that a printer should use to print a job.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|pageRanges|[integerRange](integerrange.md) collection|The page ranges to print. Read-only.|
+|quality|[printQuality](enums.md#printquality-values)|The print quality to use when printing the job. Valid values are described in the table below. Read-only.|
+|dpi|Int32|The resolution to use when printing the job, expressed in dots per inch (DPI). Read-only.|
+|feedOrientation|printerFeedOrientation|The orientation to use when feeding media into the printer. Valid values are described in the following table. Read-only.|
+|orientation|[printOrientation](enums.md#printorientation-values)|The orientation setting the printer should use when printing the job. Valid values are described in the following table.|
+|duplexMode|[printDuplexMode](enums.md#printduplexmode-values)|The duplex mode the printer should use when printing the job. Valid values are described in the table below. Read-only.|
+|copies|Int32|The number of copies that should be printed. Read-only.|
+|colorMode|[printColorMode](enums.md#printcolormode-values)|The color mode the printer should use to print the job. Valid values are described in the table below. Read-only.|
+|inputBin|String|The input bin (tray) to use when printing. See the printer's [capabilities](printercapabilities.md) for a list of supported input bins.|
+|outputBin|String|The output bin to place completed prints into. See the printer's [capabilities](printercapabilities.md) for a list of supported output bins.|
+|mediaSize|String|The media sizeto use when printing. Supports standard size names for ISO and ANSI media sizes, along with any custom sizes supported by the associated printer.|
+|margin|[printMargin](printmargin.md)|The margin settings to use when printing.|
+|mediaType|String|The default media (such as paper) type to print the document on. Valid values are described in the following table.|
+|finishings|[printFinishing](enums.md#printfinishing-values) collection|Finishing processes to use when printing.|
+|pagesPerSheet|Int32|The number of document pages to print on each sheet.
+|multipageLayout|[printMultipageLayout](enums.md#printmultipagelayout-values)|The direction to lay out pages when multiple pages are being printed per sheet. Valid values are described in the following table.|
+|collate|Boolean|Whether the printer should collate pages wehen printing multiple copies of a multi-page document.|
+|scaling|[printScaling](enums.md#printscaling-values)|Specifies how the printer should scale the document data to fit the requested media. Valid values are described in the following table.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.printJobConfiguration"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printJobConfiguration",
+ "pageRanges": [
+ {
+ "@odata.type": "microsoft.graph.integerRange"
+ }
+ ],
+ "quality": "String",
+ "dpi": "Integer",
+ "feedOrientation": "String",
+ "orientation": "String",
+ "duplexMode": "String",
+ "copies": "Integer",
+ "colorMode": "String",
+ "inputBin": "String",
+ "outputBin": "String",
+ "mediaSize": "String",
+ "margin": {
+ "@odata.type": "microsoft.graph.printMargin"
+ },
+ "mediaType": "String",
+ "finishings": [
+ "String"
+ ],
+ "pagesPerSheet": "Integer",
+ "multipageLayout": "String",
+ "collate": "Boolean",
+ "scaling": "String",
+ "fitPdfToPage": "Boolean"
+}
+```
+
v1.0 Printjobstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printjobstatus.md
+
+ Title: printJobStatus resource type
+description: Represents the current status of a print job.
+
+localization_priority: Normal
++
+# printJobStatus resource type
+
+Namespace: microsoft.graph
++
+Represents the current status of a print job.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|state|printJobProcessingState|The print job's current processing state. Valid values are described in the following table. Read-only.|
+|details|printJobProcessingDetail collection|Additional details for print job state. Valid values are described in the following table. Read-only.|
+|description|String|A human-readable description of the print job's current processing state. Read-only.|
+|isAcquiredByPrinter|Boolean|True if the job was acknowledged by a printer; false otherwise. Read-only.|
+
+### printJobProcessingState values
+
+|Member|Value|Description|
+|:|:|:|
+|unknown|0|The processing state reported by the printer is not recognized.|
+|pending|1|The print job is pending processing by the printer.|
+|processing|2|The print job is currently being processed by the printer.|
+|paused|3|The print job has been paused.|
+|stopped|4|The print job has been stopped because an issue with the printer needs to be addressed before the job can continue. More information can be found in the printer state resource.|
+|completed|5|The print job has completed successfully and no further processing will take place.|
+|canceled|6|The print job has been canceled by a user and no further processing will take place.|
+|aborted|7|The print job has been aborted by a user or the printer and no further processing will take place.|
+
+### printJobProcessingDetail values
+
+|Member|Value|Description|
+|:|:|:|
+|uploadPending|0|Document payload has not been uploaded.|
+|transforming|1|Document payload is being transformed.|
+|completedSuccessfully|2|Job has been completed successfully.|
+|completedWithWarnings|3|Job has been completed with warnings.|
+|completedWithErrors|4|Job has been completed with errors.|
+|releaseWait|5|Job is pending to be released.|
+|interpreting|6|Job is in 'processing' state, but more specifically, document payload is being interpreted.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.printJobStatus"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printJobStatus",
+ "state": "String",
+ "description": "String",
+ "isAcquiredByPrinter": "Boolean",
+ "details": [
+ "String"
+ ]
+}
+```
+
v1.0 Printmargin https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printmargin.md
+
+ Title: printMargin resource type
+description: Specifies the margin widths to use when printing.
+
+localization_priority: Normal
++
+# printMargin resource type
+
+Namespace: microsoft.graph
++
+Specifies the margin widths to use when printing.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|top|Int32|The margin in microns from the top edge.|
+|bottom|Int32|The margin in microns from the bottom edge.|
+|right|Int32|The margin in microns from the right edge.|
+|left|Int32|The margin in microns from the left edge.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.printMargin"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printMargin",
+ "top": "Integer",
+ "bottom": "Integer",
+ "right": "Integer",
+ "left": "Integer"
+}
+```
+
v1.0 Printoperation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printoperation.md
+
+ Title: printOperation resource type
+description: Represents a long-running Universal Print operation. Base class for operation types such as printerCreateOperation.
+
+localization_priority: Normal
++
+# printOperation resource type
+
+Namespace: microsoft.graph
++
+Represents a long-running Universal Print operation. Base class for operation types such as [printerCreateOperation](printercreateoperation.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+| [Get operation](../api/printoperation-get.md) | [printOperation](printoperation.md) | Retrieve a long-running operation within current user or app's tenant. |
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The operation's identifier. Read-only.|
+|status|[printOperationStatus](printoperationstatus.md)|The status of the operation. Read-only.|
+|createdDateTime|DateTimeOffset|The DateTimeOffset when the operation was created. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.printOperation",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printOperation",
+ "id": "String (identifier)",
+ "status": {
+ "@odata.type": "microsoft.graph.printOperationStatus"
+ },
+ "createdDateTime": "String (timestamp)"
+}
+```
+
v1.0 Printoperationstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printoperationstatus.md
+
+ Title: printOperationStatus resource type
+description: Represents the current status of a long-running Universal Print operation.
+
+localization_priority: Normal
++
+# printOperationStatus resource type
+
+Namespace: microsoft.graph
++
+Represents the current status of a long-running Universal Print operation.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|state|printOperationProcessingState|The printOperation's current processing state. Valid values are described in the following table. Read-only.|
+|description|String|A human-readable description of the printOperation's current processing state. Read-only.|
+
+### printOperationProcessingState values
+
+|Member|Value|Description|
+|:|:|:|
+|notStarted|0|The operation has not yet started.|
+|running|1|The operation is running.|
+|succeeded|2|The operation completed successfully.|
+|failed|3|The operation failed.|
+|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.printOperationStatus"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printOperationStatus",
+ "state": "String",
+ "description": "String"
+}
+```
+
v1.0 Printservice https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printservice.md
+
+ Title: printService resource type
+description: Represents an Azure AD tenant-specific description of a print service instance. Services exist for each component of the printing infrastructure (e.g., discovery, notifications, registration and IPP) and have one or more endpoints.
+
+localization_priority: Normal
++
+# printService resource type
+
+Namespace: microsoft.graph
++
+Represents an Azure AD tenant-specific description of a print service instance. Services exist for each component of the printing infrastructure (discovery, notifications, registration, and IPP) and have one or more endpoints.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+| [List services](../api/print-list-services.md) | [printService](printservice.md) collection | Get a list of Universal Print services. |
+| [Get service](../api/printservice-get.md) | [printService](printservice.md) | Read the properties and relationships of service object. |
+| [List endpoints](../api/printservice-list-endpoints.md) | [printServiceEndpoint](printserviceendpoint.md) collection | Get a list of endpoints that a service provides. |
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The service's identifier. Read-only.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|endpoints|[printServiceEndpoint](printserviceendpoint.md) collection| Endpoints that can be used to access the service. Read-only. Nullable.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.printService",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printService",
+ "id": "String (identifier)"
+}
+```
+
v1.0 Printserviceendpoint https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printserviceendpoint.md
+
+ Title: printServiceEndpoint resource type
+description: Represents URI and identifying information for a print service instance.
+
+localization_priority: Normal
++
+# printServiceEndpoint resource type
+
+Namespace: microsoft.graph
++
+Represents URI and identifying information for a print service instance.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+| [Get endpoint](../api/printserviceendpoint-get.md) | [printServiceEndpoint](printserviceendpoint.md) | Read the properties and relationships of endpoint object. |
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|A human-readable display name for the endpoint.|
+|id|String|A unique name that identifies the service that the endpoint provides. Possible values are: `discovery` (Discovery Service), `notification` (Notification Service), `ipp` (IPP Service), and `registration` (Registration Service). Read-only.|
+|uri|String|The URI that can be used to access the service.|
++
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.printServiceEndpoint",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printServiceEndpoint",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "uri": "String"
+}
+```
+
v1.0 Printsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printsettings.md
+
+ Title: printSettings resource type
+description: Represents tenant-wide settings for the Universal Print service.
+
+localization_priority: Normal
++
+# printSettings resource type
+
+Namespace: microsoft.graph
++
+Represents tenant-wide settings for the Universal Print service.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|documentConversionEnabled|Boolean|Specifies whether document conversion is enabled for the tenant. If document conversion is enabled, Universal Print service will automatically convert documents into a format compatible with the printer (xps to pdf) when needed.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.printSettings"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printSettings",
+ "documentConversionEnabled": "Boolean"
+}
+```
+
v1.0 Printtask https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printtask.md
+
+ Title: printTask resource type
+description: Represents a task that is executing or has been executed as a result of a Universal Print event.
+
+localization_priority: Normal
++
+# printTask resource type
+
+Namespace: microsoft.graph
++
+Represents a task that is executing or has been executed as a result of a Universal Print event.
+
+For details about how to use this resource to add pull printing support to Universal Print, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+| [List (from printTaskDefintion)](../api/printtaskdefinition-list-tasks.md) | [printTask](printtask.md) | Get a list of tasks that have been created based on a particular printTaskDefinition. The list includes currently running tasks and recently completed tasks. |
+| [Get](../api/printtask-get.md) | [printTask](printtask.md) | Get details about a print task. |
+| [Update](../api/printtaskdefinition-update-task.md) | [printTask](printtask.md) | Updates a print task. |
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The printTask's identifier. Read-only.|
+|status|[printTaskStatus](printtaskstatus.md)|The current execution status of this printTask. **The calling application is responsible for updating this status when processing is finished, unless the related printJob has been redirected to another printer.** Failure to report completion will result in the related print job being blocked from printing and eventually deleted. |
+|parentUrl|String|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.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|trigger|[printTaskTrigger](printtasktrigger.md)|The printTaskTrigger that triggered this task's execution. Read-only.|
+|definition|[printTaskDefinition](printtaskdefinition.md)|The printTaskDefinition that was used to create this task. Read-only.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.printTask",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printTask",
+ "id": "String (identifier)",
+ "status": {
+ "@odata.type": "microsoft.graph.printTaskStatus"
+ },
+ "parentUrl": "String"
+}
+```
+
v1.0 Printtaskdefinition https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printtaskdefinition.md
+
+ Title: printTaskDefinition resource type
+description: Represents a task that can be triggered when various events occur within Universal Print.
+
+localization_priority: Normal
++
+# printTaskDefinition resource type
+
+Namespace: microsoft.graph
++
+Represents an abstract definition for a task that can be triggered when various events occur within Universal Print.
+
+For details about how to use this resource to add pull printing support to Universal Print, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+
+This resource supports:
+* [Subscribing to change notifications](/graph/universal-print-webhook-notifications).
+
+## Methods
+| Method | Return Type | Description |
+|:-|:|:|
+| [List](../api/print-list-taskdefinitions.md) | [printTaskDefinition](printtaskdefinition.md) collection | Get a complete list of printTaskDefinitions created within Universal Print. |
+| [Create](../api/print-post-taskdefinitions.md) | [printTaskDefinition](printtaskdefinition.md) | Create a new printTaskDefinition. |
+| [Update](../api/print-update-taskdefinition.md) | [printTaskDefinition](printtaskdefinition.md) | Update a printTaskDefinition. |
+| [Delete](../api/print-delete-taskdefinition.md) | None | Delete a printTaskDefinition. |
+| [List tasks](../api/printtaskdefinition-list-tasks.md) | [printTask](printtask.md) | Get a list of tasks that have been created based on this definition. The list includes currently running tasks and recently completed tasks. |
+| [Get task](../api/printtask-get.md) | [printTask](printtask.md) | Gets a task that has been created based on this definition. |
+| [Update task](../api/printtaskdefinition-update-task.md) | [printTask](printtask.md) | Update a task that has been created based on this definition. **Applications that register task triggers are responsible for updating task status when processing is finished, unless the related printJob has been redirected to another printer.** Failure to report completion will result in the related print job being blocked from printing and eventually deleted. |
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The printTaskDefinition's identifier. Read-only.|
+|displayName|String|The name of the printTaskDefinition.|
+|createdBy|[appIdentity](appidentity.md)|The application that created the printTaskDefinition. Read-only.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|tasks|[printTask](printtask.md) collection|A list of tasks that have been created based on this definition. The list includes currently running tasks and recently completed tasks. Read-only.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.printTaskDefinition",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printTaskDefinition",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "createdBy": {
+ "@odata.type": "microsoft.graph.appIdentity"
+ }
+}
+```
+
v1.0 Printtaskstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printtaskstatus.md
+
+ Title: printTaskStatus resource type
+description: Represents the current execution status of a printTask.
+
+localization_priority: Normal
++
+# printTaskStatus resource type
+
+Namespace: microsoft.graph
++
+Represents the current execution status of a [printTask](printtask.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|state|printTaskProcessingState|The current processing state of the [printTask](printtask.md). Valid values are described in the following table.|
+|description|String|A human-readable description of the current processing state of the [printTask](printtask.md).|
+
+### printTaskProcessingState values
+
+|Member|Value|Description|
+|:|:|:|
+|pending|0|Task execution is pending.|
+|processing|1|Task execution is in progress.|
+|completed|2|Task execution has completed.|
+|aborted|3|Task execution was aborted.|
+|unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.printTaskStatus"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printTaskStatus",
+ "state": "String",
+ "description": "String"
+}
+```
+
v1.0 Printtasktrigger https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printtasktrigger.md
+
+ Title: printTaskTrigger resource type
+description: Determines the conditions under which a new printTask will be executed based on the associated printTaskDefinition.
+
+localization_priority: Normal
++
+# printTaskTrigger resource type
+
+Namespace: microsoft.graph
++
+Determines the condition under which a new [printTask](printtask.md) will be triggered based on the associated [printTaskDefinition](printtaskdefinition.md).
+
+For details about how to use this resource to add pull printing support to Universal Print, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+| [List](../api/printer-list-tasktriggers.md) | [printTaskTrigger](printtasktrigger.md) collection | Get a list of printTaskTriggers associated with a particular [printer](printer.md). |
+| [Get](../api/printtasktrigger-get.md) | [printTaskTrigger](printtasktrigger.md) | Get the printTaskTrigger associated with a particular [printTask](printtask.md). |
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The printTaskTrigger's identifier. Read-only.|
+|event|printEvent|The Universal Print event that will cause a new [printTask](printtask.md) to be triggered. Valid values are described in the following table.|
+
+### printEvent values
+
+|Member|Value|Description|
+|:|:|:|
+|jobStarted|0|Represents an event that occurs when a new print job is started.|
+|unknownFutureValue|1|Evolvable enumeration sentinel value. Do not use.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|definition|[printTaskDefinition](printtaskdefinition.md)|An abstract definition that will be used to create a [printTask](printtask.md) when triggered by a print event. Read-only.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.printTaskTrigger",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printTaskTrigger",
+ "id": "String (identifier)",
+ "event": "String"
+}
+```
+
v1.0 Printusagebyprinter https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printusagebyprinter.md
+
+ Title: printUsageByPrinter resource type
+description: Describes print activity for a printer during a specified time period (usageDate).
+
+localization_priority: Normal
++
+# printUsageByPrinter resource type
+
+Namespace: microsoft.graph
++
+Describes print activity for a printer during a specified time period (usageDate).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+| [List (daily)](../api/reportroot-list-dailyprintusagebyprinter.md) | [printUsageByPrinter](printUsageByPrinter.md) | Get a list of daily print usage summaries, grouped by printer. |
+| [List (monthly)](../api/reportroot-list-monthlyprintusagebyprinter.md) | [printUsageByPrinter](printUsageByPrinter.md) | Get a list of monthly print usage summaries, grouped by printer. |
+| [Get](../api/printUsageByPrinter-get.md) | [printUsageByPrinter](printUsageByPrinter.md) | Read the properties and relationships of a **printUsageByPrinter** object. |
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The ID of this usage summary.|
+|printerID|String|The ID of the printer represented by these statistics.|
+|usageDate|Date|The date associated with these statistics.|
+|completedBlackAndWhiteJobCount|Int64|The number of black and white print jobs completed by the printer on the associated date.|
+|completedColorJobCount|Int64|The number of color print jobs completed by the printer on the associated date.|
+|incompleteJobCount|Int64|The number of print jobs that were queued for the printer, but not completed, on the associated date.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.printUsageByPrinter",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printUsageByPrinter",
+ "id": "String (identifier)",
+ "usageDate": "Date",
+ "completedBlackAndWhiteJobCount": "Integer",
+ "completedColorJobCount": "Integer",
+ "incompleteJobCount": "Integer",
+ "printerId": "String"
+}
+```
+
v1.0 Printusagebyuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/printusagebyuser.md
+
+ Title: printUsageByUser resource type
+description: Describes print activity for a user during a specified time period (usageDate).
+
+localization_priority: Normal
++
+# printUsageByUser resource type
+
+Namespace: microsoft.graph
++
+Describes print activity for a user during a specified time period (usageDate).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+| [List (daily)](../api/reportroot-list-dailyprintusagebyuser.md) | [printUsageByUser](printusagebyuser.md) | Get a list of daily print usage summaries, grouped by user. |
+| [List (monthly)](../api/reportroot-list-monthlyprintusagebyuser.md) | [printUsageByUser](printusagebyuser.md) | Get a list of monthly print usage summaries, grouped by user. |
+| [Get](../api/printusagebyuser-get.md) | [printUsageByUser](printusagebyuser.md) | Read properties and relationships of a printUsageByUser object. |
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The ID of this usage summary.|
+|userPrincipalName|String|The UPN of the user represented by these statistics.|
+|usageDate|Date|The date associated with these statistics.|
+|completedBlackAndWhiteJobCount|Int64|The number of black and white print jobs completed on behalf of the user on the associated date.|
+|completedColorJobCount|Int64|The number of color print jobs completed on behalf of the user on the associated date.|
+|incompleteJobCount|Int64|The number of print jobs that were queued on behalf of the user, but not completed, on the associated date.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.printUsageByUser",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.printUsageByUser",
+ "id": "String (identifier)",
+ "usageDate": "Date",
+ "completedBlackAndWhiteJobCount": "Integer",
+ "completedColorJobCount": "Integer",
+ "incompleteJobCount": "Integer",
+ "userPrincipalName": "String"
+}
+```
+
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/toc.yml a/api-reference/v1.0/toc.yml
items:
href: api/application-post-onlinemeetings.md - name: Get href: api/onlinemeeting-get.md
+ - name: Update
+ href: api/onlinemeeting-update.md
- name: Delete href: api/onlinemeeting-delete.md - name: Create or get
items:
- name: Devices and apps expanded: true items:
+ - name: Cloud printing
+ items:
+ - name: Print
+ href: resources/print.md
+ displayName: Universal Print
+ - name: Print connector
+ href: resources/printconnector.md
+ items:
+ - name: List
+ href: api/print-list-connectors.md
+ - name: Get
+ href: api/printconnector-get.md
+ - name: Update
+ href: api/printconnector-update.md
+ - name: Delete
+ href: api/printconnector-delete.md
+ - name: Print document
+ href: resources/printdocument.md
+ items:
+ - name: Create upload session
+ href: api/printdocument-createuploadsession.md
+ - name: Download binary file
+ href: api/printdocument-get-file.md
+ - name: Print job
+ href: resources/printjob.md
+ items:
+ - name: Create job for a printer
+ href: api/printer-post-jobs.md
+ - name: Create job for a printer share
+ href: api/printershare-post-jobs.md
+ - name: List jobs for a printer
+ href: api/printer-list-jobs.md
+ - name: List jobs for a printer share
+ href: api/printershare-list-jobs.md
+ - name: Get
+ href: api/printjob-get.md
+ - name: Start
+ href: api/printjob-start.md
+ - name: Update
+ href: api/printjob-update.md
+ - name: Cancel
+ href: api/printjob-cancel.md
+ - name: Abort
+ href: api/printjob-abort.md
+ - name: Redirect
+ href: api/printjob-redirect.md
+ - name: Print operation
+ href: resources/printoperation.md
+ items:
+ - name: Get
+ href: api/printoperation-get.md
+ - name: Printer
+ href: resources/printer.md
+ items:
+ - name: List
+ href: api/print-list-printers.md
+ - name: Create
+ href: api/printer-create.md
+ - name: Get
+ href: api/printer-get.md
+ - name: Update
+ href: api/printer-update.md
+ - name: Delete
+ href: api/printer-delete.md
+ - name: Get task trigger
+ href: api/printtasktrigger-get.md
+ - name: List connectors
+ href: api/printer-list-connectors.md
+ - name: List print jobs
+ href: api/printer-list-jobs.md
+ - name: List printerShares
+ href: api/printer-list-shares.md
+ - name: Create print job
+ href: api/printer-post-jobs.md
+ - name: List task triggers
+ href: api/printer-list-tasktriggers.md
+ - name: Create task trigger
+ href: api/printer-post-tasktriggers.md
+ - name: Delete task trigger
+ href: api/printer-delete-tasktrigger.md
+ - name: Restore factory defaults
+ href: api/printer-restorefactorydefaults.md
+ - name: Printer share
+ href: resources/printershare.md
+ items:
+ - name: List
+ href: api/print-list-shares.md
+ - name: Create
+ href: api/print-post-shares.md
+ - name: Get
+ href: api/printershare-get.md
+ - name: Update
+ href: api/printershare-update.md
+ - name: Delete
+ href: api/printershare-delete.md
+ - name: List allowed users
+ href: api/printershare-list-allowedusers.md
+ - name: Create allowed user
+ href: api/printershare-post-allowedusers.md
+ - name: Delete allowed user
+ href: api/printershare-delete-alloweduser.md
+ - name: List allowed groups
+ href: api/printershare-list-allowedgroups.md
+ - name: Create allowed group
+ href: api/printershare-post-allowedgroups.md
+ - name: Delete allowed group
+ href: api/printershare-delete-allowedgroup.md
+ - name: Print task definition
+ href: resources/printtaskdefinition.md
+ items:
+ - name: List
+ href: api/print-list-taskdefinitions.md
+ - name: Create
+ href: api/print-post-taskdefinitions.md
+ - name: Get
+ href: api/printtaskdefinition-get.md
+ - name: Update
+ href: api/print-update-taskdefinition.md
+ - name: Delete
+ href: api/print-delete-taskdefinition.md
+ - name: List tasks
+ href: api/printtaskdefinition-list-tasks.md
+ - name: Get task
+ href: api/printtask-get.md
+ - name: Update task
+ href: api/printtaskdefinition-update-task.md
+ - name: Reports
+ items:
+ - name: Organized by printer
+ items:
+ - name: Get
+ href: api/printusagebyprinter-get.md
+ - name: List a printer's archived print jobs
+ href: api/reports-getprinterarchivedprintjobs.md
+ - name: List daily reports by printer
+ href: api/reportroot-list-dailyprintusagebyprinter.md
+ - name: List monthly reports by printer
+ href: api/reportroot-list-monthlyprintusagebyprinter.md
+ - name: Organized by user or group
+ items:
+ - name: Get
+ href: api/printusagebyuser-get.md
+ - name: List a user's archived print jobs
+ href: api/reports-getuserarchivedprintjobs.md
+ - name: List a group's archived print jobs
+ href: api/reports-getgrouparchivedprintjobs.md
+ - name: List daily reports by user
+ href: api/reportroot-list-dailyprintusagebyuser.md
+ - name: List monthly reports by user
+ href: api/reportroot-list-monthlyprintusagebyuser.md
+ - name: Print service
+ href: resources/printservice.md
+ items:
+ - name: List
+ href: api/print-list-services.md
+ - name: Get
+ href: api/printservice-get.md
+ - name: Endpoint
+ href: resources/printserviceendpoint.md
+ items:
+ - name: Get endpoint
+ href: api/printserviceendpoint-get.md
+ - name: List a service's endpoints
+ href: api/printservice-list-endpoints.md
+ - name: Print settings
+ href: resources/printsettings.md
+ items:
+ - name: Get
+ href: api/print-get-settings.md
+ - name: Update
+ href: api/print-update-settings.md
- name: Corporate management href: resources/intune-graph-overview.md displayName: Intune