Create an order ONLY AFTER preview_print_order, image display and buyer confirmation.
First present every preview image (or the viewer fallback), dimensions, material/color,
quantity and quote. Obtain explicit buyer confirmation for that preview version.
Then send preview_id, preview_version, buyer_confirmed=true, job_name and shipping
details ONLY; omit model/options fields. Any relevant change needs a new preview.
Legacy model inputs without a preview return a preview and NEVER create an order.
Set geometry, material, color, quantities and operator notes in preview_print_order.
OpenSCAD is preferred for designs made in conversation; uploaded STL and cached
model IDs are also supported there. One preview covers the whole multi-part order.
Confirm the shipping address with the buyer. ship_to requires their full name and
US address; contact_email is used for updates. This returns a job ID and total,
plus a payment link when payment is required. The buyer pays in their own browser.
View input schema
{
"type": "object",
"properties": {
"job_name": {
"description": "A short name for the item, shown on the order and the receipt, e.g. \"Desk cable clip\".",
"title": "Job Name",
"type": "string"
},
"material": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Print material: pla or petg.",
"title": "Material"
},
"color": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filament color, e.g. black or white.",
"title": "Color"
},
"notes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional notes for the operator, e.g. which face should look best.",
"title": "Notes"
},
"contact_email": {
"default": "",
"description": "The buyer's email, for the receipt and order updates.",
"title": "Contact Email",
"type": "string"
},
"ship_to": {
"default": "",
"description": "Required. Recipient's full name and US street address, including city, state and ZIP. We ship within the United States only.",
"title": "Ship To",
"type": "string"
},
"stl_base64": {
"default": "",
"description": "The model as a base64-encoded STL file, in millimeters. Give this or openscad_source, not both.",
"title": "Stl Base64",
"type": "string"
},
"openscad_source": {
"default": "",
"description": "OpenSCAD source for the model, in millimeters; rendered on our server. Preferred for models designed in the conversation. Give this or stl_base64, not both.",
"title": "Openscad Source",
"type": "string"
},
"quantity": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "How many identical copies. Capped by print time, not a flat number; the totals cover all of them.",
"title": "Quantity"
},
"parts": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/OrderPart"
},
"maxItems": 20,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "The WHOLE order, one entry per part. Use a model_id from earlier validation, an STL, or OpenSCAD. Each entry has its own name, material, color and quantity. Each part's quantity is capped by its own print time, not a flat count. Shipping and handling are charged once; never add independent quote totals.",
"title": "Parts"
},
"preview_id": {
"default": "",
"description": "The id returned by preview_print_order for the images shown to the buyer.",
"title": "Preview Id",
"type": "string"
},
"preview_version": {
"default": "",
"description": "The exact preview version the buyer confirmed; changes require a new preview.",
"title": "Preview Version",
"type": "string"
},
"buyer_confirmed": {
"default": false,
"description": "True ONLY after showing every preview image/options/price and receiving explicit buyer confirmation. Not proof of human viewing.",
"title": "Buyer Confirmed",
"type": "boolean"
}
},
"required": [
"job_name"
],
"$defs": {
"OrderPart": {
"additionalProperties": false,
"properties": {
"name": {
"description": "Short part name, shown on the card and receipt.",
"maxLength": 120,
"minLength": 1,
"title": "Name",
"type": "string"
},
"material": {
"default": "pla",
"description": "PLA or PETG only.",
"maxLength": 20,
"title": "Material",
"type": "string"
},
"color": {
"default": "black",
"description": "Filament color for this part.",
"maxLength": 40,
"title": "Color",
"type": "string"
},
"quantity": {
"default": 1,
"description": "Copies of THIS part. Capped by how long this part takes to print, not a flat number -- checked once its geometry is known; a rejected order reports the real cap for this part's size.",
"maximum": 500,
"minimum": 1,
"title": "Quantity",
"type": "integer"
},
"model_id": {
"default": "",
"description": "Reusable id from validate_stl; valid for 24 hours.",
"maxLength": 64,
"title": "Model Id",
"type": "string"
},
"stl_base64": {
"default": "",
"description": "STL in millimeters; give exactly one model source.",
"maxLength": 25000000,
"title": "Stl Base64",
"type": "string"
},
"openscad_source": {
"default": "",
"description": "OpenSCAD in millimeters; give exactly one model source.",
"maxLength": 50000,
"title": "Openscad Source",
"type": "string"
}
},
"required": [
"name"
],
"title": "OrderPart",
"type": "object"
}
},
"title": "submit_print_jobArguments"
}