diff --git a/.github/workflows/generate-docblocks.yml b/.github/workflows/generate-docblocks.yml
index b818857dd4580..fb4b74113db45 100644
--- a/.github/workflows/generate-docblocks.yml
+++ b/.github/workflows/generate-docblocks.yml
@@ -98,8 +98,8 @@ jobs:
 
       - name: Run docblock generator
         if: steps.check-commit.outputs.is_release_commit == 'true'
-        run: "yarn start run ../../../../packages/medusa/src/api --type oas && yarn start clean:oas"
-        working-directory: www/utils/packages/docblock-generator
+        run: "yarn generate:oas"
+        working-directory: www/utils
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           GIT_OWNER: ${{ github.repository_owner }}
diff --git a/.github/workflows/generate-resources-reference.yml b/.github/workflows/generate-resources-reference.yml
index 2d60fd93fda27..0dfddda812c78 100644
--- a/.github/workflows/generate-resources-reference.yml
+++ b/.github/workflows/generate-resources-reference.yml
@@ -65,8 +65,8 @@ jobs:
 
       - name: Generate References
         if: ${{ github.event_name != 'workflow_dispatch' }}
-        run: "yarn start generate all --merge"
-        working-directory: www/utils/packages/typedoc-generate-references
+        run: "yarn generate:references"
+        working-directory: www/utils
 
       - name: Generate Sidebar and File Map
         run: "yarn prep"
diff --git a/packages/cli/oas/medusa-oas-cli/redocly/redocly-config.yaml b/packages/cli/oas/medusa-oas-cli/redocly/redocly-config.yaml
index e113df2979423..cd082fccf77dd 100644
--- a/packages/cli/oas/medusa-oas-cli/redocly/redocly-config.yaml
+++ b/packages/cli/oas/medusa-oas-cli/redocly/redocly-config.yaml
@@ -19,6 +19,13 @@ decorators:
         - ProductCategoryResponse
       AdminShippingOption:
         - AdminShippingOption
+      AdminProductCategory:
+        - AdminProductCategory
+        - AdminProduct
+      BaseProduct:
+        - BaseProduct
+      StoreProduct:
+        - StoreProductCategory
 
 # Similar config to /www/docs/docusaurus.config.js > redocusaurus
 # Allows to emulate rendering of API public documentation when using `yarn redocly preview-docs openapi.yaml`
diff --git a/www/utils/package.json b/www/utils/package.json
index 428bbfbfa860e..3793839c86305 100644
--- a/www/utils/package.json
+++ b/www/utils/package.json
@@ -7,7 +7,9 @@
   "scripts": {
     "build": "turbo run build",
     "watch": "turbo run watch",
-    "lint": "turbo run lint"
+    "lint": "turbo run lint",
+    "generate:references": "turbo run generate:references",
+    "generate:oas": "turbo run generate:oas"
   },
   "dependencies": {
     "@babel/core": "^7.23.0",
diff --git a/www/utils/packages/docblock-generator/package.json b/www/utils/packages/docblock-generator/package.json
index 05bbf467777da..960e259254b2e 100644
--- a/www/utils/packages/docblock-generator/package.json
+++ b/www/utils/packages/docblock-generator/package.json
@@ -6,7 +6,8 @@
     "start": "node dist/index.js",
     "build": "tsc",
     "watch": "tsc --watch",
-    "prepublishOnly": "cross-env NODE_ENV=production tsc --build"
+    "prepublishOnly": "cross-env NODE_ENV=production tsc --build",
+    "generate:oas": "yarn start run ../../../../packages/medusa/src/api --type oas && yarn start clean:oas"
   },
   "publishConfig": {
     "access": "public"
diff --git a/www/utils/packages/typedoc-generate-references/package.json b/www/utils/packages/typedoc-generate-references/package.json
index 15ff3cbdb3876..bc4dd94341acf 100644
--- a/www/utils/packages/typedoc-generate-references/package.json
+++ b/www/utils/packages/typedoc-generate-references/package.json
@@ -6,7 +6,8 @@
     "start": "node dist/index.js",
     "build": "tsc",
     "watch": "tsc --watch",
-    "prepublishOnly": "cross-env NODE_ENV=production tsc --build"
+    "prepublishOnly": "cross-env NODE_ENV=production tsc --build",
+    "generate:references": "yarn start generate all --merge"
   },
   "publishConfig": {
     "access": "public"
diff --git a/www/utils/turbo.json b/www/utils/turbo.json
index a1437038fa43c..e5ca6e407866a 100644
--- a/www/utils/turbo.json
+++ b/www/utils/turbo.json
@@ -10,6 +10,16 @@
       ]
     },
     "lint": { },
-    "watch": { }
+    "watch": { },
+    "generate:references": {
+      "dependsOn": [
+        "^build"
+      ]
+    },
+    "generate:oas": {
+      "dependsOn": [
+        "^build"
+      ]
+    }
   }
 }
\ No newline at end of file