Adds async Scorecard outcomes batch update endpoint (#844)

Co-authored-by: ci.datadog-api-spec <[email protected]>

Author: api-clients-generation-pipeline[bot]

.generated-info

@@ -1,4 +1,4 @@
 {
-  "spec_repo_commit": "62a19e4",
-  "generated": "2025-08-27 15:06:21.847"
+  "spec_repo_commit": "6d9663b",
+  "generated": "2025-08-27 16:43:08.416"
 }

.generator/schemas/v2/openapi.yaml

@@ -14485,6 +14485,10 @@ components:
       description: Entity definition in raw JSON or YAML representation.
       example: "apiVersion: v3\nkind: service\nmetadata:\n  name: myservice\n"
       type: string
+    EntityReference:
+      description: The unique reference for an IDP entity.
+      example: service:my-service
+      type: string
     EntityRelationships:
       description: Entity relationships.
       properties:
@@ -34444,6 +34448,8 @@ components:
           description: If enabled, the rule is calculated as part of the score.
           example: true
           type: boolean
+        level:
+          $ref: '#/components/schemas/RuleLevel'
         modified_at:
           description: Time of the last rule outcome modification.
           format: date-time
@@ -34464,6 +34470,13 @@ components:
       description: The unique ID for a scorecard rule.
       example: q8MQxk8TCqrHnWkx
       type: string
+    RuleLevel:
+      description: The maturity level of the rule (1, 2, or 3).
+      example: 2
+      format: int32
+      maximum: 3
+      minimum: 1
+      type: integer
     RuleName:
       description: Name of the notification rule.
       example: Rule 1
@@ -43835,6 +43848,57 @@ components:
         id:
           $ref: '#/components/schemas/ApiID'
       type: object
+    UpdateOutcomesAsyncAttributes:
+      description: The JSON:API attributes for a batched set of scorecard outcomes.
+      properties:
+        results:
+          description: Set of scorecard outcomes to update asynchronously.
+          items:
+            $ref: '#/components/schemas/UpdateOutcomesAsyncRequestItem'
+          type: array
+      type: object
+    UpdateOutcomesAsyncRequest:
+      description: Scorecard outcomes batch request.
+      properties:
+        data:
+          $ref: '#/components/schemas/UpdateOutcomesAsyncRequestData'
+      type: object
+    UpdateOutcomesAsyncRequestData:
+      description: Scorecard outcomes batch request data.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/UpdateOutcomesAsyncAttributes'
+        type:
+          $ref: '#/components/schemas/UpdateOutcomesAsyncType'
+      type: object
+    UpdateOutcomesAsyncRequestItem:
+      description: Scorecard outcome for a single entity and rule.
+      properties:
+        entity_reference:
+          $ref: '#/components/schemas/EntityReference'
+        remarks:
+          description: Any remarks regarding the scorecard rule's evaluation. Supports
+            HTML hyperlinks.
+          example: 'See: <a href="https://app.datadoghq.com/services">Services</a>'
+          type: string
+        rule_id:
+          $ref: '#/components/schemas/RuleId'
+        state:
+          $ref: '#/components/schemas/State'
+      required:
+      - rule_id
+      - entity_reference
+      - state
+      type: object
+    UpdateOutcomesAsyncType:
+      default: batched-outcome
+      description: The JSON:API type for scorecard outcomes.
+      enum:
+      - batched-outcome
+      example: batched-outcome
+      type: string
+      x-enum-varnames:
+      - BATCHED_OUTCOME
     UpdateResourceEvaluationFiltersRequest:
       description: Request object to update a resource filter.
       properties:
@@ -61882,6 +61946,39 @@ paths:
         resultsPath: data
       x-unstable: '**Note**: This endpoint is in public beta.
 
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+    post:
+      description: Updates multiple scorecard rule outcomes in a single batched request.
+      operationId: UpdateScorecardOutcomesAsync
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/UpdateOutcomesAsyncRequest'
+        description: Set of scorecard outcomes.
+        required: true
+      responses:
+        '202':
+          description: Accepted
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '409':
+          $ref: '#/components/responses/ConflictResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - apm_service_catalog_write
+      summary: Update Scorecard outcomes asynchronously
+      tags:
+      - Service Scorecards
+      x-codegen-request-body-name: body
+      x-unstable: '**Note**: This endpoint is in public beta.
+
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/scorecard/outcomes/batch:
     post:

examples/v2_service-scorecards_UpdateScorecardOutcomesAsync.rs

@@ -0,0 +1,39 @@
+// Update Scorecard outcomes asynchronously returns "Accepted" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_service_scorecards::ServiceScorecardsAPI;
+use datadog_api_client::datadogV2::model::State;
+use datadog_api_client::datadogV2::model::UpdateOutcomesAsyncAttributes;
+use datadog_api_client::datadogV2::model::UpdateOutcomesAsyncRequest;
+use datadog_api_client::datadogV2::model::UpdateOutcomesAsyncRequestData;
+use datadog_api_client::datadogV2::model::UpdateOutcomesAsyncRequestItem;
+use datadog_api_client::datadogV2::model::UpdateOutcomesAsyncType;
+
+#[tokio::main]
+async fn main() {
+    // there is a valid "create_scorecard_rule" in the system
+    let create_scorecard_rule_data_id = std::env::var("CREATE_SCORECARD_RULE_DATA_ID").unwrap();
+    let body = UpdateOutcomesAsyncRequest::new().data(
+        UpdateOutcomesAsyncRequestData::new()
+            .attributes(UpdateOutcomesAsyncAttributes::new().results(vec![
+                    UpdateOutcomesAsyncRequestItem::new(
+                        "service:my-service".to_string(),
+                        create_scorecard_rule_data_id.clone(),
+                        State::PASS,
+                    )
+                    .remarks(
+                        r#"See: <a href="https://app.datadoghq.com/services">Services</a>"#
+                            .to_string(),
+                    ),
+                ]))
+            .type_(UpdateOutcomesAsyncType::BATCHED_OUTCOME),
+    );
+    let mut configuration = datadog::Configuration::new();
+    configuration.set_unstable_operation_enabled("v2.UpdateScorecardOutcomesAsync", true);
+    let api = ServiceScorecardsAPI::with_config(configuration);
+    let resp = api.update_scorecard_outcomes_async(body).await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

src/datadog/configuration.rs

@@ -201,6 +201,7 @@ impl Default for Configuration {
             ("v2.delete_scorecard_rule".to_owned(), false),
             ("v2.list_scorecard_outcomes".to_owned(), false),
             ("v2.list_scorecard_rules".to_owned(), false),
+            ("v2.update_scorecard_outcomes_async".to_owned(), false),
             ("v2.update_scorecard_rule".to_owned(), false),
             ("v2.create_incident_service".to_owned(), false),
             ("v2.delete_incident_service".to_owned(), false),

src/datadogV2/api/api_service_scorecards.rs

@@ -211,6 +211,14 @@ pub enum ListScorecardRulesError {
     UnknownValue(serde_json::Value),
 }
 
+/// UpdateScorecardOutcomesAsyncError is a struct for typed errors of method [`ServiceScorecardsAPI::update_scorecard_outcomes_async`]
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(untagged)]
+pub enum UpdateScorecardOutcomesAsyncError {
+    APIErrorResponse(crate::datadogV2::model::APIErrorResponse),
+    UnknownValue(serde_json::Value),
+}
+
 /// UpdateScorecardRuleError is a struct for typed errors of method [`ServiceScorecardsAPI::update_scorecard_rule`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
@@ -1117,6 +1125,151 @@ impl ServiceScorecardsAPI {
         }
     }
 
+    /// Updates multiple scorecard rule outcomes in a single batched request.
+    pub async fn update_scorecard_outcomes_async(
+        &self,
+        body: crate::datadogV2::model::UpdateOutcomesAsyncRequest,
+    ) -> Result<(), datadog::Error<UpdateScorecardOutcomesAsyncError>> {
+        match self
+            .update_scorecard_outcomes_async_with_http_info(body)
+            .await
+        {
+            Ok(_) => Ok(()),
+            Err(err) => Err(err),
+        }
+    }
+
+    /// Updates multiple scorecard rule outcomes in a single batched request.
+    pub async fn update_scorecard_outcomes_async_with_http_info(
+        &self,
+        body: crate::datadogV2::model::UpdateOutcomesAsyncRequest,
+    ) -> Result<datadog::ResponseContent<()>, datadog::Error<UpdateScorecardOutcomesAsyncError>>
+    {
+        let local_configuration = &self.config;
+        let operation_id = "v2.update_scorecard_outcomes_async";
+        if local_configuration.is_unstable_operation_enabled(operation_id) {
+            warn!("Using unstable operation {operation_id}");
+        } else {
+            let local_error = datadog::UnstableOperationDisabledError {
+                msg: "Operation 'v2.update_scorecard_outcomes_async' is not enabled".to_string(),
+            };
+            return Err(datadog::Error::UnstableOperationDisabledError(local_error));
+        }
+
+        let local_client = &self.client;
+
+        let local_uri_str = format!(
+            "{}/api/v2/scorecard/outcomes",
+            local_configuration.get_operation_host(operation_id)
+        );
+        let mut local_req_builder =
+            local_client.request(reqwest::Method::POST, local_uri_str.as_str());
+
+        // build headers
+        let mut headers = HeaderMap::new();
+        headers.insert("Content-Type", HeaderValue::from_static("application/json"));
+        headers.insert("Accept", HeaderValue::from_static("*/*"));
+
+        // build user agent
+        match HeaderValue::from_str(local_configuration.user_agent.as_str()) {
+            Ok(user_agent) => headers.insert(reqwest::header::USER_AGENT, user_agent),
+            Err(e) => {
+                log::warn!("Failed to parse user agent header: {e}, falling back to default");
+                headers.insert(
+                    reqwest::header::USER_AGENT,
+                    HeaderValue::from_static(datadog::DEFAULT_USER_AGENT.as_str()),
+                )
+            }
+        };
+
+        // build auth
+        if let Some(local_key) = local_configuration.auth_keys.get("apiKeyAuth") {
+            headers.insert(
+                "DD-API-KEY",
+                HeaderValue::from_str(local_key.key.as_str())
+                    .expect("failed to parse DD-API-KEY header"),
+            );
+        };
+        if let Some(local_key) = local_configuration.auth_keys.get("appKeyAuth") {
+            headers.insert(
+                "DD-APPLICATION-KEY",
+                HeaderValue::from_str(local_key.key.as_str())
+                    .expect("failed to parse DD-APPLICATION-KEY header"),
+            );
+        };
+
+        // build body parameters
+        let output = Vec::new();
+        let mut ser = serde_json::Serializer::with_formatter(output, datadog::DDFormatter);
+        if body.serialize(&mut ser).is_ok() {
+            if let Some(content_encoding) = headers.get("Content-Encoding") {
+                match content_encoding.to_str().unwrap_or_default() {
+                    "gzip" => {
+                        let mut enc = GzEncoder::new(Vec::new(), Compression::default());
+                        let _ = enc.write_all(ser.into_inner().as_slice());
+                        match enc.finish() {
+                            Ok(buf) => {
+                                local_req_builder = local_req_builder.body(buf);
+                            }
+                            Err(e) => return Err(datadog::Error::Io(e)),
+                        }
+                    }
+                    "deflate" => {
+                        let mut enc = ZlibEncoder::new(Vec::new(), Compression::default());
+                        let _ = enc.write_all(ser.into_inner().as_slice());
+                        match enc.finish() {
+                            Ok(buf) => {
+                                local_req_builder = local_req_builder.body(buf);
+                            }
+                            Err(e) => return Err(datadog::Error::Io(e)),
+                        }
+                    }
+                    "zstd1" => {
+                        let mut enc = zstd::stream::Encoder::new(Vec::new(), 0).unwrap();
+                        let _ = enc.write_all(ser.into_inner().as_slice());
+                        match enc.finish() {
+                            Ok(buf) => {
+                                local_req_builder = local_req_builder.body(buf);
+                            }
+                            Err(e) => return Err(datadog::Error::Io(e)),
+                        }
+                    }
+                    _ => {
+                        local_req_builder = local_req_builder.body(ser.into_inner());
+                    }
+                }
+            } else {
+                local_req_builder = local_req_builder.body(ser.into_inner());
+            }
+        }
+
+        local_req_builder = local_req_builder.headers(headers);
+        let local_req = local_req_builder.build()?;
+        log::debug!("request content: {:?}", local_req.body());
+        let local_resp = local_client.execute(local_req).await?;
+
+        let local_status = local_resp.status();
+        let local_content = local_resp.text().await?;
+        log::debug!("response content: {}", local_content);
+
+        if !local_status.is_client_error() && !local_status.is_server_error() {
+            Ok(datadog::ResponseContent {
+                status: local_status,
+                content: local_content,
+                entity: None,
+            })
+        } else {
+            let local_entity: Option<UpdateScorecardOutcomesAsyncError> =
+                serde_json::from_str(&local_content).ok();
+            let local_error = datadog::ResponseContent {
+                status: local_status,
+                content: local_content,
+                entity: local_entity,
+            };
+            Err(datadog::Error::ResponseError(local_error))
+        }
+    }
+
     /// Updates an existing rule.
     pub async fn update_scorecard_rule(
         &self,

src/datadogV2/model/mod.rs

@@ -4514,6 +4514,16 @@ pub mod model_outcomes_response_included_rule_attributes;
 pub use self::model_outcomes_response_included_rule_attributes::OutcomesResponseIncludedRuleAttributes;
 pub mod model_outcomes_response_links;
 pub use self::model_outcomes_response_links::OutcomesResponseLinks;
+pub mod model_update_outcomes_async_request;
+pub use self::model_update_outcomes_async_request::UpdateOutcomesAsyncRequest;
+pub mod model_update_outcomes_async_request_data;
+pub use self::model_update_outcomes_async_request_data::UpdateOutcomesAsyncRequestData;
+pub mod model_update_outcomes_async_attributes;
+pub use self::model_update_outcomes_async_attributes::UpdateOutcomesAsyncAttributes;
+pub mod model_update_outcomes_async_request_item;
+pub use self::model_update_outcomes_async_request_item::UpdateOutcomesAsyncRequestItem;
+pub mod model_update_outcomes_async_type;
+pub use self::model_update_outcomes_async_type::UpdateOutcomesAsyncType;
 pub mod model_outcomes_batch_request;
 pub use self::model_outcomes_batch_request::OutcomesBatchRequest;
 pub mod model_outcomes_batch_request_data;