Regenerate client from commit af0cd40 of spec repo

Author: ci.datadog-api-spec

.generator/schemas/v2/openapi.yaml

@@ -17289,6 +17289,76 @@ components:
       - score
       - severity
       type: object
+    Email:
+      description: On-Call User Email.
+      example:
+        data:
+          attributes:
+            active: true
+            address: [email protected]
+            alias: ''
+            blocked: false
+            created_at: '2024-04-16T23:38:50.388642Z'
+            formats:
+            - html
+            modified_at: '2024-04-16T23:38:50.388642Z'
+          id: 45cd9fe5-dd96-42ad-83de-2242ea9f6efd
+          type: emails
+      properties:
+        data:
+          $ref: '#/components/schemas/EmailData'
+      type: object
+    EmailAttributes:
+      description: Attributes for an on-call email.
+      properties:
+        active:
+          description: Whether the email is currently active.
+          type: boolean
+        address:
+          description: Email address.
+          type: string
+        alias:
+          description: Optional display alias for the email.
+          type: string
+        blocked:
+          description: Whether the email is blocked.
+          type: boolean
+        created_at:
+          description: Creation time of the email resource.
+          format: date-time
+          type: string
+        formats:
+          description: Preferred content formats for notifications.
+          items:
+            type: string
+          type: array
+        modified_at:
+          description: Last modification time of the email resource.
+          format: date-time
+          type: string
+      type: object
+    EmailData:
+      description: Data for an on-call email resource.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/EmailAttributes'
+        id:
+          description: The email's unique identifier.
+          type: string
+        type:
+          $ref: '#/components/schemas/EmailType'
+      required:
+      - type
+      type: object
+    EmailType:
+      default: emails
+      description: Indicates that the resource is of type 'emails'.
+      enum:
+      - emails
+      example: emails
+      type: string
+      x-enum-varnames:
+      - EMAILS
     Enabled:
       description: Field used to enable or disable the rule.
       example: true
@@ -70837,6 +70907,48 @@ paths:
         operator: AND
         permissions:
         - on_call_write
+  /api/v2/on-call/users/{user_id}/notification-channels/emails:
+    post:
+      description: Create a new email notification channel for an on-call user
+      operationId: CreateUserEmailNotificationChannel
+      parameters:
+      - description: The user ID
+        in: path
+        name: user_id
+        required: true
+        schema:
+          example: 00000000-0000-0000-0000-000000000000
+          type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Email'
+        required: true
+      responses:
+        '201':
+          description: Created
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '401':
+          $ref: '#/components/responses/UnauthorizedResponse'
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ: []
+      summary: Create email notification channel for user
+      tags:
+      - On-Call
+      x-permission:
+        operator: AND
+        permissions:
+        - on_call_admin
   /api/v2/org_configs:
     get:
       description: Returns all Org Configs (name, description, and value).

docs/datadog_api_client.v2.model.rst

@@ -7039,6 +7039,34 @@ datadog\_api\_client.v2.model.downtime\_update\_request\_data module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.email module
+------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.email
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.email\_attributes module
+------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.email_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.email\_data module
+------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.email_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.email\_type module
+------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.email_type
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.entity\_attributes module
 -------------------------------------------------------
 

examples/v2/on-call/CreateUserEmailNotificationChannel.py

