Add On-Call Trigger to Workflow Automation Public API

.generator/schemas/v2/openapi.yaml

@@ -41678,6 +41678,24 @@ components:
       - type
       - method
       type: object
+    OnCallTrigger:
+      description: Trigger a workflow from an On-Call Page or On-Call Handover. For
+        automatic triggering a handle must be configured and the workflow must be
+        published.
+      properties:
+        rateLimit:
+          $ref: '#/components/schemas/TriggerRateLimit'
+      type: object
+    OnCallTriggerWrapper:
+      description: Schema for an On-Call-based trigger.
+      properties:
+        onCallTrigger:
+          $ref: '#/components/schemas/OnCallTrigger'
+        startStepNames:
+          $ref: '#/components/schemas/StartStepNames'
+      required:
+      - onCallTrigger
+      type: object
     OnDemandConcurrencyCap:
       description: On-demand concurrency cap.
       properties:
@@ -60788,6 +60806,7 @@ components:
       - $ref: '#/components/schemas/IncidentTriggerWrapper'
       - $ref: '#/components/schemas/MonitorTriggerWrapper'
       - $ref: '#/components/schemas/NotebookTriggerWrapper'
+      - $ref: '#/components/schemas/OnCallTriggerWrapper'
       - $ref: '#/components/schemas/ScheduleTriggerWrapper'
       - $ref: '#/components/schemas/SecurityTriggerWrapper'
       - $ref: '#/components/schemas/SelfServiceTriggerWrapper'

docs/datadog_api_client.v2.model.rst

@@ -17959,6 +17959,20 @@ datadog\_api\_client.v2.model.on\_call\_phone\_notification\_rule\_settings modu
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.on\_call\_trigger module
+------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.on_call_trigger
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.on\_call\_trigger\_wrapper module
+---------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.on_call_trigger_wrapper
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.on\_demand\_concurrency\_cap module
 -----------------------------------------------------------------
 

src/datadog_api_client/v2/model/on_call_trigger.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.trigger_rate_limit import TriggerRateLimit
+
+
+class OnCallTrigger(ModelNormal):
+    @cached_property
+    def openapi_types(_):
+        from datadog_api_client.v2.model.trigger_rate_limit import TriggerRateLimit
+
+        return {
+            "rate_limit": (TriggerRateLimit,),
+        }
+
+    attribute_map = {
+        "rate_limit": "rateLimit",
+    }
+
+    def __init__(self_, rate_limit: Union[TriggerRateLimit, UnsetType] = unset, **kwargs):
+        """
+        Trigger a workflow from an On-Call Page or On-Call Handover. For automatic triggering a handle must be configured and the workflow must be published.
+
+        :param rate_limit: Defines a rate limit for a trigger.
+        :type rate_limit: TriggerRateLimit, optional
+        """
+        if rate_limit is not unset:
+            kwargs["rate_limit"] = rate_limit
+        super().__init__(kwargs)

src/datadog_api_client/v2/model/on_call_trigger_wrapper.py

@@ -0,0 +1,51 @@
+# 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, TYPE_CHECKING
+
+from datadog_api_client.model_utils import (
+    ModelNormal,
+    cached_property,
+    unset,
+    UnsetType,
+)
+
+
+if TYPE_CHECKING:
+    from datadog_api_client.v2.model.on_call_trigger import OnCallTrigger
+
+
+class OnCallTriggerWrapper(ModelNormal):
+    @cached_property
+    def openapi_types(_):
+        from datadog_api_client.v2.model.on_call_trigger import OnCallTrigger
+
+        return {
+            "on_call_trigger": (OnCallTrigger,),
+            "start_step_names": ([str],),
+        }
+
+    attribute_map = {
+        "on_call_trigger": "onCallTrigger",
+        "start_step_names": "startStepNames",
+    }
+
+    def __init__(
+        self_, on_call_trigger: OnCallTrigger, start_step_names: Union[List[str], UnsetType] = unset, **kwargs
+    ):
+        """
+        Schema for an On-Call-based trigger.
+
+        :param on_call_trigger: Trigger a workflow from an On-Call Page or On-Call Handover. For automatic triggering a handle must be configured and the workflow must be published.
+        :type on_call_trigger: OnCallTrigger
+
+        :param start_step_names: A list of steps that run first after a trigger fires.
+        :type start_step_names: [str], optional
+        """
+        if start_step_names is not unset:
+            kwargs["start_step_names"] = start_step_names
+        super().__init__(kwargs)
+
+        self_.on_call_trigger = on_call_trigger

