Need it for Christmas? Order by Monday, December 7. Lead times

For AI agents

Ordering from FSH Labs with an AI agent

FSH Labs is a laser cutting shop an AI agent can order from: it prices a DXF or SVG in acrylic, wood or Delrin in one call, with no account and no API key, and hands the person a link to pay.

FSH Labs laser cuts acrylic, wood and Delrin in metro Atlanta, Georgia, and ships across the US. An AI agent can price a DXF or SVG, a part from a template or a personalized product, hand the person a link to pay, and after they pay follow the order, show its proof and order it again, with no account, no API key and nothing to install. Every order is ready in 7 - 10 business days.

HTTP API
https://www.fshlabs.com/agents/v1
JSON over HTTPS. Open to any origin.
OpenAPI
https://www.fshlabs.com/agents/v1/openapi.json
The same operations, described for machines.
MCP server
https://www.fshlabs.com/mcp
Streamable HTTP, no authentication. The same operations as tools.
This guide as markdown
https://www.fshlabs.com/agents.md

Ground rules

  • Use it on a person's behalf. They pay; you never see a card.
  • The order minimum is $25 before shipping, with no setup fee, and it is charged once for an order however many items it holds. Quantity discounts are automatic.
  • Several parts, materials or products can be one order with one pay link and one parcel: price the set with quote_order, then send the same items to create_order.
  • Parts are cut exactly as drawn. Fit and dimensions are the customer's, so confirm sizes with them.
  • Parts up to 23.2 x 11.6 in. Outlines must be closed. Text must be converted to outlines.
  • We ship in the US only, and there is no rush service.
  • After the person pays you can see the order and its proof, order the same thing again, and pass the shop a request. Paying and approving a proof are theirs alone.
  • Don't invent a price. If you can't call the API, send the person to the quote page below.

Today's price for a 6 x 4 in plate with four holes, Birch plywood, 20 parts: $53.40 ($2.67 each), before shipping and tax.

1. See what we cut

GET /agents/v1/catalog or the MCP tool get_catalog

Every material and thickness with its slug, the size limits, the order minimum, the lead time and the issue codes a quote can return.

design_rules is what to draw to if you make the file yourself: the kerf, the smallest gap between cuts, and how far a real sheet strays from its listed thickness. policies covers remakes and what happens to files.

Request

curl -s https://www.fshlabs.com/agents/v1/catalog

Answer

{
  "materials": [
    {
      "slug": "birch-125",
      "name": "Birch plywood",
      "family": "wood",
      "thickness_in": 0.125,
      "quote_url": "https://www.fshlabs.com/laser-cutting/online-quote?material=birch-125"
    },
    "..."
  ],
  "limits": {
    "file_formats": [
      "dxf",
      "svg"
    ],
    "max_part_in": {
      "long": 23.2,
      "short": 11.6
    },
    "max_inline_file_bytes": 4194304
  },
  "pricing": {
    "order_minimum_cents": 2500,
    "setup_fee_cents": 0
  },
  "lead_time": "7 - 10 business days"
}

2. Price a file

POST /agents/v1/quote or the MCP tool quote_laser_file

Send the file one of four ways: a multipart upload in a field named file; file_url, a public https link (up to 10 MB); file_text, the file's own text, since DXF and SVG are both plain text (up to 4 MB, with file_name); or file_base64 (up to 4 MB, with file_name).

The answer carries a file_id. Use it for every later call, so the file is only sent once: change qty or material and quote again as often as you like.

A file that can't be priced instantly still answers 200, with priceable: false and issues saying why. block issues stop the order. review issues are priced and a person checks them before cutting.

When a line doesn't close, file.open_lines gives where its two ends are and the gap between them, and file.islands gives where each loose shape sits, so a file you drew yourself can be fixed and sent again.

When file.units_source is assumed, the file didn't say inches or millimetres. Read the sizes back to the person before ordering, or pass units. Parts are cut exactly as drawn.

