Adds async Scorecard outcomes batch update endpoint (#3277)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

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

.generated-info

@@ -1,4 +1,4 @@
 {
-  "spec_repo_commit": "62a19e4",
-  "generated": "2025-08-27 15:03:04.000"
+  "spec_repo_commit": "6d9663b",
+  "generated": "2025-08-27 16:39:32.240"
 }

.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:

api/datadog/configuration.go

@@ -676,6 +676,7 @@ func NewConfiguration() *Configuration {
 			"v2.DeleteScorecardRule":                 false,
 			"v2.ListScorecardOutcomes":               false,
 			"v2.ListScorecardRules":                  false,
+			"v2.UpdateScorecardOutcomesAsync":        false,
 			"v2.UpdateScorecardRule":                 false,
 			"v2.CreateIncidentService":               false,
 			"v2.DeleteIncidentService":               false,

api/datadogV2/api_service_scorecards.go

@@ -780,6 +780,85 @@ func (a *ServiceScorecardsApi) ListScorecardRulesWithPagination(ctx _context.Con
 	return items, cancel
 }
 
+// UpdateScorecardOutcomesAsync Update Scorecard outcomes asynchronously.
+// Updates multiple scorecard rule outcomes in a single batched request.
+func (a *ServiceScorecardsApi) UpdateScorecardOutcomesAsync(ctx _context.Context, body UpdateOutcomesAsyncRequest) (*_nethttp.Response, error) {
+	var (
+		localVarHTTPMethod = _nethttp.MethodPost
+		localVarPostBody   interface{}
+	)
+
+	operationId := "v2.UpdateScorecardOutcomesAsync"
+	isOperationEnabled := a.Client.Cfg.IsUnstableOperationEnabled(operationId)
+	if !isOperationEnabled {
+		return nil, datadog.GenericOpenAPIError{ErrorMessage: _fmt.Sprintf("Unstable operation '%s' is disabled", operationId)}
+	}
+	if isOperationEnabled && a.Client.Cfg.Debug {
+		_log.Printf("WARNING: Using unstable operation '%s'", operationId)
+	}
+
+	localBasePath, err := a.Client.Cfg.ServerURLWithContext(ctx, "v2.ServiceScorecardsApi.UpdateScorecardOutcomesAsync")
+	if err != nil {
+		return nil, datadog.GenericOpenAPIError{ErrorMessage: err.Error()}
+	}
+
+	localVarPath := localBasePath + "/api/v2/scorecard/outcomes"
+
+	localVarHeaderParams := make(map[string]string)
+	localVarQueryParams := _neturl.Values{}
+	localVarFormParams := _neturl.Values{}
+	localVarHeaderParams["Content-Type"] = "application/json"
+	localVarHeaderParams["Accept"] = "*/*"
+
+	// body params
+	localVarPostBody = &body
+	if a.Client.Cfg.DelegatedTokenConfig != nil {
+		err = datadog.UseDelegatedTokenAuth(ctx, &localVarHeaderParams, a.Client.Cfg.DelegatedTokenConfig)
+		if err != nil {
+			return nil, err
+		}
+	} else {
+		datadog.SetAuthKeys(
+			ctx,
+			&localVarHeaderParams,
+			[2]string{"apiKeyAuth", "DD-API-KEY"},
+			[2]string{"appKeyAuth", "DD-APPLICATION-KEY"},
+		)
+	}
+	req, err := a.Client.PrepareRequest(ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, nil)
+	if err != nil {
+		return nil, err
+	}
+
+	localVarHTTPResponse, err := a.Client.CallAPI(req)
+	if err != nil || localVarHTTPResponse == nil {
+		return localVarHTTPResponse, err
+	}
+
+	localVarBody, err := datadog.ReadBody(localVarHTTPResponse)
+	if err != nil {
+		return localVarHTTPResponse, err
+	}
+
+	if localVarHTTPResponse.StatusCode >= 300 {
+		newErr := datadog.GenericOpenAPIError{
+			ErrorBody:    localVarBody,
+			ErrorMessage: localVarHTTPResponse.Status,
+		}
+		if localVarHTTPResponse.StatusCode == 400 || localVarHTTPResponse.StatusCode == 403 || localVarHTTPResponse.StatusCode == 409 || localVarHTTPResponse.StatusCode == 429 {
+			var v APIErrorResponse
+			err = a.Client.Decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
+			if err != nil {
+				return localVarHTTPResponse, newErr
+			}
+			newErr.ErrorModel = v
+		}
+		return localVarHTTPResponse, newErr
+	}
+
+	return localVarHTTPResponse, nil
+}
+
 // UpdateScorecardRule Update an existing rule.
 // Updates an existing rule.
 func (a *ServiceScorecardsApi) UpdateScorecardRule(ctx _context.Context, ruleId string, body UpdateRuleRequest) (UpdateRuleResponse, *_nethttp.Response, error) {

api/datadogV2/doc.go

@@ -474,6 +474,7 @@
 //   - [ServiceScorecardsApi.DeleteScorecardRule]
 //   - [ServiceScorecardsApi.ListScorecardOutcomes]
 //   - [ServiceScorecardsApi.ListScorecardRules]
+//   - [ServiceScorecardsApi.UpdateScorecardOutcomesAsync]
 //   - [ServiceScorecardsApi.UpdateScorecardRule]
 //   - [SoftwareCatalogApi.DeleteCatalogEntity]
 //   - [SoftwareCatalogApi.DeleteCatalogKind]

api/datadogV2/model_rule_attributes.go

@@ -23,6 +23,8 @@ type RuleAttributes struct {
 	Description *string `json:"description,omitempty"`
 	// If enabled, the rule is calculated as part of the score.
 	Enabled *bool `json:"enabled,omitempty"`
+	// The maturity level of the rule (1, 2, or 3).
+	Level *int32 `json:"level,omitempty"`
 	// Time of the last rule outcome modification.
 	ModifiedAt *time.Time `json:"modified_at,omitempty"`
 	// Name of the rule.
@@ -196,6 +198,34 @@ func (o *RuleAttributes) SetEnabled(v bool) {
 	o.Enabled = &v
 }
 
+// GetLevel returns the Level field value if set, zero value otherwise.
+func (o *RuleAttributes) GetLevel() int32 {
+	if o == nil || o.Level == nil {
+		var ret int32
+		return ret
+	}
+	return *o.Level
+}
+
+// GetLevelOk returns a tuple with the Level field value if set, nil otherwise
+// and a boolean to check if the value has been set.
+func (o *RuleAttributes) GetLevelOk() (*int32, bool) {
+	if o == nil || o.Level == nil {
+		return nil, false
+	}
+	return o.Level, true
+}
+
+// HasLevel returns a boolean if a field has been set.
+func (o *RuleAttributes) HasLevel() bool {
+	return o != nil && o.Level != nil
+}
+
+// SetLevel gets a reference to the given int32 and assigns it to the Level field.
+func (o *RuleAttributes) SetLevel(v int32) {
+	o.Level = &v
+}
+
 // GetModifiedAt returns the ModifiedAt field value if set, zero value otherwise.
 func (o *RuleAttributes) GetModifiedAt() time.Time {
 	if o == nil || o.ModifiedAt == nil {
@@ -333,6 +363,9 @@ func (o RuleAttributes) MarshalJSON() ([]byte, error) {
 	if o.Enabled != nil {
 		toSerialize["enabled"] = o.Enabled
 	}
+	if o.Level != nil {
+		toSerialize["level"] = o.Level
+	}
 	if o.ModifiedAt != nil {
 		if o.ModifiedAt.Nanosecond() == 0 {
 			toSerialize["modified_at"] = o.ModifiedAt.Format("2006-01-02T15:04:05Z07:00")
@@ -364,6 +397,7 @@ func (o *RuleAttributes) UnmarshalJSON(bytes []byte) (err error) {
 		Custom        *bool      `json:"custom,omitempty"`
 		Description   *string    `json:"description,omitempty"`
 		Enabled       *bool      `json:"enabled,omitempty"`
+		Level         *int32     `json:"level,omitempty"`
 		ModifiedAt    *time.Time `json:"modified_at,omitempty"`
 		Name          *string    `json:"name,omitempty"`
 		Owner         *string    `json:"owner,omitempty"`
@@ -374,7 +408,7 @@ func (o *RuleAttributes) UnmarshalJSON(bytes []byte) (err error) {
 	}
 	additionalProperties := make(map[string]interface{})
 	if err = datadog.Unmarshal(bytes, &additionalProperties); err == nil {
-		datadog.DeleteKeys(additionalProperties, &[]string{"category", "created_at", "custom", "description", "enabled", "modified_at", "name", "owner", "scorecard_name"})
+		datadog.DeleteKeys(additionalProperties, &[]string{"category", "created_at", "custom", "description", "enabled", "level", "modified_at", "name", "owner", "scorecard_name"})
 	} else {
 		return err
 	}
@@ -383,6 +417,7 @@ func (o *RuleAttributes) UnmarshalJSON(bytes []byte) (err error) {
 	o.Custom = all.Custom
 	o.Description = all.Description
 	o.Enabled = all.Enabled
+	o.Level = all.Level
 	o.ModifiedAt = all.ModifiedAt
 	o.Name = all.Name
 	o.Owner = all.Owner