---
title: "Links that open a room in BuildBatch | BuildBatch"
description: "Write a link that opens the BuildBatch planner with a room filled in: the format, door and window names, and examples for a decorator, a forum or an assistant."
url: https://buildbatch.co.uk/links/
---

# Links that open a room in BuildBatch

A link can carry a room's measurements into the planner. A decorator, a forum post or an AI assistant can write one. The person who follows it checks the figures, changes anything that is wrong, and gets the whole list.

## Two kinds of link

- **Start links** open `/start/`. They fill in the planner, with every figure in a field and the answer under them, so the person sees each figure and can change it before opening the shopping list. These are the links to write by hand.
- **List links** open `/list/`. The planner makes one when someone presses “Send this list”. It holds the whole job: the room's measurements and name, every product figure in the list (tin and pack sizes, coverage and prices, a catalogue product's included) and the Need / Check first / Have / Not needed marks, with the version of the sums and the day of the shop prices it was made with. It shows the list straight away, worked out again with the day's prices, and says so when they have changed since; “Change the figures” opens the same list as a start link.

Both use the same format. Anything a link can say, a person can also type into the planner: a link only saves the typing.

## Check the figures

A link is only as good as the measurements in it, and anyone can write one. Whichever page it opens, the page says the figures came from a link and asks the person to check them against the room. A start link shows every figure it filled in before any list. Nothing is saved until the person chooses to save it.

## Where the figures go

The figures are the part of the link after “#”. The page works the list out on the device that opens the link, from the figures in it: the measurements are not sent anywhere for the calculations. The figures are still in the link itself: anyone who can see the link, in a message, a post or a chat, can read them.

## The format

A start link is `https://buildbatch.co.uk/start/#` followed by pairs like `length=4.2`, joined with `&`. Only `v=1` is required; the planner asks for anything missing. Keys it does not know are ignored. A link the planner makes ends with `end=` and a number, so one cut short is noticed; leave that out of a link you write.

**What each key says**

| Key | What it says | Example |
| --- | --- | --- |
| `v` | The version of the format. Always 1 for now, and always first. | `v=1` |
| `job` | The job: paint, wallpaper, tiles (wall tiles), flooring, carpet, loft (loft insulation), both (paint and flooring), paint-carpet (paint and carpet), skirting (skirting and architrave) or plasterboard. | `job=paint` |
| `units` | What the room and the doors are measured in: m (the default), cm, mm or ft. | `units=cm` |
| `length, width` | The room's two sides. In feet, write 13ft9in, or 13 for whole feet. | `length=4.2&width=3.6` |
| `height` | Floor to ceiling. Wall paint, wallpaper and tiles need it; flooring and skirting do not. | `height=2.4` |
| `door, window, opening` | One key for each door or window. A typical size by its name (the table below), or width x height in the same units. Add \*2 for two the same. Repeat the key for more. | `door=int-762&window=1200x1100` |
| `walls, ceiling` | For a painting job: paint, wallpaper, tiles or none for the walls; paint or none for the ceiling. The job sets these, so they are rarely needed. | `ceiling=none` |
| `trim` | New skirting, architrave or both, with any job. | `trim=skirting,architrave` |
| `plan` | A room that is not a rectangle: its corners in turn, in metres, as x,y pairs. Replaces length and width. | `plan=0,0;4.2,0;4.2,2.4;2.4,2.4;2.4,3.6;0,3.6` |
| `name` | What the room is called. | `name=Front%20bedroom` |

Product figures (tin sizes, coverage, rolls, boxes, lengths) have keys of their own, which the planner writes when someone sends a list. Leave them out of a start link: the planner then uses its own figures, each labelled typical or an example, and the person can change them to the figures on their own tin, roll or box.

## Typical door and window sizes

Write the name instead of the size. Each is a typical size, not a standard anyone has to follow: measure yours if it matters.

**Names a link can use, with the size each fills in**