price_breaks is the same job at other quantities, so one call answers how the price falls with more. Send compare_materials (slugs, or all) to price the same file in other materials too.

Prices are before shipping and sales tax. Send ship_zip and the answer adds shipping and total_before_tax, so the person sees the whole price before any order is made. The same engine prices the website, so the number matches what the person would see there.

A field the operation doesn't take is refused with unknown_fields, never silently dropped.

Request

curl -s https://www.fshlabs.com/agents/v1/quote \
  -F file=@plate.dxf \
  -F material=birch-125 \
  -F qty=20

Answer

{
  "priceable": true,
  "file_id": "f_9KqT2mXv4LpR7sWz1aBcDe",
  "file": {
    "name": "plate.dxf",
    "format": "dxf",
    "units": "in",
    "units_source": "file",
    "parts": [
      {
        "label": "Part 1",
        "count": 1,
        "width_in": 6,
        "height_in": 4,
        "pierces": 5
      }
    ]
  },
  "material": {
    "slug": "birch-125",
    "name": "Birch plywood",
    "thickness_in": 0.125
  },
  "qty": 20,
  "price": {
    "currency": "usd",
    "each_cents": 267,
    "parts_cents": 5340,
    "minimum_top_up_cents": 0,
    "subtotal_cents": 5340,
    "display": "$53.40"
  },
  "price_breaks": [
    {
      "qty": 1,
      "each_cents": 642,
      "subtotal_cents": 2500
    },
    {
      "qty": 2,
      "each_cents": 507,
      "subtotal_cents": 2500
    },
    {
      "qty": 5,
      "each_cents": 387,
      "subtotal_cents": 2500
    },
    {
      "qty": 10,
      "each_cents": 302,
      "subtotal_cents": 3020
    },
    {
      "qty": 20,
      "each_cents": 267,
      "subtotal_cents": 5340
    },
    {
      "qty": 25,
      "each_cents": 256,
      "subtotal_cents": 6400
    },
    {
      "qty": 50,
      "each_cents": 215,
      "subtotal_cents": 10750
    },
    {
      "qty": 100,
      "each_cents": 194,
      "subtotal_cents": 19400
    },
    {
      "qty": 250,
      "each_cents": 194,
      "subtotal_cents": 48500
    }
  ],
  "other_materials": [],
  "shipping": null,
  "total_before_tax": null,
  "excludes": [
    "shipping",
    "sales_tax"
  ],
  "lead_time": "7 - 10 business days (unstocked sheet can add time)",
  "issues": [],
  "next": {
    "recommended": "create_order",
    "create_order": "POST /agents/v1/orders"
  }
}

3. Make a payment link

POST /agents/v1/orders or the MCP tool create_order

Saves the job as an unpaid order and answers with pay_url. Give that link to the person. It opens a page showing the order with a button to pay by card on Stripe, where they enter their address and any sales tax is added. You never handle a card.

fulfilment is ship (UPS Ground, US only, needs ship_zip) or pickup (free, metro Atlanta).

Nothing is made and nobody is charged until they pay. The prices hold for 30 days.

Send an Idempotency-Key header so a retry returns the same order instead of making a second one.

tell_the_person is a ready sentence with the total and the link.

The answer carries three links, and each opens one thing only. pay_url is for the person to pay. status_url reads the order and is safe to keep (step 4). reorder_url prices and orders the same thing again once it is paid (steps 12 and 13).

For several things in one order, send items instead of one thing's fields (step 10): one pay link, one order minimum and one parcel for the lot.

Request

curl -s https://www.fshlabs.com/agents/v1/orders \
  -H 'content-type: application/json' \
  -H 'idempotency-key: 6f1c2a9e' \
  -d '{"file_id":"f_9KqT2mXv4LpR7sWz1aBcDe","material":"birch-125","qty":20,"fulfilment":"ship","ship_zip":"30126"}'

