Create security categories

async AsyncCogniteClient.iam.security_categories.create(

security_category: SecurityCategory | SecurityCategoryWrite | Sequence[SecurityCategory] | Sequence[SecurityCategoryWrite],

) → SecurityCategory | SecurityCategoryList

Create one or more security categories.

Deprecated since version 8.23.0: The Security Categories API is deprecated and is scheduled for removal on 2027-12-31. Replace security categories with data products and granular access control. See https://docs.cognite.com/cdf/deprecated for details and migration guidance.

Parameters:

security_category (SecurityCategory | SecurityCategoryWrite | Sequence[SecurityCategory] | Sequence[SecurityCategoryWrite]) – Security category or list of categories to create.

Returns:

The created security category or categories.

Return type:

SecurityCategory | SecurityCategoryList

Example

Create security category:

>>> from cognite.client import CogniteClient
>>> from cognite.client.data_classes import SecurityCategoryWrite
>>> client = CogniteClient()
>>> # async_client = AsyncCogniteClient()  # another option
>>> my_category = SecurityCategoryWrite(name="My Category")
>>> res = client.iam.security_categories.create(my_category)