[Workflow Automation] Clarify and Constrain Workflow Spec Fields

.generator/schemas/v2/openapi.yaml

@@ -20436,6 +20436,7 @@ components:
         - times
       type: object
     CompletionCondition:
+      additionalProperties: false
       description: The definition of `CompletionCondition` object.
       properties:
         operand1:
@@ -20479,6 +20480,7 @@ components:
         - OPERATOR_IS_EMPTY
         - OPERATOR_IS_NOT_EMPTY
     CompletionGate:
+      additionalProperties: false
       description: Used to create conditions before running subsequent actions.
       properties:
         completionCondition:
@@ -35926,6 +35928,7 @@ components:
           type: integer
       type: object
     ErrorHandler:
+      additionalProperties: false
       description: Used to handle errors in an action.
       properties:
         fallbackStepName:
@@ -51711,6 +51714,7 @@ components:
         name:
           description: The `InputSchemaParameters` `name`.
           example: ""
+          minLength: 1
           type: string
         type:
           $ref: "#/components/schemas/InputSchemaParametersType"
@@ -78296,11 +78300,13 @@ components:
       properties:
         branchName:
           description: The `OutboundEdge` `branchName`.
-          example: ""
+          example: main
+          minLength: 1
           type: string
         nextStepName:
           description: The `OutboundEdge` `nextStepName`.
-          example: ""
+          example: Step2
+          minLength: 1
           type: string
       required:
         - nextStepName
@@ -79450,6 +79456,7 @@ components:
         name:
           description: The `Parameter` `name`.
           example: ""
+          minLength: 1
           type: string
         value:
           description: The `Parameter` `value`.
@@ -84683,6 +84690,7 @@ components:
         - attributes
       type: object
     ReadinessGate:
+      additionalProperties: false
       description: Used to merge multiple branches into a single branch.
       properties:
         thresholdType:
@@ -87164,6 +87172,7 @@ components:
         - data
       type: object
     RetryStrategy:
+      additionalProperties: false
       description: The definition of `RetryStrategy` object.
       properties:
         kind:
@@ -87172,6 +87181,7 @@ components:
           $ref: "#/components/schemas/RetryStrategyLinear"
       required:
         - kind
+        - linear
       type: object
     RetryStrategyKind:
       description: The definition of `RetryStrategyKind` object.
@@ -87182,17 +87192,21 @@ components:
       x-enum-varnames:
         - RETRY_STRATEGY_LINEAR
     RetryStrategyLinear:
+      additionalProperties: false
       description: The definition of `RetryStrategyLinear` object.
       properties:
         interval:
           description: The `RetryStrategyLinear` `interval`. The expected format is the number of seconds ending with an s. For example, 1 day is 86400s
           example: ""
+          pattern: ^[1-9][0-9]*s$
           type: string
         maxRetries:
           description: The `RetryStrategyLinear` `maxRetries`.
-          example: 0.0
-          format: double
-          type: number
+          example: 0
+          format: int32
+          maximum: 2147483647
+          minimum: 0
+          type: integer
       required:
         - interval
         - maxRetries
@@ -103899,7 +103913,7 @@ components:
           type: string
       type: object
     Spec:
-      description: The spec defines what the workflow does.
+      description: A complete Workflow Automation definition, including its triggers, steps, and connections.
       properties:
         annotations:
           description: "A list of annotations used in the workflow. These are like sticky notes for your workflow!"
@@ -104017,11 +104031,12 @@ components:
         - type
       type: object
     StartStepNames:
-      description: "A list of steps that run first after a trigger fires."
+      description: "Names of existing workflow steps that run first after a trigger fires."
       example:
         - ""
       items:
         description: The `StartStepNames` `items`.
+        minLength: 1
         type: string
       type: array
     State:
@@ -105297,6 +105312,7 @@ components:
         actionId:
           description: The unique identifier of an action.
           example: ""
+          minLength: 1
           type: string
         completionGate:
           $ref: "#/components/schemas/CompletionGate"
@@ -105313,9 +105329,10 @@ components:
         name:
           description: Name of the step.
           example: ""
+          minLength: 1
           type: string
         outboundEdges:
-          description: A list of subsequent actions to run.
+          description: A list of subsequent actions to run. This list is empty for a terminal step.
           items:
             $ref: "#/components/schemas/OutboundEdge"
           type: array
@@ -105331,7 +105348,9 @@ components:
         - actionId
       type: object
     StepDisplay:
-      description: The definition of `StepDisplay` object.
+      description: |-
+        The position of a step on the workflow canvas. Omit `display` from every step to use
+        automatic layout, or provide it for every step to preserve a manual layout.
       properties:
         bounds:
           $ref: "#/components/schemas/StepDisplayBounds"
@@ -119084,7 +119103,7 @@ components:
         startStepNames:
           $ref: "#/components/schemas/StartStepNames"
         workflowTrigger:
-          description: "Trigger a workflow from the Datadog UI. Only required if no other trigger exists."
+          description: "Trigger a workflow from the Datadog UI. When present, this must be the workflow's only trigger."
           type: object
       required:
         - workflowTrigger

src/datadog_api_client/v2/model/api_trigger_wrapper.py

@@ -39,7 +39,7 @@ def __init__(self_, api_trigger: APITrigger, start_step_names: Union[List[str],
         :param api_trigger: Trigger a workflow from an API request. The workflow must be published.
         :type api_trigger: APITrigger
 
-        :param start_step_names: A list of steps that run first after a trigger fires.
+        :param start_step_names: Names of existing workflow steps that run first after a trigger fires.
         :type start_step_names: [str], optional
         """
         if start_step_names is not unset:

src/datadog_api_client/v2/model/app_trigger_wrapper.py

@@ -33,7 +33,7 @@ def __init__(self_, app_trigger: dict, start_step_names: Union[List[str], UnsetT
         :param app_trigger: Trigger a workflow from an App.
         :type app_trigger: dict
 
-        :param start_step_names: A list of steps that run first after a trigger fires.
+        :param start_step_names: Names of existing workflow steps that run first after a trigger fires.
         :type start_step_names: [str], optional
         """
         if start_step_names is not unset:

src/datadog_api_client/v2/model/case_trigger_wrapper.py

@@ -39,7 +39,7 @@ def __init__(self_, case_trigger: CaseTrigger, start_step_names: Union[List[str]
         :param case_trigger: Trigger a workflow from a Case. For automatic triggering a handle must be configured and the workflow must be published.
         :type case_trigger: CaseTrigger
 
-        :param start_step_names: A list of steps that run first after a trigger fires.
+        :param start_step_names: Names of existing workflow steps that run first after a trigger fires.
         :type start_step_names: [str], optional
         """
         if start_step_names is not unset:

src/datadog_api_client/v2/model/change_event_trigger_wrapper.py

@@ -33,7 +33,7 @@ def __init__(self_, change_event_trigger: dict, start_step_names: Union[List[str
         :param change_event_trigger: Trigger a workflow from a Change Event.
         :type change_event_trigger: dict
 
-        :param start_step_names: A list of steps that run first after a trigger fires.
+        :param start_step_names: Names of existing workflow steps that run first after a trigger fires.
         :type start_step_names: [str], optional
         """
         if start_step_names is not unset:

src/datadog_api_client/v2/model/completion_condition.py

@@ -22,6 +22,10 @@
 
 
 class CompletionCondition(ModelNormal):
+    @cached_property
+    def additional_properties_type(_):
+        return None
+
     @cached_property
     def openapi_types(_):
         from datadog_api_client.v2.model.completion_condition_operator import CompletionConditionOperator

src/datadog_api_client/v2/model/completion_gate.py

@@ -17,6 +17,10 @@
 
 
 class CompletionGate(ModelNormal):
+    @cached_property
+    def additional_properties_type(_):
+        return None
+
     @cached_property
     def openapi_types(_):
         from datadog_api_client.v2.model.completion_condition import CompletionCondition

src/datadog_api_client/v2/model/dashboard_trigger_wrapper.py

@@ -33,7 +33,7 @@ def __init__(self_, dashboard_trigger: dict, start_step_names: Union[List[str],
         :param dashboard_trigger: Trigger a workflow from a Dashboard.
         :type dashboard_trigger: dict
 
-        :param start_step_names: A list of steps that run first after a trigger fires.
+        :param start_step_names: Names of existing workflow steps that run first after a trigger fires.
         :type start_step_names: [str], optional
         """
         if start_step_names is not unset:

src/datadog_api_client/v2/model/database_monitoring_trigger_wrapper.py

@@ -35,7 +35,7 @@ def __init__(
         :param database_monitoring_trigger: Trigger a workflow from Database Monitoring.
         :type database_monitoring_trigger: dict
 
-        :param start_step_names: A list of steps that run first after a trigger fires.
+        :param start_step_names: Names of existing workflow steps that run first after a trigger fires.
         :type start_step_names: [str], optional
         """
         if start_step_names is not unset:

src/datadog_api_client/v2/model/datastore_trigger_wrapper.py

@@ -41,7 +41,7 @@ def __init__(
         :param datastore_trigger: Trigger a workflow from a Datastore. For automatic triggering a handle must be configured and the workflow must be published.
         :type datastore_trigger: DatastoreTrigger
 
-        :param start_step_names: A list of steps that run first after a trigger fires.
+        :param start_step_names: Names of existing workflow steps that run first after a trigger fires.
         :type start_step_names: [str], optional
         """
         if start_step_names is not unset:

src/datadog_api_client/v2/model/error_handler.py

@@ -16,6 +16,10 @@
 
 
 class ErrorHandler(ModelNormal):
+    @cached_property
+    def additional_properties_type(_):
+        return None
+
     @cached_property
     def openapi_types(_):
         from datadog_api_client.v2.model.retry_strategy import RetryStrategy

src/datadog_api_client/v2/model/form_trigger_wrapper.py

@@ -39,7 +39,7 @@ def __init__(self_, form_trigger: FormTrigger, start_step_names: Union[List[str]
         :param form_trigger: Trigger a workflow from a Form.
         :type form_trigger: FormTrigger
 
-        :param start_step_names: A list of steps that run first after a trigger fires.
+        :param start_step_names: Names of existing workflow steps that run first after a trigger fires.
         :type start_step_names: [str], optional
         """
         if start_step_names is not unset:

src/datadog_api_client/v2/model/github_webhook_trigger_wrapper.py

@@ -44,7 +44,7 @@ def __init__(
         :param github_webhook_trigger: Trigger a workflow from a GitHub webhook. To trigger a workflow from GitHub, you must set a ``webhookSecret``. In your GitHub Webhook Settings, set the Payload URL to "base_url"/api/v2/workflows/"workflow_id"/webhook?orgId="org_id", select application/json for the content type, and be highly recommend enabling SSL verification for security. The workflow must be published.
         :type github_webhook_trigger: GithubWebhookTrigger
 
-        :param start_step_names: A list of steps that run first after a trigger fires.
+        :param start_step_names: Names of existing workflow steps that run first after a trigger fires.
         :type start_step_names: [str], optional
         """
         if start_step_names is not unset:

src/datadog_api_client/v2/model/incident_trigger_wrapper.py

@@ -41,7 +41,7 @@ def __init__(
         :param incident_trigger: Trigger a workflow from an Incident. For automatic triggering a handle must be configured and the workflow must be published.
         :type incident_trigger: IncidentTrigger
 
-        :param start_step_names: A list of steps that run first after a trigger fires.
+        :param start_step_names: Names of existing workflow steps that run first after a trigger fires.
         :type start_step_names: [str], optional
         """
         if start_step_names is not unset:

src/datadog_api_client/v2/model/input_schema_parameters.py

@@ -22,6 +22,12 @@
 
 
 class InputSchemaParameters(ModelNormal):
+    validations = {
+        "name": {
+            "min_length": 1,
+        },
+    }
+
     @cached_property
     def openapi_types(_):
         from datadog_api_client.v2.model.input_schema_parameters_type import InputSchemaParametersType

src/datadog_api_client/v2/model/monitor_trigger_wrapper.py

@@ -41,7 +41,7 @@ def __init__(
         :param monitor_trigger: Trigger a workflow from a Monitor. For automatic triggering a handle must be configured and the workflow must be published.
         :type monitor_trigger: MonitorTrigger
 
-        :param start_step_names: A list of steps that run first after a trigger fires.
+        :param start_step_names: Names of existing workflow steps that run first after a trigger fires.
         :type start_step_names: [str], optional
         """
         if start_step_names is not unset:

src/datadog_api_client/v2/model/notebook_trigger_wrapper.py

@@ -33,7 +33,7 @@ def __init__(self_, notebook_trigger: dict, start_step_names: Union[List[str], U
         :param notebook_trigger: Trigger a workflow from a Notebook.
         :type notebook_trigger: dict
 
-        :param start_step_names: A list of steps that run first after a trigger fires.
+        :param start_step_names: Names of existing workflow steps that run first after a trigger fires.
         :type start_step_names: [str], optional
         """
         if start_step_names is not unset:

src/datadog_api_client/v2/model/on_call_trigger_wrapper.py

@@ -41,7 +41,7 @@ def __init__(
         :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.
+        :param start_step_names: Names of existing workflow steps that run first after a trigger fires.
         :type start_step_names: [str], optional
         """
         if start_step_names is not unset:

src/datadog_api_client/v2/model/outbound_edge.py

@@ -11,6 +11,15 @@
 
 
 class OutboundEdge(ModelNormal):
+    validations = {
+        "branch_name": {
+            "min_length": 1,
+        },
+        "next_step_name": {
+            "min_length": 1,
+        },
+    }
+
     @cached_property
     def openapi_types(_):
         return {

src/datadog_api_client/v2/model/parameter.py

@@ -16,6 +16,12 @@
 
 
 class Parameter(ModelNormal):
+    validations = {
+        "name": {
+            "min_length": 1,
+        },
+    }
+
     @cached_property
     def openapi_types(_):
         return {

src/datadog_api_client/v2/model/readiness_gate.py

@@ -16,6 +16,10 @@
 
 
 class ReadinessGate(ModelNormal):
+    @cached_property
+    def additional_properties_type(_):
+        return None
+
     @cached_property
     def openapi_types(_):
         from datadog_api_client.v2.model.readiness_gate_threshold_type import ReadinessGateThresholdType