Answer

{
  "order_id": "FSH-20261118-K7M2QX",
  "pay_url": "https://www.fshlabs.com/pay/FSH-20261118-K7M2QX/...",
  "status_url": "https://www.fshlabs.com/agents/v1/orders/FSH-20261118-K7M2QX/...",
  "price": {
    "parts_cents": 5340,
    "minimum_top_up_cents": 0,
    "shipping_cents": "priced to the ZIP",
    "total_before_tax_cents": "parts + minimum + shipping"
  },
  "valid_until": "2026-12-18T04:59:59.999Z",
  "tell_the_person": "Your order FSH-20261118-K7M2QX is saved ... Open the link to check it and pay by card."
}

4. Check the order

GET /agents/v1/orders/{order_id}/{status_token} or the MCP tool get_order_status

GET the status_url from step 3 exactly as given. It reads the order: it can't pay, can't approve a proof and can't download the file, so it is safe to keep.

After the person pays, this one call says everything they can see. proof is the latest proof with its picture link, the shop's note and whether it is decided (step 11). events is the order's history, oldest first, so a look after a week says what happened in between. cancellation says whether it can still be cancelled (step 14).

There is no webhook: the person is emailed at every step, and check_again_in_s says when another look is worth it. An order changes a handful of times in two weeks.

Request

curl -s https://www.fshlabs.com/agents/v1/orders/FSH-20261118-K7M2QX/...

Answer

{
  "order_id": "FSH-20261118-K7M2QX",
  "status": "proof-sent",
  "status_label": "Proof sent, waiting for approval",
  "paid": true,
  "lead_time": "7 - 10 business days (blanks are ordered after you pay)",
  "proof_needed": true,
  "proof": {
    "round": 1,
    "rounds_total": 1,
    "state": "awaiting-approval",
    "note": "Centred under the handle, as asked.",
    "image_url": "https://www.fshlabs.com/agents/v1/orders/FSH-20261118-K7M2QX/.../proofs/1",
    "image_type": "image/png",
    "how_to_decide": "Approving it, or asking for changes, is done from the proof link in the email we sent with it. ..."
  },
  "shipped": null,
  "cancellation": {
    "standing": "before-production",
    "terms": "Not in production yet. It can be cancelled or changed for a full refund ..."
  },
  "events": [
    {
      "at": "2026-11-18T15:02:11.000Z",
      "event": "paid"
    },
    {
      "at": "2026-11-19T14:40:03.000Z",
      "event": "proof-sent",
      "round": 1
    }
  ],
  "updated_at": "2026-11-19T14:40:03.000Z",
  "check_again_in_s": 21600
}

5. Or ask a person for a price

POST /agents/v1/quote-requests or the MCP tool request_custom_quote

For anything the instant quote can't do: a file with block issues, a PDF, photo or sketch, engraving or marking, a material that isn't listed, or 500 or more of a part.

It needs the person's real name and email, because a person at the shop replies to it within 24 hours. We send that address nothing automatically, so tell them it was sent.

Hand-quoted work has a $25 minimum. Send one request per job.

Request

curl -s https://www.fshlabs.com/agents/v1/quote-requests \
  -H 'content-type: application/json' \
  -d '{"name":"Dana Reyes","email":"dana@example.com","qty":4,"details":"12 x 8 in sign in 1/4 in birch with our logo engraved. File attached.","files":[{"file_id":"f_9KqT2mXv4LpR7sWz1aBcDe"}]}'

Answer

{
  "request_id": "L-3FA9C1D2",
  "received": true,
  "files_received": [
    "plate.dxf"
  ],
  "what_happens_next": "The shop has the request ... A person replies within 24 hours with a price and a pay link."
}

6. No drawing? List the part templates

GET /agents/v1/templates or the MCP tool list_templates

26 parts the shop cuts from dimensions alone, for a person with no CAD file. Each lists its parameters with defaults and limits. Lengths are in inches.

