diff --git a/docs/contributor/adr/0007-apirule-v1beta2-api-proposal.md b/docs/contributor/adr/0007-apirule-v2alpha1-api-proposal.md similarity index 100% rename from docs/contributor/adr/0007-apirule-v1beta2-api-proposal.md rename to docs/contributor/adr/0007-apirule-v2alpha1-api-proposal.md diff --git a/docs/user/custom-resources/apirule/v1beta2/04-10-apirule-custom-resource.md b/docs/user/custom-resources/apirule/v2alpha1/04-10-apirule-custom-resource.md similarity index 100% rename from docs/user/custom-resources/apirule/v1beta2/04-10-apirule-custom-resource.md rename to docs/user/custom-resources/apirule/v2alpha1/04-10-apirule-custom-resource.md diff --git a/docs/user/custom-resources/apirule/v1beta2/04-15-api-rule-access-strategies.md b/docs/user/custom-resources/apirule/v2alpha1/04-15-api-rule-access-strategies.md similarity index 100% rename from docs/user/custom-resources/apirule/v1beta2/04-15-api-rule-access-strategies.md rename to docs/user/custom-resources/apirule/v2alpha1/04-15-api-rule-access-strategies.md diff --git a/docs/user/troubleshooting-guides/03-00-cannot-connect-to-service/v1beta2/03-00-basic-diagnostics.md b/docs/user/troubleshooting-guides/03-00-cannot-connect-to-service/v2alpha1/03-00-basic-diagnostics.md similarity index 100% rename from docs/user/troubleshooting-guides/03-00-cannot-connect-to-service/v1beta2/03-00-basic-diagnostics.md rename to docs/user/troubleshooting-guides/03-00-cannot-connect-to-service/v2alpha1/03-00-basic-diagnostics.md diff --git a/docs/user/troubleshooting-guides/03-00-cannot-connect-to-service/v1beta2/03-01-401-unauthorized-403-forbidden.md b/docs/user/troubleshooting-guides/03-00-cannot-connect-to-service/v2alpha1/03-01-401-unauthorized-403-forbidden.md similarity index 100% rename from docs/user/troubleshooting-guides/03-00-cannot-connect-to-service/v1beta2/03-01-401-unauthorized-403-forbidden.md rename to docs/user/troubleshooting-guides/03-00-cannot-connect-to-service/v2alpha1/03-01-401-unauthorized-403-forbidden.md diff --git a/docs/user/troubleshooting-guides/03-00-cannot-connect-to-service/v1beta2/03-40-api-rule-troubleshooting.md b/docs/user/troubleshooting-guides/03-00-cannot-connect-to-service/v2alpha1/03-40-api-rule-troubleshooting.md similarity index 100% rename from docs/user/troubleshooting-guides/03-00-cannot-connect-to-service/v1beta2/03-40-api-rule-troubleshooting.md rename to docs/user/troubleshooting-guides/03-00-cannot-connect-to-service/v2alpha1/03-40-api-rule-troubleshooting.md diff --git a/docs/user/tutorials/01-40-expose-workload/v1beta2/01-40-expose-workload-apigateway.md b/docs/user/tutorials/01-40-expose-workload/v2alpha1/01-40-expose-workload-apigateway.md similarity index 100% rename from docs/user/tutorials/01-40-expose-workload/v1beta2/01-40-expose-workload-apigateway.md rename to docs/user/tutorials/01-40-expose-workload/v2alpha1/01-40-expose-workload-apigateway.md diff --git a/docs/user/tutorials/01-40-expose-workload/v1beta2/01-41-expose-multiple-workloads.md b/docs/user/tutorials/01-40-expose-workload/v2alpha1/01-41-expose-multiple-workloads.md similarity index 100% rename from docs/user/tutorials/01-40-expose-workload/v1beta2/01-41-expose-multiple-workloads.md rename to docs/user/tutorials/01-40-expose-workload/v2alpha1/01-41-expose-multiple-workloads.md diff --git a/docs/user/tutorials/01-40-expose-workload/v1beta2/01-42-expose-workloads-multiple-namespaces.md b/docs/user/tutorials/01-40-expose-workload/v2alpha1/01-42-expose-workloads-multiple-namespaces.md similarity index 100% rename from docs/user/tutorials/01-40-expose-workload/v1beta2/01-42-expose-workloads-multiple-namespaces.md rename to docs/user/tutorials/01-40-expose-workload/v2alpha1/01-42-expose-workloads-multiple-namespaces.md diff --git a/docs/user/tutorials/01-50-expose-and-secure-a-workload/v1beta2/01-52-expose-and-secure-workload-jwt.md b/docs/user/tutorials/01-50-expose-and-secure-a-workload/v2alpha1/01-52-expose-and-secure-workload-jwt.md similarity index 100% rename from docs/user/tutorials/01-50-expose-and-secure-a-workload/v1beta2/01-52-expose-and-secure-workload-jwt.md rename to docs/user/tutorials/01-50-expose-and-secure-a-workload/v2alpha1/01-52-expose-and-secure-workload-jwt.md diff --git a/tests/integration/testsuites/istio-jwt/features/v1beta2.feature b/tests/integration/testsuites/istio-jwt/features/v2alpha1.feature similarity index 100% rename from tests/integration/testsuites/istio-jwt/features/v1beta2.feature rename to tests/integration/testsuites/istio-jwt/features/v2alpha1.feature diff --git a/tests/integration/testsuites/istio-jwt/scenario_v1beta2.go b/tests/integration/testsuites/istio-jwt/scenario_v2alpha1.go similarity index 100% rename from tests/integration/testsuites/istio-jwt/scenario_v1beta2.go rename to tests/integration/testsuites/istio-jwt/scenario_v2alpha1.go