Add user status to schema and fix escalation policy included (#2536)

Co-authored-by: ci.datadog-api-spec <[email protected]>

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

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-05-01 18:50:10.700756",
-            "spec_repo_commit": "7eb88f6a"
+            "regenerated": "2025-05-02 04:31:14.572410",
+            "spec_repo_commit": "272cce39"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-05-01 18:50:10.716342",
-            "spec_repo_commit": "7eb88f6a"
+            "regenerated": "2025-05-02 04:31:14.659660",
+            "spec_repo_commit": "272cce39"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -13547,9 +13547,8 @@ components:
       oneOf:
       - $ref: '#/components/schemas/TeamReference'
       - $ref: '#/components/schemas/EscalationPolicyStep'
-      - $ref: '#/components/schemas/UserTarget'
-      - $ref: '#/components/schemas/ScheduleTarget'
-      - $ref: '#/components/schemas/TeamTarget'
+      - $ref: '#/components/schemas/EscalationPolicyUser'
+      - $ref: '#/components/schemas/ScheduleData'
     EscalationPolicyStep:
       description: Represents a single step in an escalation policy, including its
         attributes, relationships, and resource type.
@@ -13795,6 +13794,44 @@ components:
       type: string
       x-enum-varnames:
       - POLICIES
+    EscalationPolicyUser:
+      description: Represents a user object in the context of an escalation policy,
+        including their `id`, type, and basic attributes.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/EscalationPolicyUserAttributes'
+        id:
+          description: The unique user identifier.
+          type: string
+        type:
+          $ref: '#/components/schemas/EscalationPolicyUserType'
+      required:
+      - type
+      type: object
+    EscalationPolicyUserAttributes:
+      description: Provides basic user information for an escalation policy, including
+        a name and email address.
+      properties:
+        email:
+          description: The user's email address.
+          example: [email protected]
+          type: string
+        name:
+          description: The user's name.
+          example: Jane Doe
+          type: string
+        status:
+          $ref: '#/components/schemas/UserAttributesStatus'
+      type: object
+    EscalationPolicyUserType:
+      default: users
+      description: Users resource type.
+      enum:
+      - users
+      example: users
+      type: string
+      x-enum-varnames:
+      - USERS
     EscalationTarget:
       description: Represents an escalation target, which can be a team, user, or
         schedule.
@@ -31730,6 +31767,8 @@ components:
           description: The user's name.
           example: Jane Doe
           type: string
+        status:
+          $ref: '#/components/schemas/UserAttributesStatus'
       type: object
     ScheduleUserType:
       default: users
@@ -38564,6 +38603,17 @@ components:
           description: Whether the user is verified.
           type: boolean
       type: object
+    UserAttributesStatus:
+      description: The user's status.
+      enum:
+      - active
+      - deactivated
+      - pending
+      type: string
+      x-enum-varnames:
+      - ACTIVE
+      - DEACTIVATED
+      - PENDING
     UserCreateAttributes:
       description: Attributes of the created user.
       properties:

docs/datadog_api_client.v2.model.rst

@@ -5646,6 +5646,27 @@ datadog\_api\_client.v2.model.escalation\_policy\_update\_request\_data\_type mo
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.escalation\_policy\_user module
+-------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.escalation_policy_user
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.escalation\_policy\_user\_attributes module
+-------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.escalation_policy_user_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.escalation\_policy\_user\_type module
+-------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.escalation_policy_user_type
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.escalation\_target module
 -------------------------------------------------------
 
@@ -16783,6 +16804,13 @@ datadog\_api\_client.v2.model.user\_attributes module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.user\_attributes\_status module
+-------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.user_attributes_status
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.user\_create\_attributes module
 -------------------------------------------------------------
 

src/datadog_api_client/v2/model/escalation_policy.py

@@ -18,9 +18,8 @@
     from datadog_api_client.v2.model.escalation_policy_included import EscalationPolicyIncluded
     from datadog_api_client.v2.model.team_reference import TeamReference
     from datadog_api_client.v2.model.escalation_policy_step import EscalationPolicyStep
-    from datadog_api_client.v2.model.user_target import UserTarget
-    from datadog_api_client.v2.model.schedule_target import ScheduleTarget
-    from datadog_api_client.v2.model.team_target import TeamTarget
+    from datadog_api_client.v2.model.escalation_policy_user import EscalationPolicyUser
+    from datadog_api_client.v2.model.schedule_data import ScheduleData
 
 
 class EscalationPolicy(ModelNormal):
@@ -44,14 +43,7 @@ def __init__(
         data: Union[EscalationPolicyData, UnsetType] = unset,
         included: Union[
             List[
-                Union[
-                    EscalationPolicyIncluded,
-                    TeamReference,
-                    EscalationPolicyStep,
-                    UserTarget,
-                    ScheduleTarget,
-                    TeamTarget,
-                ]
+                Union[EscalationPolicyIncluded, TeamReference, EscalationPolicyStep, EscalationPolicyUser, ScheduleData]
             ],
             UnsetType,
         ] = unset,

src/datadog_api_client/v2/model/escalation_policy_included.py

@@ -40,16 +40,14 @@ def _composed_schemas(_):
         # loading
         from datadog_api_client.v2.model.team_reference import TeamReference
         from datadog_api_client.v2.model.escalation_policy_step import EscalationPolicyStep
-        from datadog_api_client.v2.model.user_target import UserTarget
-        from datadog_api_client.v2.model.schedule_target import ScheduleTarget
-        from datadog_api_client.v2.model.team_target import TeamTarget
+        from datadog_api_client.v2.model.escalation_policy_user import EscalationPolicyUser
+        from datadog_api_client.v2.model.schedule_data import ScheduleData
 
         return {
             "oneOf": [
                 TeamReference,
                 EscalationPolicyStep,
-                UserTarget,
-                ScheduleTarget,
-                TeamTarget,
+                EscalationPolicyUser,
+                ScheduleData,
             ],
         }

src/datadog_api_client/v2/model/escalation_policy_user.py

@@ -0,0 +1,64 @@
+# Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+# This product includes software developed at Datadog (https://www.datadoghq.com/).
+# Copyright 2019-Present Datadog, Inc.
+from __future__ import annotations
+
+from typing import Union, TYPE_CHECKING
+
+from datadog_api_client.model_utils import (
+    ModelNormal,
+    cached_property,
+    unset,
+    UnsetType,
+)
+
+
+if TYPE_CHECKING:
+    from datadog_api_client.v2.model.escalation_policy_user_attributes import EscalationPolicyUserAttributes
+    from datadog_api_client.v2.model.escalation_policy_user_type import EscalationPolicyUserType
+
+
+class EscalationPolicyUser(ModelNormal):
+    @cached_property
+    def openapi_types(_):
+        from datadog_api_client.v2.model.escalation_policy_user_attributes import EscalationPolicyUserAttributes
+        from datadog_api_client.v2.model.escalation_policy_user_type import EscalationPolicyUserType
+
+        return {
+            "attributes": (EscalationPolicyUserAttributes,),
+            "id": (str,),
+            "type": (EscalationPolicyUserType,),
+        }
+
+    attribute_map = {
+        "attributes": "attributes",
+        "id": "id",
+        "type": "type",
+    }
+
+    def __init__(
+        self_,
+        type: EscalationPolicyUserType,
+        attributes: Union[EscalationPolicyUserAttributes, UnsetType] = unset,
+        id: Union[str, UnsetType] = unset,
+        **kwargs,
+    ):
+        """
+        Represents a user object in the context of an escalation policy, including their ``id`` , type, and basic attributes.
+
+        :param attributes: Provides basic user information for an escalation policy, including a name and email address.
+        :type attributes: EscalationPolicyUserAttributes, optional
+
+        :param id: The unique user identifier.
+        :type id: str, optional
+
+        :param type: Users resource type.
+        :type type: EscalationPolicyUserType
+        """
+        if attributes is not unset:
+            kwargs["attributes"] = attributes
+        if id is not unset:
+            kwargs["id"] = id
+        super().__init__(kwargs)
+
+        self_.type = type

src/datadog_api_client/v2/model/escalation_policy_user_attributes.py

@@ -0,0 +1,62 @@
+# Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+# This product includes software developed at Datadog (https://www.datadoghq.com/).
+# Copyright 2019-Present Datadog, Inc.
+from __future__ import annotations
+
+from typing import Union, TYPE_CHECKING
+
+from datadog_api_client.model_utils import (
+    ModelNormal,
+    cached_property,
+    unset,
+    UnsetType,
+)
+
+
+if TYPE_CHECKING:
+    from datadog_api_client.v2.model.user_attributes_status import UserAttributesStatus
+
+
+class EscalationPolicyUserAttributes(ModelNormal):
+    @cached_property
+    def openapi_types(_):
+        from datadog_api_client.v2.model.user_attributes_status import UserAttributesStatus
+
+        return {
+            "email": (str,),
+            "name": (str,),
+            "status": (UserAttributesStatus,),
+        }
+
+    attribute_map = {
+        "email": "email",
+        "name": "name",
+        "status": "status",
+    }
+
+    def __init__(
+        self_,
+        email: Union[str, UnsetType] = unset,
+        name: Union[str, UnsetType] = unset,
+        status: Union[UserAttributesStatus, UnsetType] = unset,
+        **kwargs,
+    ):
+        """
+        Provides basic user information for an escalation policy, including a name and email address.
+
+        :param email: The user's email address.
+        :type email: str, optional
+
+        :param name: The user's name.
+        :type name: str, optional
+
+        :param status: The user's status.
+        :type status: UserAttributesStatus, optional
+        """
+        if email is not unset:
+            kwargs["email"] = email
+        if name is not unset:
+            kwargs["name"] = name
+        if status is not unset:
+            kwargs["status"] = status
+        super().__init__(kwargs)

src/datadog_api_client/v2/model/escalation_policy_user_type.py

@@ -0,0 +1,35 @@
+# Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+# This product includes software developed at Datadog (https://www.datadoghq.com/).
+# Copyright 2019-Present Datadog, Inc.
+from __future__ import annotations
+
+
+from datadog_api_client.model_utils import (
+    ModelSimple,
+    cached_property,
+)
+
+from typing import ClassVar
+
+
+class EscalationPolicyUserType(ModelSimple):
+    """
+    Users resource type.
+
+    :param value: If omitted defaults to "users". Must be one of ["users"].
+    :type value: str
+    """
+
+    allowed_values = {
+        "users",
+    }
+    USERS: ClassVar["EscalationPolicyUserType"]
+
+    @cached_property
+    def openapi_types(_):
+        return {
+            "value": (str,),
+        }
+
+
+EscalationPolicyUserType.USERS = EscalationPolicyUserType("users")