:doc:`QApps <../../qapps>` / Client / batch_update_category

*********************
batch_update_category
*********************



.. py:method:: QApps.Client.batch_update_category(**kwargs)

  

  Updates Categories for the Amazon Q Business application environment instance. Web experience users use Categories to tag and filter library items. For more information, see `Custom labels for Amazon Q Apps <https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/qapps-custom-labels.html>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/qapps-2023-11-27/BatchUpdateCategory>`_  


  **Request Syntax**
  ::

    response = client.batch_update_category(
        instanceId='string',
        categories=[
            {
                'id': 'string',
                'title': 'string',
                'color': 'string'
            },
        ]
    )
    
  :type instanceId: string
  :param instanceId: **[REQUIRED]** 

    The unique identifier of the Amazon Q Business application environment instance.

    

  
  :type categories: list
  :param categories: **[REQUIRED]** 

    The list of categories to be updated with their new values.

    

  
    - *(dict) --* 

      A label that web experience users associate with a library item. Web experience users use Categories to tag and filter library items.

      

    
      - **id** *(string) --* **[REQUIRED]** 

        The unique identifier of the category.

        

      
      - **title** *(string) --* **[REQUIRED]** 

        The name of the category.

        

      
      - **color** *(string) --* 

        The color of the category, represented as a hexadecimal value of either 3 or 6 digits.

        

      
    

  
  :returns: None
  **Exceptions**
  
  *   :py:class:`QApps.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`QApps.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`QApps.Client.exceptions.ConflictException`

  
  *   :py:class:`QApps.Client.exceptions.ValidationException`

  
  *   :py:class:`QApps.Client.exceptions.InternalServerException`

  
  *   :py:class:`QApps.Client.exceptions.UnauthorizedException`

  
  *   :py:class:`QApps.Client.exceptions.ThrottlingException`

  