diff --git a/openapi/v1-deprecated/README.md b/openapi/v1-deprecated/README.md
new file mode 100644
index 0000000000..1773a4b962
--- /dev/null
+++ b/openapi/v1-deprecated/README.md
@@ -0,0 +1,7 @@
+# MongoDB Atlas Administration API (1.0) OpenAPI Specification
+
+> [!WARNING]  
+> The APIs in these OpenAPI Specifications are deprecated. Please use the OpenAPI Specifications of the v2 APIs available at [openapi/v2](../v2).
+
+
+This folder contains the OpenAPI Specifications of the MongoDB Atlas Administration API (1.0).
diff --git a/openapi/v2/README.md b/openapi/v2/README.md
new file mode 100644
index 0000000000..1ea19adcbf
--- /dev/null
+++ b/openapi/v2/README.md
@@ -0,0 +1,3 @@
+# MongoDB Atlas Administration API (2.0) OpenAPI Specification
+
+This folder contains the OpenAPI Specifications of the MongoDB Atlas Administration API (2.0).