diff --git a/docs/stability.md b/docs/stability.md
index 82974f8f70..a70aadaf0d 100644
--- a/docs/stability.md
+++ b/docs/stability.md
@@ -13,7 +13,7 @@ Things considered stable for 3.x:
 * The query language and data model
 * Alerting and recording rules
 * The ingestion exposition format
-* v1 HTTP API (used by dashboards and UIs)
+* v1 HTTP API (used by dashboards and UIs), excluding endpoints explicitly marked as experimental
 * Configuration file format (minus the service discovery remote read/write, see below)
 * Rule/alert file format
 * Console template syntax and semantics