diff --git a/docs/data-model-alignment-v1.md b/docs/data-model-alignment-v1.md index 3462bc0..cf30523 100644 --- a/docs/data-model-alignment-v1.md +++ b/docs/data-model-alignment-v1.md @@ -897,9 +897,12 @@ Arbitrary nested JSON survives intact. The example above stores `raw->speaker_name_agreements` as `{"dealhunter": [61, 64, 97], "last_dwarf": [93, 68, 71]}` — checked, not assumed. -**Transport note.** Use the hostname and no `Host` header is needed. If you reach the -controller by IP address instead, you must send `Host: umbratrans.bdmurphy.me` or every -request returns `400` — including `/api/health`, which makes a healthy service look dead. +**Transport note.** Use `http://192.168.123.14:8442` directly. Both that address and +`umbratrans.bdmurphy.me` are accepted Host values as of 2026-10-03; before then the +service bound to `192.168.123.14` while rejecting requests to it, so *every* request by +IP returned `400 Invalid host header` — including `/api/health`, which makes a healthy +service look dead. If you see a bare `400` with no JSON body, suspect the Host header +before anything else. ### 10.7 What the response tells you