Important!

The 3D print API is shutting down on January 15, 2017. See our end of life notice for more information.

POST jobs/:job_id/printer¶a>

Sets the printer_id on a job whose status is set to either created (i.e., not been assigned a printer_id or a printable_id), queued or unscheduled.

Note that you cannot change the printer_id on jobs that are running, completed, or canceled.

Resource Information¶

Method and URI	POST https://developer.api.autodesk.com/ps/v1/print/jobs/:job_id/printer
Authentication Context	user context required
Required OAuth Scopes	`data:read` `data:write`
Data Format	JSON

Request¶

HTTP Headers¶

Name	Required	Value Type	Description
Authorization	yes	string	Must be `Bearer <token>`, where `<token>` is obtained via a three-legged OAuth flow
Content-Type	yes	string	Must be `application/json`

URI Parameters¶

Name	Required	Value Type	Description
job_id	yes	string: UUID	Job identifier

Body Structure¶

The POST body is a single, flat JSON object with the following attribute:

Name	Required	Value Type	Description
printer_id	yes	int	The printer ID to set on the job

Response¶

HTTP Status Code Summary¶

Code	Message	Meaning
200	OK	Successful
400	Bad Request	Invalid request. E.g., the request could not be parsed.
401	Unauthorized	Invalid authorization header. E.g., user is not logged in, or cannot access resource.
404	Not Found	Endpoint does not exist.
422	Unprocessable Entity	Semantic errors
429	Precondition Required	Request rate limit exceeded
500	Internal Server Error	An unknown error occurred on the server.

Body Structure (200)¶

The response body is a single, flat JSON object with the following attributes:

Field	Type	Description
printer_id	int	The printer ID
job_id	string: UUID	The job ID
status	enum: string	The status of the job

Examples¶

Successul Specification of a Printer ID for a Job (200)¶

A successful response returns a JSON object with the following attributes:

curl -X 'POST' -H 'Authorization: Bearer jwP63dl3zT4fSAiy6jOBrmcr1UKh' -H 'Content-Type: application/json'  -v 'https://developer.api.autodesk.com/ps/v1/print/jobs/37ef6f6a-abe0-43c7-a738-9c6fab4504d9/printer' -d '{
"printer_id": "1093"
}'

{
  "printer_id": "1093",
  "job_id"    : "37ef6f6a-abe0-43c7-a738-9c6fab4504d9",
  "status"    : "created"
}