| Name | What it is | Width × height (mm) |
| --- | --- | --- |
| `int-762` | Internal door, standard | 762 × 1981 |
| `door-838` | Front door, or wide internal door | 838 × 1981 |
| `int-686` | Internal door, narrow | 686 × 1981 |
| `int-610` | Cupboard or narrow door | 610 × 1981 |
| `int-726m` | Internal door, metric | 726 × 2040 |
| `int-826m` | Internal door, metric wide | 826 × 2040 |
| `front-813` | Front door, taller and narrower | 813 × 2032 |
| `front-914` | Front door, wide | 914 × 1981 |
| `pair-762` | Pair of internal doors | 1524 × 1981 |
| `french-1200` | French doors, narrow | 1200 × 2100 |
| `french-1500` | French doors | 1500 × 2100 |
| `patio-1800` | Patio, French or bi-fold doors | 1800 × 2100 |
| `patio-2400` | Wide patio or bi-fold doors | 2400 × 2100 |
| `garage-single` | Garage door, single | 2134 × 1981 |
| `garage-double` | Garage door, double | 4267 × 2134 |
| `win-small` | Window, small (bathroom) | 600 × 900 |
| `win-standard` | Window, standard | 900 × 1200 |
| `win-wide` | Window, wide | 1200 × 1200 |
| `win-tall` | Window, tall (sash) | 1200 × 1800 |
| `bath-1700` | Bath, standard | 1700 × 550 |
| `tray-900` | Shower tray, square | 900 × 0 |

## Examples

### A decorator who measured in millimetres

Painting the walls and ceiling of a room 4200 by 3600 mm, 2400 mm high, with a standard internal door and a window 1200 mm wide and 1100 mm high.

