{
  "openapi": "3.1.0",
  "info": {
    "title": "FSH Labs ordering API for AI agents",
    "version": "1.1.0",
    "summary": "Price a laser-cut part from a DXF or SVG and hand a person a link to pay. No account, no API key.",
    "description": "Everything here is open: no signup, no key, no install. An agent checks the catalog, prices a file, and makes a payment link the person opens to pay by card. Human-readable docs: https://www.fshlabs.com/agents. The same operations are MCP tools at https://www.fshlabs.com/mcp.",
    "contact": {
      "name": "FSH Labs",
      "url": "https://www.fshlabs.com/contact"
    }
  },
  "servers": [
    {
      "url": "https://www.fshlabs.com/agents/v1"
    }
  ],
  "externalDocs": {
    "description": "Guide for agents",
    "url": "https://www.fshlabs.com/agents"
  },
  "paths": {
    "/catalog": {
      "get": {
        "operationId": "get_catalog",
        "summary": "Materials, limits, lead time and policies",
        "description": "What FSH Labs laser cuts, in which materials and thicknesses, the size limits, the order minimum, the lead time and the codes a quote can come back with. Start here.",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "shop": {
                      "type": "string"
                    },
                    "what_we_do": {
                      "type": "string"
                    },
                    "materials": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "slug": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "family": {
                            "type": "string"
                          },
                          "thickness_in": {
                            "type": "number"
                          },
                          "thickness_mm": {
                            "type": "number"
                          },
                          "quote_url": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "slug",
                          "name",
                          "family",
                          "thickness_in",
                          "thickness_mm",
                          "quote_url"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "limits": {
                      "type": "object",
                      "properties": {
                        "file_formats": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "max_part_mm": {
                          "type": "object",
                          "properties": {
                            "long": {
                              "type": "number"
                            },
                            "short": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "long",
                            "short"
                          ],
                          "additionalProperties": false
                        },
                        "max_part_in": {
                          "type": "object",
                          "properties": {
                            "long": {
                              "type": "number"
                            },
                            "short": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "long",
                            "short"
                          ],
                          "additionalProperties": false
                        },
                        "min_part_mm": {
                          "type": "number"
                        },
                        "min_gap_between_cuts_in": {
                          "type": "number"
                        },
                        "max_file_bytes": {
                          "type": "number"
                        },
                        "max_inline_file_bytes": {
                          "type": "number"
                        },
                        "qty": {
                          "type": "object",
                          "properties": {
                            "min": {
                              "type": "number"
                            },
                            "max": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "min",
                            "max"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "file_formats",
                        "max_part_mm",
                        "max_part_in",
                        "min_part_mm",
                        "min_gap_between_cuts_in",
                        "max_file_bytes",
                        "max_inline_file_bytes",
                        "qty"
                      ],
                      "additionalProperties": false
                    },
                    "pricing": {
                      "type": "object",
                      "properties": {
                        "currency": {
                          "type": "string"
                        },
                        "order_minimum_cents": {
                          "description": "US cents",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "setup_fee_cents": {
                          "description": "US cents",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "volume_quote_over_qty": {
                          "type": "number"
                        },
                        "sales_tax": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "currency",
                        "order_minimum_cents",
                        "setup_fee_cents",
                        "volume_quote_over_qty",
                        "sales_tax"
                      ],
                      "additionalProperties": false
                    },
                    "design_rules": {
                      "description": "What to draw to. Use these when you make or check the file yourself.",
                      "type": "object",
                      "properties": {
                        "kerf_in": {
                          "description": "Width of material the beam burns away along a cut. Holes come out that much larger and outside edges that much smaller than drawn.",
                          "type": "object",
                          "properties": {
                            "min": {
                              "type": "number"
                            },
                            "max": {
                              "type": "number"
                            },
                            "thick_acrylic_max": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "min",
                            "max",
                            "thick_acrylic_max"
                          ],
                          "additionalProperties": false
                        },
                        "kerf_compensation": {
                          "type": "string"
                        },
                        "min_gap_between_cuts_in": {
                          "type": "number"
                        },
                        "min_part_short_side_in": {
                          "type": "number"
                        },
                        "sheet_thickness": {
                          "description": "How far a real sheet strays from its listed thickness, by material family",
                          "type": "object",
                          "properties": {
                            "acrylic": {
                              "type": "string"
                            },
                            "wood": {
                              "type": "string"
                            },
                            "plastic": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "acrylic",
                            "wood",
                            "plastic"
                          ],
                          "additionalProperties": false
                        },
                        "fits": {
                          "type": "string"
                        },
                        "guide_url": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "kerf_in",
                        "kerf_compensation",
                        "min_gap_between_cuts_in",
                        "min_part_short_side_in",
                        "sheet_thickness",
                        "fits",
                        "guide_url"
                      ],
                      "additionalProperties": false
                    },
                    "lead_time": {
                      "type": "string"
                    },
                    "lead_time_business_days": {
                      "description": "Counted from payment for cut parts, and from proof approval for personalized products",
                      "type": "object",
                      "properties": {
                        "min": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "max": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "min",
                        "max"
                      ],
                      "additionalProperties": false
                    },
                    "holiday_notice": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "holiday": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string"
                            },
                            "date": {
                              "type": "string"
                            },
                            "order_by": {
                              "type": "string"
                            },
                            "in_time": {
                              "description": "Whether an order paid today is ready before the holiday",
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "name",
                            "date",
                            "order_by",
                            "in_time"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "fulfilment": {
                      "type": "object",
                      "properties": {
                        "ship": {
                          "type": "string"
                        },
                        "pickup": {
                          "type": "string"
                        },
                        "ships_to": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "ship",
                        "pickup",
                        "ships_to"
                      ],
                      "additionalProperties": false
                    },
                    "policies": {
                      "type": "object",
                      "properties": {
                        "cut_as_sent": {
                          "type": "string"
                        },
                        "payment": {
                          "type": "string"
                        },
                        "not_cut": {
                          "type": "string"
                        },
                        "remakes": {
                          "type": "string"
                        },
                        "files": {
                          "type": "string"
                        },
                        "terms_url": {
                          "type": "string"
                        },
                        "privacy_url": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "cut_as_sent",
                        "payment",
                        "not_cut",
                        "remakes",
                        "files",
                        "terms_url",
                        "privacy_url"
                      ],
                      "additionalProperties": false
                    },
                    "issue_codes": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "string"
                          },
                          "severity": {
                            "type": "string",
                            "enum": [
                              "block",
                              "review"
                            ]
                          },
                          "meaning": {
                            "type": "string"
                          },
                          "help_url": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "code",
                          "severity",
                          "meaning",
                          "help_url"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "order_statuses": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "links": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "string"
                      }
                    }
                  },
                  "required": [
                    "shop",
                    "what_we_do",
                    "materials",
                    "limits",
                    "pricing",
                    "design_rules",
                    "lead_time",
                    "lead_time_business_days",
                    "holiday_notice",
                    "holiday",
                    "fulfilment",
                    "policies",
                    "issue_codes",
                    "order_statuses",
                    "links"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "default": {
            "description": "The request was refused. `error.code` says why.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/quote": {
      "post": {
        "operationId": "quote_laser_file",
        "summary": "Price a DXF or SVG",
        "description": "Prices one cut file in one material at one quantity, with the same engine the website charges from. Answers with the price, the same job at other quantities (price_breaks), the lead time, the part sizes we read, and any issues with the file. Send compare_materials to price it in other materials in the same call, and ship_zip to add shipping and the total before tax. A file that can't be priced instantly still answers 200, with priceable false and the reasons. Nothing is stored against a person and nothing is charged. Also available as GET with the same fields as query parameters (file_url or file_id only).",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "file_id": {
                    "description": "A file sent in an earlier call (every quote answers with one). Kept 30 days.",
                    "type": "string",
                    "maxLength": 40
                  },
                  "file_url": {
                    "description": "A public https link to the DXF or SVG, up to 10 MB. We download it.",
                    "type": "string",
                    "maxLength": 2000
                  },
                  "file_text": {
                    "description": "The file's own text (DXF and SVG are both plain text), up to 4 MB. Send with file_name.",
                    "type": "string"
                  },
                  "file_base64": {
                    "description": "The file's bytes, base64, up to 4 MB. Send with file_name.",
                    "type": "string"
                  },
                  "file_name": {
                    "description": "The file's name with its extension, e.g. bracket.dxf. Needed with file_text and file_base64.",
                    "type": "string",
                    "maxLength": 200
                  },
                  "material": {
                    "description": "A material slug from the catalog, e.g. birch-125",
                    "type": "string",
                    "maxLength": 60
                  },
                  "qty": {
                    "description": "How many. For a file holding several parts, how many sets of the whole file.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  },
                  "units": {
                    "description": "The units a DXF is drawn in when the file doesn't say. Leave out to let us read the file; the answer says what was assumed.",
                    "type": "string",
                    "enum": [
                      "in",
                      "mm"
                    ]
                  },
                  "scale": {
                    "description": "Resize the part: 1 is the file's own size, 0.5 is half.",
                    "default": 1,
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "maximum": 100
                  },
                  "ship_zip": {
                    "description": "The 5-digit US ZIP it would ship to. Given, the answer adds what shipping costs and the total before sales tax, so the person sees the whole price before an order is made.",
                    "type": "string",
                    "maxLength": 10
                  },
                  "compare_materials": {
                    "description": "Other material slugs to price the same file in, as a list or comma-separated, or \"all\" for every material. The answer lists each in other_materials.",
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 1500
                      },
                      {
                        "maxItems": 40,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "maxLength": 60
                        }
                      }
                    ]
                  }
                },
                "required": [
                  "material",
                  "qty"
                ]
              }
            },
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "description": "The same fields as form fields, with the file itself in a field named `file` (up to 4 MB)."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "priceable": {
                      "description": "false: this file can't be priced instantly. See issues, then fix the file or send a custom quote request",
                      "type": "boolean"
                    },
                    "file_id": {
                      "description": "Use this instead of sending the file again. Null if we couldn't keep the file: send it again next time.",
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "file": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "format": {
                          "type": "string",
                          "enum": [
                            "dxf",
                            "svg"
                          ]
                        },
                        "units": {
                          "type": "string",
                          "enum": [
                            "in",
                            "mm"
                          ]
                        },
                        "units_source": {
                          "description": "file: the file declares its units. request: you gave them. assumed: we guessed, so confirm the sizes below with the person",
                          "type": "string",
                          "enum": [
                            "file",
                            "request",
                            "assumed"
                          ]
                        },
                        "parts": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "label": {
                                "type": "string"
                              },
                              "count": {
                                "description": "Copies of this part in the file",
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              "width_mm": {
                                "type": "number"
                              },
                              "height_mm": {
                                "type": "number"
                              },
                              "width_in": {
                                "type": "number"
                              },
                              "height_in": {
                                "type": "number"
                              },
                              "cut_length_mm": {
                                "type": "number"
                              },
                              "pierces": {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "label",
                              "count",
                              "width_mm",
                              "height_mm",
                              "width_in",
                              "height_in",
                              "cut_length_mm",
                              "pierces"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "coordinates": {
                          "description": "The frame open_lines and islands are given in",
                          "type": "string"
                        },
                        "open_lines": {
                          "description": "Each line that doesn't close into a shape (the open-outline issue), with where its two ends are. Join the ends to close it. The first 25.",
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "part": {
                                "type": "string"
                              },
                              "start": {
                                "type": "object",
                                "properties": {
                                  "x_mm": {
                                    "type": "number"
                                  },
                                  "y_mm": {
                                    "type": "number"
                                  },
                                  "x_in": {
                                    "type": "number"
                                  },
                                  "y_in": {
                                    "type": "number"
                                  }
                                },
                                "required": [
                                  "x_mm",
                                  "y_mm",
                                  "x_in",
                                  "y_in"
                                ],
                                "additionalProperties": false
                              },
                              "end": {
                                "type": "object",
                                "properties": {
                                  "x_mm": {
                                    "type": "number"
                                  },
                                  "y_mm": {
                                    "type": "number"
                                  },
                                  "x_in": {
                                    "type": "number"
                                  },
                                  "y_in": {
                                    "type": "number"
                                  }
                                },
                                "required": [
                                  "x_mm",
                                  "y_mm",
                                  "x_in",
                                  "y_in"
                                ],
                                "additionalProperties": false
                              },
                              "gap_mm": {
                                "description": "Straight distance between the two ends: what it would take to close it",
                                "type": "number"
                              },
                              "length_mm": {
                                "type": "number"
                              }
                            },
                            "required": [
                              "part",
                              "start",
                              "end",
                              "gap_mm",
                              "length_mm"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "open_lines_total": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "islands": {
                          "description": "Each closed shape sitting inside a cutout, which would fall out loose (the loose-islands issue). The first 25.",
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "part": {
                                "type": "string"
                              },
                              "center": {
                                "type": "object",
                                "properties": {
                                  "x_mm": {
                                    "type": "number"
                                  },
                                  "y_mm": {
                                    "type": "number"
                                  },
                                  "x_in": {
                                    "type": "number"
                                  },
                                  "y_in": {
                                    "type": "number"
                                  }
                                },
                                "required": [
                                  "x_mm",
                                  "y_mm",
                                  "x_in",
                                  "y_in"
                                ],
                                "additionalProperties": false
                              },
                              "width_mm": {
                                "type": "number"
                              },
                              "height_mm": {
                                "type": "number"
                              }
                            },
                            "required": [
                              "part",
                              "center",
                              "width_mm",
                              "height_mm"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "islands_total": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "name",
                        "format",
                        "units",
                        "units_source",
                        "parts",
                        "coordinates",
                        "open_lines",
                        "open_lines_total",
                        "islands",
                        "islands_total"
                      ],
                      "additionalProperties": false
                    },
                    "material": {
                      "type": "object",
                      "properties": {
                        "slug": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "thickness_in": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "slug",
                        "name",
                        "thickness_in"
                      ],
                      "additionalProperties": false
                    },
                    "qty": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "price": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "currency": {
                              "type": "string",
                              "const": "usd"
                            },
                            "each_cents": {
                              "description": "One part, or one set when the file holds several parts",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "parts_cents": {
                              "description": "US cents",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "minimum_top_up_cents": {
                              "description": "Added when the parts come to less than the order minimum",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "subtotal_cents": {
                              "description": "Before shipping and sales tax",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "display": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "currency",
                            "each_cents",
                            "parts_cents",
                            "minimum_top_up_cents",
                            "subtotal_cents",
                            "display"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "price_breaks": {
                      "description": "The same job at other quantities, the one asked for included. Quantity discounts are automatic.",
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "qty": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "each_cents": {
                            "description": "US cents",
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "subtotal_cents": {
                            "description": "Before shipping and sales tax, order minimum included",
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          }
                        },
                        "required": [
                          "qty",
                          "each_cents",
                          "subtotal_cents"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "other_materials": {
                      "description": "The same file and quantity in each of compare_materials",
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "slug": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "thickness_in": {
                            "type": "number"
                          },
                          "each_cents": {
                            "description": "US cents",
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "subtotal_cents": {
                            "description": "US cents",
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "display": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "slug",
                          "name",
                          "thickness_in",
                          "each_cents",
                          "subtotal_cents",
                          "display"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "shipping": {
                      "description": "What shipping costs to ship_zip. Null when no ship_zip was sent, or the order is pickup only.",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "zip": {
                              "type": "string"
                            },
                            "cents": {
                              "description": "US cents",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "service": {
                              "type": "string"
                            },
                            "transit_business_days": {
                              "description": "The carrier's estimate, after the order is made",
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "rate": {
                              "description": "carrier: the live rate to this ZIP. flat: our flat rate, used when the carrier gives none",
                              "type": "string",
                              "enum": [
                                "carrier",
                                "flat"
                              ]
                            }
                          },
                          "required": [
                            "zip",
                            "cents",
                            "service",
                            "transit_business_days",
                            "rate"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "total_before_tax": {
                      "description": "Price plus shipping, before sales tax. Null without ship_zip.",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "cents": {
                              "description": "US cents",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "display": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "cents",
                            "display"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "excludes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "lead_time": {
                      "type": "string"
                    },
                    "issues": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "description": "Stable code, listed in the catalog's issue_codes",
                            "type": "string"
                          },
                          "severity": {
                            "description": "block: the file can't be priced until fixed. review: priced, and a person checks it before cutting",
                            "type": "string",
                            "enum": [
                              "block",
                              "review"
                            ]
                          },
                          "message": {
                            "type": "string"
                          },
                          "help_url": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "code",
                          "severity",
                          "message"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "notes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "next": {
                      "type": "object",
                      "properties": {
                        "recommended": {
                          "type": "string",
                          "enum": [
                            "create_order",
                            "request_custom_quote"
                          ]
                        },
                        "create_order": {
                          "type": "string"
                        },
                        "request_custom_quote": {
                          "type": "string"
                        },
                        "human_url": {
                          "description": "The website's quote page with this material and quantity chosen, for the person to use directly",
                          "type": "string"
                        }
                      },
                      "required": [
                        "recommended",
                        "request_custom_quote",
                        "human_url"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "priceable",
                    "file_id",
                    "file",
                    "material",
                    "qty",
                    "price",
                    "price_breaks",
                    "other_materials",
                    "shipping",
                    "total_before_tax",
                    "excludes",
                    "lead_time",
                    "issues",
                    "notes",
                    "next"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "default": {
            "description": "The request was refused. `error.code` says why.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "quote_laser_file_get",
        "summary": "Price a DXF or SVG (by link)",
        "description": "quote_laser_file as a GET, for an agent that can only follow links. The same fields as query parameters; an object or a list goes in as JSON text.",
        "parameters": [
          {
            "name": "file_id",
            "in": "query",
            "required": false,
            "description": "A file sent in an earlier call (every quote answers with one). Kept 30 days.",
            "schema": {
              "description": "A file sent in an earlier call (every quote answers with one). Kept 30 days.",
              "type": "string",
              "maxLength": 40
            }
          },
          {
            "name": "file_url",
            "in": "query",
            "required": false,
            "description": "A public https link to the DXF or SVG, up to 10 MB. We download it.",
            "schema": {
              "description": "A public https link to the DXF or SVG, up to 10 MB. We download it.",
              "type": "string",
              "maxLength": 2000
            }
          },
          {
            "name": "file_name",
            "in": "query",
            "required": false,
            "description": "The file's name with its extension, e.g. bracket.dxf. Needed with file_text and file_base64.",
            "schema": {
              "description": "The file's name with its extension, e.g. bracket.dxf. Needed with file_text and file_base64.",
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "material",
            "in": "query",
            "required": true,
            "description": "A material slug from the catalog, e.g. birch-125",
            "schema": {
              "description": "A material slug from the catalog, e.g. birch-125",
              "type": "string",
              "maxLength": 60
            }
          },
          {
            "name": "qty",
            "in": "query",
            "required": true,
            "description": "How many. For a file holding several parts, how many sets of the whole file.",
            "schema": {
              "description": "How many. For a file holding several parts, how many sets of the whole file.",
              "type": "integer",
              "minimum": 1,
              "maximum": 10000
            }
          },
          {
            "name": "units",
            "in": "query",
            "required": false,
            "description": "The units a DXF is drawn in when the file doesn't say. Leave out to let us read the file; the answer says what was assumed.",
            "schema": {
              "description": "The units a DXF is drawn in when the file doesn't say. Leave out to let us read the file; the answer says what was assumed.",
              "type": "string",
              "enum": [
                "in",
                "mm"
              ]
            }
          },
          {
            "name": "scale",
            "in": "query",
            "required": false,
            "description": "Resize the part: 1 is the file's own size, 0.5 is half.",
            "schema": {
              "description": "Resize the part: 1 is the file's own size, 0.5 is half.",
              "default": 1,
              "type": "number",
              "exclusiveMinimum": 0,
              "maximum": 100
            }
          },
          {
            "name": "ship_zip",
            "in": "query",
            "required": false,
            "description": "The 5-digit US ZIP it would ship to. Given, the answer adds what shipping costs and the total before sales tax, so the person sees the whole price before an order is made.",
            "schema": {
              "description": "The 5-digit US ZIP it would ship to. Given, the answer adds what shipping costs and the total before sales tax, so the person sees the whole price before an order is made.",
              "type": "string",
              "maxLength": 10
            }
          },
          {
            "name": "compare_materials",
            "in": "query",
            "required": false,
            "description": "Other material slugs to price the same file in, as a list or comma-separated, or \"all\" for every material. The answer lists each in other_materials.",
            "schema": {
              "description": "Other material slugs to price the same file in, as a list or comma-separated, or \"all\" for every material. The answer lists each in other_materials.",
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 1500
                },
                {
                  "maxItems": 40,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "maxLength": 60
                  }
                }
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "priceable": {
                      "description": "false: this file can't be priced instantly. See issues, then fix the file or send a custom quote request",
                      "type": "boolean"
                    },
                    "file_id": {
                      "description": "Use this instead of sending the file again. Null if we couldn't keep the file: send it again next time.",
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "file": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "format": {
                          "type": "string",
                          "enum": [
                            "dxf",
                            "svg"
                          ]
                        },
                        "units": {
                          "type": "string",
                          "enum": [
                            "in",
                            "mm"
                          ]
                        },
                        "units_source": {
                          "description": "file: the file declares its units. request: you gave them. assumed: we guessed, so confirm the sizes below with the person",
                          "type": "string",
                          "enum": [
                            "file",
                            "request",
                            "assumed"
                          ]
                        },
                        "parts": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "label": {
                                "type": "string"
                              },
                              "count": {
                                "description": "Copies of this part in the file",
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              "width_mm": {
                                "type": "number"
                              },
                              "height_mm": {
                                "type": "number"
                              },
                              "width_in": {
                                "type": "number"
                              },
                              "height_in": {
                                "type": "number"
                              },
                              "cut_length_mm": {
                                "type": "number"
                              },
                              "pierces": {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "label",
                              "count",
                              "width_mm",
                              "height_mm",
                              "width_in",
                              "height_in",
                              "cut_length_mm",
                              "pierces"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "coordinates": {
                          "description": "The frame open_lines and islands are given in",
                          "type": "string"
                        },
                        "open_lines": {
                          "description": "Each line that doesn't close into a shape (the open-outline issue), with where its two ends are. Join the ends to close it. The first 25.",
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "part": {
                                "type": "string"
                              },
                              "start": {
                                "type": "object",
                                "properties": {
                                  "x_mm": {
                                    "type": "number"
                                  },
                                  "y_mm": {
                                    "type": "number"
                                  },
                                  "x_in": {
                                    "type": "number"
                                  },
                                  "y_in": {
                                    "type": "number"
                                  }
                                },
                                "required": [
                                  "x_mm",
                                  "y_mm",
                                  "x_in",
                                  "y_in"
                                ],
                                "additionalProperties": false
                              },
                              "end": {
                                "type": "object",
                                "properties": {
                                  "x_mm": {
                                    "type": "number"
                                  },
                                  "y_mm": {
                                    "type": "number"
                                  },
                                  "x_in": {
                                    "type": "number"
                                  },
                                  "y_in": {
                                    "type": "number"
                                  }
                                },
                                "required": [
                                  "x_mm",
                                  "y_mm",
                                  "x_in",
                                  "y_in"
                                ],
                                "additionalProperties": false
                              },
                              "gap_mm": {
                                "description": "Straight distance between the two ends: what it would take to close it",
                                "type": "number"
                              },
                              "length_mm": {
                                "type": "number"
                              }
                            },
                            "required": [
                              "part",
                              "start",
                              "end",
                              "gap_mm",
                              "length_mm"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "open_lines_total": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "islands": {
                          "description": "Each closed shape sitting inside a cutout, which would fall out loose (the loose-islands issue). The first 25.",
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "part": {
                                "type": "string"
                              },
                              "center": {
                                "type": "object",
                                "properties": {
                                  "x_mm": {
                                    "type": "number"
                                  },
                                  "y_mm": {
                                    "type": "number"
                                  },
                                  "x_in": {
                                    "type": "number"
                                  },
                                  "y_in": {
                                    "type": "number"
                                  }
                                },
                                "required": [
                                  "x_mm",
                                  "y_mm",
                                  "x_in",
                                  "y_in"
                                ],
                                "additionalProperties": false
                              },
                              "width_mm": {
                                "type": "number"
                              },
                              "height_mm": {
                                "type": "number"
                              }
                            },
                            "required": [
                              "part",
                              "center",
                              "width_mm",
                              "height_mm"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "islands_total": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "name",
                        "format",
                        "units",
                        "units_source",
                        "parts",
                        "coordinates",
                        "open_lines",
                        "open_lines_total",
                        "islands",
                        "islands_total"
                      ],
                      "additionalProperties": false
                    },
                    "material": {
                      "type": "object",
                      "properties": {
                        "slug": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "thickness_in": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "slug",
                        "name",
                        "thickness_in"
                      ],
                      "additionalProperties": false
                    },
                    "qty": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "price": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "currency": {
                              "type": "string",
                              "const": "usd"
                            },
                            "each_cents": {
                              "description": "One part, or one set when the file holds several parts",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "parts_cents": {
                              "description": "US cents",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "minimum_top_up_cents": {
                              "description": "Added when the parts come to less than the order minimum",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "subtotal_cents": {
                              "description": "Before shipping and sales tax",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "display": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "currency",
                            "each_cents",
                            "parts_cents",
                            "minimum_top_up_cents",
                            "subtotal_cents",
                            "display"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "price_breaks": {
                      "description": "The same job at other quantities, the one asked for included. Quantity discounts are automatic.",
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "qty": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "each_cents": {
                            "description": "US cents",
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "subtotal_cents": {
                            "description": "Before shipping and sales tax, order minimum included",
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          }
                        },
                        "required": [
                          "qty",
                          "each_cents",
                          "subtotal_cents"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "other_materials": {
                      "description": "The same file and quantity in each of compare_materials",
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "slug": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "thickness_in": {
                            "type": "number"
                          },
                          "each_cents": {
                            "description": "US cents",
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "subtotal_cents": {
                            "description": "US cents",
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "display": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "slug",
                          "name",
                          "thickness_in",
                          "each_cents",
                          "subtotal_cents",
                          "display"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "shipping": {
                      "description": "What shipping costs to ship_zip. Null when no ship_zip was sent, or the order is pickup only.",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "zip": {
                              "type": "string"
                            },
                            "cents": {
                              "description": "US cents",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "service": {
                              "type": "string"
                            },
                            "transit_business_days": {
                              "description": "The carrier's estimate, after the order is made",
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "rate": {
                              "description": "carrier: the live rate to this ZIP. flat: our flat rate, used when the carrier gives none",
                              "type": "string",
                              "enum": [
                                "carrier",
                                "flat"
                              ]
                            }
                          },
                          "required": [
                            "zip",
                            "cents",
                            "service",
                            "transit_business_days",
                            "rate"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "total_before_tax": {
                      "description": "Price plus shipping, before sales tax. Null without ship_zip.",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "cents": {
                              "description": "US cents",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "display": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "cents",
                            "display"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "excludes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "lead_time": {
                      "type": "string"
                    },
                    "issues": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "description": "Stable code, listed in the catalog's issue_codes",
                            "type": "string"
                          },
                          "severity": {
                            "description": "block: the file can't be priced until fixed. review: priced, and a person checks it before cutting",
                            "type": "string",
                            "enum": [
                              "block",
                              "review"
                            ]
                          },
                          "message": {
                            "type": "string"
                          },
                          "help_url": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "code",
                          "severity",
                          "message"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "notes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "next": {
                      "type": "object",
                      "properties": {
                        "recommended": {
                          "type": "string",
                          "enum": [
                            "create_order",
                            "request_custom_quote"
                          ]
                        },
                        "create_order": {
                          "type": "string"
                        },
                        "request_custom_quote": {
                          "type": "string"
                        },
                        "human_url": {
                          "description": "The website's quote page with this material and quantity chosen, for the person to use directly",
                          "type": "string"
                        }
                      },
                      "required": [
                        "recommended",
                        "request_custom_quote",
                        "human_url"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "priceable",
                    "file_id",
                    "file",
                    "material",
                    "qty",
                    "price",
                    "price_breaks",
                    "other_materials",
                    "shipping",
                    "total_before_tax",
                    "excludes",
                    "lead_time",
                    "issues",
                    "notes",
                    "next"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "default": {
            "description": "The request was refused. `error.code` says why.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/orders": {
      "post": {
        "operationId": "create_order",
        "summary": "Make a payment link for the person",
        "description": "Saves the priced job as an unpaid order and answers with a pay link for the person. Prices hold for 30 days. They open the link, check the order and pay by card on Stripe; address, phone and sales tax are handled there. Nothing is made, and nobody is charged, until they pay. Takes the same file and options as the quote, so quote first and pass its file_id. With kind laser-template or personalize it orders a template part or a personalized product instead, from the same fields quote_template or quote_product took. For several things in one order (one pay link, one order minimum, one parcel), send `items` instead of one thing's own fields: price the set first with quote_order.",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Any unique string. A retry with the same key answers with the first result instead of making a second one.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "kind": {
                    "description": "What is being ordered. laser-file (the default): a DXF or SVG, with the file fields and material. laser-template: template, values and material. personalize: product, variant, text and font.",
                    "default": "laser-file",
                    "type": "string",
                    "enum": [
                      "laser-file",
                      "laser-template",
                      "personalize"
                    ]
                  },
                  "material": {
                    "description": "A material slug from get_catalog. Needed for laser-file; optional for laser-template; not used for personalize.",
                    "type": "string",
                    "maxLength": 60
                  },
                  "qty": {
                    "description": "How many. For a file holding several parts, how many sets of the whole file.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  },
                  "units": {
                    "description": "The units a DXF is drawn in when the file doesn't say. Leave out to let us read the file; the answer says what was assumed.",
                    "type": "string",
                    "enum": [
                      "in",
                      "mm"
                    ]
                  },
                  "scale": {
                    "description": "Resize the part: 1 is the file's own size, 0.5 is half.",
                    "default": 1,
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "maximum": 100
                  },
                  "template": {
                    "description": "A template slug from list_templates, e.g. mounting-plate",
                    "type": "string",
                    "maxLength": 60
                  },
                  "values": {
                    "description": "The template's parameters by key. Lengths are in inches; a toggle is 1 or 0; a choice is one of its option values. Any left out take the template's default.",
                    "default": {},
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "type": "number"
                    }
                  },
                  "product": {
                    "description": "A product slug from list_products",
                    "type": "string",
                    "maxLength": 60
                  },
                  "variant": {
                    "description": "A variant slug (a colour or size) from list_products. Left out, the first is used; the answer says which.",
                    "type": "string",
                    "maxLength": 60
                  },
                  "text": {
                    "description": "The text to put on it: up to 3 lines of 40 characters, as an array or one string with line breaks",
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 400
                      },
                      {
                        "maxItems": 3,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "maxLength": 40
                        }
                      }
                    ]
                  },
                  "font": {
                    "description": "A font key from the product's fonts in list_products. Left out, the first is used.",
                    "type": "string",
                    "maxLength": 20
                  },
                  "names": {
                    "description": "A different name on each piece, one per piece, for products with takes_names. `text` is then the first name.",
                    "maxItems": 5000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200
                    }
                  },
                  "notes": {
                    "description": "Anything the shop should know. A person reads it before making the order.",
                    "type": "string",
                    "maxLength": 500
                  },
                  "file_id": {
                    "description": "A file sent in an earlier call (every quote answers with one). Kept 30 days.",
                    "type": "string",
                    "maxLength": 40
                  },
                  "file_url": {
                    "description": "A public https link to the DXF or SVG, up to 10 MB. We download it.",
                    "type": "string",
                    "maxLength": 2000
                  },
                  "file_text": {
                    "description": "The file's own text (DXF and SVG are both plain text), up to 4 MB. Send with file_name.",
                    "type": "string"
                  },
                  "file_base64": {
                    "description": "The file's bytes, base64, up to 4 MB. Send with file_name.",
                    "type": "string"
                  },
                  "file_name": {
                    "description": "The file's name with its extension, e.g. bracket.dxf. Needed with file_text and file_base64.",
                    "type": "string",
                    "maxLength": 200
                  },
                  "items": {
                    "description": "Several things as ONE order: one payment link, one order minimum, one parcel. Up to 20. Each item takes the same fields as an order of one thing (kind, material, qty, template, values, product, text ...), with its own quantity. A laser-file item names its file by file_id: quote the file first with quote_laser_file, which answers with the id. The same file_id may appear in several items, e.g. the same part in two materials.",
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "description": "What is being ordered. laser-file (the default): a DXF or SVG, with the file fields and material. laser-template: template, values and material. personalize: product, variant, text and font.",
                          "default": "laser-file",
                          "type": "string",
                          "enum": [
                            "laser-file",
                            "laser-template",
                            "personalize"
                          ]
                        },
                        "material": {
                          "description": "A material slug from get_catalog. Needed for laser-file; optional for laser-template; not used for personalize.",
                          "type": "string",
                          "maxLength": 60
                        },
                        "qty": {
                          "description": "How many. For a file holding several parts, how many sets of the whole file.",
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 10000
                        },
                        "units": {
                          "description": "The units a DXF is drawn in when the file doesn't say. Leave out to let us read the file; the answer says what was assumed.",
                          "type": "string",
                          "enum": [
                            "in",
                            "mm"
                          ]
                        },
                        "scale": {
                          "description": "Resize the part: 1 is the file's own size, 0.5 is half.",
                          "default": 1,
                          "type": "number",
                          "exclusiveMinimum": 0,
                          "maximum": 100
                        },
                        "template": {
                          "description": "A template slug from list_templates, e.g. mounting-plate",
                          "type": "string",
                          "maxLength": 60
                        },
                        "values": {
                          "description": "The template's parameters by key. Lengths are in inches; a toggle is 1 or 0; a choice is one of its option values. Any left out take the template's default.",
                          "default": {},
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "number"
                          }
                        },
                        "product": {
                          "description": "A product slug from list_products",
                          "type": "string",
                          "maxLength": 60
                        },
                        "variant": {
                          "description": "A variant slug (a colour or size) from list_products. Left out, the first is used; the answer says which.",
                          "type": "string",
                          "maxLength": 60
                        },
                        "text": {
                          "description": "The text to put on it: up to 3 lines of 40 characters, as an array or one string with line breaks",
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 400
                            },
                            {
                              "maxItems": 3,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "maxLength": 40
                              }
                            }
                          ]
                        },
                        "font": {
                          "description": "A font key from the product's fonts in list_products. Left out, the first is used.",
                          "type": "string",
                          "maxLength": 20
                        },
                        "names": {
                          "description": "A different name on each piece, one per piece, for products with takes_names. `text` is then the first name.",
                          "maxItems": 5000,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 200
                          }
                        },
                        "notes": {
                          "description": "Anything the shop should know. A person reads it before making the order.",
                          "type": "string",
                          "maxLength": 500
                        },
                        "file_id": {
                          "description": "A file sent in an earlier call (every quote answers with one). Kept 30 days.",
                          "type": "string",
                          "maxLength": 40
                        }
                      }
                    }
                  },
                  "fulfilment": {
                    "description": "ship: UPS Ground in the US. pickup: free, at a meeting spot in metro Atlanta",
                    "type": "string",
                    "enum": [
                      "ship",
                      "pickup"
                    ]
                  },
                  "ship_zip": {
                    "description": "The 5-digit US ZIP it ships to. Needed with fulfilment ship, to price shipping.",
                    "type": "string",
                    "maxLength": 10
                  },
                  "contact": {
                    "description": "Who the order is for. Optional: Stripe collects the name, email and address when they pay.",
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string",
                        "maxLength": 120
                      },
                      "email": {
                        "description": "The person's email, so the shop can reach them about the order",
                        "type": "string",
                        "maxLength": 320
                      },
                      "company": {
                        "type": "string",
                        "maxLength": 160
                      },
                      "po": {
                        "description": "Their purchase order number, printed on the receipt",
                        "type": "string",
                        "maxLength": 60
                      }
                    }
                  }
                },
                "required": [
                  "fulfilment"
                ]
              }
            },
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "description": "The same fields as form fields, with the file itself in a field named `file` (up to 4 MB)."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "order_id": {
                      "type": "string"
                    },
                    "pay_url": {
                      "description": "Give this to the person. It opens a page showing the order, with a button to pay by card. Treat it as private to them.",
                      "type": "string"
                    },
                    "quote_pdf_url": {
                      "description": "The same order as a formal quote PDF",
                      "type": "string"
                    },
                    "status_url": {
                      "description": "GET this for the order's status. It can't pay or download anything.",
                      "type": "string"
                    },
                    "status_page_url": {
                      "description": "The same status as a web page for the person",
                      "type": "string"
                    },
                    "item": {
                      "description": "What the order is: its one item, or a summary of several",
                      "type": "string"
                    },
                    "qty": {
                      "description": "Pieces across every item",
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "items": {
                      "description": "Every item on the order, in the order sent",
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "item": {
                            "type": "string"
                          },
                          "kind": {
                            "type": "string"
                          },
                          "qty": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "each_cents": {
                            "description": "US cents",
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "parts_cents": {
                            "description": "This item's goods. The order minimum is on the order, not on an item",
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "needs_proof": {
                            "description": "false: made exactly as ordered, with no proof. true: the shop emails a proof to approve first",
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "item",
                          "kind",
                          "qty",
                          "each_cents",
                          "parts_cents",
                          "needs_proof"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "needs_proof": {
                      "description": "Whether anything on the order waits for a proof before it is made",
                      "type": "boolean"
                    },
                    "price": {
                      "type": "object",
                      "properties": {
                        "currency": {
                          "type": "string",
                          "const": "usd"
                        },
                        "parts_cents": {
                          "description": "US cents",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "minimum_top_up_cents": {
                          "description": "Charged once for the whole order, however many items it holds",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "shipping_cents": {
                          "description": "US cents",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "shipping_service": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "total_before_tax_cents": {
                          "description": "US cents",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "display": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "currency",
                        "parts_cents",
                        "minimum_top_up_cents",
                        "shipping_cents",
                        "shipping_service",
                        "total_before_tax_cents",
                        "display"
                      ],
                      "additionalProperties": false
                    },
                    "sales_tax": {
                      "type": "string"
                    },
                    "fulfilment": {
                      "type": "string",
                      "enum": [
                        "ship",
                        "pickup"
                      ]
                    },
                    "lead_time": {
                      "type": "string"
                    },
                    "valid_until": {
                      "description": "The prices hold until then; after that, quote again",
                      "type": "string"
                    },
                    "review_notes": {
                      "description": "Things a person at the shop checks before cutting",
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "tell_the_person": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "order_id",
                    "pay_url",
                    "quote_pdf_url",
                    "status_url",
                    "status_page_url",
                    "item",
                    "qty",
                    "items",
                    "needs_proof",
                    "price",
                    "sales_tax",
                    "fulfilment",
                    "lead_time",
                    "valid_until",
                    "review_notes",
                    "tell_the_person"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "default": {
            "description": "The request was refused. `error.code` says why.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/orders/{order_id}/{status_token}": {
      "get": {
        "operationId": "get_order_status",
        "summary": "Where an order stands",
        "description": "Whether the order is paid, in production, shipped (with tracking) or ready for pickup. Use the status_url from create_order as is.",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "required": true,
            "description": "e.g. FSH-20261118-K7M2QX",
            "schema": {
              "description": "e.g. FSH-20261118-K7M2QX",
              "type": "string"
            }
          },
          {
            "name": "status_token",
            "in": "path",
            "required": true,
            "description": "The last part of the status_url that create_order answered with",
            "schema": {
              "description": "The last part of the status_url that create_order answered with",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "order_id": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "unpaid",
                        "quote-sent",
                        "needs-proof",
                        "proof-sent",
                        "changes-requested",
                        "approved",
                        "shipped",
                        "ready",
                        "delivered"
                      ]
                    },
                    "status_label": {
                      "type": "string"
                    },
                    "next_step": {
                      "type": "string"
                    },
                    "paid": {
                      "type": "boolean"
                    },
                    "created_at": {
                      "type": "string"
                    },
                    "paid_at": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "item": {
                      "description": "What the order is: its one item, or a summary of several",
                      "type": "string"
                    },
                    "qty": {
                      "description": "Pieces across every item",
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "item": {
                            "type": "string"
                          },
                          "qty": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "proof": {
                            "description": "true for an item the shop proofs before making",
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "item",
                          "qty",
                          "proof"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "summary": {
                      "description": "The order in one line, quantity included",
                      "type": "string"
                    },
                    "fulfilment": {
                      "type": "string",
                      "enum": [
                        "pickup",
                        "ship"
                      ]
                    },
                    "lead_time": {
                      "type": "string"
                    },
                    "pay_by": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "payable": {
                      "type": "boolean"
                    },
                    "shipped": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "at": {
                              "type": "string"
                            },
                            "carrier": {
                              "type": "string"
                            },
                            "tracking": {
                              "type": "string"
                            },
                            "tracking_url": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "at",
                            "carrier",
                            "tracking",
                            "tracking_url"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "ready_at": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "delivered_at": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "order_id",
                    "status",
                    "status_label",
                    "next_step",
                    "paid",
                    "created_at",
                    "paid_at",
                    "item",
                    "qty",
                    "items",
                    "summary",
                    "fulfilment",
                    "lead_time",
                    "pay_by",
                    "payable",
                    "shipped",
                    "ready_at",
                    "delivered_at"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "default": {
            "description": "The request was refused. `error.code` says why.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/quote-requests": {
      "post": {
        "operationId": "request_custom_quote",
        "summary": "Ask a person at the shop for a price",
        "description": "For anything the instant quote can't price: a file with open outlines or engraving artwork, a PDF or sketch, a material that isn't listed, engraving or marking, or a run of 500 or more. It reaches the shop's inbox and a person replies to the email given within 24 hours. Hand-quoted work has a $25 minimum. Send one request per job.",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Any unique string. A retry with the same key answers with the first result instead of making a second one.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "description": "The person's name",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 120
                  },
                  "email": {
                    "description": "The person's email. The shop replies to it; we send nothing to it automatically.",
                    "type": "string",
                    "maxLength": 320
                  },
                  "details": {
                    "description": "What they need: the part, material, thickness, sizes, finish, engraving, and anything the instant quote couldn't handle",
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 3000
                  },
                  "qty": {
                    "default": 1,
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000000
                  },
                  "material": {
                    "description": "A material slug from the catalog, if they chose one",
                    "type": "string",
                    "maxLength": 60
                  },
                  "needed_by": {
                    "description": "A date, if they have a deadline",
                    "type": "string",
                    "maxLength": 40
                  },
                  "company": {
                    "type": "string",
                    "maxLength": 160
                  },
                  "phone": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "po": {
                    "type": "string",
                    "maxLength": 60
                  },
                  "files": {
                    "description": "Up to 5 files, each sent the same ways as a quote's file. Any of: stl, 3mf, obj, step, stp, svg, dxf, pdf, png, jpg, jpeg, webp, heic, heif, ai, eps, dwg, cdr",
                    "default": [],
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "file_id": {
                          "description": "A file sent in an earlier call (every quote answers with one). Kept 30 days.",
                          "type": "string",
                          "maxLength": 40
                        },
                        "file_url": {
                          "description": "A public https link to the DXF or SVG, up to 10 MB. We download it.",
                          "type": "string",
                          "maxLength": 2000
                        },
                        "file_text": {
                          "description": "The file's own text (DXF and SVG are both plain text), up to 4 MB. Send with file_name.",
                          "type": "string"
                        },
                        "file_base64": {
                          "description": "The file's bytes, base64, up to 4 MB. Send with file_name.",
                          "type": "string"
                        },
                        "file_name": {
                          "description": "The file's name with its extension",
                          "type": "string",
                          "maxLength": 200
                        }
                      }
                    }
                  }
                },
                "required": [
                  "name",
                  "email",
                  "details"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "request_id": {
                      "type": "string"
                    },
                    "received": {
                      "type": "boolean",
                      "const": true
                    },
                    "files_received": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "what_happens_next": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "request_id",
                    "received",
                    "files_received",
                    "what_happens_next"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "default": {
            "description": "The request was refused. `error.code` says why.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/templates": {
      "get": {
        "operationId": "list_templates",
        "summary": "Parts that need no drawing",
        "description": "Parametric parts the shop cuts from dimensions alone, with no drawing. Each lists its parameters with defaults and limits. Use quote_template to price one, and create_order with kind laser-template to order it. For a person with no CAD file.",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "note": {
                      "type": "string"
                    },
                    "templates": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "slug": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "category": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "unit": {
                            "description": "What one of it is called: part, box, set",
                            "type": "string"
                          },
                          "default_material": {
                            "type": "string"
                          },
                          "note": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "url": {
                            "description": "The template's page, where a person types the same values and sees the drawing",
                            "type": "string"
                          },
                          "params": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string"
                                },
                                "label": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string",
                                  "enum": [
                                    "length",
                                    "count",
                                    "toggle",
                                    "choice"
                                  ]
                                },
                                "unit": {
                                  "anyOf": [
                                    {
                                      "type": "string"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "default": {
                                  "type": "number"
                                },
                                "min": {
                                  "type": "number"
                                },
                                "max": {
                                  "type": "number"
                                },
                                "options": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "value": {
                                        "type": "number"
                                      },
                                      "label": {
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "value",
                                      "label"
                                    ],
                                    "additionalProperties": false
                                  }
                                },
                                "hint": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "key",
                                "label",
                                "kind",
                                "unit",
                                "default",
                                "min",
                                "max"
                              ],
                              "additionalProperties": false
                            }
                          }
                        },
                        "required": [
                          "slug",
                          "name",
                          "category",
                          "description",
                          "unit",
                          "default_material",
                          "note",
                          "url",
                          "params"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "note",
                    "templates"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "default": {
            "description": "The request was refused. `error.code` says why.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/quote/template": {
      "post": {
        "operationId": "quote_template",
        "summary": "Price a part from a template",
        "description": "Prices a template part from its dimensions, in one material at one quantity. Values that don't make a part (a hole wider than the plate) are refused with the reason in plain words. Read the sizes back to the person: the part is cut to exactly these numbers.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "template": {
                    "description": "A template slug from list_templates, e.g. mounting-plate",
                    "type": "string",
                    "maxLength": 60
                  },
                  "values": {
                    "description": "The template's parameters by key. Lengths are in inches; a toggle is 1 or 0; a choice is one of its option values. Any left out take the template's default.",
                    "default": {},
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "type": "number"
                    }
                  },
                  "ship_zip": {
                    "description": "The 5-digit US ZIP it would ship to. Given, the answer adds what shipping costs and the total before sales tax, so the person sees the whole price before an order is made.",
                    "type": "string",
                    "maxLength": 10
                  },
                  "material": {
                    "description": "A material slug from get_catalog. Left out, the template's usual sheet is used; the answer says which.",
                    "type": "string",
                    "maxLength": 60
                  },
                  "qty": {
                    "description": "How many. For a file holding several parts, how many sets of the whole file.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  }
                },
                "required": [
                  "template",
                  "qty"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "priceable": {
                      "type": "boolean",
                      "const": true
                    },
                    "template": {
                      "type": "object",
                      "properties": {
                        "slug": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "unit": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "slug",
                        "name",
                        "unit"
                      ],
                      "additionalProperties": false
                    },
                    "values": {
                      "description": "Every parameter as priced, defaults filled in",
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "number"
                      }
                    },
                    "material": {
                      "type": "object",
                      "properties": {
                        "slug": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "thickness_in": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "slug",
                        "name",
                        "thickness_in"
                      ],
                      "additionalProperties": false
                    },
                    "qty": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "price": {
                      "type": "object",
                      "properties": {
                        "currency": {
                          "type": "string",
                          "const": "usd"
                        },
                        "each_cents": {
                          "description": "One part, or one set when the file holds several parts",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "parts_cents": {
                          "description": "US cents",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "minimum_top_up_cents": {
                          "description": "Added when the parts come to less than the order minimum",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "subtotal_cents": {
                          "description": "Before shipping and sales tax",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "display": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "currency",
                        "each_cents",
                        "parts_cents",
                        "minimum_top_up_cents",
                        "subtotal_cents",
                        "display"
                      ],
                      "additionalProperties": false
                    },
                    "price_breaks": {
                      "description": "The same job at other quantities, the one asked for included. Quantity discounts are automatic.",
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "qty": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "each_cents": {
                            "description": "US cents",
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "subtotal_cents": {
                            "description": "Before shipping and sales tax, order minimum included",
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          }
                        },
                        "required": [
                          "qty",
                          "each_cents",
                          "subtotal_cents"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "shipping": {
                      "description": "What shipping costs to ship_zip. Null when no ship_zip was sent, or the order is pickup only.",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "zip": {
                              "type": "string"
                            },
                            "cents": {
                              "description": "US cents",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "service": {
                              "type": "string"
                            },
                            "transit_business_days": {
                              "description": "The carrier's estimate, after the order is made",
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "rate": {
                              "description": "carrier: the live rate to this ZIP. flat: our flat rate, used when the carrier gives none",
                              "type": "string",
                              "enum": [
                                "carrier",
                                "flat"
                              ]
                            }
                          },
                          "required": [
                            "zip",
                            "cents",
                            "service",
                            "transit_business_days",
                            "rate"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "total_before_tax": {
                      "description": "Price plus shipping, before sales tax. Null without ship_zip.",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "cents": {
                              "description": "US cents",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "display": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "cents",
                            "display"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "specs": {
                      "description": "What will be made, as the shop's build sheet reads it",
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "label": {
                            "type": "string"
                          },
                          "value": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "label",
                          "value"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "excludes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "lead_time": {
                      "type": "string"
                    },
                    "review_notes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "next": {
                      "type": "object",
                      "properties": {
                        "create_order": {
                          "type": "string"
                        },
                        "human_url": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "create_order",
                        "human_url"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "priceable",
                    "template",
                    "values",
                    "material",
                    "qty",
                    "price",
                    "price_breaks",
                    "shipping",
                    "total_before_tax",
                    "specs",
                    "excludes",
                    "lead_time",
                    "review_notes",
                    "next"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "default": {
            "description": "The request was refused. `error.code` says why.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "quote_template_get",
        "summary": "Price a part from a template (by link)",
        "description": "quote_template as a GET, for an agent that can only follow links. The same fields as query parameters; an object or a list goes in as JSON text.",
        "parameters": [
          {
            "name": "template",
            "in": "query",
            "required": true,
            "description": "A template slug from list_templates, e.g. mounting-plate",
            "schema": {
              "description": "A template slug from list_templates, e.g. mounting-plate",
              "type": "string",
              "maxLength": 60
            }
          },
          {
            "name": "values",
            "in": "query",
            "required": false,
            "description": "The template's parameters by key. Lengths are in inches; a toggle is 1 or 0; a choice is one of its option values. Any left out take the template's default.",
            "schema": {
              "description": "The template's parameters by key. Lengths are in inches; a toggle is 1 or 0; a choice is one of its option values. Any left out take the template's default.",
              "default": {},
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "number"
              }
            }
          },
          {
            "name": "ship_zip",
            "in": "query",
            "required": false,
            "description": "The 5-digit US ZIP it would ship to. Given, the answer adds what shipping costs and the total before sales tax, so the person sees the whole price before an order is made.",
            "schema": {
              "description": "The 5-digit US ZIP it would ship to. Given, the answer adds what shipping costs and the total before sales tax, so the person sees the whole price before an order is made.",
              "type": "string",
              "maxLength": 10
            }
          },
          {
            "name": "material",
            "in": "query",
            "required": false,
            "description": "A material slug from get_catalog. Left out, the template's usual sheet is used; the answer says which.",
            "schema": {
              "description": "A material slug from get_catalog. Left out, the template's usual sheet is used; the answer says which.",
              "type": "string",
              "maxLength": 60
            }
          },
          {
            "name": "qty",
            "in": "query",
            "required": true,
            "description": "How many. For a file holding several parts, how many sets of the whole file.",
            "schema": {
              "description": "How many. For a file holding several parts, how many sets of the whole file.",
              "type": "integer",
              "minimum": 1,
              "maximum": 10000
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "priceable": {
                      "type": "boolean",
                      "const": true
                    },
                    "template": {
                      "type": "object",
                      "properties": {
                        "slug": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "unit": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "slug",
                        "name",
                        "unit"
                      ],
                      "additionalProperties": false
                    },
                    "values": {
                      "description": "Every parameter as priced, defaults filled in",
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "number"
                      }
                    },
                    "material": {
                      "type": "object",
                      "properties": {
                        "slug": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "thickness_in": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "slug",
                        "name",
                        "thickness_in"
                      ],
                      "additionalProperties": false
                    },
                    "qty": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "price": {
                      "type": "object",
                      "properties": {
                        "currency": {
                          "type": "string",
                          "const": "usd"
                        },
                        "each_cents": {
                          "description": "One part, or one set when the file holds several parts",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "parts_cents": {
                          "description": "US cents",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "minimum_top_up_cents": {
                          "description": "Added when the parts come to less than the order minimum",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "subtotal_cents": {
                          "description": "Before shipping and sales tax",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "display": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "currency",
                        "each_cents",
                        "parts_cents",
                        "minimum_top_up_cents",
                        "subtotal_cents",
                        "display"
                      ],
                      "additionalProperties": false
                    },
                    "price_breaks": {
                      "description": "The same job at other quantities, the one asked for included. Quantity discounts are automatic.",
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "qty": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "each_cents": {
                            "description": "US cents",
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "subtotal_cents": {
                            "description": "Before shipping and sales tax, order minimum included",
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          }
                        },
                        "required": [
                          "qty",
                          "each_cents",
                          "subtotal_cents"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "shipping": {
                      "description": "What shipping costs to ship_zip. Null when no ship_zip was sent, or the order is pickup only.",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "zip": {
                              "type": "string"
                            },
                            "cents": {
                              "description": "US cents",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "service": {
                              "type": "string"
                            },
                            "transit_business_days": {
                              "description": "The carrier's estimate, after the order is made",
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "rate": {
                              "description": "carrier: the live rate to this ZIP. flat: our flat rate, used when the carrier gives none",
                              "type": "string",
                              "enum": [
                                "carrier",
                                "flat"
                              ]
                            }
                          },
                          "required": [
                            "zip",
                            "cents",
                            "service",
                            "transit_business_days",
                            "rate"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "total_before_tax": {
                      "description": "Price plus shipping, before sales tax. Null without ship_zip.",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "cents": {
                              "description": "US cents",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "display": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "cents",
                            "display"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "specs": {
                      "description": "What will be made, as the shop's build sheet reads it",
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "label": {
                            "type": "string"
                          },
                          "value": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "label",
                          "value"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "excludes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "lead_time": {
                      "type": "string"
                    },
                    "review_notes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "next": {
                      "type": "object",
                      "properties": {
                        "create_order": {
                          "type": "string"
                        },
                        "human_url": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "create_order",
                        "human_url"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "priceable",
                    "template",
                    "values",
                    "material",
                    "qty",
                    "price",
                    "price_breaks",
                    "shipping",
                    "total_before_tax",
                    "specs",
                    "excludes",
                    "lead_time",
                    "review_notes",
                    "next"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "default": {
            "description": "The request was refused. `error.code` says why.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/products": {
      "get": {
        "operationId": "list_products",
        "summary": "Personalized products",
        "description": "Products the shop supplies and marks with the person's text, each with its colours, price by quantity, fonts and text limits. Use quote_product to price one with their text, and create_order with kind personalize to order it. There is no order minimum on these.",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "note": {
                      "type": "string"
                    },
                    "products": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "slug": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "category": {
                            "type": "string"
                          },
                          "summary": {
                            "type": "string"
                          },
                          "spec": {
                            "type": "string"
                          },
                          "takes": {
                            "type": "array",
                            "items": {
                              "type": "string",
                              "enum": [
                                "text",
                                "image"
                              ]
                            }
                          },
                          "orderable_here": {
                            "description": "true: takes text, so quote_product and create_order work. false: it takes only a logo or photo, which the person adds on the product page (url)",
                            "type": "boolean"
                          },
                          "variant_name": {
                            "type": "string"
                          },
                          "variants": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "slug": {
                                  "type": "string"
                                },
                                "label": {
                                  "type": "string"
                                },
                                "extra_cents": {
                                  "description": "US cents",
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                }
                              },
                              "required": [
                                "slug",
                                "label",
                                "extra_cents"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "price_tiers": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "min_qty": {
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                },
                                "each_cents": {
                                  "description": "US cents",
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                }
                              },
                              "required": [
                                "min_qty",
                                "each_cents"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "fonts": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string"
                                },
                                "label": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "key",
                                "label"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "max_text_lines": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "max_line_chars": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "per_letter": {
                            "description": "Standing letters: priced per letter, and qty is how many copies of the word",
                            "type": "boolean"
                          },
                          "takes_names": {
                            "description": "Can carry a different name on each piece",
                            "type": "boolean"
                          },
                          "pickup_only": {
                            "type": "boolean"
                          },
                          "lead_time": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "slug",
                          "name",
                          "category",
                          "summary",
                          "spec",
                          "takes",
                          "orderable_here",
                          "variant_name",
                          "variants",
                          "price_tiers",
                          "fonts",
                          "max_text_lines",
                          "max_line_chars",
                          "per_letter",
                          "takes_names",
                          "pickup_only",
                          "lead_time",
                          "url"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "note",
                    "products"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "default": {
            "description": "The request was refused. `error.code` says why.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/quote/product": {
      "post": {
        "operationId": "quote_product",
        "summary": "Price a personalized product",
        "description": "Prices a product from list_products with the person's text on it, in one colour at one quantity. The price is by quantity tier and there is no order minimum. Read the text back to the person exactly as you sent it, spelling included: it is what gets engraved, after they approve a proof.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "product": {
                    "description": "A product slug from list_products",
                    "type": "string",
                    "maxLength": 60
                  },
                  "variant": {
                    "description": "A variant slug (a colour or size) from list_products. Left out, the first is used; the answer says which.",
                    "type": "string",
                    "maxLength": 60
                  },
                  "text": {
                    "description": "The text to put on it: up to 3 lines of 40 characters, as an array or one string with line breaks",
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 400
                      },
                      {
                        "maxItems": 3,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "maxLength": 40
                        }
                      }
                    ]
                  },
                  "font": {
                    "description": "A font key from the product's fonts in list_products. Left out, the first is used.",
                    "type": "string",
                    "maxLength": 20
                  },
                  "names": {
                    "description": "A different name on each piece, one per piece, for products with takes_names. `text` is then the first name.",
                    "maxItems": 5000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200
                    }
                  },
                  "notes": {
                    "description": "Anything the shop should know. A person reads it before making the order.",
                    "type": "string",
                    "maxLength": 500
                  },
                  "ship_zip": {
                    "description": "The 5-digit US ZIP it would ship to. Given, the answer adds what shipping costs and the total before sales tax, so the person sees the whole price before an order is made.",
                    "type": "string",
                    "maxLength": 10
                  },
                  "qty": {
                    "description": "How many pieces. For a per_letter product, how many copies of the word.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 5000
                  }
                },
                "required": [
                  "product",
                  "text",
                  "qty"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "priceable": {
                      "type": "boolean",
                      "const": true
                    },
                    "product": {
                      "type": "object",
                      "properties": {
                        "slug": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "slug",
                        "name"
                      ],
                      "additionalProperties": false
                    },
                    "variant": {
                      "type": "object",
                      "properties": {
                        "slug": {
                          "type": "string"
                        },
                        "label": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "slug",
                        "label"
                      ],
                      "additionalProperties": false
                    },
                    "text": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "font": {
                      "type": "string"
                    },
                    "qty": {
                      "description": "Pieces priced. For a per_letter product, the number of letters",
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "letters_per_copy": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "price": {
                      "type": "object",
                      "properties": {
                        "currency": {
                          "type": "string",
                          "const": "usd"
                        },
                        "each_cents": {
                          "description": "One part, or one set when the file holds several parts",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "parts_cents": {
                          "description": "US cents",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "minimum_top_up_cents": {
                          "description": "Added when the parts come to less than the order minimum",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "subtotal_cents": {
                          "description": "Before shipping and sales tax",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "display": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "currency",
                        "each_cents",
                        "parts_cents",
                        "minimum_top_up_cents",
                        "subtotal_cents",
                        "display"
                      ],
                      "additionalProperties": false
                    },
                    "shipping": {
                      "description": "What shipping costs to ship_zip. Null when no ship_zip was sent, or the order is pickup only.",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "zip": {
                              "type": "string"
                            },
                            "cents": {
                              "description": "US cents",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "service": {
                              "type": "string"
                            },
                            "transit_business_days": {
                              "description": "The carrier's estimate, after the order is made",
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "rate": {
                              "description": "carrier: the live rate to this ZIP. flat: our flat rate, used when the carrier gives none",
                              "type": "string",
                              "enum": [
                                "carrier",
                                "flat"
                              ]
                            }
                          },
                          "required": [
                            "zip",
                            "cents",
                            "service",
                            "transit_business_days",
                            "rate"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "total_before_tax": {
                      "description": "Price plus shipping, before sales tax. Null without ship_zip.",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "cents": {
                              "description": "US cents",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "display": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "cents",
                            "display"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "specs": {
                      "description": "What will be made, as the shop's build sheet reads it",
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "label": {
                            "type": "string"
                          },
                          "value": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "label",
                          "value"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "excludes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "proof": {
                      "type": "string"
                    },
                    "lead_time": {
                      "type": "string"
                    },
                    "pickup_only": {
                      "type": "boolean"
                    },
                    "review_notes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "next": {
                      "type": "object",
                      "properties": {
                        "create_order": {
                          "type": "string"
                        },
                        "human_url": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "create_order",
                        "human_url"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "priceable",
                    "product",
                    "variant",
                    "text",
                    "font",
                    "qty",
                    "letters_per_copy",
                    "price",
                    "shipping",
                    "total_before_tax",
                    "specs",
                    "excludes",
                    "proof",
                    "lead_time",
                    "pickup_only",
                    "review_notes",
                    "next"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "default": {
            "description": "The request was refused. `error.code` says why.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "quote_product_get",
        "summary": "Price a personalized product (by link)",
        "description": "quote_product as a GET, for an agent that can only follow links. The same fields as query parameters; an object or a list goes in as JSON text.",
        "parameters": [
          {
            "name": "product",
            "in": "query",
            "required": true,
            "description": "A product slug from list_products",
            "schema": {
              "description": "A product slug from list_products",
              "type": "string",
              "maxLength": 60
            }
          },
          {
            "name": "variant",
            "in": "query",
            "required": false,
            "description": "A variant slug (a colour or size) from list_products. Left out, the first is used; the answer says which.",
            "schema": {
              "description": "A variant slug (a colour or size) from list_products. Left out, the first is used; the answer says which.",
              "type": "string",
              "maxLength": 60
            }
          },
          {
            "name": "text",
            "in": "query",
            "required": true,
            "description": "The text to put on it: up to 3 lines of 40 characters, as an array or one string with line breaks",
            "schema": {
              "description": "The text to put on it: up to 3 lines of 40 characters, as an array or one string with line breaks",
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 400
                },
                {
                  "maxItems": 3,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "maxLength": 40
                  }
                }
              ]
            }
          },
          {
            "name": "font",
            "in": "query",
            "required": false,
            "description": "A font key from the product's fonts in list_products. Left out, the first is used.",
            "schema": {
              "description": "A font key from the product's fonts in list_products. Left out, the first is used.",
              "type": "string",
              "maxLength": 20
            }
          },
          {
            "name": "names",
            "in": "query",
            "required": false,
            "description": "A different name on each piece, one per piece, for products with takes_names. `text` is then the first name.",
            "schema": {
              "description": "A different name on each piece, one per piece, for products with takes_names. `text` is then the first name.",
              "maxItems": 5000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 200
              }
            }
          },
          {
            "name": "notes",
            "in": "query",
            "required": false,
            "description": "Anything the shop should know. A person reads it before making the order.",
            "schema": {
              "description": "Anything the shop should know. A person reads it before making the order.",
              "type": "string",
              "maxLength": 500
            }
          },
          {
            "name": "ship_zip",
            "in": "query",
            "required": false,
            "description": "The 5-digit US ZIP it would ship to. Given, the answer adds what shipping costs and the total before sales tax, so the person sees the whole price before an order is made.",
            "schema": {
              "description": "The 5-digit US ZIP it would ship to. Given, the answer adds what shipping costs and the total before sales tax, so the person sees the whole price before an order is made.",
              "type": "string",
              "maxLength": 10
            }
          },
          {
            "name": "qty",
            "in": "query",
            "required": true,
            "description": "How many pieces. For a per_letter product, how many copies of the word.",
            "schema": {
              "description": "How many pieces. For a per_letter product, how many copies of the word.",
              "type": "integer",
              "minimum": 1,
              "maximum": 5000
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "priceable": {
                      "type": "boolean",
                      "const": true
                    },
                    "product": {
                      "type": "object",
                      "properties": {
                        "slug": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "slug",
                        "name"
                      ],
                      "additionalProperties": false
                    },
                    "variant": {
                      "type": "object",
                      "properties": {
                        "slug": {
                          "type": "string"
                        },
                        "label": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "slug",
                        "label"
                      ],
                      "additionalProperties": false
                    },
                    "text": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "font": {
                      "type": "string"
                    },
                    "qty": {
                      "description": "Pieces priced. For a per_letter product, the number of letters",
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "letters_per_copy": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "price": {
                      "type": "object",
                      "properties": {
                        "currency": {
                          "type": "string",
                          "const": "usd"
                        },
                        "each_cents": {
                          "description": "One part, or one set when the file holds several parts",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "parts_cents": {
                          "description": "US cents",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "minimum_top_up_cents": {
                          "description": "Added when the parts come to less than the order minimum",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "subtotal_cents": {
                          "description": "Before shipping and sales tax",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "display": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "currency",
                        "each_cents",
                        "parts_cents",
                        "minimum_top_up_cents",
                        "subtotal_cents",
                        "display"
                      ],
                      "additionalProperties": false
                    },
                    "shipping": {
                      "description": "What shipping costs to ship_zip. Null when no ship_zip was sent, or the order is pickup only.",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "zip": {
                              "type": "string"
                            },
                            "cents": {
                              "description": "US cents",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "service": {
                              "type": "string"
                            },
                            "transit_business_days": {
                              "description": "The carrier's estimate, after the order is made",
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "rate": {
                              "description": "carrier: the live rate to this ZIP. flat: our flat rate, used when the carrier gives none",
                              "type": "string",
                              "enum": [
                                "carrier",
                                "flat"
                              ]
                            }
                          },
                          "required": [
                            "zip",
                            "cents",
                            "service",
                            "transit_business_days",
                            "rate"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "total_before_tax": {
                      "description": "Price plus shipping, before sales tax. Null without ship_zip.",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "cents": {
                              "description": "US cents",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "display": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "cents",
                            "display"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "specs": {
                      "description": "What will be made, as the shop's build sheet reads it",
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "label": {
                            "type": "string"
                          },
                          "value": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "label",
                          "value"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "excludes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "proof": {
                      "type": "string"
                    },
                    "lead_time": {
                      "type": "string"
                    },
                    "pickup_only": {
                      "type": "boolean"
                    },
                    "review_notes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "next": {
                      "type": "object",
                      "properties": {
                        "create_order": {
                          "type": "string"
                        },
                        "human_url": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "create_order",
                        "human_url"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "priceable",
                    "product",
                    "variant",
                    "text",
                    "font",
                    "qty",
                    "letters_per_copy",
                    "price",
                    "shipping",
                    "total_before_tax",
                    "specs",
                    "excludes",
                    "proof",
                    "lead_time",
                    "pickup_only",
                    "review_notes",
                    "next"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "default": {
            "description": "The request was refused. `error.code` says why.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/quote-order": {
      "post": {
        "operationId": "quote_order",
        "summary": "Price several things as one order",
        "description": "Prices a list of things as one order: each item at its own quantity, ONE order minimum for the lot, and ONE parcel to one ZIP. Send up to 20 items; each is a file you already quoted (by file_id), a template part or a personalized product, with its own material and quantity. The answer says what the whole order costs and what it saves against ordering each item alone. Nothing is stored. To change the order, change the list and call again; when the person is happy, send the same items to create_order.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "items": {
                    "description": "Several things as ONE order: one payment link, one order minimum, one parcel. Up to 20. Each item takes the same fields as an order of one thing (kind, material, qty, template, values, product, text ...), with its own quantity. A laser-file item names its file by file_id: quote the file first with quote_laser_file, which answers with the id. The same file_id may appear in several items, e.g. the same part in two materials.",
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "description": "What is being ordered. laser-file (the default): a DXF or SVG, with the file fields and material. laser-template: template, values and material. personalize: product, variant, text and font.",
                          "default": "laser-file",
                          "type": "string",
                          "enum": [
                            "laser-file",
                            "laser-template",
                            "personalize"
                          ]
                        },
                        "material": {
                          "description": "A material slug from get_catalog. Needed for laser-file; optional for laser-template; not used for personalize.",
                          "type": "string",
                          "maxLength": 60
                        },
                        "qty": {
                          "description": "How many. For a file holding several parts, how many sets of the whole file.",
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 10000
                        },
                        "units": {
                          "description": "The units a DXF is drawn in when the file doesn't say. Leave out to let us read the file; the answer says what was assumed.",
                          "type": "string",
                          "enum": [
                            "in",
                            "mm"
                          ]
                        },
                        "scale": {
                          "description": "Resize the part: 1 is the file's own size, 0.5 is half.",
                          "default": 1,
                          "type": "number",
                          "exclusiveMinimum": 0,
                          "maximum": 100
                        },
                        "template": {
                          "description": "A template slug from list_templates, e.g. mounting-plate",
                          "type": "string",
                          "maxLength": 60
                        },
                        "values": {
                          "description": "The template's parameters by key. Lengths are in inches; a toggle is 1 or 0; a choice is one of its option values. Any left out take the template's default.",
                          "default": {},
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "number"
                          }
                        },
                        "product": {
                          "description": "A product slug from list_products",
                          "type": "string",
                          "maxLength": 60
                        },
                        "variant": {
                          "description": "A variant slug (a colour or size) from list_products. Left out, the first is used; the answer says which.",
                          "type": "string",
                          "maxLength": 60
                        },
                        "text": {
                          "description": "The text to put on it: up to 3 lines of 40 characters, as an array or one string with line breaks",
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 400
                            },
                            {
                              "maxItems": 3,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "maxLength": 40
                              }
                            }
                          ]
                        },
                        "font": {
                          "description": "A font key from the product's fonts in list_products. Left out, the first is used.",
                          "type": "string",
                          "maxLength": 20
                        },
                        "names": {
                          "description": "A different name on each piece, one per piece, for products with takes_names. `text` is then the first name.",
                          "maxItems": 5000,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 200
                          }
                        },
                        "notes": {
                          "description": "Anything the shop should know. A person reads it before making the order.",
                          "type": "string",
                          "maxLength": 500
                        },
                        "file_id": {
                          "description": "A file sent in an earlier call (every quote answers with one). Kept 30 days.",
                          "type": "string",
                          "maxLength": 40
                        }
                      }
                    }
                  },
                  "ship_zip": {
                    "description": "The 5-digit US ZIP it would ship to. Given, the answer adds what shipping costs and the total before sales tax, so the person sees the whole price before an order is made.",
                    "type": "string",
                    "maxLength": 10
                  }
                },
                "required": [
                  "items"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "priceable": {
                      "type": "boolean",
                      "const": true
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "item": {
                            "type": "string"
                          },
                          "kind": {
                            "type": "string"
                          },
                          "qty": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "each_cents": {
                            "description": "US cents",
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "parts_cents": {
                            "description": "This item's goods. The order minimum is on the order, not on an item",
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "needs_proof": {
                            "description": "false: made exactly as ordered, with no proof. true: the shop emails a proof to approve first",
                            "type": "boolean"
                          },
                          "lead_time": {
                            "type": "string"
                          },
                          "review_notes": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "pickup_only": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "item",
                          "kind",
                          "qty",
                          "each_cents",
                          "parts_cents",
                          "needs_proof",
                          "lead_time",
                          "review_notes",
                          "pickup_only"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "price": {
                      "type": "object",
                      "properties": {
                        "currency": {
                          "type": "string",
                          "const": "usd"
                        },
                        "parts_cents": {
                          "description": "Every item's goods",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "minimum_top_up_cents": {
                          "description": "Added once when the whole order comes to less than the order minimum; 0 otherwise",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "subtotal_cents": {
                          "description": "Before shipping and sales tax",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "display": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "currency",
                        "parts_cents",
                        "minimum_top_up_cents",
                        "subtotal_cents",
                        "display"
                      ],
                      "additionalProperties": false
                    },
                    "saved_vs_separate_cents": {
                      "description": "What one order saves in order minimums against ordering each item on its own. Shipping once instead of several times saves more, and is not counted here",
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "shipping": {
                      "description": "What shipping costs to ship_zip. Null when no ship_zip was sent, or the order is pickup only.",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "zip": {
                              "type": "string"
                            },
                            "cents": {
                              "description": "US cents",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "service": {
                              "type": "string"
                            },
                            "transit_business_days": {
                              "description": "The carrier's estimate, after the order is made",
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "rate": {
                              "description": "carrier: the live rate to this ZIP. flat: our flat rate, used when the carrier gives none",
                              "type": "string",
                              "enum": [
                                "carrier",
                                "flat"
                              ]
                            }
                          },
                          "required": [
                            "zip",
                            "cents",
                            "service",
                            "transit_business_days",
                            "rate"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "total_before_tax": {
                      "description": "Price plus shipping, before sales tax. Null without ship_zip.",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "cents": {
                              "description": "US cents",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "display": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "cents",
                            "display"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "excludes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "needs_proof": {
                      "description": "Whether anything on the order waits for a proof before it is made",
                      "type": "boolean"
                    },
                    "proof_items": {
                      "description": "Which items get a proof, as positions in items (0 is the first)",
                      "type": "array",
                      "items": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      }
                    },
                    "pickup_only": {
                      "description": "True when an item is too big for a parcel: the whole order is then pickup only",
                      "type": "boolean"
                    },
                    "lead_time": {
                      "description": "One lead time for the order: its slowest item's. Everything leaves together",
                      "type": "string"
                    },
                    "notes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "next": {
                      "type": "object",
                      "properties": {
                        "create_order": {
                          "type": "string"
                        },
                        "human_url": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "create_order",
                        "human_url"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "priceable",
                    "items",
                    "price",
                    "saved_vs_separate_cents",
                    "shipping",
                    "total_before_tax",
                    "excludes",
                    "needs_proof",
                    "proof_items",
                    "pickup_only",
                    "lead_time",
                    "notes",
                    "next"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "default": {
            "description": "The request was refused. `error.code` says why.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "code",
              "message"
            ],
            "properties": {
              "code": {
                "type": "string",
                "description": "Stable, machine-readable. Listed on /agents."
              },
              "message": {
                "type": "string",
                "description": "Plain words, fit to show the person."
              },
              "retry_after_s": {
                "type": "integer"
              },
              "human_url": {
                "type": "string",
                "description": "Where the person can do this on the website instead."
              },
              "field": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        }
      }
    }
  }
}