> ## Documentation Index
> Fetch the complete documentation index at: https://docs.provenmetal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Buy links

> A permanent order link for a published board.

Shoppers open the link, pick quantity and city, get a live price and check out.

<Steps>
  <Step title="Upload">`upload` with the design (plus BOM and pick-and-place for assembly).</Step>

  <Step title="Create">
    ```json theme={"dark"}
    {
      "upload_id": "3f2c…",
      "project_name": "Keyboard controller rev C",
      "source_url": "https://github.com/you/keyboard",
      "assembly": true
    }
    ```
  </Step>

  <Step title="Publish">Put the returned `https://central.provenmetal.com/buy/<id>` behind a Buy button.</Step>
</Steps>

Set known options (`layers`, `thickness_mm`, `surface_finish`, `solder_mask`, `copper_oz`, `material`) so shoppers aren't asked.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.