docs: Change :id to {id} in OAS comments (#2015)

docs/api/admin/paths/price-lists_{id}_products.yaml

@@ -4,6 +4,12 @@ get:
   description: Retrieves a list of Product that are part of a Price List
   x-authenticated: true
   parameters:
+    - in: path
+      name: id
+      required: true
+      description: ID of the price list.
+      schema:
+        type: string
     - in: query
       name: q
       description: >-

docs/api/admin/paths/tax-rates_:id.yaml

@@ -1,102 +0,0 @@
-get:
-  operationId: GetTaxRatesTaxRate
-  summary: Get Tax Rate
-  description: Retrieves a TaxRate
-  parameters:
-    - in: query
-      name: fields
-      description: Which fields should be included in the result.
-      style: form
-      explode: false
-      schema:
-        type: array
-        items:
-          type: string
-    - in: query
-      name: expand
-      description: Which fields should be expanded and retrieved in the result.
-      style: form
-      explode: false
-      schema:
-        type: array
-        items:
-          type: string
-  x-authenticated: true
-  tags:
-    - Tax Rate
-  responses:
-    '200':
-      description: OK
-      content:
-        application/json:
-          schema:
-            properties:
-              tax_rate:
-                $ref: ../components/schemas/tax_rate.yaml
-post:
-  operationId: PostTaxRatesTaxRate
-  summary: Update a Tax Rate
-  description: Updates a Tax Rate
-  parameters:
-    - in: query
-      name: fields
-      description: Which fields should be included in the result.
-      style: form
-      explode: false
-      schema:
-        type: array
-        items:
-          type: string
-    - in: query
-      name: expand
-      description: Which fields should be expanded and retrieved in the result.
-      style: form
-      explode: false
-      schema:
-        type: array
-        items:
-          type: string
-  x-authenticated: true
-  requestBody:
-    content:
-      application/json:
-        schema:
-          properties:
-            code:
-              type: string
-              description: A code to identify the tax type by
-            name:
-              type: string
-              description: A human friendly name for the tax
-            region_id:
-              type: string
-              description: The ID of the Region that the rate belongs to
-            rate:
-              type: number
-              description: The numeric rate to charge
-            products:
-              type: array
-              description: The IDs of the products associated with this tax rate
-              items:
-                type: string
-            shipping_options:
-              type: array
-              description: The IDs of the shipping options associated with this tax rate
-              items:
-                type: string
-            product_types:
-              type: array
-              description: The IDs of the types of products associated with this tax rate
-              items:
-                type: string
-  tags:
-    - Tax Rate
-  responses:
-    '200':
-      description: OK
-      content:
-        application/json:
-          schema:
-            properties:
-              tax_rate:
-                $ref: ../components/schemas/tax_rate.yaml

docs/api/admin/paths/tax-rates_{id}.yaml

@@ -30,3 +30,117 @@ delete:
                 type: boolean
                 description: Whether or not the items were deleted.
                 default: true
+get:
+  operationId: GetTaxRatesTaxRate
+  summary: Get Tax Rate
+  description: Retrieves a TaxRate
+  parameters:
+    - in: path
+      name: id
+      required: true
+      description: ID of the tax rate.
+      schema:
+        type: string
+    - in: query
+      name: fields
+      description: Which fields should be included in the result.
+      style: form
+      explode: false
+      schema:
+        type: array
+        items:
+          type: string
+    - in: query
+      name: expand
+      description: Which fields should be expanded and retrieved in the result.
+      style: form
+      explode: false
+      schema:
+        type: array
+        items:
+          type: string
+  x-authenticated: true
+  tags:
+    - Tax Rate
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            properties:
+              tax_rate:
+                $ref: ../components/schemas/tax_rate.yaml
+post:
+  operationId: PostTaxRatesTaxRate
+  summary: Update a Tax Rate
+  description: Updates a Tax Rate
+  parameters:
+    - in: path
+      name: id
+      required: true
+      description: ID of the tax rate.
+      schema:
+        type: string
+    - in: query
+      name: fields
+      description: Which fields should be included in the result.
+      style: form
+      explode: false
+      schema:
+        type: array
+        items:
+          type: string
+    - in: query
+      name: expand
+      description: Which fields should be expanded and retrieved in the result.
+      style: form
+      explode: false
+      schema:
+        type: array
+        items:
+          type: string
+  x-authenticated: true
+  requestBody:
+    content:
+      application/json:
+        schema:
+          properties:
+            code:
+              type: string
+              description: A code to identify the tax type by
+            name:
+              type: string
+              description: A human friendly name for the tax
+            region_id:
+              type: string
+              description: The ID of the Region that the rate belongs to
+            rate:
+              type: number
+              description: The numeric rate to charge
+            products:
+              type: array
+              description: The IDs of the products associated with this tax rate
+              items:
+                type: string
+            shipping_options:
+              type: array
+              description: The IDs of the shipping options associated with this tax rate
+              items:
+                type: string
+            product_types:
+              type: array
+              description: The IDs of the types of products associated with this tax rate
+              items:
+                type: string
+  tags:
+    - Tax Rate
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            properties:
+              tax_rate:
+                $ref: ../components/schemas/tax_rate.yaml

docs/api/admin/paths/tax-rates_{id}_product-types_batch.yaml

@@ -3,6 +3,12 @@ post:
   summary: Add Tax Rate to Product Types
   description: Associates a Tax Rate with a list of Product Types
   parameters:
+    - in: path
+      name: id
+      required: true
+      description: ID of the tax rate.
+      schema:
+        type: string
     - in: query
       name: fields
       description: Which fields should be included in the result.
@@ -50,6 +56,12 @@ delete:
   summary: Remove Tax Rate from Product Types
   description: Removes a Tax Rate from a list of Product Types
   parameters:
+    - in: path
+      name: id
+      required: true
+      description: ID of the tax rate.
+      schema:
+        type: string
     - in: query
       name: fields
       description: Which fields should be included in the result.

docs/api/admin/paths/tax-rates_{id}_products_batch.yaml

@@ -3,6 +3,12 @@ post:
   summary: Add Tax Rate to Products
   description: Associates a Tax Rate with a list of Products
   parameters:
+    - in: path
+      name: id
+      required: true
+      description: ID of the tax rate.
+      schema:
+        type: string
     - in: query
       name: fields
       description: Which fields should be included in the result.
@@ -50,6 +56,12 @@ delete:
   summary: Removes Tax Rate from Products
   description: Removes a Tax Rate from a list of Products
   parameters:
+    - in: path
+      name: id
+      required: true
+      description: ID of the tax rate.
+      schema:
+        type: string
     - in: query
       name: fields
       description: Which fields should be included in the result.

docs/api/admin/paths/tax-rates_{id}_shipping-options_batch.yaml

@@ -3,6 +3,12 @@ post:
   summary: Add Tax Rate to Product Types
   description: Associates a Tax Rate with a list of Shipping Options
   parameters:
+    - in: path
+      name: id
+      required: true
+      description: ID of the tax rate.
+      schema:
+        type: string
     - in: query
       name: fields
       description: Which fields should be included in the result.
@@ -50,6 +56,12 @@ delete:
   summary: Removes a Tax Rate from Product Types
   description: Removes a Tax Rate from a list of Product Types
   parameters:
+    - in: path
+      name: id
+      required: true
+      description: ID of the tax rate.
+      schema:
+        type: string
     - in: query
       name: fields
       description: Which fields should be included in the result.