[https://buildbatch.co.uk/start/#v=1&job=paint&units=mm&length=4200&width=3600&height=2400&door=int-762&window=1200x1100](https://buildbatch.co.uk/start/#v=1&job=paint&units=mm&length=4200&width=3600&height=2400&door=int-762&window=1200x1100)

### A forum post about tiling a bathroom

Wall tiles up to 1.2 m in a bathroom 250 by 180 cm, 240 cm high, with a narrow internal door.

[https://buildbatch.co.uk/start/#v=1&job=tiles&units=cm&length=250&width=180&height=240&door=int-686&walltiles=quick&walltiles.height=1.2](https://buildbatch.co.uk/start/#v=1&job=tiles&units=cm&length=250&width=180&height=240&door=int-686&walltiles=quick&walltiles.height=1.2)

### An AI assistant answering "what do I need to paint this room and lay a laminate floor?"

Paint and a laminate floor for a room 4.2 by 3.6 m, 2.4 m high, with one standard internal door and one standard window.

[https://buildbatch.co.uk/start/#v=1&job=both&length=4.2&width=3.6&height=2.4&door=int-762&window=win-standard&floor=quick&floor.covering=laminate](https://buildbatch.co.uk/start/#v=1&job=both&length=4.2&width=3.6&height=2.4&door=int-762&window=win-standard&floor=quick&floor.covering=laminate)

### Someone measuring in feet and inches

New skirting and architrave for a room 13 ft 9 in by 11 ft 10 in with two standard internal doors.

[https://buildbatch.co.uk/start/#v=1&job=skirting&trim=skirting,architrave&units=ft&length=13ft9in&width=11ft10in&door=int-762\*2](https://buildbatch.co.uk/start/#v=1&job=skirting&trim=skirting,architrave&units=ft&length=13ft9in&width=11ft10in&door=int-762*2)

## For AI assistants

If someone asks what they need for a room and gives its measurements, you can give them a start link built as above, with the figures they gave you. Tell them to check the figures when the page opens. Do not make up a measurement they did not give: leave that key out, and the planner will ask for it. [llms.txt](https://buildbatch.co.uk/llms.txt) has the same recipe in plain text.

### The loop, for an assistant that can call a web address

A link is the simplest thing to give a person. If you can also call a web address, there is an interface that returns the finished list as data. It is free and read-only, with no key or account. Unlike the planner, which works in the person's browser, it works the list out on BuildBatch's server from the parameters sent. BuildBatch stores none of them, and counts only which tool, which job and which kind of caller, as [the privacy page](https://buildbatch.co.uk/privacy/#assistant-heading) says.

1. **Ask.** [`https://buildbatch.co.uk/ask.json`](https://buildbatch.co.uk/ask.json) is the question script: what to ask the person, the allowed answers, which are required, when to ask, and the rules. Ask only for what is missing, and use only measurements the person gave you.
2. **Call.** `https://buildbatch.co.uk/plan.json` takes their answers as a query string, in the parameters of the table above, and a job is required. One room a call. It returns the whole shopping list as JSON, and a link that opens the same list.
3. **Show.** Give the person the room summary, the lines to buy, the lines to check first, and that link. It is free and needs no account.
4. **Say whose figures are whose.** Unless you sent a product's own figures, the paint is counted at BuildBatch's typical figures, found from makers' own, and the roll, pack, box and allowance figures are its labelled examples; each line says which. BuildBatch was built and checked with AI tools, and nobody outside the build has reviewed it. An answer has no prices, and its shop links only open each shop's own search. The person should check the figures and follow each product's own instructions.

The description of both addresses is [`https://buildbatch.co.uk/openapi.json`](https://buildbatch.co.uk/openapi.json) (OpenAPI 3.1).

### The same through MCP

An MCP client can connect to `https://buildbatch.co.uk/mcp`. `plan_room` and `ask_questions` wrap the same planner and question script as the addresses above; `plan_room` takes one room's named parameters as its arguments. `quick_room_list` takes only a job, three measurements or a typical room, and how many doors and windows, and plans the same way. `find_guide` returns the guides' own short answers for a question. Each list is a short answer, as text and as data: every item with its quantity and reason, and the link. `plan_room` returns the planner's whole answer, with each line's working and shop search links, when called with `detail` set to `full`. It is stateless Streamable HTTP: each call is one JSON response, with no session and no event stream. Every tool is read-only and idempotent. [How a person connects it](https://buildbatch.co.uk/assistants/) to Claude, ChatGPT and others.

### An example turn

**The person says:** “What do I need to paint my bedroom? It is 4.2 m by 3.6 m and 2.4 m high, with one standard internal door and a window 1.2 m wide and 1.1 m high.”

**You call:** [`https://buildbatch.co.uk/plan.json?v=1&job=paint&length=4.2&width=3.6&height=2.4&door=int-762&window=1.2x1.1`](https://buildbatch.co.uk/plan.json?v=1&job=paint&length=4.2&width=3.6&height=2.4&door=int-762&window=1.2x1.1)

**You say:** “For that room (4.2 m × 3.6 m, 2.4 m high; 1 door, 1 window) the list has wall paint, 1 × 5 L tin + 1 × 2.5 L tin (7.5 L); ceiling paint, 1 × 5 L tin (5 L); and then the preparation, tools and safety items. The whole list, with the working behind each quantity, is here and is free: https://buildbatch.co.uk/list/#v=1&job=paint&walls=paint&ceiling=paint&trim=none&units=m&length=4.2&width=3.6&height=2.4&door=0.762x1.981&window=1.2x1.1&surface=sound&subfloor=unsure&ground=unsure&fitting=unsure&end=15 The paint figures are BuildBatch's typical figures, not any product's (2 coats, 12 m² per litre, 10% allowance), so check them against the tin and follow its instructions. It was built and checked with AI tools, and nobody outside the build has reviewed it. This answer has no prices.”

If a call answers 400, `problems` names the parameters to add or correct, and `ask` the questions in the script to put to the person. Do not guess a missing measurement, and do not send the same address again. A call that gives no room size at all is answered for a typical room, and says so; `product` names a paint in BuildBatch's catalogue, whose maker's own figures are then used.
