Add OpenAPI definition for CCM ListCostTagDescriptions (#4060)

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

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

.generator/schemas/v2/openapi.yaml

@@ -15600,6 +15600,98 @@ components:
       type: string
       x-enum-varnames:
         - COST_BY_ORG
+    CostTagDescription:
+      description: A Cloud Cost Management tag key description, either cross-cloud or scoped to a single cloud provider.
+      properties:
+        attributes:
+          $ref: "#/components/schemas/CostTagDescriptionAttributes"
+        id:
+          description: Stable identifier of the tag description. Equals the tag key when the description is the cross-cloud default; encodes both the cloud and the tag key when the description is cloud-specific.
+          example: account_id
+          type: string
+        type:
+          $ref: "#/components/schemas/CostTagDescriptionType"
+      required:
+        - attributes
+        - id
+        - type
+      type: object
+    CostTagDescriptionAttributes:
+      description: Human-readable description and metadata attached to a Cloud Cost Management tag key, optionally scoped to a single cloud provider.
+      properties:
+        cloud:
+          description: Cloud provider this description applies to (for example, `aws`). Empty when the description is the cross-cloud default for the tag key.
+          example: aws
+          type: string
+        created_at:
+          description: Timestamp when the description was created, in RFC 3339 format.
+          example: "2026-01-01T12:00:00Z"
+          type: string
+        description:
+          description: The human-readable description for the tag key.
+          example: AWS account that owns this cost.
+          type: string
+        source:
+          $ref: "#/components/schemas/CostTagDescriptionSource"
+        tag_key:
+          description: The tag key this description applies to.
+          example: account_id
+          type: string
+        updated_at:
+          description: Timestamp when the description was last updated, in RFC 3339 format.
+          example: "2026-01-01T12:00:00Z"
+          type: string
+      required:
+        - cloud
+        - created_at
+        - description
+        - source
+        - tag_key
+        - updated_at
+      type: object
+    CostTagDescriptionSource:
+      description: Origin of the description. `human` indicates the description was written by a user, `ai_generated` was produced by AI, and `datadog` is a default supplied by Datadog.
+      enum:
+        - human
+        - ai_generated
+        - datadog
+      example: human
+      type: string
+      x-enum-varnames:
+        - HUMAN
+        - AI_GENERATED
+        - DATADOG
+    CostTagDescriptionType:
+      default: cost_tag_description
+      description: Type of the Cloud Cost Management tag description resource.
+      enum:
+        - cost_tag_description
+      example: cost_tag_description
+      type: string
+      x-enum-varnames:
+        - COST_TAG_DESCRIPTION
+    CostTagDescriptionsResponse:
+      description: List of Cloud Cost Management tag key descriptions for the organization, optionally filtered to a single cloud provider.
+      example:
+        data:
+          - attributes:
+              cloud: aws
+              created_at: "2026-01-01T12:00:00Z"
+              description: AWS account that owns this cost.
+              source: human
+              tag_key: account_id
+              updated_at: "2026-01-01T12:00:00Z"
+            id: account_id
+            type: cost_tag_description
+      properties:
+        data:
+          description: List of tag key descriptions.
+          items:
+            $ref: "#/components/schemas/CostTagDescription"
+          type: array
+      required:
+        - data
+      type: object
     CoverageSummaryAttributes:
       description: Attributes object for code coverage summary response.
       properties:
@@ -96749,6 +96841,57 @@ paths:
         operator: OR
         permissions:
           - cloud_cost_management_read
+  /api/v2/cost/tag_descriptions:
+    get:
+      description: List Cloud Cost Management tag key descriptions for the organization. Use `filter[cloud]` to scope the result to a single cloud provider; when omitted, both cross-cloud defaults and cloud-specific descriptions are returned.
+      operationId: ListCostTagDescriptions
+      parameters:
+        - description: Filter descriptions to a specific cloud provider (for example, `aws`). Omit to return descriptions across all clouds.
+          in: query
+          name: filter[cloud]
+          required: false
+          schema:
+            type: string
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                default:
+                  value:
+                    data:
+                      - attributes:
+                          cloud: aws
+                          created_at: "2026-01-01T12:00:00Z"
+                          description: AWS account that owns this cost.
+                          source: human
+                          tag_key: account_id
+                          updated_at: "2026-01-01T12:00:00Z"
+                        id: account_id
+                        type: cost_tag_description
+              schema:
+                $ref: "#/components/schemas/CostTagDescriptionsResponse"
+          description: OK
+        "403":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/APIErrorResponse"
+          description: Forbidden
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      security:
+        - apiKeyAuth: []
+          appKeyAuth: []
+        - AuthZ:
+            - cloud_cost_management_read
+      summary: List Cloud Cost Management tag descriptions
+      tags:
+        - Cloud Cost Management
+      "x-permission":
+        operator: OR
+        permissions:
+          - cloud_cost_management_read
   /api/v2/cost_by_tag/active_billing_dimensions:
     get:
       description: |-

api/datadogV2/api_cloud_cost_management.go

@@ -1835,6 +1835,111 @@ func (a *CloudCostManagementApi) ListCostOCIConfigs(ctx _context.Context) (OCICo
 	return localVarReturnValue, localVarHTTPResponse, nil
 }
 
+// ListCostTagDescriptionsOptionalParameters holds optional parameters for ListCostTagDescriptions.
+type ListCostTagDescriptionsOptionalParameters struct {
+	FilterCloud *string
+}
+
+// NewListCostTagDescriptionsOptionalParameters creates an empty struct for parameters.
+func NewListCostTagDescriptionsOptionalParameters() *ListCostTagDescriptionsOptionalParameters {
+	this := ListCostTagDescriptionsOptionalParameters{}
+	return &this
+}
+
+// WithFilterCloud sets the corresponding parameter name and returns the struct.
+func (r *ListCostTagDescriptionsOptionalParameters) WithFilterCloud(filterCloud string) *ListCostTagDescriptionsOptionalParameters {
+	r.FilterCloud = &filterCloud
+	return r
+}
+
+// ListCostTagDescriptions List Cloud Cost Management tag descriptions.
+// List Cloud Cost Management tag key descriptions for the organization. Use `filter[cloud]` to scope the result to a single cloud provider; when omitted, both cross-cloud defaults and cloud-specific descriptions are returned.
+func (a *CloudCostManagementApi) ListCostTagDescriptions(ctx _context.Context, o ...ListCostTagDescriptionsOptionalParameters) (CostTagDescriptionsResponse, *_nethttp.Response, error) {
+	var (
+		localVarHTTPMethod  = _nethttp.MethodGet
+		localVarPostBody    interface{}
+		localVarReturnValue CostTagDescriptionsResponse
+		optionalParams      ListCostTagDescriptionsOptionalParameters
+	)
+
+	if len(o) > 1 {
+		return localVarReturnValue, nil, datadog.ReportError("only one argument of type ListCostTagDescriptionsOptionalParameters is allowed")
+	}
+	if len(o) == 1 {
+		optionalParams = o[0]
+	}
+
+	localBasePath, err := a.Client.Cfg.ServerURLWithContext(ctx, "v2.CloudCostManagementApi.ListCostTagDescriptions")
+	if err != nil {
+		return localVarReturnValue, nil, datadog.GenericOpenAPIError{ErrorMessage: err.Error()}
+	}
+
+	localVarPath := localBasePath + "/api/v2/cost/tag_descriptions"
+
+	localVarHeaderParams := make(map[string]string)
+	localVarQueryParams := _neturl.Values{}
+	localVarFormParams := _neturl.Values{}
+	if optionalParams.FilterCloud != nil {
+		localVarQueryParams.Add("filter[cloud]", datadog.ParameterToString(*optionalParams.FilterCloud, ""))
+	}
+	localVarHeaderParams["Accept"] = "application/json"
+
+	if a.Client.Cfg.DelegatedTokenConfig != nil {
+		err = datadog.UseDelegatedTokenAuth(ctx, &localVarHeaderParams, a.Client.Cfg.DelegatedTokenConfig)
+		if err != nil {
+			return localVarReturnValue, 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 localVarReturnValue, nil, err
+	}
+
+	localVarHTTPResponse, err := a.Client.CallAPI(req)
+	if err != nil || localVarHTTPResponse == nil {
+		return localVarReturnValue, localVarHTTPResponse, err
+	}
+
+	localVarBody, err := datadog.ReadBody(localVarHTTPResponse)
+	if err != nil {
+		return localVarReturnValue, localVarHTTPResponse, err
+	}
+
+	if localVarHTTPResponse.StatusCode >= 300 {
+		newErr := datadog.GenericOpenAPIError{
+			ErrorBody:    localVarBody,
+			ErrorMessage: localVarHTTPResponse.Status,
+		}
+		if localVarHTTPResponse.StatusCode == 403 || localVarHTTPResponse.StatusCode == 429 {
+			var v APIErrorResponse
+			err = a.Client.Decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
+			if err != nil {
+				return localVarReturnValue, localVarHTTPResponse, newErr
+			}
+			newErr.ErrorModel = v
+		}
+		return localVarReturnValue, localVarHTTPResponse, newErr
+	}
+
+	err = a.Client.Decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
+	if err != nil {
+		newErr := datadog.GenericOpenAPIError{
+			ErrorBody:    localVarBody,
+			ErrorMessage: err.Error(),
+		}
+		return localVarReturnValue, localVarHTTPResponse, newErr
+	}
+
+	return localVarReturnValue, localVarHTTPResponse, nil
+}
+
 // ListCustomAllocationRules List custom allocation rules.
 // List all custom allocation rules - Retrieve a list of all custom allocation rules for the organization
 func (a *CloudCostManagementApi) ListCustomAllocationRules(ctx _context.Context) (ArbitraryRuleResponseArray, *_nethttp.Response, error) {

api/datadogV2/doc.go

@@ -199,6 +199,7 @@
 //   - [CloudCostManagementApi.ListCostAzureUCConfigs]
 //   - [CloudCostManagementApi.ListCostGCPUsageCostConfigs]
 //   - [CloudCostManagementApi.ListCostOCIConfigs]
+//   - [CloudCostManagementApi.ListCostTagDescriptions]
 //   - [CloudCostManagementApi.ListCustomAllocationRules]
 //   - [CloudCostManagementApi.ListCustomAllocationRulesStatus]
 //   - [CloudCostManagementApi.ListCustomCostsFiles]