src/datadog_api_client/v2/model/spec.py

@@ -31,6 +31,7 @@
     from datadog_api_client.v2.model.incident_trigger_wrapper import IncidentTriggerWrapper
     from datadog_api_client.v2.model.monitor_trigger_wrapper import MonitorTriggerWrapper
     from datadog_api_client.v2.model.notebook_trigger_wrapper import NotebookTriggerWrapper
+    from datadog_api_client.v2.model.on_call_trigger_wrapper import OnCallTriggerWrapper
     from datadog_api_client.v2.model.schedule_trigger_wrapper import ScheduleTriggerWrapper
     from datadog_api_client.v2.model.security_trigger_wrapper import SecurityTriggerWrapper
     from datadog_api_client.v2.model.self_service_trigger_wrapper import SelfServiceTriggerWrapper
@@ -92,6 +93,7 @@ def __init__(
                     IncidentTriggerWrapper,
                     MonitorTriggerWrapper,
                     NotebookTriggerWrapper,
+                    OnCallTriggerWrapper,
                     ScheduleTriggerWrapper,
                     SecurityTriggerWrapper,
                     SelfServiceTriggerWrapper,

src/datadog_api_client/v2/model/trigger.py

@@ -51,6 +51,9 @@ def __init__(self, **kwargs):
         :param notebook_trigger: Trigger a workflow from a Notebook.
         :type notebook_trigger: dict
 
+        :param on_call_trigger: Trigger a workflow from an On-Call Page or On-Call Handover. For automatic triggering a handle must be configured and the workflow must be published.
+        :type on_call_trigger: OnCallTrigger
+
         :param schedule_trigger: Trigger a workflow from a Schedule. The workflow must be published.
         :type schedule_trigger: ScheduleTrigger
 
@@ -91,6 +94,7 @@ def _composed_schemas(_):
         from datadog_api_client.v2.model.incident_trigger_wrapper import IncidentTriggerWrapper
         from datadog_api_client.v2.model.monitor_trigger_wrapper import MonitorTriggerWrapper
         from datadog_api_client.v2.model.notebook_trigger_wrapper import NotebookTriggerWrapper
+        from datadog_api_client.v2.model.on_call_trigger_wrapper import OnCallTriggerWrapper
         from datadog_api_client.v2.model.schedule_trigger_wrapper import ScheduleTriggerWrapper
         from datadog_api_client.v2.model.security_trigger_wrapper import SecurityTriggerWrapper
         from datadog_api_client.v2.model.self_service_trigger_wrapper import SelfServiceTriggerWrapper
@@ -111,6 +115,7 @@ def _composed_schemas(_):
                 IncidentTriggerWrapper,
                 MonitorTriggerWrapper,
                 NotebookTriggerWrapper,
+                OnCallTriggerWrapper,
                 ScheduleTriggerWrapper,
                 SecurityTriggerWrapper,
                 SelfServiceTriggerWrapper,

src/datadog_api_client/v2/models/__init__.py

@@ -3731,6 +3731,8 @@
 from datadog_api_client.v2.model.on_call_page_target_type import OnCallPageTargetType
 from datadog_api_client.v2.model.on_call_phone_notification_rule_method import OnCallPhoneNotificationRuleMethod
 from datadog_api_client.v2.model.on_call_phone_notification_rule_settings import OnCallPhoneNotificationRuleSettings
+from datadog_api_client.v2.model.on_call_trigger import OnCallTrigger
+from datadog_api_client.v2.model.on_call_trigger_wrapper import OnCallTriggerWrapper
 from datadog_api_client.v2.model.on_demand_concurrency_cap import OnDemandConcurrencyCap
 from datadog_api_client.v2.model.on_demand_concurrency_cap_attributes import OnDemandConcurrencyCapAttributes
 from datadog_api_client.v2.model.on_demand_concurrency_cap_response import OnDemandConcurrencyCapResponse
@@ -8256,6 +8258,8 @@
     "OnCallPageTargetType",
     "OnCallPhoneNotificationRuleMethod",
     "OnCallPhoneNotificationRuleSettings",
+    "OnCallTrigger",
+    "OnCallTriggerWrapper",
     "OnDemandConcurrencyCap",
     "OnDemandConcurrencyCapAttributes",
     "OnDemandConcurrencyCapResponse",