Request

curl -s https://www.fshlabs.com/agents/v1/templates

Answer

{
  "templates": [
    {
      "slug": "mounting-plate",
      "name": "Mounting plate",
      "unit": "part",
      "params": [
        {
          "key": "width",
          "label": "Plate width",
          "kind": "length",
          "unit": "in",
          "default": 6,
          "min": 0.75,
          "max": 23
        },
        {
          "key": "height",
          "label": "Plate height",
          "kind": "length",
          "unit": "in",
          "default": 4,
          "min": 0.75,
          "max": 11.5
        },
        "..."
      ]
    },
    "..."
  ]
}

7. Price a template part

POST /agents/v1/quote/template or the MCP tool quote_template

Send the template's slug, any values that differ from its defaults, a material and a qty. Values that don't make a part are refused with the reason in plain words. price_breaks and ship_zip work as they do for a file.

To order it, call step 3 with "kind": "laser-template" and the same template, values, material and qty. Read the sizes back to the person first: the part is cut to exactly these numbers.

Request

curl -s https://www.fshlabs.com/agents/v1/quote/template \
  -H 'content-type: application/json' \
  -d '{"template":"mounting-plate","values":{"width":6,"height":4},"material":"birch-125","qty":20}'

Answer

{
  "priceable": true,
  "template": {
    "slug": "mounting-plate",
    "name": "Mounting plate",
    "unit": "part"
  },
  "values": {
    "width": 6,
    "height": 4,
    "...": "every other parameter, at its default"
  },
  "qty": 20,
  "price": {
    "each_cents": 267,
    "subtotal_cents": 5340,
    "display": "$53.40"
  },
  "lead_time": "7 - 10 business days (unstocked sheet can add time)"
}

8. List personalized products

GET /agents/v1/products or the MCP tool list_products

63 products the shop supplies and marks with the person's text, each with its colours, price by quantity, fonts and text limits. There is no order minimum on these, and no setup fee.

A product with orderable_here: false takes only a logo or photo, which can't be sent through the API yet: give the person its url.

Request

curl -s https://www.fshlabs.com/agents/v1/products

Answer

{
  "products": [
    {
      "slug": "tumbler-20oz",
      "name": "20 oz insulated tumbler",
      "orderable_here": true,
      "variants": [
        {
          "slug": "black",
          "label": "Black",
          "extra_cents": 0
        },
        {
          "slug": "white",
          "label": "White",
          "extra_cents": 0
        }
      ],
      "price_tiers": [
        {
          "min_qty": 1,
          "each_cents": 2200
        },
        {
          "min_qty": 10,
          "each_cents": 1900
        },
        {
          "min_qty": 25,
          "each_cents": 1750
        },
        {
          "min_qty": 50,
          "each_cents": 1650
        },
        {
          "min_qty": 100,
          "each_cents": 1600
        }
      ],
      "fonts": [
        {
          "key": "sans",
          "label": "Sans"
        },
        "..."
      ],
      "max_text_lines": 3
    },
    "..."
  ]
}

9. Price a personalized product

POST /agents/v1/quote/product or the MCP tool quote_product

Send the product, a variant (a colour or size), the text, a font and a qty. For a different name on each piece, send names too.

To order it, call step 3 with "kind": "personalize" and the same fields. After they pay, the person is emailed a proof to approve before anything is made, so read the text back to them exactly as you sent it, spelling included.

Request

curl -s https://www.fshlabs.com/agents/v1/quote/product \
  -H 'content-type: application/json' \
  -d '{"product":"tumbler-20oz","variant":"black","text":["Dana Reyes"],"font":"sans","qty":10}'

Answer

