diff --git a/docs/content/api/legacy.md b/docs/content/api/legacy.md
index 46b4f2f2..dc2f1dbe 100644
--- a/docs/content/api/legacy.md
+++ b/docs/content/api/legacy.md
@@ -4,10 +4,10 @@ permalink: /api/legacy
 ---
 
 # Legacy API documentation
-
+<!-- 
 ::: warning
 This is the documentation for v1 of the PluralKit API. Please use v2 going forwards - v1 is deprecated and will be removed eventually.
-:::
+::: -->
 
 ## Models
 The following three models (usually represented in JSON format) represent the various objects in PluralKit's API.
diff --git a/docs/content/api/reference.md b/docs/content/api/reference.md
index 6001780e..055241f8 100644
--- a/docs/content/api/reference.md
+++ b/docs/content/api/reference.md
@@ -1,6 +1,6 @@
 ---
 title: Reference
-permalink: /api/reference
+permalink: /api
 ---
 
 # API Reference
@@ -8,6 +8,10 @@ permalink: /api/reference
 PluralKit has a basic HTTP REST API for querying and modifying your system.
 The root endpoint of the API is `https://api.pluralkit.me/v2/`.
 
+::: warning
+This documentation is currently pre-release. Until this notice is removed, please refer to the [legacy API documentation](/api/legacy) for model and endpoint information.
+:::
+
 #### Authorization header token example
 ```
 Authorization: z865MC7JNhLtZuSq1NXQYVe+FgZJHBfeBCXOPYYRwH4liDCDrsd7zdOuR45mX257