brinkcommerce-dev-mcp 0.1.0-beta.1

package/openapi-specs/.cache/ProductManagement.yaml

@@ -0,0 +1,1460 @@
+openapi: 3.0.1
+info:
+  title: ProductManagement
+  version: '1'
+servers:
+  - url: https://management.eu-west-1.CUSTOMER_NAME.brinkcommerce.io/product
+security:
+  - OAuth2:
+      - product-management/addon:read
+      - product-management/product:write
+      - product-management/addon:write
+      - product-management/product:read
+tags:
+  - name: product variants
+    description: Endpoints for working with product variants
+  - name: product parents
+    description: Endpoints for working with product parents
+  - name: addons
+    description: Endpoints for working with addons
+paths:
+  /addons/{addonId}:
+    get:
+      operationId: GetAddon
+      tags:
+        - addons
+      summary: Get an addon
+      parameters:
+        - $ref: '#/components/parameters/addonId'
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Addon'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/addon:read
+          api_key: []
+      x-hideTryItPanel: true
+    put:
+      operationId: PutAddon
+      tags:
+        - addons
+      summary: Create or update an addon
+      parameters:
+        - $ref: '#/components/parameters/addonId'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PutAddonRequest'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Addon'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '415':
+          description: 415 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/addon:write
+          api_key: []
+      x-hideTryItPanel: true
+    delete:
+      operationId: DeleteAddon
+      tags:
+        - addons
+      summary: Delete an addon
+      parameters:
+        - $ref: '#/components/parameters/addonId'
+      responses:
+        '204':
+          description: 204 response
+          content: {}
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/addon:write
+          api_key: []
+      x-hideTryItPanel: true
+    patch:
+      operationId: PatchAddon
+      tags:
+        - addons
+      summary: Patch an addon
+      parameters:
+        - $ref: '#/components/parameters/addonId'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PatchAddonRequest'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Addon'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '415':
+          description: 415 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/addon:write
+          api_key: []
+      x-hideTryItPanel: true
+  /product-parents/{productParentId}/addons/{addonId}:
+    delete:
+      operationId: DeleteProductParentAddon
+      tags:
+        - addons
+      summary: Delete an addon on a product parent
+      parameters:
+        - $ref: '#/components/parameters/productParentId'
+        - $ref: '#/components/parameters/addonId'
+      responses:
+        '204':
+          description: 204 response
+          content: {}
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/product:write
+          api_key: []
+      x-hideTryItPanel: true
+  /product-parents/{productParentId}/variants:
+    get:
+      operationId: GetProductVariants
+      tags:
+        - product variants
+      summary: Get product variants on a product parent
+      parameters:
+        - $ref: '#/components/parameters/productParentId'
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ProductVariants'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/product:read
+          api_key: []
+      x-hideTryItPanel: true
+  /product-parents/{productParentId}/addons:
+    get:
+      operationId: GetProductParentAddons
+      tags:
+        - addons
+      summary: Get addons on a product parent
+      parameters:
+        - $ref: '#/components/parameters/productParentId'
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ProductParentAddons'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/product:read
+          api_key: []
+      x-hideTryItPanel: true
+    post:
+      operationId: PostProductParentAddon
+      tags:
+        - addons
+      summary: Create a product parent addon
+      parameters:
+        - $ref: '#/components/parameters/productParentId'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PostProductParentAddonRequest'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ProductParentAddon'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '415':
+          description: 415 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/product:write
+          api_key: []
+      x-hideTryItPanel: true
+  /product-variants/{productVariantId}:
+    get:
+      operationId: GetProductVariant
+      tags:
+        - product variants
+      summary: Get a product variant
+      parameters:
+        - $ref: '#/components/parameters/productVariantId'
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ProductVariant'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/product:read
+          api_key: []
+      x-hideTryItPanel: true
+    put:
+      operationId: PutProductVariant
+      tags:
+        - product variants
+      summary: Create or update a product variant
+      parameters:
+        - $ref: '#/components/parameters/productVariantId'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PutProductVariantRequest'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ProductVariant'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '415':
+          description: 415 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/product:write
+          api_key: []
+      x-hideTryItPanel: true
+    delete:
+      operationId: DeleteProductVariant
+      tags:
+        - product variants
+      summary: Delete a product variant
+      parameters:
+        - $ref: '#/components/parameters/productVariantId'
+      responses:
+        '204':
+          description: 204 response
+          content: {}
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/product:write
+          api_key: []
+      x-hideTryItPanel: true
+    patch:
+      operationId: PatchProductVariant
+      tags:
+        - product variants
+      summary: Patch a product variant
+      parameters:
+        - $ref: '#/components/parameters/productVariantId'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PatchProductVariantRequest'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ProductVariant'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '415':
+          description: 415 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/product:write
+          api_key: []
+      x-hideTryItPanel: true
+  /product-parents/{productParentId}/archive:
+    post:
+      operationId: PostProductParentArchive
+      tags:
+        - product parents
+      summary: Archive a product parent
+      parameters:
+        - $ref: '#/components/parameters/productParentId'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PostProductParentArchiveRequest'
+        required: true
+      responses:
+        '204':
+          description: 204 response
+          content: {}
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '415':
+          description: 415 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/product:write
+          api_key: []
+      x-hideTryItPanel: true
+  /product-parents/{productParentId}:
+    get:
+      operationId: GetProductParent
+      tags:
+        - product parents
+      summary: Get a product parent
+      parameters:
+        - $ref: '#/components/parameters/productParentId'
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ProductParent'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/product:read
+          api_key: []
+      x-hideTryItPanel: true
+    put:
+      operationId: PutProductParent
+      tags:
+        - product parents
+      summary: Create or update a product parent
+      parameters:
+        - $ref: '#/components/parameters/productParentId'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PutProductParentRequest'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ProductParent'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '415':
+          description: 415 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/product:write
+          api_key: []
+      x-hideTryItPanel: true
+    delete:
+      operationId: DeleteProductParent
+      tags:
+        - product parents
+      summary: Delete a product parent
+      parameters:
+        - $ref: '#/components/parameters/productParentId'
+      responses:
+        '204':
+          description: 204 response
+          content: {}
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/product:write
+          api_key: []
+      x-hideTryItPanel: true
+    patch:
+      operationId: PatchProductParent
+      tags:
+        - product parents
+      summary: Patch a product parent
+      parameters:
+        - $ref: '#/components/parameters/productParentId'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PatchProductParentRequest'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ProductParent'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '401':
+          description: 401 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '415':
+          description: 415 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      security:
+        - OAuth2:
+            - product-management/product:write
+          api_key: []
+      x-hideTryItPanel: true
+components:
+  schemas:
+    Translations:
+      title: Translations
+      type: object
+      description: Object of translations. Keys should be language codes, and must follow the pattern `^[A-Za-z0-9_-]{1,100}$`. Values are strings that can contain a maximum of 500 characters.
+      maxProperties: 50
+      additionalProperties:
+        type: string
+        maxLength: 500
+    Tags:
+      title: Tags
+      type: object
+      description: Object of tags which can be used by Brink to create e.g. discounts. Keys must follow the pattern `^[A-Za-z0-9_-]{1,20}$`. Values are arrays, that cannot be empty, contain a maximum of 10 items, and items are strings that must follow the pattern `^[^\n\t]+$`.
+      maxProperties: 20
+      additionalProperties:
+        type: array
+        minItems: 1
+        maxItems: 10
+        uniqueItems: true
+        items:
+          type: string
+          pattern: ^[^\n\t]+$
+          minLength: 1
+          maxLength: 40
+    CustomAttributes:
+      title: CustomAttributes
+      type: object
+      description: Object of custom attributes which will be available in the Shopper Cart. Keys must follow the pattern `^[A-Za-z0-9_-]{1,20}$`. Values are strings that can contain a maximum of 500 characters.
+      maxProperties: 50
+      additionalProperties:
+        type: string
+        maxLength: 500
+    Addon:
+      title: Addon
+      required:
+        - created
+        - customAttributes
+        - description
+        - displayDescriptions
+        - displayNames
+        - id
+        - imageUrl
+        - isActive
+        - isArchived
+        - name
+        - tags
+        - taxGroupId
+        - updated
+      type: object
+      properties:
+        isArchived:
+          type: boolean
+          description: If it is archived or not
+        created:
+          type: string
+          description: When it was created
+          format: date-time
+        displayNames:
+          $ref: '#/components/schemas/Translations'
+        description:
+          type: string
+          description: A description of the addon
+        displayDescriptions:
+          $ref: '#/components/schemas/Translations'
+        isActive:
+          type: boolean
+          description: If it is active or not
+        tags:
+          $ref: '#/components/schemas/Tags'
+        taxGroupId:
+          type: string
+          description: The id of the tax group that sets the tax for this addon
+        imageUrl:
+          maxLength: 1024
+          type: string
+          description: An absolute URI to a image
+          format: uri
+        name:
+          type: string
+          description: A descriptive name of the addon
+        id:
+          type: string
+          description: The unique id of the addon
+        updated:
+          type: string
+          description: When it was last updated
+          format: date-time
+        customAttributes:
+          $ref: '#/components/schemas/CustomAttributes'
+    ErrorResponse:
+      title: Error
+      type: object
+      properties:
+        requestId:
+          type: string
+          description: The request id
+        error:
+          type: string
+          description: The error message
+    PutAddonRequest:
+      title: PutAddonRequest
+      required:
+        - customAttributes
+        - description
+        - displayDescriptions
+        - displayNames
+        - imageUrl
+        - isActive
+        - name
+        - tags
+        - taxGroupId
+      type: object
+      properties:
+        taxGroupId:
+          type: string
+          description: The id of the tax group that sets the tax for this addon.
+          minLength: 1
+        imageUrl:
+          maxLength: 1024
+          type: string
+          description: An absolute URI to a image
+          format: uri
+        name:
+          type: string
+          description: A descriptive name of the addon
+          minLength: 1
+        displayNames:
+          $ref: '#/components/schemas/Translations'
+        description:
+          type: string
+          description: A description of the addon
+        displayDescriptions:
+          $ref: '#/components/schemas/Translations'
+        isActive:
+          type: boolean
+          description: If the addon is active or not
+        customAttributes:
+          $ref: '#/components/schemas/CustomAttributes'
+        tags:
+          $ref: '#/components/schemas/Tags'
+    PatchAddonRequest:
+      title: PatchAddonRequest
+      type: object
+      properties:
+        isArchived:
+          type: boolean
+          description: If the addon is archived or not
+        taxGroupId:
+          type: string
+          description: The id of the tax group that sets the tax for this addon.
+          minLength: 1
+        imageUrl:
+          maxLength: 1024
+          type: string
+          description: An absolute URI to a image
+          format: uri
+        name:
+          type: string
+          description: A descriptive name of the addon
+          minLength: 1
+        displayNames:
+          $ref: '#/components/schemas/Translations'
+        description:
+          type: string
+          description: A description of the addon
+        displayDescriptions:
+          $ref: '#/components/schemas/Translations'
+        isActive:
+          type: boolean
+          description: If the addon is active or not
+        customAttributes:
+          $ref: '#/components/schemas/CustomAttributes'
+        tags:
+          $ref: '#/components/schemas/Tags'
+    ShippingAttributes:
+      title: ShippingAttributes
+      type: array
+      description: Attributes that could be used to adjust delivery and shipping options
+      maxItems: 10
+      uniqueItems: true
+      nullable: true
+      items:
+        type: string
+        pattern: ^[A-Za-z0-9_-]+$
+        maxLength: 40
+    Dimensions:
+      title: Dimensions
+      type: object
+      nullable: true
+      description: Physical dimensions of the packaged product. These measurements are used for logistics.
+      required:
+        - height
+        - length
+        - width
+      properties:
+        width:
+          minimum: 0
+          type: integer
+          description: Width (in millimeters)
+          format: int32
+        length:
+          minimum: 0
+          type: integer
+          description: Length (in millimeters)
+          format: int32
+        height:
+          minimum: 0
+          type: integer
+          description: Height (in millimeters)
+          format: int32
+    ProductVariant:
+      title: ProductVariant
+      required:
+        - created
+        - customAttributes
+        - description
+        - displayDescriptions
+        - displayNames
+        - id
+        - imageUrl
+        - isActive
+        - isArchived
+        - name
+        - productParentId
+        - tags
+        - taxGroupId
+        - updated
+      type: object
+      properties:
+        isArchived:
+          type: boolean
+          description: If it is archived or not
+        created:
+          type: string
+          description: When it was created
+          format: date-time
+        displayNames:
+          $ref: '#/components/schemas/Translations'
+        description:
+          type: string
+          description: A description of the product variant
+        weight:
+          type: integer
+          description: Weight of the product (in grams)
+          format: int32
+        displayDescriptions:
+          $ref: '#/components/schemas/Translations'
+        isActive:
+          type: boolean
+          description: If it is active or not
+        tags:
+          $ref: '#/components/schemas/Tags'
+        taxGroupId:
+          type: string
+          description: The id of the tax group that will set the tax for this product variant
+        imageUrl:
+          maxLength: 1024
+          type: string
+          description: An absolute URI to a image
+          format: uri
+        name:
+          type: string
+          description: A descriptive name of the product variant
+        id:
+          type: string
+          description: The unique id of the product variant
+        updated:
+          type: string
+          description: When it was last updated
+          format: date-time
+        shippingAttributes:
+          $ref: '#/components/schemas/ShippingAttributes'
+        productParentId:
+          type: string
+          description: The id of the related product parent
+        dimensions:
+          $ref: '#/components/schemas/Dimensions'
+        customAttributes:
+          $ref: '#/components/schemas/CustomAttributes'
+    ProductVariants:
+      title: GetProductVariantsResponse
+      type: object
+      required:
+        - productVariants
+      properties:
+        productVariants:
+          type: array
+          items:
+            $ref: '#/components/schemas/ProductVariant'
+    ProductAddon:
+      title: ProductAddon
+      required:
+        - addonId
+        - created
+        - customAttributes
+        - description
+        - displayDescriptions
+        - displayNames
+        - imageUrl
+        - isActive
+        - isArchived
+        - name
+        - productParentId
+        - tags
+        - taxGroupId
+        - updated
+      type: object
+      properties:
+        isArchived:
+          type: boolean
+          description: If it is archived or not
+        created:
+          type: string
+          description: When it was created
+          format: date-time
+        displayNames:
+          $ref: '#/components/schemas/Translations'
+        description:
+          type: string
+          description: A description of the addon
+        displayDescriptions:
+          $ref: '#/components/schemas/Translations'
+        isActive:
+          type: boolean
+          description: If it is active or not
+        addonId:
+          type: string
+          description: The id of the addon
+        tags:
+          $ref: '#/components/schemas/Tags'
+        taxGroupId:
+          type: string
+          description: The id of the tax group that sets the tax for this addon
+        imageUrl:
+          maxLength: 1024
+          type: string
+          description: An absolute URI to a image
+          format: uri
+        name:
+          type: string
+          description: A descriptive name of the addon
+        updated:
+          type: string
+          description: When it was last updated
+          format: date-time
+        productParentId:
+          type: string
+          description: The id of the product parent
+        customAttributes:
+          $ref: '#/components/schemas/CustomAttributes'
+    ProductParentAddons:
+      title: GetProductParentAddonsResponse
+      type: object
+      required:
+        - productAddons
+      properties:
+        productAddons:
+          type: array
+          items:
+            $ref: '#/components/schemas/ProductAddon'
+    PostProductParentAddonRequest:
+      title: PostProductParentAddonRequest
+      required:
+        - addonId
+      type: object
+      properties:
+        addonId:
+          type: string
+          description: The id of the addon
+          minLength: 1
+    ProductParentAddon:
+      title: PostProductParentAddonResponse
+      required:
+        - addonId
+        - productParentId
+      type: object
+      properties:
+        addonId:
+          type: string
+          description: The id of the addon
+        productParentId:
+          type: string
+          description: The id of the product parent
+    PutProductVariantRequest:
+      title: PutProductVariantRequest
+      required:
+        - customAttributes
+        - description
+        - displayDescriptions
+        - displayNames
+        - imageUrl
+        - isActive
+        - name
+        - productParentId
+        - tags
+        - taxGroupId
+      type: object
+      properties:
+        displayNames:
+          $ref: '#/components/schemas/Translations'
+        description:
+          type: string
+          description: A description of the product variant
+        weight:
+          minimum: 0
+          type: integer
+          nullable: true
+          description: Weight of the product (in grams)
+          format: int32
+        displayDescriptions:
+          $ref: '#/components/schemas/Translations'
+        isActive:
+          type: boolean
+          description: If the product is active or not
+        tags:
+          $ref: '#/components/schemas/Tags'
+        taxGroupId:
+          type: string
+          description: The id of the tax group that will set the tax for this product variant.
+          minLength: 1
+        imageUrl:
+          maxLength: 1024
+          type: string
+          description: An absolute URI to an image
+          format: uri
+        name:
+          type: string
+          description: A descriptive name of the product variant
+          minLength: 1
+        shippingAttributes:
+          $ref: '#/components/schemas/ShippingAttributes'
+        productParentId:
+          type: string
+          description: The product parent id for this product variant.
+          minLength: 1
+        customAttributes:
+          $ref: '#/components/schemas/CustomAttributes'
+        dimensions:
+          $ref: '#/components/schemas/Dimensions'
+    PatchShippingAttributes:
+      title: ShippingAttributes
+      type: array
+      description: Attributes that could be used to adjust delivery and shipping options
+      maxItems: 10
+      uniqueItems: true
+      nullable: true
+      items:
+        type: string
+        pattern: ^[A-Za-z0-9_-]+$
+        maxLength: 40
+    PatchDimensions:
+      type: object
+      nullable: true
+      description: Physical dimensions of the packaged product. These measurements are used for logistics.
+      required:
+        - height
+        - length
+        - width
+      properties:
+        width:
+          minimum: 0
+          type: integer
+          description: Width (in millimeters)
+          format: int32
+        length:
+          minimum: 0
+          type: integer
+          description: Length (in millimeters)
+          format: int32
+        height:
+          minimum: 0
+          type: integer
+          description: Height (in millimeters)
+          format: int32
+    PatchProductVariantRequest:
+      title: PatchProductVariantRequest
+      type: object
+      properties:
+        isArchived:
+          type: boolean
+          description: If the product variant is archived or not
+        displayNames:
+          $ref: '#/components/schemas/Translations'
+        description:
+          type: string
+          description: A description of the product variant
+        weight:
+          minimum: 0
+          type: integer
+          description: Weight of the product (in grams)
+          format: int32
+          nullable: true
+        displayDescriptions:
+          $ref: '#/components/schemas/Translations'
+        isActive:
+          type: boolean
+          description: If the product variant is active or not
+        tags:
+          $ref: '#/components/schemas/Tags'
+        taxGroupId:
+          type: string
+          description: The id of the tax group that will set the tax for this product variant.
+          minLength: 1
+        imageUrl:
+          maxLength: 1024
+          type: string
+          description: An absolute URI to an image
+          format: uri
+        name:
+          type: string
+          description: A descriptive name of the product variant
+          minLength: 1
+        shippingAttributes:
+          $ref: '#/components/schemas/PatchShippingAttributes'
+        productParentId:
+          type: string
+          description: The id of the product parent that will be set for this product variant.
+          minLength: 1
+        customAttributes:
+          $ref: '#/components/schemas/CustomAttributes'
+        dimensions:
+          $ref: '#/components/schemas/PatchDimensions'
+    PostProductParentArchiveRequest:
+      title: PostProductParentArchiveRequest
+      type: object
+      properties:
+        includeProductVariants:
+          type: boolean
+          description: Include the related product variants in the archiving
+          default: true
+    ProductParentTags:
+      title: Tags
+      type: object
+      deprecated: true
+      description: Tags on Product Parent level are no longer used
+      x-omitempty: false
+    ProductParent:
+      title: ProductParent
+      required:
+        - created
+        - customAttributes
+        - description
+        - displayDescriptions
+        - displayNames
+        - id
+        - isActive
+        - isArchived
+        - name
+        - updated
+      type: object
+      properties:
+        isArchived:
+          type: boolean
+          description: If it is archived or not
+        created:
+          type: string
+          description: When it was created
+          format: date-time
+        imageUrl:
+          maxLength: 1024
+          type: string
+          description: An absolute URI to a image
+          format: uri
+          nullable: true
+        name:
+          type: string
+          description: A descriptive name of the product parent
+        displayNames:
+          $ref: '#/components/schemas/Translations'
+        description:
+          type: string
+          description: A description of the product parent
+        id:
+          type: string
+          description: The unique id of the product parent
+        displayDescriptions:
+          $ref: '#/components/schemas/Translations'
+        isActive:
+          type: boolean
+          description: If it is active or not
+        updated:
+          type: string
+          description: When it was last updated
+          format: date-time
+        customAttributes:
+          $ref: '#/components/schemas/CustomAttributes'
+        tags:
+          $ref: '#/components/schemas/ProductParentTags'
+    PutProductParentRequest:
+      title: PutProductParentRequest
+      required:
+        - customAttributes
+        - description
+        - displayDescriptions
+        - displayNames
+        - isActive
+        - name
+      type: object
+      properties:
+        imageUrl:
+          maxLength: 1024
+          type: string
+          nullable: true
+          description: An absolute URI to a image
+          format: uri
+        name:
+          type: string
+          description: A descriptive default name of the product parent
+          minLength: 1
+        displayNames:
+          $ref: '#/components/schemas/Translations'
+        description:
+          type: string
+          description: A description of the product parent
+        displayDescriptions:
+          $ref: '#/components/schemas/Translations'
+        isActive:
+          type: boolean
+          description: If the product parent is active or not
+        customAttributes:
+          $ref: '#/components/schemas/CustomAttributes'
+        tags:
+          $ref: '#/components/schemas/ProductParentTags'
+    PatchProductParentRequest:
+      title: PatchProductParentRequest
+      type: object
+      properties:
+        isArchived:
+          type: boolean
+          description: If the product parent is archived or not
+        imageUrl:
+          maxLength: 1024
+          type: string
+          nullable: true
+          description: An absolute URI to a image
+          format: uri
+        name:
+          type: string
+          description: A descriptive default name of the product parent
+          minLength: 1
+        displayNames:
+          $ref: '#/components/schemas/Translations'
+        description:
+          type: string
+          description: A description of the product parent
+        displayDescriptions:
+          $ref: '#/components/schemas/Translations'
+        isActive:
+          type: boolean
+          description: If the product parent is active or not
+        customAttributes:
+          $ref: '#/components/schemas/CustomAttributes'
+        tags:
+          $ref: '#/components/schemas/ProductParentTags'
+  securitySchemes:
+    api_key:
+      type: apiKey
+      name: x-api-key
+      in: header
+    OAuth2:
+      type: oauth2
+      flows:
+        clientCredentials:
+          tokenUrl: TOKEN_URL
+          scopes:
+            product-management/addon:read: Addon read-only access
+            product-management/product:write: Product write access
+            product-management/addon:write: Addon write access
+            product-management/product:read: Product read-only access
+  parameters:
+    addonId:
+      name: addonId
+      in: path
+      required: true
+      schema:
+        type: string
+        maxLength: 100
+    productParentId:
+      name: productParentId
+      in: path
+      required: true
+      schema:
+        type: string
+        maxLength: 100
+    productVariantId:
+      name: productVariantId
+      in: path
+      required: true
+      schema:
+        type: string
+        maxLength: 100