Merge pull request #1366 from Shopify/liz/add-release-candidate-api-version

 Add ability to use release candidate API version

Author: lizkenyon

Diff for: CHANGELOG.md

@@ -7,7 +7,7 @@ Note: For changes to the API, see https://shopify.dev/changelog?filter=api
 - [#1372](https://github.com/Shopify/shopify-api-ruby/pull/1372) Add support for 2025-04 API version
 - [#1369](https://github.com/Shopify/shopify-api-ruby/pull/1369) Make `sub` and `sid` jwt claims optional (Checkout ui extension support)
 - [#1370](https://github.com/Shopify/shopify-api-ruby/pull/1370) Add support for Shopify internal hosts
-
+- [#1366](https://github.com/Shopify/shopify-api-ruby/pull/1366) Add support for release candidate API versions
 
 ## 14.8.0
 

Diff for: lib/shopify_api/admin_versions.rb

@@ -5,6 +5,8 @@ module ShopifyAPI
   module AdminVersions
     SUPPORTED_ADMIN_VERSIONS = T.let([
       "unstable",
+      "2025-07",
+      "2025-04",
       "2025-04",
       "2025-01",
       "2024-10",
@@ -22,8 +24,10 @@ module AdminVersions
     ], T::Array[String])
 
     LATEST_SUPPORTED_ADMIN_VERSION = T.let("2025-04", String)
+    RELEASE_CANDIDATE_ADMIN_VERSION = T.let("2025-07", String)
   end
 
   SUPPORTED_ADMIN_VERSIONS = ShopifyAPI::AdminVersions::SUPPORTED_ADMIN_VERSIONS
   LATEST_SUPPORTED_ADMIN_VERSION = ShopifyAPI::AdminVersions::LATEST_SUPPORTED_ADMIN_VERSION
+  RELEASE_CANDIDATE_ADMIN_VERSION = ShopifyAPI::AdminVersions::RELEASE_CANDIDATE_ADMIN_VERSION
 end

Diff for: lib/shopify_api/context.rb

@@ -101,10 +101,11 @@ def load_rest_resources(api_version:)
         @rest_resource_loader&.setup
         @rest_resource_loader&.unload
 
-        # No resources for the unstable version
-        return if api_version == "unstable"
+        # No resources for the unstable version or the release candidate version
+        return if api_version == "unstable" || api_version == RELEASE_CANDIDATE_ADMIN_VERSION
 
         version_folder_name = api_version.gsub("-", "_")
+
         path = "#{__dir__}/rest/resources/#{version_folder_name}"
 
         unless Dir.exist?(path)

Diff for: test/admin_versions_test.rb

@@ -12,5 +12,9 @@ def test_supported_admin_versions
     def test_supported_latest_supported_admin_version
       assert_instance_of(String, ShopifyAPI::AdminVersions::LATEST_SUPPORTED_ADMIN_VERSION)
     end
+
+    def test_supported_release_candidate_admin_version
+      assert_instance_of(String, ShopifyAPI::AdminVersions::RELEASE_CANDIDATE_ADMIN_VERSION)
+    end
   end
 end