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

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:28.634789",
-            "spec_repo_commit": "ab6a0f8c"
+            "regenerated": "2025-04-24 13:38:36.780020",
+            "spec_repo_commit": "4295fd1a"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-04-24 04:43:28.650597",
-            "spec_repo_commit": "ab6a0f8c"
+            "regenerated": "2025-04-24 13:38:36.795313",
+            "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.rs

@@ -1,4 +1,4 @@
-// Create on call escalation policy returns "Created" response
+// Create on-call escalation policy returns "Created" response
 use datadog_api_client::datadog;
 use datadog_api_client::datadogV2::api_on_call::CreateOnCallEscalationPolicyOptionalParams;
 use datadog_api_client::datadogV2::api_on_call::OnCallAPI;

examples/v2_on-call_CreateOnCallSchedule.rs

@@ -28,66 +28,65 @@ async fn main() {
     let dd_team_data_id = std::env::var("DD_TEAM_DATA_ID").unwrap();
     let body =
         ScheduleCreateRequest::new(
-            ScheduleCreateRequestData::new(ScheduleCreateRequestDataType::SCHEDULES)
-                .attributes(
-                    ScheduleCreateRequestDataAttributes::new(
-                        vec![
-                            ScheduleCreateRequestDataAttributesLayersItems::new(
-                                DateTime::parse_from_rfc3339("2021-11-01T11:11:11+00:00")
+            ScheduleCreateRequestData::new(
+                ScheduleCreateRequestDataAttributes::new(
+                    vec![
+                        ScheduleCreateRequestDataAttributesLayersItems::new(
+                            DateTime::parse_from_rfc3339("2021-11-01T11:11:11+00:00")
+                                .expect("Failed to parse datetime")
+                                .with_timezone(&Utc),
+                            ScheduleCreateRequestDataAttributesLayersItemsInterval::new().days(1),
+                            vec![
+                                ScheduleCreateRequestDataAttributesLayersItemsMembersItems
+                                ::new().user(
+                                    ScheduleCreateRequestDataAttributesLayersItemsMembersItemsUser
+                                    ::new().id(user_data_id.clone()),
+                                )
+                            ],
+                            "Layer 1".to_string(),
+                            DateTime::parse_from_rfc3339("2021-11-06T11:11:11+00:00")
+                                .expect("Failed to parse datetime")
+                                .with_timezone(&Utc),
+                        )
+                            .end_date(
+                                DateTime::parse_from_rfc3339("2021-11-21T11:11:11+00:00")
                                     .expect("Failed to parse datetime")
                                     .with_timezone(&Utc),
-                                ScheduleCreateRequestDataAttributesLayersItemsInterval::new().days(1),
+                            )
+                            .restrictions(
                                 vec![
-                                    ScheduleCreateRequestDataAttributesLayersItemsMembersItems
-                                    ::new().user(
-                                        ScheduleCreateRequestDataAttributesLayersItemsMembersItemsUser
-                                        ::new().id(user_data_id.clone()),
-                                    )
+                                    ScheduleCreateRequestDataAttributesLayersItemsRestrictionsItems::new()
+                                        .end_day(
+                                            ScheduleCreateRequestDataAttributesLayersItemsRestrictionsItemsEndDay
+                                            ::FRIDAY,
+                                        )
+                                        .end_time("17:00:00".to_string())
+                                        .start_day(
+                                            ScheduleCreateRequestDataAttributesLayersItemsRestrictionsItemsStartDay
+                                            ::MONDAY,
+                                        )
+                                        .start_time("09:00:00".to_string())
                                 ],
-                                "Layer 1".to_string(),
-                                DateTime::parse_from_rfc3339("2021-11-06T11:11:11+00:00")
-                                    .expect("Failed to parse datetime")
-                                    .with_timezone(&Utc),
                             )
-                                .end_date(
-                                    DateTime::parse_from_rfc3339("2021-11-21T11:11:11+00:00")
-                                        .expect("Failed to parse datetime")
-                                        .with_timezone(&Utc),
-                                )
-                                .restrictions(
-                                    vec![
-                                        ScheduleCreateRequestDataAttributesLayersItemsRestrictionsItems::new()
-                                            .end_day(
-                                                ScheduleCreateRequestDataAttributesLayersItemsRestrictionsItemsEndDay
-                                                ::FRIDAY,
-                                            )
-                                            .end_time("17:00:00".to_string())
-                                            .start_day(
-                                                ScheduleCreateRequestDataAttributesLayersItemsRestrictionsItemsStartDay
-                                                ::MONDAY,
-                                            )
-                                            .start_time("09:00:00".to_string())
-                                    ],
-                                )
+                    ],
+                    "Example-On-Call".to_string(),
+                    "America/New_York".to_string(),
+                ).tags(vec!["tag1".to_string(), "tag2".to_string()]),
+                ScheduleCreateRequestDataType::SCHEDULES,
+            ).relationships(
+                ScheduleCreateRequestDataRelationships
+                ::new().teams(
+                    ScheduleCreateRequestDataRelationshipsTeams
+                    ::new().data(
+                        vec![
+                            ScheduleCreateRequestDataRelationshipsTeamsDataItems::new(
+                                dd_team_data_id.clone(),
+                                ScheduleCreateRequestDataRelationshipsTeamsDataItemsType::TEAMS,
+                            )
                         ],
-                        "Example-On-Call".to_string(),
-                        "America/New_York".to_string(),
-                    ).tags(vec!["tag1".to_string(), "tag2".to_string()]),
-                )
-                .relationships(
-                    ScheduleCreateRequestDataRelationships
-                    ::new().teams(
-                        ScheduleCreateRequestDataRelationshipsTeams
-                        ::new().data(
-                            vec![
-                                ScheduleCreateRequestDataRelationshipsTeamsDataItems::new(
-                                    dd_team_data_id.clone(),
-                                    ScheduleCreateRequestDataRelationshipsTeamsDataItemsType::TEAMS,
-                                )
-                            ],
-                        ),
                     ),
                 ),
+            ),
         );
     let configuration = datadog::Configuration::new();
     let api = OnCallAPI::with_config(configuration);

examples/v2_on-call_DeleteOnCallEscalationPolicy.rs

@@ -1,4 +1,4 @@
-// Delete on call escalation policy returns "No Content" response
+// Delete on-call escalation policy returns "No Content" response
 use datadog_api_client::datadog;
 use datadog_api_client::datadogV2::api_on_call::OnCallAPI;
 

examples/v2_on-call_GetOnCallEscalationPolicy.rs

@@ -1,4 +1,4 @@
-// Get on call escalation policy returns "OK" response
+// Get on-call escalation policy returns "OK" response
 use datadog_api_client::datadog;
 use datadog_api_client::datadogV2::api_on_call::GetOnCallEscalationPolicyOptionalParams;
 use datadog_api_client::datadogV2::api_on_call::OnCallAPI;

examples/v2_on-call_UpdateOnCallEscalationPolicy.rs

@@ -1,4 +1,4 @@
-// Update on call escalation policy returns "OK" response
+// Update on-call escalation policy returns "OK" response
 use datadog_api_client::datadog;
 use datadog_api_client::datadogV2::api_on_call::OnCallAPI;
 use datadog_api_client::datadogV2::api_on_call::UpdateOnCallEscalationPolicyOptionalParams;

src/datadogV2/model/model_schedule_create_request_data.rs

@@ -13,7 +13,7 @@ use std::fmt::{self, Formatter};
 pub struct ScheduleCreateRequestData {
     /// Describes the main attributes for creating a new schedule, including name, layers, time zone, and tags.
     #[serde(rename = "attributes")]
-    pub attributes: Option<crate::datadogV2::model::ScheduleCreateRequestDataAttributes>,
+    pub attributes: crate::datadogV2::model::ScheduleCreateRequestDataAttributes,
     /// Gathers relationship objects for the schedule creation request, including the teams to associate.
     #[serde(rename = "relationships")]
     pub relationships: Option<crate::datadogV2::model::ScheduleCreateRequestDataRelationships>,
@@ -29,25 +29,18 @@ pub struct ScheduleCreateRequestData {
 
 impl ScheduleCreateRequestData {
     pub fn new(
+        attributes: crate::datadogV2::model::ScheduleCreateRequestDataAttributes,
         type_: crate::datadogV2::model::ScheduleCreateRequestDataType,
     ) -> ScheduleCreateRequestData {
         ScheduleCreateRequestData {
-            attributes: None,
+            attributes,
             relationships: None,
             type_,
             additional_properties: std::collections::BTreeMap::new(),
             _unparsed: false,
         }
     }
 
-    pub fn attributes(
-        mut self,
-        value: crate::datadogV2::model::ScheduleCreateRequestDataAttributes,
-    ) -> Self {
-        self.attributes = Some(value);
-        self
-    }
-
     pub fn relationships(
         mut self,
         value: crate::datadogV2::model::ScheduleCreateRequestDataRelationships,
@@ -99,9 +92,6 @@ impl<'de> Deserialize<'de> for ScheduleCreateRequestData {
                 while let Some((k, v)) = map.next_entry::<String, serde_json::Value>()? {
                     match k.as_str() {
                         "attributes" => {
-                            if v.is_null() {
-                                continue;
-                            }
                             attributes = Some(serde_json::from_value(v).map_err(M::Error::custom)?);
                         }
                         "relationships" => {
@@ -129,6 +119,7 @@ impl<'de> Deserialize<'de> for ScheduleCreateRequestData {
                         }
                     }
                 }
+                let attributes = attributes.ok_or_else(|| M::Error::missing_field("attributes"))?;
                 let type_ = type_.ok_or_else(|| M::Error::missing_field("type_"))?;
 
                 let content = ScheduleCreateRequestData {

tests/scenarios/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