{
  "priceable": true,
  "product": {
    "slug": "tumbler-20oz",
    "name": "20 oz insulated tumbler"
  },
  "variant": {
    "slug": "black",
    "label": "Black"
  },
  "text": [
    "Dana Reyes"
  ],
  "font": "sans",
  "qty": 10,
  "price": {
    "each_cents": 1900,
    "subtotal_cents": 19000,
    "display": "$190.00"
  },
  "proof": "After payment we email the person a proof to approve before anything is made.",
  "lead_time": "7 - 10 business days (blanks are ordered after you pay)"
}

10. Price several things as one order

POST /agents/v1/quote-order or the MCP tool quote_order

A project is rarely one part. Send every part as items and the answer prices them as ONE order: each item at its own quantity, one order minimum for the lot, and one parcel to one ZIP. saved_vs_separate_cents is what that saves against ordering each item alone.

An item is a file you already quoted (file_id, with its material and qty), a template part (kind "laser-template") or a personalized product (kind "personalize"). Up to 20 items. The same file_id can appear twice, for the same part in two materials.

You hold the list. Nothing is stored: to add, remove or change an item, change the list and call again. When the person is happy, send the same items to create_order (step 3) with fulfilment and ship_zip, and give them the one pay_url.

needs_proof and proof_items say which items get a proof before they are made. Cut files and template parts are made exactly as ordered, with no proof; personalized products get one. Everything leaves together, so an order with a proofed item waits for that approval. If the person wants the cut parts sooner, order them on their own.

Request

curl -s https://www.fshlabs.com/agents/v1/quote-order \
  -H 'content-type: application/json' \
  -d '{"items":[{"file_id":"f_9KqT2mXv4LpR7sWz1aBcDe","material":"birch-125","qty":20},{"kind":"laser-template","template":"mounting-plate","values":{"width":6,"height":4},"material":"birch-125","qty":4},{"kind":"personalize","product":"tumbler-20oz","text":"Dana Reyes","qty":10}],"ship_zip":"30126"}'

Answer

{
  "priceable": true,
  "items": [
    {
      "item": "Laser cut part, Birch plywood",
      "kind": "laser-file",
      "qty": 20,
      "each_cents": 267,
      "parts_cents": 5340,
      "needs_proof": false
    },
    "...",
    {
      "item": "20 oz insulated tumbler",
      "kind": "personalize",
      "qty": 10,
      "each_cents": 1900,
      "parts_cents": 19000,
      "needs_proof": true
    }
  ],
  "price": {
    "parts_cents": "every item's goods",
    "minimum_top_up_cents": 0,
    "subtotal_cents": "before shipping and sales tax"
  },
  "saved_vs_separate_cents": "what one order saves in order minimums",
  "shipping": {
    "zip": "30126",
    "cents": "one parcel, priced to the ZIP",
    "service": "UPS Ground"
  },
  "needs_proof": true,
  "proof_items": [
    2
  ],
  "lead_time": "7 - 10 business days",
  "next": {
    "create_order": "POST /agents/v1/orders with the same items, plus fulfilment and ship_zip"
  }
}

11. After they pay: show the proof

GET /agents/v1/orders/{order_id}/{status_token}/proofs/{round} or the MCP tool get_proof_image

A personalized product is proofed before it is made. Once the shop sends the proof, step 4's proof.image_url is this address: GET it for the proof as a PNG or JPEG and show it to the person. For a PDF proof it is the first page, and proof.full_proof_url is the whole file. Over MCP the tool answers with the picture itself.

You can show a proof. You can't approve one, and you can't ask for changes: the person does both from the proof link in the email we sent them. Approval is the moment the lead time starts and the spelling becomes theirs, so it stays with them. Tell them to check their email.

Request

curl -s https://www.fshlabs.com/agents/v1/orders/FSH-20261118-K7M2QX/.../proofs/1 -o proof.png

Answer

{
  "(a file)": "image/png or image/jpeg: the proof. With ?full=1, a PDF proof's own file."
}

12. After they pay: price the same thing again

