diff --git a/ceilometer/api/v1/blueprint.py b/ceilometer/api/v1/blueprint.py
index a4c20d283a..ec7cd1d11c 100644
--- a/ceilometer/api/v1/blueprint.py
+++ b/ceilometer/api/v1/blueprint.py
@@ -18,6 +18,15 @@
 """Blueprint for version 1 of API.
 """
 
+#############################################################################
+#############################################################################
+#
+# NOTE(dhellmann): The V1 API is being deprecated during Havana, and
+# as such it is feature-frozen. Only make bug-fix changes in this file.
+#
+#############################################################################
+#############################################################################
+
 # [ ] / -- information about this version of the API
 #
 # [ ] /extensions -- list of available extensions
diff --git a/doc/source/webapi/v1.rst b/doc/source/webapi/v1.rst
index a4faa483a7..c369cae9b7 100644
--- a/doc/source/webapi/v1.rst
+++ b/doc/source/webapi/v1.rst
@@ -2,5 +2,10 @@
  V1 Web API
 ============
 
+.. warning::
+
+   The V1 API is being deprecated during the Havana development
+   cycle. Please use the V2 API instead.
+
 .. autoflask:: ceilometer.api.v1.app:app
    :undoc-static: