What to buy for a room (quick)
quick_room_listRead-onlyIdempotent
Works out how much paint, wallpaper, wall tiles, flooring, carpet, skirting, loft insulation, plasterboard, concrete, patio paving or sub-base and gravel one room or area needs, and everything else to buy for the job (preparation, tools, safety), in real UK pack sizes. Takes the job and either the room's length, width and height, or a typical room by name for a room that has not been measured; the answer then states that the measurements are typical. A height left out, for a job on the walls, is taken as 2.4 m and the answer states it. Returns a short shopping list and a link to the whole list. It does not take exact door sizes, a product's own coverage or pack size, tiling part-way up a wall or an L-shaped room. For sub-base and gravel it plans gravel over Type 1 for a driveway, and the answer lists both as taken; plan_room takes groundwork.material (Type 1 or gravel alone) and groundwork.use (a path, a shed base or a border).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | Yes | The job. Required. wallpaper is the paint job with papered walls and no ceiling; tiles is the paint job with tiled walls and no ceiling; both is paint and a new floor; paint-carpet is paint and carpet from a roll; skirting is skirting and architrave; groundwork is MOT Type 1 sub-base, gravel, or gravel over Type 1 (groundwork.material). | |
| room | No | A typical room, for a person who has not measured: bedroom-small (3 m × 2.5 m), bedroom-large (4 m × 3.5 m), living-small (4 m × 3 m), living-large (5.5 m × 4 m), kitchen-small (3 m × 2 m), kitchen-large (4.5 m × 3.5 m), bathroom-small (2 m × 1.7 m), bathroom-large (2.7 m × 2.4 m), each 2.4 m high. The answer states that these are typical measurements. Not used together with length and width, and not for a loft, a slab, a patio or a sub-base, which are not rooms. | |
| doors | No | How many doors. Each is taken off the wall area at a typical size. | |
| units | No | What the measurements are in: m, cm, mm or ft (feet). Metres if left out. | |
| width | No | The room's width, in the units. | |
| height | No | Floor to ceiling, in the units. Used for paint, wallpaper, wall tiles, both, paint-carpet and plasterboard; if it is left out for those, a 2.4 m ceiling, a typical UK height, is taken and the answer states it. | |
| length | No | The room's length, in the units. | |
| windows | No | How many windows. Each is taken off the wall area at a typical size. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| v | No | The version number of the planner's link and answer format. | |
| ok | Yes | true: a list was made. false: the call was refused, and error says why. | |
| api | No | Always "buildbatch-assistant". | |
| ask | No | When ok is false: the ids of the questions in ask_questions to ask the person, in order. | |
| more | No | What plan_room with detail "full" adds. | |
| next | No | When ok is false: what to do next. | |
| room | No | The room as the planner understood it: a sentence (metres, as worked out), or with detail "full" its areas and lengths. | |
| error | No | When ok is false: why the call was refused, as words or as { code, message }. | |
| first | No | What has to be in place before the job starts, as toBuy's items: not a thing to buy. | |
| lines | No | detail "full": every line with its working, packs, figures and each shop's search link. | |
| links | No | What listUrl and startUrl open, in words. | |
| shops | No | detail "full": the shops each line's search link goes to. | |
| toBuy | No | Each thing to buy, in the order of the list. | |
| prices | No | That no price is shown or used in this answer. | |
| review | No | How far the figures have been checked: not yet by a tradesperson. | |
| assumed | No | What was taken as not given, with the value taken (a missing height is a 2.4 m ceiling). | |
| figures | No | What generic, typical and user mean. | |
| honesty | No | detail "full": the formulas' versions, how far the figures have been checked, and what the shop links are. | |
| ignored | No | Arguments that were not used, with why. | |
| listUrl | No | The whole list on buildbatch.co.uk, as a link a person can open. | |
| notUsed | No | Arguments that were sent and not used, with why. | |
| summary | No | detail "full": the counts and the short list. | |
| toCheck | No | Each thing that depends on the person's own job, as toBuy's items, with its question. | |
| document | No | "plan-summary" for the short answer; the planner's own name for detail "full" or a refusal. | |
| problems | No | When ok is false: each argument that is missing or not understood, with the id of its question in ask_questions. | |
| startUrl | No | The planner opened on this room, to change it. | |
| statuses | No | detail "full": what each line's status means. | |
| toAnswer | No | Questions whose answers would change the list. | |
| warnings | No | Warnings that come with the list. | |
| leftovers | No | What will be left over once the whole packs are bought. | |
| understood | No | detail "full": every argument as the planner read it. | |
| assumptions | No | detail "full": what the whole list assumes. | |
| typicalRoom | No | When a typical room was used: its id, label and a note that these are not the person's own measurements. | |
| startUrlNote | No | What the startUrl link opens. |