printJob resource type

Namespace: microsoft.graph


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a print job that has been queued for a printer.


Method Return Type Description
Get printJob Read properties and relationships of printJob object.
Create printJob Create a new print job object.
Update printJob Update a print job object.
Start None Start the print job.
Cancel None Cancel the print job.
Abort None Abort the print job.
Redirect (to another printer) printJob A print job that is queued for the destination printer.


Property Type Description
id String The printer's GUID. Read-only.
createdDateTime DateTimeOffset The DateTimeOffset when the job was created. Read-only.
status printJobStatus The status of the print job. Read-only.
configuration printJobConfiguration 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.


Relationship Type Description
createdBy userIdentity Read-only. Nullable.
documents printDocument collection Read-only.
tasks printTask collection A list of printTasks that were triggered by this print job.

JSON representation

The following is a JSON representation of the resource.

  "id": "String (identifier)",
  "createdDateTime": "String (timestamp)",
  "isFetchable": "Boolean",
  "redirectedFrom": "String",
  "redirectedTo": "String",
  "status": {"@odata.type": "microsoft.graph.printJobStatus"},
  "createdBy": {"@odata.type": "microsoft.graph.userIdentity"},
  "configuration": {"@odata.type": "microsoft.graph.printJobConfiguration"},
  "documents": [ {"@odata.type": "microsoft.graph.printDocument"} ]