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

*********************
batch_create_category
*********************



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

  

  Creates 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/BatchCreateCategory>`_  


  **Request Syntax**
  ::

    response = client.batch_create_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 category objects to be created

    

  
    - *(dict) --* 

      The category object to be created.

      

    
      - **id** *(string) --* 

        The unique identifier to be associated with a category. If you don't include a value, the category is automatically assigned a unique identifier.

        

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

        The name of the category.

        

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

        The color to be associated with a category. The color must be 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`

  