> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fynn.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a product group

> Update a product group.

<sup>Required permissions: `product-group:write`</sup>

Update a product group.


## OpenAPI

````yaml put /catalogue/product-groups/{id}
openapi: 3.1.0
info:
  title: Fynn API
  description: ''
  termsOfService: https://www.fynn.eu/tos
  contact:
    name: Fynn UG (haftungsbeschränkt)
    url: https://www.fynn.eu
    email: hi@fynn.eu
  license:
    name: Proprietary
    url: https://www.fynn.eu/license
  version: 0.0.0
servers:
  - url: https://coreapi.io
    description: Production
  - url: https://preview.coreapi.io
    description: Sandbox
security:
  - JWT: []
tags: []
paths:
  /catalogue/product-groups/{id}:
    parameters: []
    put:
      tags:
        - ProductGroup
      summary: Update a product group
      description: |-
        Update a product group.

        <sup>Required permissions: `product-group:write`</sup>
      operationId: updateProductGroup
      parameters:
        - name: id
          in: path
          description: ProductGroup identifier
          required: true
          schema:
            type: string
      requestBody:
        description: The updated ProductGroup resource
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductGroup-ProductGroupWrite'
        required: true
      responses:
        '200':
          description: ProductGroup resource updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductGroup-ProductGroupRead'
        '400':
          description: Invalid input
        '404':
          description: Resource not found
        '422':
          description: Unprocessable entity
      security:
        - JWT:
            - product-group:write
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |-
            curl -X PUT \
             /catalogue/product-groups/{id} \
             --header "Content-Type: application/json" \
             --header "Authorization: Bearer <token>" \
             --data '{"name": "Updated Name", "enabled": true}'
components:
  schemas:
    ProductGroup-ProductGroupWrite:
      type: object
      description: Create or update a product group
      properties:
        name:
          type: string
          example: SaaS Packages
        enabled:
          example: true
          type: boolean
        forceSameBillingInterval:
          type: boolean
          example: false
        memberships:
          type: array
          items:
            $ref: '#/components/schemas/ProductGroupMembership-ProductGroupWrite'
      required:
        - name
        - enabled
    ProductGroup-ProductGroupRead:
      type: object
      description: A product group for up- and downgrades
      properties:
        id:
          readOnly: true
          example: ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b
          type: string
        name:
          type: string
          example: SaaS Packages
        enabled:
          example: true
          type: boolean
        forceSameBillingInterval:
          type: boolean
          description: >-
            If true, customers can only switch between plans with the same
            billing interval
          example: false
        memberships:
          type: array
          items:
            $ref: '#/components/schemas/ProductGroupMembership-ProductGroupRead'
        createdAt:
          readOnly: true
          type: string
          format: date-time
        updatedAt:
          readOnly: true
          type: string
          format: date-time
    ProductGroupMembership-ProductGroupWrite:
      type: object
      properties:
        product:
          type: string
          description: IRI reference to the product
          example: /api/products/uuid
        pricePlans:
          type: array
          items:
            type: string
          description: IRI references to price plans
          example:
            - /api/plans/uuid
        position:
          type: integer
        label:
          type: string
        upgradeable:
          type: boolean
        downgradeable:
          type: boolean
        changeTiming:
          type: string
          enum:
            - immediately
            - end_of_period
        creditType:
          type: string
          enum:
            - full
            - pro_rata
            - last_invoiced
            - none
      required:
        - product
        - pricePlans
        - position
        - upgradeable
        - downgradeable
        - changeTiming
    ProductGroupMembership-ProductGroupRead:
      type: object
      description: A membership tier within a product group
      properties:
        id:
          readOnly: true
          example: ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b
          type: string
        product: 5eeb70e3-9b5d-43cb-9c01-59bf77dbebc4
        pricePlans:
          type: array
          items: 3ed7b86b-6c57-4f2a-86e1-464fe58b0d0d
        position:
          type: integer
          description: >-
            Position in the group. Lower = cheaper tier, higher = more expensive
            tier
        label:
          type: string
          description: Display label for this membership
          example: Pro
        upgradeable:
          type: boolean
          description: Whether upgrade to higher positions is allowed
        downgradeable:
          type: boolean
          description: Whether downgrade to lower positions is allowed
        changeTiming:
          type: string
          enum:
            - immediately
            - end_of_period
          description: When the change takes effect
        creditType:
          type: string
          enum:
            - full
            - pro_rata
            - last_invoiced
            - none
          description: How unused time is credited (only for immediate changes)
  securitySchemes:
    JWT:
      type: http
      scheme: bearer

````