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/printable¶a>
Used to set the printable_id or printable_url of the printable file for a queued job.
The printable file is usually generated by the POST trays/generate_printable endpoint, which returns a file_id for the printable file.
Resource Information¶
| Method and URI | POST https:/ |
| 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- |
| Content-Type | yes | string | Must be application/json |
URI Parameters¶
Name |
Required |
Value Type |
Description |
|---|---|---|---|
| job_id | yes | string: UUID | job ID |
Body Structure¶
The POST body is a JSON object with the following attributes:
Name |
Required |
Value Type |
Description |
|---|---|---|---|
| printable_id | yes | string: URN | ID returned by
POST trays/ |
| printable_url | yes | string: URL | URL of a printable file; required only if printable_id is omitted |
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¶
Successful Addition of a Printable File to a Job (200)¶
curl -X 'POST'-H 'Authorization: Bearer jwP63dl3zT4fSAiy6jOBrmcr1UKh' -H 'Content-Type: application/json' -v 'https://developer.api.autodesk.com/ps/v1/print/jobs/7e7b1964-5a2e-4e9c-9368-2523bf1a308a/printable' -d '{
"printable_id": "urn:adsk.objects:os.object:print-services-external/b1996dd1-4b7f-44d8-9040-01615530073c.tar.gz"
}'
{
"printer_id": 647,
"job_id" : "7e7b1964-5a2e-4e9c-9368-2523bf1a308a",
"status" : "created"
}
