Skip to content

Fetch every file of an order's print as one zip

GET
/v1/orders/{id}/job/bundle
curl --request GET \
--url https://api.pixonaut.app/v1/orders/example/job/bundle \
--header 'Authorization: Bearer <token>'

Operation ID: orders.job.files.bundle

Every file one of the order’s prints (printId, required for an order of several) can be handed out as, for the order’s machine profile, or machineProfile, another of its printshop’s, or settings, output settings for this download only: each part of the process file and, where the print has one, the separated file, as the list of its files names them, in one zip, in a folder named for the machine (as-ordered for the order’s own), with the job ticket drawn for that machine as job-ticket.json. For each set add names, the same print for another machine profile of the order’s printshop, or with output settings for this download only, in a folder of its own. A file the order’s file door would refuse with spot_plate_required is left out. Not for a failed or cancelled order.

id
required
string
machineProfile
string
settings
string
printId

Which of the order’s prints, one of its printIds. Required when the order holds several; left out, the order’s only print.

string

Which of the order’s prints, one of its printIds. Required when the order holds several; left out, the order’s only print.

add

Sets of files to add beside the print’s own, as a JSON array: each {"machineProfile": "<id>"}, a machine profile of the tenant’s printshops, or {"settings": {…}}, output settings for this download only. At most 10.

string

Sets of files to add beside the print’s own, as a JSON array: each {"machineProfile": "<id>"}, a machine profile of the tenant’s printshops, or {"settings": {…}}, output settings for this download only. At most 10.

The print’s files and job ticket, zipped

Media typeapplication/zip
string
X-Request-Id
required
string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.

Refused: unauthorized

Media typeapplication/json
object
error
required
string

Examples

Exampleunauthorized

unauthorized

{
"error": "unauthorized"
}
X-Request-Id
required
string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.

Refused: origin_forbidden, forbidden, feature_disabled, workspace_suspended

Media typeapplication/json
object
error
required
string
feature

The feature the tenant does not have. Always sent with feature_disabled.

string

Examples

feature_disabled

{
"error": "feature_disabled",
"feature": "api"
}
X-Request-Id
required
string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.

Refused: order_not_found, print_not_found, machine_profile_not_found, part_not_offered, separation_not_found, file_not_found, not_found

Media typeapplication/json
object
error
required
string

Examples

file_not_found

{
"error": "file_not_found"
}
X-Request-Id
required
string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.

Refused: ink_mask_missing, print_profile_unavailable, print_raster_too_large, print_id_required, invalid_query

Media typeapplication/json
object
error
required
string
printIds

Always sent with print_id_required.

Array<string>
reason

Always sent with print_raster_too_large.

string

Examples

ink_mask_missing

{
"error": "ink_mask_missing"
}
X-Request-Id
required
string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.

Refused: rate_limited

Media typeapplication/json
object
error
required
string

Examples

Examplerate_limited

rate_limited

{
"error": "rate_limited"
}
X-Request-Id
required
string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.

Refused: db_error. A request that failed unexpectedly answers as text instead.

object
error
required
string

Examples

Exampledb_error

db_error

{
"error": "db_error"
}
X-Request-Id
required
string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.

Questions? Write to [email protected].

Status · Terms of service · Privacy policy · Subprocessors