Document new attributes for team models (#1614)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.5",
-            "regenerated": "2023-08-17 19:37:36.120280",
-            "spec_repo_commit": "bb17cef0"
+            "regenerated": "2023-08-21 14:22:17.422870",
+            "spec_repo_commit": "77f8c067"
         },
         "v2": {
             "apigentools_version": "1.6.5",
-            "regenerated": "2023-08-17 19:37:36.141484",
-            "spec_repo_commit": "bb17cef0"
+            "regenerated": "2023-08-21 14:22:17.439772",
+            "spec_repo_commit": "77f8c067"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -16002,6 +16002,17 @@ components:
     TeamAttributes:
       description: Team attributes
       properties:
+        avatar:
+          description: Unicode representation of the avatar for the team, limited
+            to a single grapheme
+          example: "\U0001F951"
+          nullable: true
+          type: string
+        banner:
+          description: Banner selection for the team
+          format: int64
+          nullable: true
+          type: integer
         created_at:
           description: Creation date of the team
           format: date-time
@@ -16015,6 +16026,12 @@ components:
           example: example-team
           maxLength: 195
           type: string
+        hidden_modules:
+          description: Collection of hidden modules for the team
+          items:
+            description: String identifier of the module
+            type: string
+          type: array
         link_count:
           description: The number of links belonging to the team
           format: int32
@@ -16041,6 +16058,12 @@ components:
           maximum: 2147483647
           readOnly: true
           type: integer
+        visible_modules:
+          description: Collection of visible modules for the team
+          items:
+            description: String identifier of the module
+            type: string
+          type: array
       required:
       - handle
       - name
@@ -16061,6 +16084,17 @@ components:
     TeamCreateAttributes:
       description: Team creation attributes
       properties:
+        avatar:
+          description: Unicode representation of the avatar for the team, limited
+            to a single grapheme
+          example: "\U0001F951"
+          nullable: true
+          type: string
+        banner:
+          description: Banner selection for the team
+          format: int64
+          nullable: true
+          type: integer
         description:
           description: Free-form markdown description/content for the team's homepage
           type: string
@@ -16069,11 +16103,23 @@ components:
           example: example-team
           maxLength: 195
           type: string
+        hidden_modules:
+          description: Collection of hidden modules for the team
+          items:
+            description: String identifier of the module
+            type: string
+          type: array
         name:
           description: The name of the team
           example: Example Team
           maxLength: 200
           type: string
+        visible_modules:
+          description: Collection of visible modules for the team
+          items:
+            description: String identifier of the module
+            type: string
+          type: array
       required:
       - handle
       - name
@@ -16344,6 +16390,17 @@ components:
     TeamUpdateAttributes:
       description: Team update attributes
       properties:
+        avatar:
+          description: Unicode representation of the avatar for the team, limited
+            to a single grapheme
+          example: "\U0001F951"
+          nullable: true
+          type: string
+        banner:
+          description: Banner selection for the team
+          format: int64
+          nullable: true
+          type: integer
         color:
           description: An identifier for the color representing the team
           format: int32
@@ -16358,11 +16415,23 @@ components:
           example: example-team
           maxLength: 195
           type: string
+        hidden_modules:
+          description: Collection of hidden modules for the team
+          items:
+            description: String identifier of the module
+            type: string
+          type: array
         name:
           description: The name of the team
           example: Example Team
           maxLength: 200
           type: string
+        visible_modules:
+          description: Collection of visible modules for the team
+          items:
+            description: String identifier of the module
+            type: string
+          type: array
       required:
       - handle
       - name

examples/v2/teams/CreateTeam_252121814.py

@@ -0,0 +1,36 @@
+"""
+Create a team with V2 fields returns "CREATED" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.teams_api import TeamsApi
+from datadog_api_client.v2.model.team_create import TeamCreate
+from datadog_api_client.v2.model.team_create_attributes import TeamCreateAttributes
+from datadog_api_client.v2.model.team_create_request import TeamCreateRequest
+from datadog_api_client.v2.model.team_type import TeamType
+
+body = TeamCreateRequest(
+    data=TeamCreate(
+        attributes=TeamCreateAttributes(
+            handle="handle-a0fc0297eb519635",
+            name="name-a0fc0297eb519635",
+            avatar="🥑",
+            banner=7,
+            visible_modules=[
+                "m1",
+                "m2",
+            ],
+            hidden_modules=[
+                "m3",
+            ],
+        ),
+        type=TeamType.TEAM,
+    ),
+)
+
+configuration = Configuration()
+with ApiClient(configuration) as api_client:
+    api_instance = TeamsApi(api_client)
+    response = api_instance.create_team(body=body)
+
+    print(response)

examples/v2/teams/UpdateTeam.py

@@ -20,6 +20,15 @@
         attributes=TeamUpdateAttributes(
             handle=DD_TEAM_DATA_ATTRIBUTES_HANDLE,
             name="Example Team updated",
+            avatar="🥑",
+            banner=7,
+            hidden_modules=[
+                "m3",
+            ],
+            visible_modules=[
+                "m1",
+                "m2",
+            ],
         ),
         type=TeamType.TEAM,
     ),

src/datadog_api_client/v2/model/team_attributes.py

@@ -3,7 +3,7 @@
 # Copyright 2019-Present Datadog, Inc.
 from __future__ import annotations
 
-from typing import Union
+from typing import List, Union
 
 from datadog_api_client.model_utils import (
     ModelNormal,
@@ -37,25 +37,33 @@ class TeamAttributes(ModelNormal):
     @cached_property
     def openapi_types(_):
         return {
+            "avatar": (str, none_type),
+            "banner": (int, none_type),
             "created_at": (datetime,),
             "description": (str, none_type),
             "handle": (str,),
+            "hidden_modules": ([str],),
             "link_count": (int,),
             "modified_at": (datetime,),
             "name": (str,),
             "summary": (str, none_type),
             "user_count": (int,),
+            "visible_modules": ([str],),
         }
 
     attribute_map = {
+        "avatar": "avatar",
+        "banner": "banner",
         "created_at": "created_at",
         "description": "description",
         "handle": "handle",
+        "hidden_modules": "hidden_modules",
         "link_count": "link_count",
         "modified_at": "modified_at",
         "name": "name",
         "summary": "summary",
         "user_count": "user_count",
+        "visible_modules": "visible_modules",
     }
     read_only_vars = {
         "link_count",
@@ -66,17 +74,27 @@ def __init__(
         self_,
         handle: str,
         name: str,
+        avatar: Union[str, none_type, UnsetType] = unset,
+        banner: Union[int, none_type, UnsetType] = unset,
         created_at: Union[datetime, UnsetType] = unset,
         description: Union[str, none_type, UnsetType] = unset,
+        hidden_modules: Union[List[str], UnsetType] = unset,
         link_count: Union[int, UnsetType] = unset,
         modified_at: Union[datetime, UnsetType] = unset,
         summary: Union[str, none_type, UnsetType] = unset,
         user_count: Union[int, UnsetType] = unset,
+        visible_modules: Union[List[str], UnsetType] = unset,
         **kwargs,
     ):
         """
         Team attributes
 
+        :param avatar: Unicode representation of the avatar for the team, limited to a single grapheme
+        :type avatar: str, none_type, optional
+
+        :param banner: Banner selection for the team
+        :type banner: int, none_type, optional
+
         :param created_at: Creation date of the team
         :type created_at: datetime, optional
 
@@ -86,6 +104,9 @@ def __init__(
         :param handle: The team's identifier
         :type handle: str
 
+        :param hidden_modules: Collection of hidden modules for the team
+        :type hidden_modules: [str], optional
+
         :param link_count: The number of links belonging to the team
         :type link_count: int, optional
 
@@ -100,11 +121,20 @@ def __init__(
 
         :param user_count: The number of users belonging to the team
         :type user_count: int, optional
+
+        :param visible_modules: Collection of visible modules for the team
+        :type visible_modules: [str], optional
         """
+        if avatar is not unset:
+            kwargs["avatar"] = avatar
+        if banner is not unset:
+            kwargs["banner"] = banner
         if created_at is not unset:
             kwargs["created_at"] = created_at
         if description is not unset:
             kwargs["description"] = description
+        if hidden_modules is not unset:
+            kwargs["hidden_modules"] = hidden_modules
         if link_count is not unset:
             kwargs["link_count"] = link_count
         if modified_at is not unset:
@@ -113,6 +143,8 @@ def __init__(
             kwargs["summary"] = summary
         if user_count is not unset:
             kwargs["user_count"] = user_count
+        if visible_modules is not unset:
+            kwargs["visible_modules"] = visible_modules
         super().__init__(kwargs)
 
         self_.handle = handle

src/datadog_api_client/v2/model/team_create_attributes.py

@@ -3,11 +3,12 @@
 # Copyright 2019-Present Datadog, Inc.
 from __future__ import annotations
 
-from typing import Union
+from typing import List, Union
 
 from datadog_api_client.model_utils import (
     ModelNormal,
     cached_property,
+    none_type,
     unset,
     UnsetType,
 )
@@ -26,32 +27,70 @@ class TeamCreateAttributes(ModelNormal):
     @cached_property
     def openapi_types(_):
         return {
+            "avatar": (str, none_type),
+            "banner": (int, none_type),
             "description": (str,),
             "handle": (str,),
+            "hidden_modules": ([str],),
             "name": (str,),
+            "visible_modules": ([str],),
         }
 
     attribute_map = {
+        "avatar": "avatar",
+        "banner": "banner",
         "description": "description",
         "handle": "handle",
+        "hidden_modules": "hidden_modules",
         "name": "name",
+        "visible_modules": "visible_modules",
     }
 
-    def __init__(self_, handle: str, name: str, description: Union[str, UnsetType] = unset, **kwargs):
+    def __init__(
+        self_,
+        handle: str,
+        name: str,
+        avatar: Union[str, none_type, UnsetType] = unset,
+        banner: Union[int, none_type, UnsetType] = unset,
+        description: Union[str, UnsetType] = unset,
+        hidden_modules: Union[List[str], UnsetType] = unset,
+        visible_modules: Union[List[str], UnsetType] = unset,
+        **kwargs,
+    ):
         """
         Team creation attributes
 
+        :param avatar: Unicode representation of the avatar for the team, limited to a single grapheme
+        :type avatar: str, none_type, optional
+
+        :param banner: Banner selection for the team
+        :type banner: int, none_type, optional
+
         :param description: Free-form markdown description/content for the team's homepage
         :type description: str, optional
 
         :param handle: The team's identifier
         :type handle: str
 
+        :param hidden_modules: Collection of hidden modules for the team
+        :type hidden_modules: [str], optional
+
         :param name: The name of the team
         :type name: str
+
+        :param visible_modules: Collection of visible modules for the team
+        :type visible_modules: [str], optional
         """
+        if avatar is not unset:
+            kwargs["avatar"] = avatar
+        if banner is not unset:
+            kwargs["banner"] = banner
         if description is not unset:
             kwargs["description"] = description
+        if hidden_modules is not unset:
+            kwargs["hidden_modules"] = hidden_modules
+        if visible_modules is not unset:
+            kwargs["visible_modules"] = visible_modules
         super().__init__(kwargs)
 
         self_.handle = handle