diff --git a/backend/src/routes/v2/environment.ts b/backend/src/routes/v2/environment.ts
index 133f0d717..a6d5baa13 100644
--- a/backend/src/routes/v2/environment.ts
+++ b/backend/src/routes/v2/environment.ts
@@ -16,7 +16,7 @@ import {
 router.post(
   "/:workspaceId/environments",
   requireAuth({
-    acceptedAuthModes: [AuthMode.JWT],
+    acceptedAuthModes: [AuthMode.JWT, AuthMode.API_KEY],
   }),
   requireWorkspaceAuth({
     acceptedRoles: [ADMIN, MEMBER],
@@ -32,7 +32,7 @@ router.post(
 router.put(
   "/:workspaceId/environments",
   requireAuth({
-    acceptedAuthModes: [AuthMode.JWT],
+    acceptedAuthModes: [AuthMode.JWT, AuthMode.API_KEY],
   }),
   requireWorkspaceAuth({
     acceptedRoles: [ADMIN, MEMBER],
@@ -49,7 +49,7 @@ router.put(
 router.patch(
   "/:workspaceId/environments",
   requireAuth({
-    acceptedAuthModes: [AuthMode.JWT],
+    acceptedAuthModes: [AuthMode.JWT, AuthMode.API_KEY],
   }),
   requireWorkspaceAuth({
     acceptedRoles: [ADMIN, MEMBER],
@@ -67,7 +67,7 @@ router.patch(
 router.delete(
   "/:workspaceId/environments",
   requireAuth({
-    acceptedAuthModes: [AuthMode.JWT],
+    acceptedAuthModes: [AuthMode.JWT, AuthMode.API_KEY],
   }),
   requireWorkspaceAuth({
     acceptedRoles: [ADMIN],
@@ -82,7 +82,7 @@ router.delete(
 router.get(
   "/:workspaceId/environments",
   requireAuth({
-    acceptedAuthModes: [AuthMode.JWT],
+    acceptedAuthModes: [AuthMode.JWT, AuthMode.API_KEY],
   }),
   requireWorkspaceAuth({
     acceptedRoles: [MEMBER, ADMIN],
diff --git a/docs/api-reference/endpoints/environments/create.mdx b/docs/api-reference/endpoints/environments/create.mdx
new file mode 100644
index 000000000..2bb14167c
--- /dev/null
+++ b/docs/api-reference/endpoints/environments/create.mdx
@@ -0,0 +1,4 @@
+---
+title: "Create"
+openapi: "POST /api/v2/workspace/{workspaceId}/environments"
+---
\ No newline at end of file
diff --git a/docs/api-reference/endpoints/environments/delete.mdx b/docs/api-reference/endpoints/environments/delete.mdx
new file mode 100644
index 000000000..944e42961
--- /dev/null
+++ b/docs/api-reference/endpoints/environments/delete.mdx
@@ -0,0 +1,4 @@
+---
+title: "Delete"
+openapi: "DELETE /api/v2/workspace/{workspaceId}/environments"
+---
\ No newline at end of file
diff --git a/docs/api-reference/endpoints/environments/list.mdx b/docs/api-reference/endpoints/environments/list.mdx
new file mode 100644
index 000000000..4a9d9068e
--- /dev/null
+++ b/docs/api-reference/endpoints/environments/list.mdx
@@ -0,0 +1,4 @@
+---
+title: "List"
+openapi: "GET /api/v2/workspace/{workspaceId}/environments"
+---
\ No newline at end of file
diff --git a/docs/api-reference/endpoints/environments/update.mdx b/docs/api-reference/endpoints/environments/update.mdx
new file mode 100644
index 000000000..291344d6c
--- /dev/null
+++ b/docs/api-reference/endpoints/environments/update.mdx
@@ -0,0 +1,4 @@
+---
+title: "Update"
+openapi: "PUT /api/v2/workspace/{workspaceId}/environments"
+---
\ No newline at end of file
diff --git a/docs/api-reference/endpoints/secrets/read-one.mdx b/docs/api-reference/endpoints/secrets/list.mdx
similarity index 82%
rename from docs/api-reference/endpoints/secrets/read-one.mdx
rename to docs/api-reference/endpoints/secrets/list.mdx
index 6dbbcd726..eaa4597fb 100644
--- a/docs/api-reference/endpoints/secrets/read-one.mdx
+++ b/docs/api-reference/endpoints/secrets/list.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Retrieve"
-openapi: "GET /api/v3/secrets/{secretName}"
+title: "List"
+openapi: "GET /api/v3/secrets/"
 ---
 
 <Tip>
diff --git a/docs/api-reference/endpoints/secrets/read.mdx b/docs/api-reference/endpoints/secrets/read.mdx
index ab258bdba..6dbbcd726 100644
--- a/docs/api-reference/endpoints/secrets/read.mdx
+++ b/docs/api-reference/endpoints/secrets/read.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Retrieve All"
-openapi: "GET /api/v3/secrets/"
+title: "Retrieve"
+openapi: "GET /api/v3/secrets/{secretName}"
 ---
 
 <Tip>
diff --git a/docs/mint.json b/docs/mint.json
index 4892def24..4eed75c48 100644
--- a/docs/mint.json
+++ b/docs/mint.json
@@ -321,12 +321,21 @@
             "api-reference/endpoints/workspaces/rollback-snapshot"
           ]
         },
+        {
+          "group": "Environments",
+          "pages": [
+            "api-reference/endpoints/environments/list",
+            "api-reference/endpoints/environments/create",
+            "api-reference/endpoints/environments/update",
+            "api-reference/endpoints/environments/delete"
+          ]
+        },
         {
           "group": "Secrets",
           "pages": [
-            "api-reference/endpoints/secrets/read",
+            "api-reference/endpoints/secrets/list",
             "api-reference/endpoints/secrets/create",
-            "api-reference/endpoints/secrets/read-one",
+            "api-reference/endpoints/secrets/read",
             "api-reference/endpoints/secrets/update",
             "api-reference/endpoints/secrets/delete",
             "api-reference/endpoints/secrets/versions",