GET /agents/v1/reorders/{order_id}/{reorder_token} or the MCP tool quote_reorder

For "order ten more of what I got last time". GET the reorder_url from step 3 (it works once the order is paid), or the reorder link from the person's own email, with a new qty. The file or design is the one we already hold, so nothing is sent again.

The price is today's, at the quantity break for the new quantity. proof says what happens before it is made: none for a part cut as sent, skipped when the person already approved a proof of the same art, new otherwise.

A reorder link repeats an order of one item. An order of several items is built again from its items; one the shop quoted by hand answers not-reorderable, and a person prices the repeat.

Request

curl -s 'https://www.fshlabs.com/agents/v1/reorders/FSH-20261118-K7M2QX/...?qty=25&ship_zip=30126'

Answer

{
  "priceable": true,
  "reorder_of": {
    "order_id": "FSH-20261118-K7M2QX",
    "item": "20 oz insulated tumbler",
    "qty": 10,
    "ordered_at": "2026-11-18T14:58:40.000Z"
  },
  "qty": 25,
  "price": {
    "each_cents": 1750,
    "subtotal_cents": 43750,
    "display": "$437.50"
  },
  "proof": "skipped",
  "proof_note": "The same art as the original, whose proof the person already approved, so we make it without a new one.",
  "lead_time": "7 - 10 business days (blanks are ordered after you pay)",
  "next": {
    "create_reorder": "POST /agents/v1/reorders/FSH-20261118-K7M2QX/... with qty, fulfilment and ship_zip"
  }
}

13. After they pay: order the same thing again

POST /agents/v1/reorders/{order_id}/{reorder_token} or the MCP tool create_reorder

POST to the same address with qty, fulfilment and ship_zip. The answer is step 3's: a new order with its own pay_url for the person, prices held 30 days, nothing made until they pay. reorder_of names the order it repeats.

Send an Idempotency-Key, as for any order. Reorders count toward the same ten payment links an hour.

Request

curl -s https://www.fshlabs.com/agents/v1/reorders/FSH-20261118-K7M2QX/... \
  -H 'content-type: application/json' \
  -H 'idempotency-key: 9b2e7d41' \
  -d '{"qty":25,"fulfilment":"ship","ship_zip":"30126"}'

Answer

{
  "order_id": "FSH-20261202-P4T9WM",
  "reorder_of": "FSH-20261118-K7M2QX",
  "pay_url": "https://www.fshlabs.com/pay/FSH-20261202-P4T9WM/...",
  "status_url": "https://www.fshlabs.com/agents/v1/orders/FSH-20261202-P4T9WM/...",
  "needs_proof": false,
  "tell_the_person": "Your order FSH-20261202-P4T9WM is saved ... It repeats order FSH-20261118-K7M2QX, whose proof was already approved, so we make it without a new one."
}

14. After they pay: ask to cancel or change it

POST /agents/v1/orders/{order_id}/{status_token}/requests or the MCP tool request_order_change

POST to the order's status_url with /requests on the end: a kind (cancel, change or question) and a message saying what the person wants. It reaches a person at the shop and changes nothing by itself. The shop replies to the email the order was paid with and confirms with them before doing anything, so tell the person to watch that inbox.

What the terms allow depends on where the order is, and step 4's cancellation says so before you ask. before-production (waiting on a proof): cancelled or changed for a full refund. ask (in production): refunded in full only if nothing has been cut, so send it at once; a part cut as sent goes into production the day it is paid. after-production (shipped, ready or delivered): it can't be cancelled, and a part that arrived damaged or wrong is remade or refunded when they reply to their order email with photos within 7 days.

A new file, size or design after setup restarts the job and is quoted again. An unpaid order needs no cancelling: it is never made.

Request

curl -s https://www.fshlabs.com/agents/v1/orders/FSH-20261118-K7M2QX/.../requests \
  -H 'content-type: application/json' \
  -d '{"kind":"change","message":"Please make it 12 instead of 10, same text."}'

