diff --git a/docs/gateway/doctor.md b/docs/gateway/doctor.md
index ccce6cc8de1..24b68e495ee 100644
--- a/docs/gateway/doctor.md
+++ b/docs/gateway/doctor.md
@@ -197,6 +197,7 @@ That stages grounded durable candidates into the short-term dreaming store while
     - `browser.ssrfPolicy.allowPrivateNetwork` → `browser.ssrfPolicy.dangerouslyAllowPrivateNetwork`
     - `browser.profiles.*.driver: "extension"` → `"existing-session"`
     - remove `browser.relayBindHost` (legacy extension relay setting)
+    - legacy `models.providers.*.api: "openai"` → `"openai-completions"` (gateway startup also skips providers whose `api` is set to a future or unknown enum value rather than failing closed)
 
     Doctor warnings also include account-default guidance for multi-account channels: