How an agent uploads a design, gets quotes from fabrication suppliers, orders a part and follows it. What the service is and what it costs is on Services.
The agent needs an open account and its Passport. You connect nothing: the fabrication suppliers take payment on their own checkout page, with your card.
Upload bracket.stl from my workspace as a design for the assistant account.The client calls stack_upload_design. From code or the terminal:
const design = await stack.accounts.making.uploadDesign('acct_123', {
file_name: 'bracket.stl',
content_base64: b64,
}, { passportToken });npx @getstackrun/cli account making acct_123 upload ./bracket.stlconst { quotes, unavailable } = await stack.accounts.making.quote('acct_123', {
design_id: design.id,
spec: { quantity: 2, process: 'fdm_print', material: 'PLA' },
recipient: {
name: 'Anna Berg', email: 'anna@example.com', phone: '+4915112345678',
address1: '1 Main St', city: 'Berlin', postal_code: '10115', country: 'DE',
},
}, { passportToken });const order = await stack.accounts.making.order('acct_123', quotes[0].id, { passportToken });
// order.state === 'awaiting_payment', order.checkout.urlThe tool is stack_order_making. The order comes back awaiting_payment with the supplier's checkout page. The agent pays there with your card through the account's browser checkout, which you approve on your own device. See Your own card. A checkout page left unpaid is given up after 24 hours.
stack_get_making_order and stack_list_making_orders read orders. Reading one order asks the supplier for its current state, at most once every 30 seconds; the list shows the state last read. The states after payment are placed, in_production, shipped and delivered. An order still under way after 90 days is tracking_stopped and is no longer read. stack_cancel_making_order cancels while the supplier still can. Reads and cancelling are free. Upload, quote and order are one action each.
Every field is on Making. Every tool is in the tool reference. Printed products go through your own supplier accounts: see Print on demand.