Answer

{
  "received": true,
  "order_id": "FSH-20261118-K7M2QX",
  "kind": "change",
  "changed": false,
  "standing": "before-production",
  "terms": "Not in production yet. It can be cancelled or changed for a full refund ...",
  "what_happens_next": "The shop has the request. A person at the shop replies to the email the order was paid with, and confirms with them before anything is cancelled or changed. Nothing has changed yet. ..."
}

15. After they pay: find an order whose link was lost

POST /agents/v1/orders/lookup or the MCP tool find_order

Every email we send about an order has its status link, so look there first. If the person has only the order number, send it with one thing its buyer knows: the email it was paid with, or the ship_zip it shipped to. The answer is step 4's, plus the status_url to keep.

It finds paid orders only and returns the status only: never a name, an address, a pay link or a file. Every miss answers the same not-found, whichever detail was wrong, and one order takes five tries a day.

There is no way to list a person's orders. That would need them to prove who they are, and nothing here has accounts.

Request

curl -s https://www.fshlabs.com/agents/v1/orders/lookup \
  -H 'content-type: application/json' \
  -d '{"order_id":"FSH-20261118-K7M2QX","email":"dana@example.com"}'

Answer

{
  "order_id": "FSH-20261118-K7M2QX",
  "status": "approved",
  "status_label": "In production",
  "paid": true,
  "status_url": "https://www.fshlabs.com/agents/v1/orders/FSH-20261118-K7M2QX/...",
  "status_page_url": "https://www.fshlabs.com/order/status/FSH-20261118-K7M2QX/..."
}

If you can only read pages

Some assistants can fetch a page but can't send a file. You can still get the person to a price in one click: give them the quote page with the material and quantity already chosen. They drop their file in and the price appears, with nothing to sign up for.

The link is https://www.fshlabs.com/laser-cutting/online-quote?material=<slug>&qty=<n>. For example, 20 parts in Birch plywood: https://www.fshlabs.com/laser-cutting/online-quote?material=birch-125&qty=20

The three quotes also answer a plain GET with the same fields in the query string, so a price that needs no upload is one link: https://www.fshlabs.com/agents/v1/quote/template?template=mounting-plate&material=birch-125&qty=20 prices the plate above, https://www.fshlabs.com/agents/v1/quote/product?product=tumbler-20oz&text=Dana&qty=10 a personalized product, and https://www.fshlabs.com/agents/v1/quote?file_url=<a public https link to the file>&material=<slug>&qty=<n> a file that is already online.

For work the instant quote can't price, the request form is https://www.fshlabs.com/order.

An order's links each carry a different token, made for one purpose. A token opens what is listed for it and nothing else, so a link can be passed on without handing over the rest.

  • status_url (the status token): read the order, its history and its proof picture, and send the shop a request. It can't pay, approve a proof, order anything or reach the file. Safe to keep in a chat.
  • reorder_url (the reorder token): price and order the same thing again, once the order is paid. It can buy, so treat it as the person's.
  • pay_url (the pay token): open the pay page and the quote PDF. It is for the person. It can't approve a proof.
  • The proof link (the proof token): approve a proof or ask for changes. Only the proof email carries it, so only the person holds it. No operation here returns it.

Materials

SlugMaterialThicknessFor a person
acrylic-clear-063Clear acrylic.063 inQuote page
acrylic-clear-118Clear acrylic.118 inQuote page
acrylic-clear-177Clear acrylic.177 inQuote page
acrylic-clear-214Clear acrylic.214 inQuote page
acrylic-clear-375Clear acrylic.375 inQuote page
acrylic-clear-500Clear acrylic.500 inQuote page
acrylic-black-118Black acrylic.118 inQuote page
acrylic-white-118White acrylic.118 inQuote page
acrylic-red-118Red acrylic.118 inQuote page
acrylic-blue-118Blue acrylic.118 inQuote page
acrylic-green-118Green acrylic.118 inQuote page
acrylic-yellow-118Yellow acrylic.118 inQuote page
acrylic-mirror-118Mirror acrylic.118 inQuote page
birch-125Birch plywood.125 inQuote page
birch-250Birch plywood.250 inQuote page
mdf-125MDF.125 inQuote page
mdf-250MDF.250 inQuote page
hardboard-125Hardboard.125 inQuote page
delrin-125Delrin (acetal).125 inQuote page
polypropylene-030Polypropylene.030 inQuote page

