diff --git a/docs/api-reference/endpoints/depreciated/environments/create.mdx b/docs/api-reference/endpoints/depreciated/environments/create.mdx
new file mode 100644
index 000000000..826dcce3d
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/environments/create.mdx
@@ -0,0 +1,4 @@
+---
+title: "Create"
+openapi: "POST /api/v1/workspace/{workspaceId}/environments"
+---
diff --git a/docs/api-reference/endpoints/depreciated/environments/delete.mdx b/docs/api-reference/endpoints/depreciated/environments/delete.mdx
new file mode 100644
index 000000000..903e58d2a
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/environments/delete.mdx
@@ -0,0 +1,4 @@
+---
+title: "Delete"
+openapi: "DELETE /api/v1/workspace/{workspaceId}/environments/{id}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/environments/update.mdx b/docs/api-reference/endpoints/depreciated/environments/update.mdx
new file mode 100644
index 000000000..f93968668
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/environments/update.mdx
@@ -0,0 +1,4 @@
+---
+title: "Update"
+openapi: "PATCH /api/v1/workspace/{workspaceId}/environments/{id}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/folders/create.mdx b/docs/api-reference/endpoints/depreciated/folders/create.mdx
new file mode 100644
index 000000000..e1ff3004a
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/folders/create.mdx
@@ -0,0 +1,4 @@
+---
+title: "Create"
+openapi: "POST /api/v1/folders"
+---
diff --git a/docs/api-reference/endpoints/depreciated/folders/delete.mdx b/docs/api-reference/endpoints/depreciated/folders/delete.mdx
new file mode 100644
index 000000000..a106cc2eb
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/folders/delete.mdx
@@ -0,0 +1,4 @@
+---
+title: "Delete"
+openapi: "DELETE /api/v1/folders/{folderIdOrName}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/folders/get-by-id.mdx b/docs/api-reference/endpoints/depreciated/folders/get-by-id.mdx
new file mode 100644
index 000000000..db3c4d0cc
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/folders/get-by-id.mdx
@@ -0,0 +1,4 @@
+---
+title: "Get by ID"
+openapi: "GET /api/v1/folders/{id}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/folders/list.mdx b/docs/api-reference/endpoints/depreciated/folders/list.mdx
new file mode 100644
index 000000000..f40f93273
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/folders/list.mdx
@@ -0,0 +1,4 @@
+---
+title: "List"
+openapi: "GET /api/v1/folders"
+---
diff --git a/docs/api-reference/endpoints/depreciated/folders/update.mdx b/docs/api-reference/endpoints/depreciated/folders/update.mdx
new file mode 100644
index 000000000..c54778e94
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/folders/update.mdx
@@ -0,0 +1,4 @@
+---
+title: "Update"
+openapi: "PATCH /api/v1/folders/{folderId}"
+---
diff --git a/docs/api-reference/endpoints/organizations/workspaces.mdx b/docs/api-reference/endpoints/depreciated/organizations/projects.mdx
similarity index 100%
rename from docs/api-reference/endpoints/organizations/workspaces.mdx
rename to docs/api-reference/endpoints/depreciated/organizations/projects.mdx
diff --git a/docs/api-reference/endpoints/depreciated/project-groups/create.mdx b/docs/api-reference/endpoints/depreciated/project-groups/create.mdx
new file mode 100644
index 000000000..6dd7f1a4f
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-groups/create.mdx
@@ -0,0 +1,4 @@
+---
+title: "Create Project Membership"
+openapi: "POST /api/v2/workspace/{projectId}/groups/{groupIdOrName}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/project-groups/delete.mdx b/docs/api-reference/endpoints/depreciated/project-groups/delete.mdx
new file mode 100644
index 000000000..07db40d7f
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-groups/delete.mdx
@@ -0,0 +1,4 @@
+---
+title: "Delete Project Membership"
+openapi: "DELETE /api/v2/workspace/{projectId}/groups/{groupId}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/project-groups/get-by-id.mdx b/docs/api-reference/endpoints/depreciated/project-groups/get-by-id.mdx
new file mode 100644
index 000000000..611f39059
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-groups/get-by-id.mdx
@@ -0,0 +1,4 @@
+---
+title: "Get Project Membership"
+openapi: "GET /api/v2/workspace/{projectId}/groups/{groupId}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/project-groups/list.mdx b/docs/api-reference/endpoints/depreciated/project-groups/list.mdx
new file mode 100644
index 000000000..1488fb6ae
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-groups/list.mdx
@@ -0,0 +1,4 @@
+---
+title: "List Project Memberships"
+openapi: "GET /api/v2/workspace/{projectId}/groups"
+---
diff --git a/docs/api-reference/endpoints/depreciated/project-groups/update.mdx b/docs/api-reference/endpoints/depreciated/project-groups/update.mdx
new file mode 100644
index 000000000..8b963a1d8
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-groups/update.mdx
@@ -0,0 +1,4 @@
+---
+title: "Update Project Membership"
+openapi: "PATCH /api/v2/workspace/{projectId}/groups/{groupId}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/project-identities/add-identity-membership.mdx b/docs/api-reference/endpoints/depreciated/project-identities/add-identity-membership.mdx
new file mode 100644
index 000000000..285b1d1c4
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-identities/add-identity-membership.mdx
@@ -0,0 +1,4 @@
+---
+title: "Create Identity Membership"
+openapi: "POST /api/v2/workspace/{projectId}/identity-memberships/{identityId}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/project-identities/delete-identity-membership.mdx b/docs/api-reference/endpoints/depreciated/project-identities/delete-identity-membership.mdx
new file mode 100644
index 000000000..e2b266626
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-identities/delete-identity-membership.mdx
@@ -0,0 +1,4 @@
+---
+title: "Delete Identity Membership"
+openapi: "DELETE /api/v2/workspace/{projectId}/identity-memberships/{identityId}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/project-identities/get-by-id.mdx b/docs/api-reference/endpoints/depreciated/project-identities/get-by-id.mdx
new file mode 100644
index 000000000..37f4192d7
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-identities/get-by-id.mdx
@@ -0,0 +1,4 @@
+---
+title: "Get Identity by ID"
+openapi: "GET /api/v2/workspace/{projectId}/identity-memberships/{identityId}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/project-identities/list-identity-memberships.mdx b/docs/api-reference/endpoints/depreciated/project-identities/list-identity-memberships.mdx
new file mode 100644
index 000000000..e5162e693
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-identities/list-identity-memberships.mdx
@@ -0,0 +1,4 @@
+---
+title: "List Identity Memberships"
+openapi: "GET /api/v2/workspace/{projectId}/identity-memberships"
+---
diff --git a/docs/api-reference/endpoints/depreciated/project-identities/update-identity-membership.mdx b/docs/api-reference/endpoints/depreciated/project-identities/update-identity-membership.mdx
new file mode 100644
index 000000000..667cf7eb3
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-identities/update-identity-membership.mdx
@@ -0,0 +1,4 @@
+---
+title: "Update Identity Membership"
+openapi: "PATCH /api/v2/workspace/{projectId}/identity-memberships/{identityId}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/project-roles/create.mdx b/docs/api-reference/endpoints/depreciated/project-roles/create.mdx
new file mode 100644
index 000000000..97570ec36
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-roles/create.mdx
@@ -0,0 +1,10 @@
+---
+title: "Create"
+openapi: "POST /api/v2/workspace/{projectId}/roles"
+---
+
+
+ You can read more about the permissions field in the [permissions
+ documentation](/internals/permissions).
+
+
diff --git a/docs/api-reference/endpoints/depreciated/project-roles/delete.mdx b/docs/api-reference/endpoints/depreciated/project-roles/delete.mdx
new file mode 100644
index 000000000..41edfa7c3
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-roles/delete.mdx
@@ -0,0 +1,4 @@
+---
+title: "Delete"
+openapi: "DELETE /api/v2/workspace/{projectId}/roles/{roleId}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/project-roles/get-by-slug.mdx b/docs/api-reference/endpoints/depreciated/project-roles/get-by-slug.mdx
new file mode 100644
index 000000000..dfc5c582a
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-roles/get-by-slug.mdx
@@ -0,0 +1,4 @@
+---
+title: "Get By Slug"
+openapi: "GET /api/v2/workspace/{projectId}/roles/slug/{roleSlug}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/project-roles/list.mdx b/docs/api-reference/endpoints/depreciated/project-roles/list.mdx
new file mode 100644
index 000000000..8d8dc10c1
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-roles/list.mdx
@@ -0,0 +1,4 @@
+---
+title: "List"
+openapi: "GET /api/v2/workspace/{projectId}/roles"
+---
diff --git a/docs/api-reference/endpoints/depreciated/project-roles/update.mdx b/docs/api-reference/endpoints/depreciated/project-roles/update.mdx
new file mode 100644
index 000000000..662d5e617
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-roles/update.mdx
@@ -0,0 +1,4 @@
+---
+title: "Update"
+openapi: "PATCH /api/v2/workspace/{projectId}/roles/{roleId}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/project-users/delete-membership.mdx b/docs/api-reference/endpoints/depreciated/project-users/delete-membership.mdx
new file mode 100644
index 000000000..1995e4726
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-users/delete-membership.mdx
@@ -0,0 +1,4 @@
+---
+title: "Delete User Membership"
+openapi: "DELETE /api/v1/workspace/{workspaceId}/memberships/{membershipId}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/project-users/get-by-username.mdx b/docs/api-reference/endpoints/depreciated/project-users/get-by-username.mdx
new file mode 100644
index 000000000..ec69d4947
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-users/get-by-username.mdx
@@ -0,0 +1,4 @@
+---
+title: "Get By Username"
+openapi: "POST /api/v1/workspace/{workspaceId}/memberships/details"
+---
diff --git a/docs/api-reference/endpoints/project-users/invite-member-to-workspace.mdx b/docs/api-reference/endpoints/depreciated/project-users/invite-member-to-project.mdx
similarity index 100%
rename from docs/api-reference/endpoints/project-users/invite-member-to-workspace.mdx
rename to docs/api-reference/endpoints/depreciated/project-users/invite-member-to-project.mdx
diff --git a/docs/api-reference/endpoints/depreciated/project-users/memberships.mdx b/docs/api-reference/endpoints/depreciated/project-users/memberships.mdx
new file mode 100644
index 000000000..3c4735f94
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-users/memberships.mdx
@@ -0,0 +1,4 @@
+---
+title: "Get User Memberships"
+openapi: "GET /api/v1/workspace/{workspaceId}/memberships"
+---
diff --git a/docs/api-reference/endpoints/project-users/remove-member-from-workspace.mdx b/docs/api-reference/endpoints/depreciated/project-users/remove-member-from-project.mdx
similarity index 100%
rename from docs/api-reference/endpoints/project-users/remove-member-from-workspace.mdx
rename to docs/api-reference/endpoints/depreciated/project-users/remove-member-from-project.mdx
diff --git a/docs/api-reference/endpoints/depreciated/project-users/update-membership.mdx b/docs/api-reference/endpoints/depreciated/project-users/update-membership.mdx
new file mode 100644
index 000000000..9a7aa600f
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/project-users/update-membership.mdx
@@ -0,0 +1,4 @@
+---
+title: "Update User Membership"
+openapi: "PATCH /api/v1/workspace/{workspaceId}/memberships/{membershipId}"
+---
diff --git a/docs/api-reference/endpoints/workspaces/create-workspace.mdx b/docs/api-reference/endpoints/depreciated/projects/create-project.mdx
similarity index 100%
rename from docs/api-reference/endpoints/workspaces/create-workspace.mdx
rename to docs/api-reference/endpoints/depreciated/projects/create-project.mdx
diff --git a/docs/api-reference/endpoints/workspaces/delete-workspace.mdx b/docs/api-reference/endpoints/depreciated/projects/delete-project.mdx
similarity index 100%
rename from docs/api-reference/endpoints/workspaces/delete-workspace.mdx
rename to docs/api-reference/endpoints/depreciated/projects/delete-project.mdx
diff --git a/docs/api-reference/endpoints/workspaces/get-workspace-by-slug.mdx b/docs/api-reference/endpoints/depreciated/projects/get-project-by-slug.mdx
similarity index 100%
rename from docs/api-reference/endpoints/workspaces/get-workspace-by-slug.mdx
rename to docs/api-reference/endpoints/depreciated/projects/get-project-by-slug.mdx
diff --git a/docs/api-reference/endpoints/workspaces/get-workspace.mdx b/docs/api-reference/endpoints/depreciated/projects/get-project.mdx
similarity index 94%
rename from docs/api-reference/endpoints/workspaces/get-workspace.mdx
rename to docs/api-reference/endpoints/depreciated/projects/get-project.mdx
index edd0a0276..a27d41b43 100644
--- a/docs/api-reference/endpoints/workspaces/get-workspace.mdx
+++ b/docs/api-reference/endpoints/depreciated/projects/get-project.mdx
@@ -1,4 +1,4 @@
---
title: "Get Project"
openapi: "GET /api/v1/workspace/{workspaceId}"
----
\ No newline at end of file
+---
diff --git a/docs/api-reference/endpoints/workspaces/workspace-key.mdx b/docs/api-reference/endpoints/depreciated/projects/project-key.mdx
similarity index 100%
rename from docs/api-reference/endpoints/workspaces/workspace-key.mdx
rename to docs/api-reference/endpoints/depreciated/projects/project-key.mdx
diff --git a/docs/api-reference/endpoints/workspaces/update-workspace.mdx b/docs/api-reference/endpoints/depreciated/projects/project-workspace.mdx
similarity index 100%
rename from docs/api-reference/endpoints/workspaces/update-workspace.mdx
rename to docs/api-reference/endpoints/depreciated/projects/project-workspace.mdx
diff --git a/docs/api-reference/endpoints/workspaces/rollback-snapshot.mdx b/docs/api-reference/endpoints/depreciated/projects/rollback-snapshot.mdx
similarity index 100%
rename from docs/api-reference/endpoints/workspaces/rollback-snapshot.mdx
rename to docs/api-reference/endpoints/depreciated/projects/rollback-snapshot.mdx
diff --git a/docs/api-reference/endpoints/workspaces/secret-snapshots.mdx b/docs/api-reference/endpoints/depreciated/projects/secret-snapshots.mdx
similarity index 100%
rename from docs/api-reference/endpoints/workspaces/secret-snapshots.mdx
rename to docs/api-reference/endpoints/depreciated/projects/secret-snapshots.mdx
diff --git a/docs/api-reference/endpoints/depreciated/projects/update-project.mdx b/docs/api-reference/endpoints/depreciated/projects/update-project.mdx
new file mode 100644
index 000000000..699e3e3af
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/projects/update-project.mdx
@@ -0,0 +1,4 @@
+---
+title: "Update Project"
+openapi: "PATCH /api/v1/workspace/{workspaceId}"
+---
\ No newline at end of file
diff --git a/docs/api-reference/endpoints/depreciated/secret-imports/create.mdx b/docs/api-reference/endpoints/depreciated/secret-imports/create.mdx
new file mode 100644
index 000000000..3abfb320f
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secret-imports/create.mdx
@@ -0,0 +1,4 @@
+---
+title: "Create"
+openapi: "POST /api/v1/secret-imports"
+---
diff --git a/docs/api-reference/endpoints/depreciated/secret-imports/delete.mdx b/docs/api-reference/endpoints/depreciated/secret-imports/delete.mdx
new file mode 100644
index 000000000..cfa5960b1
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secret-imports/delete.mdx
@@ -0,0 +1,4 @@
+---
+title: "Delete"
+openapi: "DELETE /api/v1/secret-imports/{secretImportId}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/secret-imports/list.mdx b/docs/api-reference/endpoints/depreciated/secret-imports/list.mdx
new file mode 100644
index 000000000..580d4be8d
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secret-imports/list.mdx
@@ -0,0 +1,4 @@
+---
+title: "List"
+openapi: "GET /api/v1/secret-imports"
+---
diff --git a/docs/api-reference/endpoints/depreciated/secret-imports/update.mdx b/docs/api-reference/endpoints/depreciated/secret-imports/update.mdx
new file mode 100644
index 000000000..f21133223
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secret-imports/update.mdx
@@ -0,0 +1,4 @@
+---
+title: "Update"
+openapi: "PATCH /api/v1/secret-imports/{secretImportId}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/secret-tags/create.mdx b/docs/api-reference/endpoints/depreciated/secret-tags/create.mdx
new file mode 100644
index 000000000..82d0eed17
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secret-tags/create.mdx
@@ -0,0 +1,4 @@
+---
+title: "Create"
+openapi: "POST /api/v1/workspace/{projectId}/tags"
+---
\ No newline at end of file
diff --git a/docs/api-reference/endpoints/depreciated/secret-tags/delete.mdx b/docs/api-reference/endpoints/depreciated/secret-tags/delete.mdx
new file mode 100644
index 000000000..cc98f03c2
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secret-tags/delete.mdx
@@ -0,0 +1,4 @@
+---
+title: "Delete"
+openapi: "DELETE /api/v1/workspace/{projectId}/tags/{tagId}"
+---
\ No newline at end of file
diff --git a/docs/api-reference/endpoints/depreciated/secret-tags/get-by-id.mdx b/docs/api-reference/endpoints/depreciated/secret-tags/get-by-id.mdx
new file mode 100644
index 000000000..de02fe133
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secret-tags/get-by-id.mdx
@@ -0,0 +1,4 @@
+---
+title: "Get By ID"
+openapi: "GET /api/v1/workspace/{projectId}/tags/{tagId}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/secret-tags/get-by-slug.mdx b/docs/api-reference/endpoints/depreciated/secret-tags/get-by-slug.mdx
new file mode 100644
index 000000000..91eab730f
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secret-tags/get-by-slug.mdx
@@ -0,0 +1,4 @@
+---
+title: "Get By Slug"
+openapi: "GET /api/v1/workspace/{projectId}/tags/slug/{tagSlug}"
+---
diff --git a/docs/api-reference/endpoints/depreciated/secret-tags/list.mdx b/docs/api-reference/endpoints/depreciated/secret-tags/list.mdx
new file mode 100644
index 000000000..c4a940f77
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secret-tags/list.mdx
@@ -0,0 +1,4 @@
+---
+title: "List"
+openapi: "GET /api/v1/workspace/{projectId}/tags"
+---
\ No newline at end of file
diff --git a/docs/api-reference/endpoints/depreciated/secret-tags/update.mdx b/docs/api-reference/endpoints/depreciated/secret-tags/update.mdx
new file mode 100644
index 000000000..b9c290db8
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secret-tags/update.mdx
@@ -0,0 +1,4 @@
+---
+title: "Update"
+openapi: "PATCH /api/v1/workspace/{projectId}/tags/{tagId}"
+---
diff --git a/docs/api-reference/endpoints/secrets/attach-tags.mdx b/docs/api-reference/endpoints/depreciated/secrets/attach-tags.mdx
similarity index 100%
rename from docs/api-reference/endpoints/secrets/attach-tags.mdx
rename to docs/api-reference/endpoints/depreciated/secrets/attach-tags.mdx
diff --git a/docs/api-reference/endpoints/depreciated/secrets/create-many.mdx b/docs/api-reference/endpoints/depreciated/secrets/create-many.mdx
new file mode 100644
index 000000000..227c5470d
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secrets/create-many.mdx
@@ -0,0 +1,5 @@
+---
+title: "Bulk Create"
+openapi: "POST /api/v3/secrets/batch/raw"
+---
+
diff --git a/docs/api-reference/endpoints/depreciated/secrets/create.mdx b/docs/api-reference/endpoints/depreciated/secrets/create.mdx
new file mode 100644
index 000000000..afee0a719
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secrets/create.mdx
@@ -0,0 +1,5 @@
+---
+title: "Create"
+openapi: "POST /api/v3/secrets/raw/{secretName}"
+---
+
diff --git a/docs/api-reference/endpoints/depreciated/secrets/delete-many.mdx b/docs/api-reference/endpoints/depreciated/secrets/delete-many.mdx
new file mode 100644
index 000000000..57c8588d8
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secrets/delete-many.mdx
@@ -0,0 +1,5 @@
+---
+title: "Bulk Delete"
+openapi: "DELETE /api/v3/secrets/batch/raw"
+---
+
diff --git a/docs/api-reference/endpoints/depreciated/secrets/delete.mdx b/docs/api-reference/endpoints/depreciated/secrets/delete.mdx
new file mode 100644
index 000000000..ef3abc722
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secrets/delete.mdx
@@ -0,0 +1,5 @@
+---
+title: "Delete"
+openapi: "DELETE /api/v3/secrets/raw/{secretName}"
+---
+
diff --git a/docs/api-reference/endpoints/secrets/detach-tags.mdx b/docs/api-reference/endpoints/depreciated/secrets/detach-tags.mdx
similarity index 100%
rename from docs/api-reference/endpoints/secrets/detach-tags.mdx
rename to docs/api-reference/endpoints/depreciated/secrets/detach-tags.mdx
diff --git a/docs/api-reference/endpoints/depreciated/secrets/list.mdx b/docs/api-reference/endpoints/depreciated/secrets/list.mdx
new file mode 100644
index 000000000..4808f6690
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secrets/list.mdx
@@ -0,0 +1,4 @@
+---
+title: "List"
+openapi: "GET /api/v3/secrets/raw"
+---
diff --git a/docs/api-reference/endpoints/depreciated/secrets/read.mdx b/docs/api-reference/endpoints/depreciated/secrets/read.mdx
new file mode 100644
index 000000000..6af308e0f
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secrets/read.mdx
@@ -0,0 +1,5 @@
+---
+title: "Retrieve"
+openapi: "GET /api/v3/secrets/raw/{secretName}"
+---
+
diff --git a/docs/api-reference/endpoints/depreciated/secrets/update-many.mdx b/docs/api-reference/endpoints/depreciated/secrets/update-many.mdx
new file mode 100644
index 000000000..7586d91bc
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secrets/update-many.mdx
@@ -0,0 +1,5 @@
+---
+title: "Bulk Update"
+openapi: "PATCH /api/v3/secrets/batch/raw"
+---
+
diff --git a/docs/api-reference/endpoints/depreciated/secrets/update.mdx b/docs/api-reference/endpoints/depreciated/secrets/update.mdx
new file mode 100644
index 000000000..ce68c492e
--- /dev/null
+++ b/docs/api-reference/endpoints/depreciated/secrets/update.mdx
@@ -0,0 +1,4 @@
+---
+title: "Update"
+openapi: "PATCH /api/v3/secrets/raw/{secretName}"
+---
diff --git a/docs/api-reference/endpoints/environments/create.mdx b/docs/api-reference/endpoints/environments/create.mdx
index 826dcce3d..c7f9b0658 100644
--- a/docs/api-reference/endpoints/environments/create.mdx
+++ b/docs/api-reference/endpoints/environments/create.mdx
@@ -1,4 +1,4 @@
---
title: "Create"
-openapi: "POST /api/v1/workspace/{workspaceId}/environments"
+openapi: "POST /api/v1/projects/{projectId}/environments"
---
diff --git a/docs/api-reference/endpoints/environments/delete.mdx b/docs/api-reference/endpoints/environments/delete.mdx
index 903e58d2a..2d2419255 100644
--- a/docs/api-reference/endpoints/environments/delete.mdx
+++ b/docs/api-reference/endpoints/environments/delete.mdx
@@ -1,4 +1,4 @@
---
title: "Delete"
-openapi: "DELETE /api/v1/workspace/{workspaceId}/environments/{id}"
+openapi: "DELETE /api/v1/projects/{projectId}/environments/{id}"
---
diff --git a/docs/api-reference/endpoints/environments/update.mdx b/docs/api-reference/endpoints/environments/update.mdx
index f93968668..1583f5220 100644
--- a/docs/api-reference/endpoints/environments/update.mdx
+++ b/docs/api-reference/endpoints/environments/update.mdx
@@ -1,4 +1,4 @@
---
title: "Update"
-openapi: "PATCH /api/v1/workspace/{workspaceId}/environments/{id}"
+openapi: "PATCH /api/v1/projects/{projectId}/environments/{id}"
---
diff --git a/docs/api-reference/endpoints/folders/create.mdx b/docs/api-reference/endpoints/folders/create.mdx
index e1ff3004a..13c4abea2 100644
--- a/docs/api-reference/endpoints/folders/create.mdx
+++ b/docs/api-reference/endpoints/folders/create.mdx
@@ -1,4 +1,4 @@
---
title: "Create"
-openapi: "POST /api/v1/folders"
+openapi: "POST /api/v2/folders"
---
diff --git a/docs/api-reference/endpoints/folders/delete.mdx b/docs/api-reference/endpoints/folders/delete.mdx
index a106cc2eb..71ba9684c 100644
--- a/docs/api-reference/endpoints/folders/delete.mdx
+++ b/docs/api-reference/endpoints/folders/delete.mdx
@@ -1,4 +1,4 @@
---
title: "Delete"
-openapi: "DELETE /api/v1/folders/{folderIdOrName}"
+openapi: "DELETE /api/v2/folders/{folderIdOrName}"
---
diff --git a/docs/api-reference/endpoints/folders/get-by-id.mdx b/docs/api-reference/endpoints/folders/get-by-id.mdx
index db3c4d0cc..ebfda35da 100644
--- a/docs/api-reference/endpoints/folders/get-by-id.mdx
+++ b/docs/api-reference/endpoints/folders/get-by-id.mdx
@@ -1,4 +1,4 @@
---
title: "Get by ID"
-openapi: "GET /api/v1/folders/{id}"
+openapi: "GET /api/v2/folders/{id}"
---
diff --git a/docs/api-reference/endpoints/folders/list.mdx b/docs/api-reference/endpoints/folders/list.mdx
index f40f93273..1d3a10ed8 100644
--- a/docs/api-reference/endpoints/folders/list.mdx
+++ b/docs/api-reference/endpoints/folders/list.mdx
@@ -1,4 +1,4 @@
---
title: "List"
-openapi: "GET /api/v1/folders"
+openapi: "GET /api/v2/folders"
---
diff --git a/docs/api-reference/endpoints/folders/update.mdx b/docs/api-reference/endpoints/folders/update.mdx
index c54778e94..969833a04 100644
--- a/docs/api-reference/endpoints/folders/update.mdx
+++ b/docs/api-reference/endpoints/folders/update.mdx
@@ -1,4 +1,4 @@
---
title: "Update"
-openapi: "PATCH /api/v1/folders/{folderId}"
+openapi: "PATCH /api/v2/folders/{folderId}"
---
diff --git a/docs/api-reference/endpoints/project-groups/create.mdx b/docs/api-reference/endpoints/project-groups/create.mdx
index 6dd7f1a4f..c40c506a6 100644
--- a/docs/api-reference/endpoints/project-groups/create.mdx
+++ b/docs/api-reference/endpoints/project-groups/create.mdx
@@ -1,4 +1,4 @@
---
title: "Create Project Membership"
-openapi: "POST /api/v2/workspace/{projectId}/groups/{groupIdOrName}"
+openapi: "POST /api/v1/projects/{projectId}/groups/{groupIdOrName}"
---
diff --git a/docs/api-reference/endpoints/project-groups/delete.mdx b/docs/api-reference/endpoints/project-groups/delete.mdx
index 07db40d7f..450e05501 100644
--- a/docs/api-reference/endpoints/project-groups/delete.mdx
+++ b/docs/api-reference/endpoints/project-groups/delete.mdx
@@ -1,4 +1,4 @@
---
title: "Delete Project Membership"
-openapi: "DELETE /api/v2/workspace/{projectId}/groups/{groupId}"
+openapi: "DELETE /api/v1/projects/{projectId}/groups/{groupId}"
---
diff --git a/docs/api-reference/endpoints/project-groups/get-by-id.mdx b/docs/api-reference/endpoints/project-groups/get-by-id.mdx
index 611f39059..89aa6ebac 100644
--- a/docs/api-reference/endpoints/project-groups/get-by-id.mdx
+++ b/docs/api-reference/endpoints/project-groups/get-by-id.mdx
@@ -1,4 +1,4 @@
---
title: "Get Project Membership"
-openapi: "GET /api/v2/workspace/{projectId}/groups/{groupId}"
+openapi: "GET /api/v1/projects/{projectId}/groups/{groupId}"
---
diff --git a/docs/api-reference/endpoints/project-groups/list.mdx b/docs/api-reference/endpoints/project-groups/list.mdx
index 1488fb6ae..90b4f957a 100644
--- a/docs/api-reference/endpoints/project-groups/list.mdx
+++ b/docs/api-reference/endpoints/project-groups/list.mdx
@@ -1,4 +1,4 @@
---
title: "List Project Memberships"
-openapi: "GET /api/v2/workspace/{projectId}/groups"
+openapi: "GET /api/v1/projects/{projectId}/groups"
---
diff --git a/docs/api-reference/endpoints/project-groups/update.mdx b/docs/api-reference/endpoints/project-groups/update.mdx
index 8b963a1d8..029815673 100644
--- a/docs/api-reference/endpoints/project-groups/update.mdx
+++ b/docs/api-reference/endpoints/project-groups/update.mdx
@@ -1,4 +1,4 @@
---
title: "Update Project Membership"
-openapi: "PATCH /api/v2/workspace/{projectId}/groups/{groupId}"
+openapi: "PATCH /api/v1/projects/{projectId}/groups/{groupId}"
---
diff --git a/docs/api-reference/endpoints/project-identities/add-identity-membership.mdx b/docs/api-reference/endpoints/project-identities/add-identity-membership.mdx
index 285b1d1c4..8b0122efd 100644
--- a/docs/api-reference/endpoints/project-identities/add-identity-membership.mdx
+++ b/docs/api-reference/endpoints/project-identities/add-identity-membership.mdx
@@ -1,4 +1,4 @@
---
title: "Create Identity Membership"
-openapi: "POST /api/v2/workspace/{projectId}/identity-memberships/{identityId}"
+openapi: "POST /api/v1/projects/{projectId}/identity-memberships/{identityId}"
---
diff --git a/docs/api-reference/endpoints/project-identities/delete-identity-membership.mdx b/docs/api-reference/endpoints/project-identities/delete-identity-membership.mdx
index e2b266626..10c56e5ec 100644
--- a/docs/api-reference/endpoints/project-identities/delete-identity-membership.mdx
+++ b/docs/api-reference/endpoints/project-identities/delete-identity-membership.mdx
@@ -1,4 +1,4 @@
---
title: "Delete Identity Membership"
-openapi: "DELETE /api/v2/workspace/{projectId}/identity-memberships/{identityId}"
+openapi: "DELETE /api/v1/projects/{projectId}/identity-memberships/{identityId}"
---
diff --git a/docs/api-reference/endpoints/project-identities/get-by-id.mdx b/docs/api-reference/endpoints/project-identities/get-by-id.mdx
index 37f4192d7..801b0d422 100644
--- a/docs/api-reference/endpoints/project-identities/get-by-id.mdx
+++ b/docs/api-reference/endpoints/project-identities/get-by-id.mdx
@@ -1,4 +1,4 @@
---
title: "Get Identity by ID"
-openapi: "GET /api/v2/workspace/{projectId}/identity-memberships/{identityId}"
+openapi: "GET /api/v1/projects/{projectId}/identity-memberships/{identityId}"
---
diff --git a/docs/api-reference/endpoints/project-identities/list-identity-memberships.mdx b/docs/api-reference/endpoints/project-identities/list-identity-memberships.mdx
index e5162e693..8673350fa 100644
--- a/docs/api-reference/endpoints/project-identities/list-identity-memberships.mdx
+++ b/docs/api-reference/endpoints/project-identities/list-identity-memberships.mdx
@@ -1,4 +1,4 @@
---
title: "List Identity Memberships"
-openapi: "GET /api/v2/workspace/{projectId}/identity-memberships"
+openapi: "GET /api/v1/projects/{projectId}/identity-memberships"
---
diff --git a/docs/api-reference/endpoints/project-identities/update-identity-membership.mdx b/docs/api-reference/endpoints/project-identities/update-identity-membership.mdx
index 667cf7eb3..ef34363d6 100644
--- a/docs/api-reference/endpoints/project-identities/update-identity-membership.mdx
+++ b/docs/api-reference/endpoints/project-identities/update-identity-membership.mdx
@@ -1,4 +1,4 @@
---
title: "Update Identity Membership"
-openapi: "PATCH /api/v2/workspace/{projectId}/identity-memberships/{identityId}"
+openapi: "PATCH /api/v1/projects/{projectId}/identity-memberships/{identityId}"
---
diff --git a/docs/api-reference/endpoints/project-roles/create.mdx b/docs/api-reference/endpoints/project-roles/create.mdx
index 97570ec36..1d3f9eb51 100644
--- a/docs/api-reference/endpoints/project-roles/create.mdx
+++ b/docs/api-reference/endpoints/project-roles/create.mdx
@@ -1,10 +1,9 @@
---
title: "Create"
-openapi: "POST /api/v2/workspace/{projectId}/roles"
+openapi: "POST /api/v1/projects/{projectId}/roles"
---
You can read more about the permissions field in the [permissions
documentation](/internals/permissions).
-
diff --git a/docs/api-reference/endpoints/project-roles/delete.mdx b/docs/api-reference/endpoints/project-roles/delete.mdx
index 41edfa7c3..7b162c6da 100644
--- a/docs/api-reference/endpoints/project-roles/delete.mdx
+++ b/docs/api-reference/endpoints/project-roles/delete.mdx
@@ -1,4 +1,4 @@
---
title: "Delete"
-openapi: "DELETE /api/v2/workspace/{projectId}/roles/{roleId}"
+openapi: "DELETE /api/v1/projects/{projectId}/roles/{roleId}"
---
diff --git a/docs/api-reference/endpoints/project-roles/get-by-slug.mdx b/docs/api-reference/endpoints/project-roles/get-by-slug.mdx
index dfc5c582a..adfac8cd3 100644
--- a/docs/api-reference/endpoints/project-roles/get-by-slug.mdx
+++ b/docs/api-reference/endpoints/project-roles/get-by-slug.mdx
@@ -1,4 +1,4 @@
---
title: "Get By Slug"
-openapi: "GET /api/v2/workspace/{projectId}/roles/slug/{roleSlug}"
+openapi: "GET /api/v1/projects/{projectId}/roles/slug/{roleSlug}"
---
diff --git a/docs/api-reference/endpoints/project-roles/list.mdx b/docs/api-reference/endpoints/project-roles/list.mdx
index 8d8dc10c1..df6164370 100644
--- a/docs/api-reference/endpoints/project-roles/list.mdx
+++ b/docs/api-reference/endpoints/project-roles/list.mdx
@@ -1,4 +1,4 @@
---
title: "List"
-openapi: "GET /api/v2/workspace/{projectId}/roles"
+openapi: "GET /api/v1/projects/{projectId}/roles"
---
diff --git a/docs/api-reference/endpoints/project-roles/update.mdx b/docs/api-reference/endpoints/project-roles/update.mdx
index 662d5e617..56ac34f8b 100644
--- a/docs/api-reference/endpoints/project-roles/update.mdx
+++ b/docs/api-reference/endpoints/project-roles/update.mdx
@@ -1,4 +1,4 @@
---
title: "Update"
-openapi: "PATCH /api/v2/workspace/{projectId}/roles/{roleId}"
+openapi: "PATCH /api/v1/projects/{projectId}/roles/{roleId}"
---
diff --git a/docs/api-reference/endpoints/project-users/delete-membership.mdx b/docs/api-reference/endpoints/project-users/delete-membership.mdx
index 1995e4726..5c87e94af 100644
--- a/docs/api-reference/endpoints/project-users/delete-membership.mdx
+++ b/docs/api-reference/endpoints/project-users/delete-membership.mdx
@@ -1,4 +1,4 @@
---
title: "Delete User Membership"
-openapi: "DELETE /api/v1/workspace/{workspaceId}/memberships/{membershipId}"
+openapi: "DELETE /api/v1/projects/{projectId}/memberships/{membershipId}"
---
diff --git a/docs/api-reference/endpoints/project-users/get-by-username.mdx b/docs/api-reference/endpoints/project-users/get-by-username.mdx
index ec69d4947..5e4916b8e 100644
--- a/docs/api-reference/endpoints/project-users/get-by-username.mdx
+++ b/docs/api-reference/endpoints/project-users/get-by-username.mdx
@@ -1,4 +1,4 @@
---
title: "Get By Username"
-openapi: "POST /api/v1/workspace/{workspaceId}/memberships/details"
+openapi: "POST /api/v1/projects/{projectId}/memberships/details"
---
diff --git a/docs/api-reference/endpoints/project-users/invite-member-to-project.mdx b/docs/api-reference/endpoints/project-users/invite-member-to-project.mdx
new file mode 100644
index 000000000..c6fda8a09
--- /dev/null
+++ b/docs/api-reference/endpoints/project-users/invite-member-to-project.mdx
@@ -0,0 +1,4 @@
+---
+title: "Invite Member"
+openapi: "POST /api/v1/projects/{projectId}/memberships"
+---
diff --git a/docs/api-reference/endpoints/project-users/memberships.mdx b/docs/api-reference/endpoints/project-users/memberships.mdx
index 3c4735f94..dd79667fe 100644
--- a/docs/api-reference/endpoints/project-users/memberships.mdx
+++ b/docs/api-reference/endpoints/project-users/memberships.mdx
@@ -1,4 +1,4 @@
---
title: "Get User Memberships"
-openapi: "GET /api/v1/workspace/{workspaceId}/memberships"
+openapi: "GET /api/v1/projects/{projectId}/memberships"
---
diff --git a/docs/api-reference/endpoints/project-users/remove-member-from-project.mdx b/docs/api-reference/endpoints/project-users/remove-member-from-project.mdx
new file mode 100644
index 000000000..8646aa158
--- /dev/null
+++ b/docs/api-reference/endpoints/project-users/remove-member-from-project.mdx
@@ -0,0 +1,4 @@
+---
+title: "Remove Member"
+openapi: "DELETE /api/v1/projects/{projectId}/memberships"
+---
diff --git a/docs/api-reference/endpoints/project-users/update-membership.mdx b/docs/api-reference/endpoints/project-users/update-membership.mdx
index 9a7aa600f..5f1edcf0a 100644
--- a/docs/api-reference/endpoints/project-users/update-membership.mdx
+++ b/docs/api-reference/endpoints/project-users/update-membership.mdx
@@ -1,4 +1,4 @@
---
title: "Update User Membership"
-openapi: "PATCH /api/v1/workspace/{workspaceId}/memberships/{membershipId}"
+openapi: "PATCH /api/v1/projects/{projectId}/memberships/{membershipId}"
---
diff --git a/docs/api-reference/endpoints/projects/create-project.mdx b/docs/api-reference/endpoints/projects/create-project.mdx
new file mode 100644
index 000000000..7ee1caff8
--- /dev/null
+++ b/docs/api-reference/endpoints/projects/create-project.mdx
@@ -0,0 +1,4 @@
+---
+title: "Create Project"
+openapi: "POST /api/v1/projects"
+---
diff --git a/docs/api-reference/endpoints/projects/delete-project.mdx b/docs/api-reference/endpoints/projects/delete-project.mdx
new file mode 100644
index 000000000..eff96ded5
--- /dev/null
+++ b/docs/api-reference/endpoints/projects/delete-project.mdx
@@ -0,0 +1,8 @@
+---
+title: "Delete Project"
+openapi: "DELETE /api/v1/projects/{projectId}"
+---
+
+
+ This operation is irreversible. All data associated with the project will be deleted. Please use with caution.
+
diff --git a/docs/api-reference/endpoints/projects/get-project-by-slug.mdx b/docs/api-reference/endpoints/projects/get-project-by-slug.mdx
new file mode 100644
index 000000000..9bcccc31e
--- /dev/null
+++ b/docs/api-reference/endpoints/projects/get-project-by-slug.mdx
@@ -0,0 +1,4 @@
+---
+title: "Get Project By Slug"
+openapi: "GET /api/v1/projects/slug/{slug}"
+---
diff --git a/docs/api-reference/endpoints/projects/get-project.mdx b/docs/api-reference/endpoints/projects/get-project.mdx
new file mode 100644
index 000000000..6ed92833e
--- /dev/null
+++ b/docs/api-reference/endpoints/projects/get-project.mdx
@@ -0,0 +1,4 @@
+---
+title: "Get Project"
+openapi: "GET /api/v1/projects/{projectId}"
+---
diff --git a/docs/api-reference/endpoints/projects/rollback-snapshot.mdx b/docs/api-reference/endpoints/projects/rollback-snapshot.mdx
new file mode 100644
index 000000000..527c861b2
--- /dev/null
+++ b/docs/api-reference/endpoints/projects/rollback-snapshot.mdx
@@ -0,0 +1,4 @@
+---
+title: "Roll Back to Snapshot"
+openapi: "POST /api/v1/secret-snapshot/{secretSnapshotId}/rollback"
+---
diff --git a/docs/api-reference/endpoints/projects/secret-snapshots.mdx b/docs/api-reference/endpoints/projects/secret-snapshots.mdx
new file mode 100644
index 000000000..182e61507
--- /dev/null
+++ b/docs/api-reference/endpoints/projects/secret-snapshots.mdx
@@ -0,0 +1,4 @@
+---
+title: "Get Snapshots"
+openapi: "GET /api/v1/projects/{projectId}/secret-snapshots"
+---
diff --git a/docs/api-reference/endpoints/projects/update-project.mdx b/docs/api-reference/endpoints/projects/update-project.mdx
new file mode 100644
index 000000000..99fcc7b76
--- /dev/null
+++ b/docs/api-reference/endpoints/projects/update-project.mdx
@@ -0,0 +1,4 @@
+---
+title: "Update Project"
+openapi: "PATCH /api/v1/projects/{projectId}"
+---
diff --git a/docs/api-reference/endpoints/secret-imports/create.mdx b/docs/api-reference/endpoints/secret-imports/create.mdx
index 3abfb320f..f072e59a4 100644
--- a/docs/api-reference/endpoints/secret-imports/create.mdx
+++ b/docs/api-reference/endpoints/secret-imports/create.mdx
@@ -1,4 +1,4 @@
---
title: "Create"
-openapi: "POST /api/v1/secret-imports"
+openapi: "POST /api/v2/secret-imports"
---
diff --git a/docs/api-reference/endpoints/secret-imports/delete.mdx b/docs/api-reference/endpoints/secret-imports/delete.mdx
index cfa5960b1..d0b35426b 100644
--- a/docs/api-reference/endpoints/secret-imports/delete.mdx
+++ b/docs/api-reference/endpoints/secret-imports/delete.mdx
@@ -1,4 +1,4 @@
---
title: "Delete"
-openapi: "DELETE /api/v1/secret-imports/{secretImportId}"
+openapi: "DELETE /api/v2/secret-imports/{secretImportId}"
---
diff --git a/docs/api-reference/endpoints/secret-imports/list.mdx b/docs/api-reference/endpoints/secret-imports/list.mdx
index 580d4be8d..1cf3e1386 100644
--- a/docs/api-reference/endpoints/secret-imports/list.mdx
+++ b/docs/api-reference/endpoints/secret-imports/list.mdx
@@ -1,4 +1,4 @@
---
title: "List"
-openapi: "GET /api/v1/secret-imports"
+openapi: "GET /api/v2/secret-imports"
---
diff --git a/docs/api-reference/endpoints/secret-imports/update.mdx b/docs/api-reference/endpoints/secret-imports/update.mdx
index f21133223..146fcd76b 100644
--- a/docs/api-reference/endpoints/secret-imports/update.mdx
+++ b/docs/api-reference/endpoints/secret-imports/update.mdx
@@ -1,4 +1,4 @@
---
title: "Update"
-openapi: "PATCH /api/v1/secret-imports/{secretImportId}"
+openapi: "PATCH /api/v2/secret-imports/{secretImportId}"
---
diff --git a/docs/api-reference/endpoints/secret-tags/create.mdx b/docs/api-reference/endpoints/secret-tags/create.mdx
index 82d0eed17..d4c587979 100644
--- a/docs/api-reference/endpoints/secret-tags/create.mdx
+++ b/docs/api-reference/endpoints/secret-tags/create.mdx
@@ -1,4 +1,4 @@
---
title: "Create"
-openapi: "POST /api/v1/workspace/{projectId}/tags"
----
\ No newline at end of file
+openapi: "POST /api/v1/projects/{projectId}/tags"
+---
diff --git a/docs/api-reference/endpoints/secret-tags/delete.mdx b/docs/api-reference/endpoints/secret-tags/delete.mdx
index cc98f03c2..121d6816c 100644
--- a/docs/api-reference/endpoints/secret-tags/delete.mdx
+++ b/docs/api-reference/endpoints/secret-tags/delete.mdx
@@ -1,4 +1,4 @@
---
title: "Delete"
-openapi: "DELETE /api/v1/workspace/{projectId}/tags/{tagId}"
----
\ No newline at end of file
+openapi: "DELETE /api/v1/projects/{projectId}/tags/{tagId}"
+---
diff --git a/docs/api-reference/endpoints/secret-tags/get-by-id.mdx b/docs/api-reference/endpoints/secret-tags/get-by-id.mdx
index de02fe133..7e1fa8d7f 100644
--- a/docs/api-reference/endpoints/secret-tags/get-by-id.mdx
+++ b/docs/api-reference/endpoints/secret-tags/get-by-id.mdx
@@ -1,4 +1,4 @@
---
title: "Get By ID"
-openapi: "GET /api/v1/workspace/{projectId}/tags/{tagId}"
+openapi: "GET /api/v1/projects/{projectId}/tags/{tagId}"
---
diff --git a/docs/api-reference/endpoints/secret-tags/get-by-slug.mdx b/docs/api-reference/endpoints/secret-tags/get-by-slug.mdx
index 91eab730f..c012c97d4 100644
--- a/docs/api-reference/endpoints/secret-tags/get-by-slug.mdx
+++ b/docs/api-reference/endpoints/secret-tags/get-by-slug.mdx
@@ -1,4 +1,4 @@
---
title: "Get By Slug"
-openapi: "GET /api/v1/workspace/{projectId}/tags/slug/{tagSlug}"
+openapi: "GET /api/v1/projects/{projectId}/tags/slug/{tagSlug}"
---
diff --git a/docs/api-reference/endpoints/secret-tags/list.mdx b/docs/api-reference/endpoints/secret-tags/list.mdx
index c4a940f77..b7e1eca74 100644
--- a/docs/api-reference/endpoints/secret-tags/list.mdx
+++ b/docs/api-reference/endpoints/secret-tags/list.mdx
@@ -1,4 +1,4 @@
---
title: "List"
-openapi: "GET /api/v1/workspace/{projectId}/tags"
----
\ No newline at end of file
+openapi: "GET /api/v1/projects/{projectId}/tags"
+---
diff --git a/docs/api-reference/endpoints/secret-tags/update.mdx b/docs/api-reference/endpoints/secret-tags/update.mdx
index b9c290db8..b20ce49f4 100644
--- a/docs/api-reference/endpoints/secret-tags/update.mdx
+++ b/docs/api-reference/endpoints/secret-tags/update.mdx
@@ -1,4 +1,4 @@
---
title: "Update"
-openapi: "PATCH /api/v1/workspace/{projectId}/tags/{tagId}"
+openapi: "PATCH /api/v1/projects/{projectId}/tags/{tagId}"
---
diff --git a/docs/api-reference/endpoints/secrets/create-many.mdx b/docs/api-reference/endpoints/secrets/create-many.mdx
index 227c5470d..e3d30aef8 100644
--- a/docs/api-reference/endpoints/secrets/create-many.mdx
+++ b/docs/api-reference/endpoints/secrets/create-many.mdx
@@ -1,5 +1,4 @@
---
title: "Bulk Create"
-openapi: "POST /api/v3/secrets/batch/raw"
+openapi: "POST /api/v4/secrets/batch"
---
-
diff --git a/docs/api-reference/endpoints/secrets/create.mdx b/docs/api-reference/endpoints/secrets/create.mdx
index afee0a719..c04dcf9f4 100644
--- a/docs/api-reference/endpoints/secrets/create.mdx
+++ b/docs/api-reference/endpoints/secrets/create.mdx
@@ -1,5 +1,4 @@
---
title: "Create"
-openapi: "POST /api/v3/secrets/raw/{secretName}"
+openapi: "POST /api/v4/secrets/{secretName}"
---
-
diff --git a/docs/api-reference/endpoints/secrets/delete-many.mdx b/docs/api-reference/endpoints/secrets/delete-many.mdx
index 57c8588d8..49491c3b9 100644
--- a/docs/api-reference/endpoints/secrets/delete-many.mdx
+++ b/docs/api-reference/endpoints/secrets/delete-many.mdx
@@ -1,5 +1,4 @@
---
title: "Bulk Delete"
-openapi: "DELETE /api/v3/secrets/batch/raw"
+openapi: "DELETE /api/v4/secrets/batch"
---
-
diff --git a/docs/api-reference/endpoints/secrets/delete.mdx b/docs/api-reference/endpoints/secrets/delete.mdx
index ef3abc722..f71a851e8 100644
--- a/docs/api-reference/endpoints/secrets/delete.mdx
+++ b/docs/api-reference/endpoints/secrets/delete.mdx
@@ -1,5 +1,4 @@
---
title: "Delete"
-openapi: "DELETE /api/v3/secrets/raw/{secretName}"
+openapi: "DELETE /api/v4/secrets/{secretName}"
---
-
diff --git a/docs/api-reference/endpoints/secrets/list.mdx b/docs/api-reference/endpoints/secrets/list.mdx
index 4808f6690..6a1f38d68 100644
--- a/docs/api-reference/endpoints/secrets/list.mdx
+++ b/docs/api-reference/endpoints/secrets/list.mdx
@@ -1,4 +1,4 @@
---
title: "List"
-openapi: "GET /api/v3/secrets/raw"
+openapi: "GET /api/v4/secrets"
---
diff --git a/docs/api-reference/endpoints/secrets/read.mdx b/docs/api-reference/endpoints/secrets/read.mdx
index 6af308e0f..10e725ba5 100644
--- a/docs/api-reference/endpoints/secrets/read.mdx
+++ b/docs/api-reference/endpoints/secrets/read.mdx
@@ -1,5 +1,4 @@
---
title: "Retrieve"
-openapi: "GET /api/v3/secrets/raw/{secretName}"
+openapi: "GET /api/v4/secrets/{secretName}"
---
-
diff --git a/docs/api-reference/endpoints/secrets/update-many.mdx b/docs/api-reference/endpoints/secrets/update-many.mdx
index 7586d91bc..9aca17148 100644
--- a/docs/api-reference/endpoints/secrets/update-many.mdx
+++ b/docs/api-reference/endpoints/secrets/update-many.mdx
@@ -1,5 +1,4 @@
---
title: "Bulk Update"
-openapi: "PATCH /api/v3/secrets/batch/raw"
+openapi: "PATCH /api/v4/secrets/batch"
---
-
diff --git a/docs/api-reference/endpoints/secrets/update.mdx b/docs/api-reference/endpoints/secrets/update.mdx
index ce68c492e..435f3e0c4 100644
--- a/docs/api-reference/endpoints/secrets/update.mdx
+++ b/docs/api-reference/endpoints/secrets/update.mdx
@@ -1,4 +1,4 @@
---
title: "Update"
-openapi: "PATCH /api/v3/secrets/raw/{secretName}"
+openapi: "PATCH /api/v4/secrets/{secretName}"
---
diff --git a/docs/docs.json b/docs/docs.json
index 285e11a60..32e49119c 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -1008,26 +1008,25 @@
"api-reference/endpoints/organizations/update-membership",
"api-reference/endpoints/organizations/delete-membership",
"api-reference/endpoints/organizations/bulk-delete-memberships",
- "api-reference/endpoints/organizations/list-identity-memberships",
- "api-reference/endpoints/organizations/workspaces"
+ "api-reference/endpoints/organizations/list-identity-memberships"
]
},
{
"group": "Projects",
"pages": [
- "api-reference/endpoints/workspaces/get-workspace-by-slug",
- "api-reference/endpoints/workspaces/create-workspace",
- "api-reference/endpoints/workspaces/delete-workspace",
- "api-reference/endpoints/workspaces/get-workspace",
- "api-reference/endpoints/workspaces/update-workspace",
- "api-reference/endpoints/workspaces/secret-snapshots"
+ "api-reference/endpoints/projects/get-project-by-slug",
+ "api-reference/endpoints/projects/create-project",
+ "api-reference/endpoints/projects/delete-project",
+ "api-reference/endpoints/projects/get-project",
+ "api-reference/endpoints/projects/update-project",
+ "api-reference/endpoints/projects/secret-snapshots"
]
},
{
"group": "Project Users",
"pages": [
- "api-reference/endpoints/project-users/invite-member-to-workspace",
- "api-reference/endpoints/project-users/remove-member-from-workspace",
+ "api-reference/endpoints/project-users/invite-member-to-project",
+ "api-reference/endpoints/project-users/remove-member-from-project",
"api-reference/endpoints/project-users/memberships",
"api-reference/endpoints/project-users/get-by-username",
"api-reference/endpoints/project-users/update-membership"
@@ -1112,9 +1111,7 @@
"api-reference/endpoints/secrets/delete",
"api-reference/endpoints/secrets/create-many",
"api-reference/endpoints/secrets/update-many",
- "api-reference/endpoints/secrets/delete-many",
- "api-reference/endpoints/secrets/attach-tags",
- "api-reference/endpoints/secrets/detach-tags"
+ "api-reference/endpoints/secrets/delete-many"
]
},
{
@@ -2463,6 +2460,121 @@
]
}
]
+ },
+ {
+ "group": "To be depreciated",
+ "pages": [
+ {
+ "group": "Organizations",
+ "pages": [
+ "api-reference/endpoints/depreciated/organizations/projects"
+ ]
+ },
+ {
+ "group": "Projects",
+ "pages": [
+ "api-reference/endpoints/depreciated/projects/get-project-by-slug",
+ "api-reference/endpoints/depreciated/projects/create-project",
+ "api-reference/endpoints/depreciated/projects/delete-project",
+ "api-reference/endpoints/depreciated/projects/get-project",
+ "api-reference/endpoints/depreciated/projects/update-project",
+ "api-reference/endpoints/depreciated/projects/secret-snapshots"
+ ]
+ },
+ {
+ "group": "Project Users",
+ "pages": [
+ "api-reference/endpoints/depreciated/project-users/invite-member-to-project",
+ "api-reference/endpoints/depreciated/project-users/remove-member-from-project",
+ "api-reference/endpoints/depreciated/project-users/memberships",
+ "api-reference/endpoints/depreciated/project-users/get-by-username",
+ "api-reference/endpoints/depreciated/project-users/update-membership"
+ ]
+ },
+ {
+ "group": "Project Groups",
+ "pages": [
+ "api-reference/endpoints/depreciated/project-groups/create",
+ "api-reference/endpoints/depreciated/project-groups/delete",
+ "api-reference/endpoints/depreciated/project-groups/get-by-id",
+ "api-reference/endpoints/depreciated/project-groups/list",
+ "api-reference/endpoints/depreciated/project-groups/update"
+ ]
+ },
+ {
+ "group": "Project Identities",
+ "pages": [
+ "api-reference/endpoints/depreciated/project-identities/add-identity-membership",
+ "api-reference/endpoints/depreciated/project-identities/list-identity-memberships",
+ "api-reference/endpoints/depreciated/project-identities/get-by-id",
+ "api-reference/endpoints/depreciated/project-identities/update-identity-membership",
+ "api-reference/endpoints/depreciated/project-identities/delete-identity-membership"
+ ]
+ },
+ {
+ "group": "Project Roles",
+ "pages": [
+ "api-reference/endpoints/depreciated/project-roles/create",
+ "api-reference/endpoints/depreciated/project-roles/update",
+ "api-reference/endpoints/depreciated/project-roles/delete",
+ "api-reference/endpoints/depreciated/project-roles/get-by-slug",
+ "api-reference/endpoints/depreciated/project-roles/list"
+ ]
+ },
+ {
+ "group": "Environments",
+ "pages": [
+ "api-reference/endpoints/depreciated/environments/create",
+ "api-reference/endpoints/depreciated/environments/update",
+ "api-reference/endpoints/depreciated/environments/delete"
+ ]
+ },
+ {
+ "group": "Folders",
+ "pages": [
+ "api-reference/endpoints/depreciated/folders/list",
+ "api-reference/endpoints/depreciated/folders/get-by-id",
+ "api-reference/endpoints/depreciated/folders/create",
+ "api-reference/endpoints/depreciated/folders/update",
+ "api-reference/endpoints/depreciated/folders/delete"
+ ]
+ },
+ {
+ "group": "Secret Tags",
+ "pages": [
+ "api-reference/endpoints/depreciated/secret-tags/list",
+ "api-reference/endpoints/depreciated/secret-tags/get-by-id",
+ "api-reference/endpoints/depreciated/secret-tags/get-by-slug",
+ "api-reference/endpoints/depreciated/secret-tags/create",
+ "api-reference/endpoints/depreciated/secret-tags/update",
+ "api-reference/endpoints/depreciated/secret-tags/delete"
+ ]
+ },
+ {
+ "group": "Secrets",
+ "pages": [
+ "api-reference/endpoints/depreciated/secrets/list",
+ "api-reference/endpoints/depreciated/secrets/create",
+ "api-reference/endpoints/depreciated/secrets/read",
+ "api-reference/endpoints/depreciated/secrets/update",
+ "api-reference/endpoints/depreciated/secrets/delete",
+ "api-reference/endpoints/depreciated/secrets/create-many",
+ "api-reference/endpoints/depreciated/secrets/update-many",
+ "api-reference/endpoints/depreciated/secrets/delete-many",
+ "api-reference/endpoints/depreciated/secrets/attach-tags",
+ "api-reference/endpoints/depreciated/secrets/detach-tags"
+ ]
+ },
+ {
+ "group": "Secret Imports",
+ "pages": [
+ "api-reference/endpoints/depreciated/secret-imports/list",
+ "api-reference/endpoints/depreciated/secret-imports/create",
+ "api-reference/endpoints/depreciated/secret-imports/update",
+ "api-reference/endpoints/depreciated/secret-imports/delete"
+ ]
+ }
+ ]
}
]
},
@@ -2506,7 +2618,7 @@
"href": "https://infisical.com"
},
"api": {
- "openapi": "https://app.infisical.com/api/docs/json",
+ "openapi": "http://localhost:8080/api/docs/json",
"mdx": {
"server": ["https://app.infisical.com"]
}
diff --git a/docs/internals/permissions/organization-permissions.mdx b/docs/internals/permissions/organization-permissions.mdx
index 5f5fc962f..13dda8196 100644
--- a/docs/internals/permissions/organization-permissions.mdx
+++ b/docs/internals/permissions/organization-permissions.mdx
@@ -18,13 +18,13 @@ Some organization-level resources—specifically `app-connections`—support con
Below is a comprehensive list of all available organization-level subjects and their supported actions, organized by functional area.
-### Workspace Management
+### Project Management
#### Subject: `workspace`
-| Action | Description |
-| -------- | --------------------- |
-| `create` | Create new workspaces |
+| Action | Description |
+| -------- | ------------------ |
+| `create` | Create new project |
### Role Management