@@ -0,0 +1,35 @@
+"""
+Create email notification channel for user returns "Created" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.on_call_api import OnCallApi
+from datadog_api_client.v2.model.email import Email
+from datadog_api_client.v2.model.email_attributes import EmailAttributes
+from datadog_api_client.v2.model.email_data import EmailData
+from datadog_api_client.v2.model.email_type import EmailType
+from datetime import datetime
+from dateutil.tz import tzutc
+
+body = Email(
+    data=EmailData(
+        attributes=EmailAttributes(
+            active=True,
+            address="[email protected]",
+            alias="",
+            blocked=False,
+            created_at=datetime(2024, 4, 16, 23, 38, 50, 388642, tzinfo=tzutc()),
+            formats=[
+                "html",
+            ],
+            modified_at=datetime(2024, 4, 16, 23, 38, 50, 388642, tzinfo=tzutc()),
+        ),
+        id="45cd9fe5-dd96-42ad-83de-2242ea9f6efd",
+        type=EmailType.EMAILS,
+    ),
+)
+
+configuration = Configuration()
+with ApiClient(configuration) as api_client:
+    api_instance = OnCallApi(api_client)
+    api_instance.create_user_email_notification_channel(user_id="00000000-0000-0000-0000-000000000000", body=body)

src/datadog_api_client/v2/api/on_call_api.py

@@ -21,6 +21,7 @@
 from datadog_api_client.v2.model.team_on_call_responders import TeamOnCallResponders
 from datadog_api_client.v2.model.team_routing_rules import TeamRoutingRules
 from datadog_api_client.v2.model.team_routing_rules_request import TeamRoutingRulesRequest
+from datadog_api_client.v2.model.email import Email
 
 
 class OnCallApi:
@@ -84,6 +85,32 @@ def __init__(self, api_client=None):
             api_client=api_client,
         )
 
+        self._create_user_email_notification_channel_endpoint = _Endpoint(
+            settings={
+                "response_type": None,
+                "auth": ["apiKeyAuth", "appKeyAuth", "AuthZ"],
+                "endpoint_path": "/api/v2/on-call/users/{user_id}/notification-channels/emails",
+                "operation_id": "create_user_email_notification_channel",
+                "http_method": "POST",
+                "version": "v2",
+            },
+            params_map={
+                "user_id": {
+                    "required": True,
+                    "openapi_types": (str,),
+                    "attribute": "user_id",
+                    "location": "path",
+                },
+                "body": {
+                    "required": True,
+                    "openapi_types": (Email,),
+                    "location": "body",
+                },
+            },
+            headers_map={"accept": ["*/*"], "content_type": ["application/json"]},
+            api_client=api_client,
+        )
+
         self._delete_on_call_escalation_policy_endpoint = _Endpoint(
             settings={
                 "response_type": None,
@@ -414,6 +441,27 @@ def create_on_call_schedule(
 
         return self._create_on_call_schedule_endpoint.call_with_http_info(**kwargs)
 
+    def create_user_email_notification_channel(
+        self,
+        user_id: str,
+        body: Email,
+    ) -> None:
+        """Create email notification channel for user.
+
+        Create a new email notification channel for an on-call user
+
+        :param user_id: The user ID
+        :type user_id: str
+        :type body: Email
+        :rtype: None
+        """
+        kwargs: Dict[str, Any] = {}
+        kwargs["user_id"] = user_id
+
+        kwargs["body"] = body
+
+        return self._create_user_email_notification_channel_endpoint.call_with_http_info(**kwargs)
+
     def delete_on_call_escalation_policy(
         self,
         policy_id: str,

src/datadog_api_client/v2/model/email.py

@@ -0,0 +1,42 @@
+# 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.email_data import EmailData
+
+
+class Email(ModelNormal):
+    @cached_property
+    def openapi_types(_):
+        from datadog_api_client.v2.model.email_data import EmailData
+
+        return {
+            "data": (EmailData,),
+        }
+
+    attribute_map = {
+        "data": "data",
+    }
+
+    def __init__(self_, data: Union[EmailData, UnsetType] = unset, **kwargs):
+        """
+        On-Call User Email.
+
+        :param data: Data for an on-call email resource.
+        :type data: EmailData, optional
+        """
+        if data is not unset:
+            kwargs["data"] = data
+        super().__init__(kwargs)

src/datadog_api_client/v2/model/email_attributes.py

@@ -0,0 +1,89 @@
+# 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 List, Union
+
+from datadog_api_client.model_utils import (
+    ModelNormal,
+    cached_property,
+    datetime,
+    unset,
+    UnsetType,
+)
+
+
+class EmailAttributes(ModelNormal):
+    @cached_property
+    def openapi_types(_):
+        return {
+            "active": (bool,),
+            "address": (str,),
+            "alias": (str,),
+            "blocked": (bool,),
+            "created_at": (datetime,),
+            "formats": ([str],),
+            "modified_at": (datetime,),
+        }
+
+    attribute_map = {
+        "active": "active",
+        "address": "address",
+        "alias": "alias",
+        "blocked": "blocked",
+        "created_at": "created_at",
+        "formats": "formats",
+        "modified_at": "modified_at",
+    }
+
+    def __init__(
+        self_,
+        active: Union[bool, UnsetType] = unset,
+        address: Union[str, UnsetType] = unset,
+        alias: Union[str, UnsetType] = unset,
+        blocked: Union[bool, UnsetType] = unset,
+        created_at: Union[datetime, UnsetType] = unset,
+        formats: Union[List[str], UnsetType] = unset,
+        modified_at: Union[datetime, UnsetType] = unset,
+        **kwargs,
+    ):
+        """
+        Attributes for an on-call email.
+
+        :param active: Whether the email is currently active.
+        :type active: bool, optional
+
+        :param address: Email address.
+        :type address: str, optional
+
+        :param alias: Optional display alias for the email.
+        :type alias: str, optional
+
+        :param blocked: Whether the email is blocked.
+        :type blocked: bool, optional
+
+        :param created_at: Creation time of the email resource.
+        :type created_at: datetime, optional
+
+        :param formats: Preferred content formats for notifications.
+        :type formats: [str], optional
+
+        :param modified_at: Last modification time of the email resource.
+        :type modified_at: datetime, optional
+        """
+        if active is not unset:
+            kwargs["active"] = active
+        if address is not unset:
+            kwargs["address"] = address
+        if alias is not unset:
+            kwargs["alias"] = alias
+        if blocked is not unset:
+            kwargs["blocked"] = blocked
+        if created_at is not unset:
+            kwargs["created_at"] = created_at
+        if formats is not unset:
+            kwargs["formats"] = formats
+        if modified_at is not unset:
+            kwargs["modified_at"] = modified_at
+        super().__init__(kwargs)