chore(docs): Generated API Reference (#3021)

Co-authored-by: shahednasser <shahednasser@users.noreply.github.com>

docs/api/admin/code_samples/JavaScript/product-categories/getundefined

@@ -1,7 +0,0 @@
-import Medusa from "@medusajs/medusa-js"
-const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
-// must be previously logged in or use api token
-medusa.admin.productCategories.list()
-.then(({ product_category, limit, offset, count }) => {
-  console.log(product_category.length);
-});

docs/api/admin/code_samples/JavaScript/product-categories/postundefined

@@ -1,9 +0,0 @@
-import Medusa from "@medusajs/medusa-js"
-const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
-// must be previously logged in or use api token
-medusa.admin.productCategories.create({
-  name: 'Jeans',
-})
-.then(({ productCategory }) => {
-  console.log(productCategory.id);
-});

docs/api/admin/code_samples/JavaScript/product-categories_{id}/deleteundefined

@@ -1,7 +0,0 @@
-import Medusa from "@medusajs/medusa-js"
-const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
-// must be previously logged in or use api token
-medusa.admin.productCategories.delete(product_category_id)
-.then(({ id, object, deleted }) => {
-  console.log(id);
-});

docs/api/admin/code_samples/JavaScript/product-categories_{id}/getundefined

@@ -1,7 +0,0 @@
-import Medusa from "@medusajs/medusa-js"
-const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
-// must be previously logged in or use api token
-medusa.admin.productCategories.retrieve("pcat-id")
-.then(({ productCategory }) => {
-  console.log(productCategory.id);
-});

docs/api/admin/components/schemas/ProductCategory.yaml

@@ -37,6 +37,10 @@ properties:
     items:
       type: object
       description: A product category object.
+  parent_category_id:
+    description: The ID of the parent category.
+    type: string
+    default: null
   parent_category:
     description: >-
       A product category object. Available if the relation `parent_category` is

docs/api/admin/paths/product-categories.yaml

@@ -24,10 +24,6 @@ post:
         schema:
           $ref: ../components/schemas/AdminPostProductCategoriesReq.yaml
   x-codeSamples:
-    - lang: JavaScript
-      label: JS Client
-      source:
-        $ref: ../code_samples/JavaScript/product-categories/postundefined
     - lang: Shell
       label: cURL
       source:
@@ -45,7 +41,7 @@ post:
           schema:
             type: object
             properties:
-              productCategory:
+              product_category:
                 $ref: ../components/schemas/ProductCategory.yaml
     '400':
       $ref: ../components/responses/400_error.yaml
@@ -98,10 +94,6 @@ get:
         type: integer
         default: 100
   x-codeSamples:
-    - lang: JavaScript
-      label: JS Client
-      source:
-        $ref: ../code_samples/JavaScript/product-categories/getundefined
     - lang: Shell
       label: cURL
       source:
@@ -110,7 +102,7 @@ get:
     - api_token: []
     - cookie_auth: []
   tags:
-    - Product Categories
+    - Product Category
   responses:
     '200':
       description: OK
@@ -119,7 +111,7 @@ get:
           schema:
             type: object
             properties:
-              product_category:
+              product_categories:
                 type: array
                 items:
                   $ref: ../components/schemas/ProductCategory.yaml

docs/api/admin/paths/product-categories_{id}.yaml

@@ -11,10 +11,6 @@ delete:
       schema:
         type: string
   x-codeSamples:
-    - lang: JavaScript
-      label: JS Client
-      source:
-        $ref: ../code_samples/JavaScript/product-categories_{id}/deleteundefined
     - lang: Shell
       label: cURL
       source:
@@ -68,10 +64,6 @@ get:
       schema:
         type: string
   x-codeSamples:
-    - lang: JavaScript
-      label: JS Client
-      source:
-        $ref: ../code_samples/JavaScript/product-categories_{id}/getundefined
     - lang: Shell
       label: cURL
       source:
@@ -80,7 +72,7 @@ get:
     - api_token: []
     - cookie_auth: []
   tags:
-    - Category
+    - Product Category
   responses:
     '200':
       description: OK
@@ -89,7 +81,7 @@ get:
           schema:
             type: object
             properties:
-              productCategory:
+              product_category:
                 $ref: ../components/schemas/ProductCategory.yaml
     '400':
       $ref: ../components/responses/400_error.yaml