File issue codes

no-outline
block: nothing in the file is a closed outline
open-outline
block: the part's outside edge doesn't close
loose-islands
block: shapes inside a cutout would fall out; it is engraving artwork, quoted by a person
too-large
review: bigger than the laser bed; priced, then checked by a person
too-small
review: under 1/4 in on its short side; priced, then checked
cleaned-up
review: tiny gaps were closed or doubled lines dropped
not-cut
review: text and images in the file are ignored, only outlines are cut

Errors

Every refusal is { "error": { "code", "message" } } with a matching HTTP status.

invalid-request
A field is missing or wrong (fields names each one), or the request carries a field this operation doesn't take (unknown_fields, with valid listing the ones it does). Fix and send again.
unsupported-format
Only DXF and SVG are priced instantly. accepted lists them. For any other file, send a custom quote request.
file-too-large
Over 4 MB sent inline, or over 10 MB by file_url. Send a link instead, or simplify the file.
file-unreadable
The file is empty, damaged, or not what its name says. Export it again, or send a custom quote request.
file-fetch-failed
We couldn't download file_url. It must be a public https link. Send the file as file_text or file_base64 instead.
file-not-found
No file with that file_id (they are kept 30 days). Send the file again.
unknown-material
Not a material slug. valid lists every slug.
unknown-template
Not a template slug. valid lists every slug; list_templates describes them.
unknown-product
Not a product slug. valid lists every slug; list_products describes them.
not-priceable
The file has a problem that stops an instant order. issues says what. Fix the file or send a custom quote request.
rejected
The order can't be taken as asked. The message says why.
ship-zip-required
Shipping is priced to the ZIP. Send ship_zip, or use fulfilment pickup.
pickup-only
This order is too big to ship. Use fulfilment pickup, or send a custom quote request.
not-reorderable
The order is real and paid, but can't be priced again by itself: the shop quoted it by hand, it holds several items, or its file is gone. Send a custom quote request naming the order.
not-paid
That needs a paid order, and this one isn't paid yet. An unpaid order is never made and simply lapses on its pay_by date.
not-found
No order matches that link or those details, or there is no endpoint at that path (endpoints lists every one). An order lookup answers this for every miss, whatever was wrong.
method-not-allowed
That path exists, but not with that HTTP method. allow lists the ones it takes.
rate-limited
Too many calls from this address. Wait retry_after_s seconds.
capacity
The shop has taken all the agent orders it can today. Send the person to human_url.
unavailable
A service we depend on is down. Retry after retry_after_s, or send the person to human_url.
internal
Our fault. Try again in a minute.

Limits

  • Catalog, status and proof pictures: 120 calls a minute per address.
  • Quotes, a whole order's included: 60 a minute per address, and 20 a minute with ship_zip.
  • Payment links count once however many items the order holds, up to 20 items an order.
  • Payment links, reorders included: 10 an hour per address.
  • Requests about an order: 5 an hour per address, and 2 a day per order.
  • Order lookups: 10 an hour per address, and 5 a day per order number.
  • Quote requests: 3 an hour per address, and 3 a day per email.
  • A 429 carries retry_after_s. A 503 with code capacity means the shop has taken all it can today: send the person to human_url.

For people

Reading this as a person?

These pages say the same thing for a developer, for someone adding the MCP server, and for someone comparing shops.