Update On-Call Escalation policies endpoints schemas and description (#2353)

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-04-24 04:43:27.330024",
-            "spec_repo_commit": "ab6a0f8c"
+            "regenerated": "2025-04-24 13:38:29.822501",
+            "spec_repo_commit": "4295fd1a"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-04-24 04:43:27.348734",
-            "spec_repo_commit": "ab6a0f8c"
+            "regenerated": "2025-04-24 13:38:29.838645",
+            "spec_repo_commit": "4295fd1a"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -13065,6 +13065,7 @@ components:
           $ref: '#/components/schemas/EscalationPolicyDataAttributes'
         id:
           description: Specifies the unique identifier of the escalation policy.
+          example: ab000000-0000-0000-0000-000000000000
           type: string
         relationships:
           $ref: '#/components/schemas/EscalationPolicyDataRelationships'
@@ -28006,6 +28007,7 @@ components:
           $ref: '#/components/schemas/ScheduleCreateRequestDataType'
       required:
       - type
+      - attributes
       type: object
     ScheduleCreateRequestDataAttributes:
       description: Describes the main attributes for creating a new schedule, including
@@ -47481,7 +47483,7 @@ paths:
       - apiKeyAuth: []
         appKeyAuth: []
       - AuthZ: []
-      summary: Create on call escalation policy
+      summary: Create on-call escalation policy
       tags:
       - On-Call
   /api/v2/on-call/escalation-policies/{policy_id}:
@@ -47511,7 +47513,7 @@ paths:
       - apiKeyAuth: []
         appKeyAuth: []
       - AuthZ: []
-      summary: Delete on call escalation policy
+      summary: Delete on-call escalation policy
       tags:
       - On-Call
     get:
@@ -47552,7 +47554,7 @@ paths:
       - apiKeyAuth: []
         appKeyAuth: []
       - AuthZ: []
-      summary: Get on call escalation policy
+      summary: Get on-call escalation policy
       tags:
       - On-Call
     put:
@@ -47599,7 +47601,7 @@ paths:
       - apiKeyAuth: []
         appKeyAuth: []
       - AuthZ: []
-      summary: Update on call escalation policy
+      summary: Update on-call escalation policy
       tags:
       - On-Call
   /api/v2/on-call/schedules:

examples/v2/on-call/CreateOnCallEscalationPolicy.rb

@@ -1,4 +1,4 @@
-# Create on call escalation policy returns "Created" response
+# Create on-call escalation policy returns "Created" response
 
 require "datadog_api_client"
 api_instance = DatadogAPIClient::V2::On - CallAPI.new

examples/v2/on-call/DeleteOnCallEscalationPolicy.rb

@@ -1,4 +1,4 @@
-# Delete on call escalation policy returns "No Content" response
+# Delete on-call escalation policy returns "No Content" response
 
 require "datadog_api_client"
 api_instance = DatadogAPIClient::V2::On - CallAPI.new

examples/v2/on-call/GetOnCallEscalationPolicy.rb

@@ -1,4 +1,4 @@
-# Get on call escalation policy returns "OK" response
+# Get on-call escalation policy returns "OK" response
 
 require "datadog_api_client"
 api_instance = DatadogAPIClient::V2::On - CallAPI.new

examples/v2/on-call/UpdateOnCallEscalationPolicy.rb

@@ -1,4 +1,4 @@
-# Update on call escalation policy returns "OK" response
+# Update on-call escalation policy returns "OK" response
 
 require "datadog_api_client"
 api_instance = DatadogAPIClient::V2::On - CallAPI.new

features/v2/on-call.feature

@@ -10,14 +10,14 @@ Feature: On-Call
     And an instance of "On-Call" API
 
   @generated @skip @team:DataDog/bugle
-  Scenario: Create on call escalation policy returns "Bad Request" response
+  Scenario: Create on-call escalation policy returns "Bad Request" response
     Given new "CreateOnCallEscalationPolicy" request
     And body with value {"data": {"attributes": {"description": "Escalation Policy 1 description", "name": "Escalation Policy 1", "resolve_page_on_policy_end": true, "retries": 2, "steps": [{"assignment": "default", "escalate_after_seconds": 3600, "targets": [{"id": "00000000-aba1-0000-0000-000000000000", "type": "users"}, {"id": "00000000-aba2-0000-0000-000000000000", "type": "schedules"}, {"id": "00000000-aba3-0000-0000-000000000000", "type": "teams"}]}, {"assignment": "round-robin", "escalate_after_seconds": 3600, "targets": [{"id": "00000000-aba1-0000-0000-000000000000", "type": "users"}, {"id": "00000000-abb1-0000-0000-000000000000", "type": "users"}]}]}, "relationships": {"teams": {"data": [{"id": "00000000-da3a-0000-0000-000000000000", "type": "teams"}]}}, "type": "policies"}}
     When the request is sent
     Then the response status is 400 Bad Request
 
   @team:DataDog/bugle
-  Scenario: Create on call escalation policy returns "Created" response
+  Scenario: Create on-call escalation policy returns "Created" response
     Given new "CreateOnCallEscalationPolicy" request
     And there is a valid "schedule" in the system
     And there is a valid "dd_team" in the system
@@ -43,7 +43,7 @@ Feature: On-Call
     Then the response status is 201 Created
 
   @team:DataDog/bugle
-  Scenario: Delete on call escalation policy returns "No Content" response
+  Scenario: Delete on-call escalation policy returns "No Content" response
     Given new "DeleteOnCallEscalationPolicy" request
     And there is a valid "user" in the system
     And there is a valid "dd_team" in the system
@@ -54,7 +54,7 @@ Feature: On-Call
     Then the response status is 204 No Content
 
   @generated @skip @team:DataDog/bugle
-  Scenario: Delete on call escalation policy returns "Not Found" response
+  Scenario: Delete on-call escalation policy returns "Not Found" response
     Given new "DeleteOnCallEscalationPolicy" request
     And request contains "policy_id" parameter from "REPLACE.ME"
     When the request is sent
@@ -76,21 +76,21 @@ Feature: On-Call
     Then the response status is 404 Not Found
 
   @generated @skip @team:DataDog/bugle
-  Scenario: Get on call escalation policy returns "Bad Request" response
+  Scenario: Get on-call escalation policy returns "Bad Request" response
     Given new "GetOnCallEscalationPolicy" request
     And request contains "policy_id" parameter from "REPLACE.ME"
     When the request is sent
     Then the response status is 400 Bad Request
 
   @generated @skip @team:DataDog/bugle
-  Scenario: Get on call escalation policy returns "Not Found" response
+  Scenario: Get on-call escalation policy returns "Not Found" response
     Given new "GetOnCallEscalationPolicy" request
     And request contains "policy_id" parameter from "REPLACE.ME"
     When the request is sent
     Then the response status is 404 Not Found
 
   @team:DataDog/bugle
-  Scenario: Get on call escalation policy returns "OK" response
+  Scenario: Get on-call escalation policy returns "OK" response
     Given new "GetOnCallEscalationPolicy" request
     And there is a valid "user" in the system
     And there is a valid "dd_team" in the system
@@ -116,23 +116,23 @@ Feature: On-Call
     Then the response status is 200 OK
 
   @generated @skip @team:DataDog/bugle
-  Scenario: Update on call escalation policy returns "Bad Request" response
+  Scenario: Update on-call escalation policy returns "Bad Request" response
     Given new "UpdateOnCallEscalationPolicy" request
     And request contains "policy_id" parameter from "REPLACE.ME"
     And body with value {"data": {"attributes": {"description": "Escalation Policy 1 description", "name": "Escalation Policy 1", "resolve_page_on_policy_end": false, "retries": 2, "steps": [{"assignment": "default", "escalate_after_seconds": 3600, "id": "00000000-aba1-0000-0000-000000000000", "targets": [{"id": "00000000-aba1-0000-0000-000000000000", "type": "users"}, {"id": "00000000-aba2-0000-0000-000000000000", "type": "schedules"}]}]}, "id": "a3000000-0000-0000-0000-000000000000", "relationships": {"teams": {"data": [{"id": "00000000-da3a-0000-0000-000000000000", "type": "teams"}]}}, "type": "policies"}}
     When the request is sent
     Then the response status is 400 Bad Request
 
   @generated @skip @team:DataDog/bugle
-  Scenario: Update on call escalation policy returns "Not Found" response
+  Scenario: Update on-call escalation policy returns "Not Found" response
     Given new "UpdateOnCallEscalationPolicy" request
     And request contains "policy_id" parameter from "REPLACE.ME"
     And body with value {"data": {"attributes": {"description": "Escalation Policy 1 description", "name": "Escalation Policy 1", "resolve_page_on_policy_end": false, "retries": 2, "steps": [{"assignment": "default", "escalate_after_seconds": 3600, "id": "00000000-aba1-0000-0000-000000000000", "targets": [{"id": "00000000-aba1-0000-0000-000000000000", "type": "users"}, {"id": "00000000-aba2-0000-0000-000000000000", "type": "schedules"}]}]}, "id": "a3000000-0000-0000-0000-000000000000", "relationships": {"teams": {"data": [{"id": "00000000-da3a-0000-0000-000000000000", "type": "teams"}]}}, "type": "policies"}}
     When the request is sent
     Then the response status is 404 Not Found
 
   @team:DataDog/bugle
-  Scenario: Update on call escalation policy returns "OK" response
+  Scenario: Update on-call escalation policy returns "OK" response
     Given new "UpdateOnCallEscalationPolicy" request
     And there is a valid "user" in the system
     And there is a valid "dd_team" in the system

lib/datadog_api_client/v2/api/on_call_api.rb

@@ -23,15 +23,15 @@ def initialize(api_client = DatadogAPIClient::APIClient.default)
       @api_client = api_client
     end
 
-    # Create on call escalation policy.
+    # Create on-call escalation policy.
     #
     # @see #create_on_call_escalation_policy_with_http_info
     def create_on_call_escalation_policy(body, opts = {})
       data, _status_code, _headers = create_on_call_escalation_policy_with_http_info(body, opts)
       data
     end
 
-    # Create on call escalation policy.
+    # Create on-call escalation policy.
     #
     # Create a new on-call escalation policy
     #
@@ -161,15 +161,15 @@ def create_on_call_schedule_with_http_info(body, opts = {})
       return data, status_code, headers
     end
 
-    # Delete on call escalation policy.
+    # Delete on-call escalation policy.
     #
     # @see #delete_on_call_escalation_policy_with_http_info
     def delete_on_call_escalation_policy(policy_id, opts = {})
       delete_on_call_escalation_policy_with_http_info(policy_id, opts)
       nil
     end
 
-    # Delete on call escalation policy.
+    # Delete on-call escalation policy.
     #
     # Delete an on-call escalation policy
     #
@@ -291,15 +291,15 @@ def delete_on_call_schedule_with_http_info(schedule_id, opts = {})
       return data, status_code, headers
     end
 
-    # Get on call escalation policy.
+    # Get on-call escalation policy.
     #
     # @see #get_on_call_escalation_policy_with_http_info
     def get_on_call_escalation_policy(policy_id, opts = {})
       data, _status_code, _headers = get_on_call_escalation_policy_with_http_info(policy_id, opts)
       data
     end
 
-    # Get on call escalation policy.
+    # Get on-call escalation policy.
     #
     # Get an on-call escalation policy
     #
@@ -425,15 +425,15 @@ def get_on_call_schedule_with_http_info(schedule_id, opts = {})
       return data, status_code, headers
     end
 
-    # Update on call escalation policy.
+    # Update on-call escalation policy.
     #
     # @see #update_on_call_escalation_policy_with_http_info
     def update_on_call_escalation_policy(policy_id, body, opts = {})
       data, _status_code, _headers = update_on_call_escalation_policy_with_http_info(policy_id, body, opts)
       data
     end
 
-    # Update on call escalation policy.
+    # Update on-call escalation policy.
     #
     # Update an on-call escalation policy
     #

lib/datadog_api_client/v2/models/schedule_create_request_data.rb

@@ -22,7 +22,7 @@ class ScheduleCreateRequestData
     include BaseGenericModel
 
     # Describes the main attributes for creating a new schedule, including name, layers, time zone, and tags.
-    attr_accessor :attributes
+    attr_reader :attributes
 
     # Gathers relationship objects for the schedule creation request, including the teams to associate.
     attr_accessor :relationships
@@ -87,10 +87,21 @@ def initialize(attributes = {})
     # @return true if the model is valid
     # @!visibility private
     def valid?
+      return false if @attributes.nil?
       return false if @type.nil?
       true
     end
 
+    # Custom attribute writer method with validation
+    # @param attributes [Object] Object to be assigned
+    # @!visibility private
+    def attributes=(attributes)
+      if attributes.nil?
+        fail ArgumentError, 'invalid value for "attributes", attributes cannot be nil.'
+      end
+      @attributes = attributes
+    end
+
     # Custom attribute writer method with validation
     # @param type [Object] Object to be assigned
     # @!visibility private