From a8b46b9ac0e19f85999cbf7a1f1974f60cdf2465 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marc-Andr=C3=A9=20Bombeck?= <mbombeck@gmail.com>
Date: Fri, 16 Oct 2026 05:37:18 +0200
Subject: [PATCH] docs(api): regenerate the OpenAPI contract

---
 docs/api/openapi.yaml | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/docs/api/openapi.yaml b/docs/api/openapi.yaml
index f735b0d4e..3440fa985 100644
--- a/docs/api/openapi.yaml
+++ b/docs/api/openapi.yaml
@@ -46822,8 +46822,11 @@ components:
             - up-bad
             - neutral
             - hold
-          description: "How a change counts: `up-good` a rise is progress, `up-bad` a fall is progress, `hold` the value is inside
-            its band so staying is progress, `neutral` no judgement."
+          description: "How a change counts: `up-good` a rise is progress, `up-bad` a fall is progress, `hold` staying is progress
+            and a move either way is no setback, `neutral` no judgement. `hold` covers a value inside its band, a blood
+            pressure, resting pulse or body fat below a profile-default band (a default's lower edge is no goal; below
+            the person's own target a rise stays `up-good`), and steps or oxygen saturation above their band (more is
+            never worse)."
         targetPosition:
           anyOf:
             - type: string
@@ -75952,12 +75955,27 @@ components:
           enum:
             - total
             - supplemental
+        form:
+          anyOf:
+            - type: string
+              enum:
+                - retinol
+                - folic_acid
+                - magnesium_salts
+                - alpha_tocopherol
+            - type: "null"
+          description: "v1.43 — the chemical form the level is set for, where narrower than the nutrient: `retinol` (vitamin A:
+            preformed retinol only, beta-carotene does not count), `folic_acid`, `magnesium_salts` (readily dissociable
+            salts in supplements), `alpha_tocopherol`. `null` where the level covers the nutrient as such. Phrase it in
+            the reader's language; skip an unknown value."
         source:
           type: string
+          description: The bare citation (EFSA overview and the opinion it rests on), not prose. Every level here is the adult one.
       required:
         - value
         - unit
         - scope
+        - form
         - source
       additionalProperties: false
       description: The tolerable upper intake level, with the unit, whether it applies to the total intake or to the