datadog_api_client 2.18.0 → 2.20.0

data/.generator/schemas/v2/openapi.yaml

@@ -151,6 +151,13 @@ components:
       required: true
       schema:
         type: string
+    CloudAccountID:
+      description: Cloud Account id.
+      in: path
+      name: cloud_account_id
+      required: true
+      schema:
+        type: string
     CloudWorkloadSecurityAgentRuleID:
       description: The ID of the Agent rule.
       example: 3b5-v82-ns6
@@ -425,6 +432,13 @@ components:
       required: true
       schema:
         type: string
+    SecurityMonitoringSuppressionID:
+      description: The ID of the suppression rule
+      in: path
+      name: suppression_id
+      required: true
+      schema:
+        type: string
     SensitiveDataScannerGroupID:
       description: The ID of a group of rules.
       in: path
@@ -741,6 +755,49 @@ components:
       type: string
       x-enum-varnames:
       - API_KEYS
+    AWSRelatedAccount:
+      description: AWS related account.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/AWSRelatedAccountAttributes'
+        id:
+          description: The AWS account ID.
+          example: '123456789123'
+          type: string
+        type:
+          $ref: '#/components/schemas/AWSRelatedAccountType'
+      required:
+      - id
+      - type
+      type: object
+    AWSRelatedAccountAttributes:
+      description: Attributes for an AWS related account.
+      properties:
+        has_datadog_integration:
+          description: Whether or not the AWS account has a Datadog integration.
+          type: boolean
+        name:
+          description: The name of the AWS account.
+          type: string
+      type: object
+    AWSRelatedAccountType:
+      default: aws_account
+      description: Type of AWS related account.
+      enum:
+      - aws_account
+      example: aws_account
+      type: string
+      x-enum-varnames:
+      - AWS_ACCOUNT
+    AWSRelatedAccountsResponse:
+      description: List of AWS related accounts.
+      properties:
+        data:
+          description: An AWS related account.
+          items:
+            $ref: '#/components/schemas/AWSRelatedAccount'
+          type: array
+      type: object
     ActiveBillingDimensionsAttributes:
       description: List of active billing dimensions.
       properties:
@@ -782,6 +839,11 @@ components:
       type: string
       x-enum-varnames:
       - BILLING_DIMENSIONS
+    ApiID:
+      description: API identifier.
+      example: 90646597-5fdb-4a17-a240-647003f8c028
+      format: uuid
+      type: string
     ApmRetentionFilterType:
       default: apm_retention_filter
       description: The type of the resource.
@@ -1369,6 +1431,459 @@ components:
       type: string
       x-enum-varnames:
       - AUTHN_MAPPINGS
+    AwsCURConfig:
+      description: AWS CUR config.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/AwsCURConfigAttributes'
+        id:
+          description: The ID of the AWS CUR config.
+          format: int64
+          type: integer
+        type:
+          $ref: '#/components/schemas/AwsCURConfigType'
+      required:
+      - attributes
+      - type
+      type: object
+    AwsCURConfigAttributes:
+      description: Attributes for An AWS CUR config.
+      properties:
+        account_id:
+          description: The AWS account ID.
+          example: '123456789123'
+          type: string
+        bucket_name:
+          description: The AWS bucket name used to store the Cost and Usage Report.
+          example: dd-cost-bucket
+          type: string
+        bucket_region:
+          description: The region the bucket is located in.
+          example: us-east-1
+          type: string
+        created_at:
+          description: The timestamp when the AWS CUR config was created.
+          pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{6}$
+          type: string
+        error_messages:
+          description: The error messages for the AWS CUR config.
+          items:
+            type: string
+          type: array
+        months:
+          deprecated: true
+          description: The number of months the report has been backfilled.
+          format: int32
+          maximum: 36
+          type: integer
+        report_name:
+          description: The name of the Cost and Usage Report.
+          example: dd-report-name
+          type: string
+        report_prefix:
+          description: The report prefix used for the Cost and Usage Report.
+          example: dd-report-prefix
+          type: string
+        status:
+          description: The status of the AWS CUR.
+          example: active
+          type: string
+        status_updated_at:
+          description: The timestamp when the AWS CUR config status was updated.
+          pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{6}$
+          type: string
+        updated_at:
+          description: The timestamp when the AWS CUR config status was updated.
+          pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{6}$
+          type: string
+      required:
+      - account_id
+      - bucket_name
+      - bucket_region
+      - report_name
+      - report_prefix
+      - status
+      type: object
+    AwsCURConfigPatchData:
+      description: AWS CUR config Patch data.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/AwsCURConfigPatchRequestAttributes'
+        type:
+          $ref: '#/components/schemas/AwsCURConfigPatchRequestType'
+      required:
+      - attributes
+      - type
+      type: object
+    AwsCURConfigPatchRequest:
+      description: AWS CUR config Patch Request.
+      properties:
+        data:
+          $ref: '#/components/schemas/AwsCURConfigPatchData'
+      required:
+      - data
+      type: object
+    AwsCURConfigPatchRequestAttributes:
+      description: Attributes for AWS CUR config Patch Request.
+      properties:
+        is_enabled:
+          description: Whether or not the Cloud Cost Management account is enabled.
+          example: true
+          type: boolean
+      required:
+      - is_enabled
+      type: object
+    AwsCURConfigPatchRequestType:
+      default: aws_cur_config_patch_request
+      description: Type of AWS CUR config Patch Request.
+      enum:
+      - aws_cur_config_patch_request
+      example: aws_cur_config_patch_request
+      type: string
+      x-enum-varnames:
+      - AWS_CUR_CONFIG_PATCH_REQUEST
+    AwsCURConfigPostData:
+      description: AWS CUR config Post data.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/AwsCURConfigPostRequestAttributes'
+        type:
+          $ref: '#/components/schemas/AwsCURConfigPostRequestType'
+      required:
+      - attributes
+      - type
+      type: object
+    AwsCURConfigPostRequest:
+      description: AWS CUR config Post Request.
+      properties:
+        data:
+          $ref: '#/components/schemas/AwsCURConfigPostData'
+      required:
+      - data
+      type: object
+    AwsCURConfigPostRequestAttributes:
+      description: Attributes for AWS CUR config Post Request.
+      properties:
+        account_id:
+          description: The AWS account ID.
+          example: '123456789123'
+          type: string
+        bucket_name:
+          description: The AWS bucket name used to store the Cost and Usage Report.
+          example: dd-cost-bucket
+          type: string
+        bucket_region:
+          description: The region the bucket is located in.
+          example: us-east-1
+          type: string
+        is_enabled:
+          description: Whether or not the Cloud Cost Management account is enabled.
+          type: boolean
+        months:
+          description: The month of the report.
+          format: int32
+          maximum: 36
+          type: integer
+        report_name:
+          description: The name of the Cost and Usage Report.
+          example: dd-report-name
+          type: string
+        report_prefix:
+          description: The report prefix used for the Cost and Usage Report.
+          example: dd-report-prefix
+          type: string
+      required:
+      - account_id
+      - bucket_name
+      - report_name
+      - report_prefix
+      type: object
+    AwsCURConfigPostRequestType:
+      default: aws_cur_config_post_request
+      description: Type of AWS CUR config Post Request.
+      enum:
+      - aws_cur_config_post_request
+      example: aws_cur_config_post_request
+      type: string
+      x-enum-varnames:
+      - AWS_CUR_CONFIG_POST_REQUEST
+    AwsCURConfigResponse:
+      description: Response of AWS CUR config.
+      properties:
+        data:
+          $ref: '#/components/schemas/AwsCURConfig'
+      type: object
+    AwsCURConfigType:
+      default: aws_cur_config
+      description: Type of AWS CUR config.
+      enum:
+      - aws_cur_config
+      example: aws_cur_config
+      type: string
+      x-enum-varnames:
+      - AWS_CUR_CONFIG
+    AwsCURConfigsResponse:
+      description: List of AWS CUR configs.
+      properties:
+        data:
+          description: An AWS CUR config.
+          items:
+            $ref: '#/components/schemas/AwsCURConfig'
+          type: array
+      type: object
+    AzureUCConfig:
+      description: Azure config.
+      properties:
+        account_id:
+          description: The tenant ID of the azure account.
+          example: 1234abcd-1234-abcd-1234-1234abcd1234
+          type: string
+        client_id:
+          description: The client ID of the Azure account.
+          example: 1234abcd-1234-abcd-1234-1234abcd1234
+          type: string
+        created_at:
+          description: The timestamp when the Azure config was created.
+          pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{6}$
+          type: string
+        dataset_type:
+          description: The dataset type of the Azure config.
+          example: actual
+          type: string
+        error_messages:
+          description: The error messages for the Azure config.
+          items:
+            type: string
+          type: array
+        export_name:
+          description: The name of the configured Azure Export.
+          example: dd-actual-export
+          type: string
+        export_path:
+          description: The path where the Azure Export is saved.
+          example: dd-export-path
+          type: string
+        id:
+          description: The ID of the Azure config.
+          format: int64
+          type: integer
+        months:
+          deprecated: true
+          description: The number of months the report has been backfilled.
+          format: int32
+          maximum: 36
+          type: integer
+        scope:
+          description: The scope of your observed subscription.
+          example: subscriptions/1234abcd-1234-abcd-1234-1234abcd1234
+          type: string
+        status:
+          description: The status of the Azure config.
+          example: active
+          type: string
+        status_updated_at:
+          description: The timestamp when the Azure config status was last updated.
+          pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{6}$
+          type: string
+        storage_account:
+          description: The name of the storage account where the Azure Export is saved.
+          example: dd-storage-account
+          type: string
+        storage_container:
+          description: The name of the storage container where the Azure Export is
+            saved.
+          example: dd-storage-container
+          type: string
+        updated_at:
+          description: The timestamp when the Azure config was last updated.
+          pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{6}$
+          type: string
+      required:
+      - account_id
+      - client_id
+      - dataset_type
+      - export_name
+      - export_path
+      - scope
+      - status
+      - storage_account
+      - storage_container
+      type: object
+    AzureUCConfigPair:
+      description: Azure config pair.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/AzureUCConfigPairAttributes'
+        id:
+          description: The ID of Cloud Cost Management account.
+          format: int64
+          type: integer
+        type:
+          $ref: '#/components/schemas/AzureUCConfigPairType'
+      required:
+      - attributes
+      - type
+      type: object
+    AzureUCConfigPairAttributes:
+      description: Attributes for Azure config pair.
+      properties:
+        configs:
+          description: An Azure config.
+          items:
+            $ref: '#/components/schemas/AzureUCConfig'
+          type: array
+        id:
+          description: The ID of the Azure config pair.
+          format: int64
+          type: integer
+      required:
+      - configs
+      type: object
+    AzureUCConfigPairType:
+      default: azure_uc_configs
+      description: Type of Azure config pair.
+      enum:
+      - azure_uc_configs
+      example: azure_uc_configs
+      type: string
+      x-enum-varnames:
+      - AZURE_UC_CONFIGS
+    AzureUCConfigPairsResponse:
+      description: Response of Azure config pair.
+      properties:
+        data:
+          $ref: '#/components/schemas/AzureUCConfigPair'
+      type: object
+    AzureUCConfigPatchData:
+      description: Azure config Patch data.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/AzureUCConfigPatchRequestAttributes'
+        type:
+          $ref: '#/components/schemas/AzureUCConfigPatchRequestType'
+      required:
+      - attributes
+      - type
+      type: object
+    AzureUCConfigPatchRequest:
+      description: Azure config Patch Request.
+      properties:
+        data:
+          $ref: '#/components/schemas/AzureUCConfigPatchData'
+      required:
+      - data
+      type: object
+    AzureUCConfigPatchRequestAttributes:
+      description: Attributes for Azure config Patch Request.
+      properties:
+        is_enabled:
+          description: Whether or not the Cloud Cost Management account is enabled.
+          example: true
+          type: boolean
+      required:
+      - is_enabled
+      type: object
+    AzureUCConfigPatchRequestType:
+      default: azure_uc_config_patch_request
+      description: Type of Azure config Patch Request.
+      enum:
+      - azure_uc_config_patch_request
+      example: azure_uc_config_patch_request
+      type: string
+      x-enum-varnames:
+      - AZURE_UC_CONFIG_PATCH_REQUEST
+    AzureUCConfigPostData:
+      description: Azure config Post data.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/AzureUCConfigPostRequestAttributes'
+        type:
+          $ref: '#/components/schemas/AzureUCConfigPostRequestType'
+      required:
+      - attributes
+      - type
+      type: object
+    AzureUCConfigPostRequest:
+      description: Azure config Post Request.
+      properties:
+        data:
+          $ref: '#/components/schemas/AzureUCConfigPostData'
+      required:
+      - data
+      type: object
+    AzureUCConfigPostRequestAttributes:
+      description: Attributes for Azure config Post Request.
+      properties:
+        account_id:
+          description: The tenant ID of the azure account.
+          example: 1234abcd-1234-abcd-1234-1234abcd1234
+          type: string
+        actual_bill_config:
+          $ref: '#/components/schemas/BillConfig'
+        amortized_bill_config:
+          $ref: '#/components/schemas/BillConfig'
+        client_id:
+          description: The client ID of the azure account.
+          example: 1234abcd-1234-abcd-1234-1234abcd1234
+          type: string
+        is_enabled:
+          description: Whether or not the Cloud Cost Management account is enabled.
+          type: boolean
+        scope:
+          description: The scope of your observed subscription.
+          example: subscriptions/1234abcd-1234-abcd-1234-1234abcd1234
+          type: string
+      required:
+      - account_id
+      - actual_bill_config
+      - amortized_bill_config
+      - client_id
+      - scope
+      type: object
+    AzureUCConfigPostRequestType:
+      default: azure_uc_config_post_request
+      description: Type of Azure config Post Request.
+      enum:
+      - azure_uc_config_post_request
+      example: azure_uc_config_post_request
+      type: string
+      x-enum-varnames:
+      - AZURE_UC_CONFIG_POST_REQUEST
+    AzureUCConfigsResponse:
+      description: List of Azure accounts with configs.
+      properties:
+        data:
+          description: An Azure config pair.
+          items:
+            $ref: '#/components/schemas/AzureUCConfigPair'
+          type: array
+      type: object
+    BillConfig:
+      description: Bill config.
+      properties:
+        export_name:
+          description: The name of the configured Azure Export.
+          example: dd-actual-export
+          type: string
+        export_path:
+          description: The path where the Azure Export is saved.
+          example: dd-export-path
+          type: string
+        storage_account:
+          description: The name of the storage account where the Azure Export is saved.
+          example: dd-storage-account
+          type: string
+        storage_container:
+          description: The name of the storage container where the Azure Export is
+            saved.
+          example: dd-storage-container
+          type: string
+      required:
+      - export_name
+      - export_path
+      - storage_account
+      - storage_container
+      type: object
     BulkMuteFindingsRequest:
       description: The new bulk mute finding request.
       properties:
@@ -3005,11 +3520,47 @@ components:
       type: string
       x-enum-varnames:
       - CLOUD_CONFIGURATION
-    CloudWorkloadSecurityAgentRuleAttributes:
-      description: A Cloud Workload Security Agent rule returned by the API.
+    CloudCostActivity:
+      description: Cloud Cost Activity.
       properties:
-        agentConstraint:
-          description: The version of the agent.
+        attributes:
+          $ref: '#/components/schemas/CloudCostActivityAttributes'
+        type:
+          $ref: '#/components/schemas/CloudCostActivityType'
+      required:
+      - attributes
+      - type
+      type: object
+    CloudCostActivityAttributes:
+      description: Attributes for Cloud Cost activity.
+      properties:
+        is_enabled:
+          description: Whether or not the cloud account is enabled.
+          example: true
+          type: boolean
+      required:
+      - is_enabled
+      type: object
+    CloudCostActivityResponse:
+      description: Response for Cloud Cost activity.
+      properties:
+        data:
+          $ref: '#/components/schemas/CloudCostActivity'
+      type: object
+    CloudCostActivityType:
+      default: cloud_cost_activity
+      description: Type of Cloud Cost Activity.
+      enum:
+      - cloud_cost_activity
+      example: cloud_cost_activity
+      type: string
+      x-enum-varnames:
+      - CLOUD_COST_ACTIVITY
+    CloudWorkloadSecurityAgentRuleAttributes:
+      description: A Cloud Workload Security Agent rule returned by the API.
+      properties:
+        agentConstraint:
+          description: The version of the agent.
           type: string
         category:
           description: The category of the Agent rule.
@@ -3237,6 +3788,22 @@ components:
           description: The name of the Cloudflare account.
           example: test-name
           type: string
+        resources:
+          description: An allowlist of resources to restrict pulling metrics for.
+          example:
+          - web
+          - dns
+          items:
+            type: string
+          type: array
+        zones:
+          description: An allowlist of zones to restrict pulling metrics for.
+          example:
+          - zone_id_1
+          - zone_id_2
+          items:
+            type: string
+          type: array
       required:
       - api_key
       - name
@@ -3269,6 +3836,22 @@ components:
           description: The name of the Cloudflare account.
           example: test-name
           type: string
+        resources:
+          description: An allowlist of resources to restrict pulling metrics for.
+          example:
+          - web
+          - dns
+          items:
+            type: string
+          type: array
+        zones:
+          description: An allowlist of zones to restrict pulling metrics for.
+          example:
+          - zone_id_1
+          - zone_id_2
+          items:
+            type: string
+          type: array
       required:
       - name
       type: object
@@ -3317,6 +3900,22 @@ components:
             key is provided (and not a token), this field is also required.
           example: test-email@example.com
           type: string
+        resources:
+          description: An allowlist of resources to restrict pulling metrics for.
+          example:
+          - web
+          - dns
+          items:
+            type: string
+          type: array
+        zones:
+          description: An allowlist of zones to restrict pulling metrics for.
+          example:
+          - zone_id_1
+          - zone_id_2
+          items:
+            type: string
+          type: array
       required:
       - api_key
       type: object
@@ -4279,6 +4878,29 @@ components:
       type: string
       x-enum-varnames:
       - COST_BY_ORG
+    CreateOpenAPIResponse:
+      description: Response for `CreateOpenAPI` operation.
+      properties:
+        data:
+          $ref: '#/components/schemas/CreateOpenAPIResponseData'
+      type: object
+    CreateOpenAPIResponseAttributes:
+      description: Attributes for `CreateOpenAPI`.
+      properties:
+        failed_endpoints:
+          description: List of endpoints which couldn't be parsed.
+          items:
+            $ref: '#/components/schemas/OpenAPIEndpoint'
+          type: array
+      type: object
+    CreateOpenAPIResponseData:
+      description: Data envelope for `CreateOpenAPIResponse`.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/CreateOpenAPIResponseAttributes'
+        id:
+          $ref: '#/components/schemas/ApiID'
+      type: object
     CreateRuleRequest:
       description: Scorecard create rule request.
       properties:
@@ -4336,6 +4958,10 @@ components:
     DORADeploymentRequestAttributes:
       description: Attributes to create a DORA deployment event.
       properties:
+        env:
+          description: Environment name to where the service was deployed.
+          example: staging
+          type: string
         finished_at:
           description: Unix timestamp in nanoseconds when the deployment finished.
             It should not be older than 3 hours.
@@ -4424,6 +5050,10 @@ components:
     DORAIncidentRequestAttributes:
       description: Attributes to create a DORA incident event.
       properties:
+        env:
+          description: Environment name that was impacted by the incident.
+          example: staging
+          type: string
         finished_at:
           description: Unix timestamp in nanoseconds when the incident finished. It
             should not be older than 3 hours.
@@ -6393,8 +7023,19 @@ components:
             type: string
           type: array
         is_cspm_enabled:
-          description: When enabled, Datadog performs configuration checks across
-            your Google Cloud environment by continuously scanning every resource.
+          description: 'When enabled, Datadog will activate the Cloud Security Monitoring
+            product for this service account. Note: This requires resource_collection_enabled
+            to be set to true.'
+          type: boolean
+        is_security_command_center_enabled:
+          default: false
+          description: 'When enabled, Datadog will attempt to collect Security Command
+            Center Findings. Note: This requires additional permissions on the service
+            account.'
+          example: true
+          type: boolean
+        resource_collection_enabled:
+          description: When enabled, Datadog scans for all resources in your GCP environment.
           type: boolean
       type: object
     GCPSTSServiceAccountCreateRequest:
@@ -10442,7 +11083,7 @@ components:
       description: The metrics' payload.
       properties:
         series:
-          description: A list of time series to submit to Datadog.
+          description: A list of timeseries to submit to Datadog.
           example:
           - metric: system.load.1
             points:
@@ -11466,6 +12107,24 @@ components:
       type: string
       x-enum-varnames:
       - ON_DEMAND_CONCURRENCY_CAP
+    OpenAPIEndpoint:
+      description: Endpoint info extracted from an `OpenAPI` specification.
+      properties:
+        method:
+          description: The endpoint method.
+          type: string
+        path:
+          description: The endpoint path.
+          type: string
+      type: object
+    OpenAPIFile:
+      description: Object for API data in an `OpenAPI` format as a file.
+      properties:
+        openapi_spec_file:
+          description: Binary `OpenAPI` spec file
+          format: binary
+          type: string
+      type: object
     OpsgenieServiceCreateAttributes:
       description: The Opsgenie service attributes for a create request.
       properties:
@@ -13628,6 +14287,27 @@ components:
       - id
       - type
       type: object
+    RelationshipToUserTeamTeam:
+      description: Relationship between team membership and team
+      properties:
+        data:
+          $ref: '#/components/schemas/RelationshipToUserTeamTeamData'
+      required:
+      - data
+      type: object
+    RelationshipToUserTeamTeamData:
+      description: The team associated with the membership
+      properties:
+        id:
+          description: The ID of the team associated with the membership
+          example: d7e15d9d-d346-43da-81d8-3d9e71d9a5e9
+          type: string
+        type:
+          $ref: '#/components/schemas/UserTeamTeamType'
+      required:
+      - id
+      - type
+      type: object
     RelationshipToUserTeamUser:
       description: Relationship between team membership and user
       properties:
@@ -15045,6 +15725,8 @@ components:
           $ref: '#/components/schemas/SecurityMonitoringRuleMaxSignalDuration'
         newValueOptions:
           $ref: '#/components/schemas/SecurityMonitoringRuleNewValueOptions'
+        thirdPartyRuleOptions:
+          $ref: '#/components/schemas/SecurityMonitoringRuleThirdPartyOptions'
       type: object
     SecurityMonitoringRuleQuery:
       description: Query for matching rule.
@@ -15093,6 +15775,30 @@ components:
       - MEDIUM
       - HIGH
       - CRITICAL
+    SecurityMonitoringRuleThirdPartyOptions:
+      description: Options on third party rules.
+      properties:
+        defaultNotifications:
+          description: Notification targets for the logs that do not correspond to
+            any of the cases.
+          items:
+            description: Notification.
+            type: string
+          type: array
+        defaultStatus:
+          $ref: '#/components/schemas/SecurityMonitoringRuleSeverity'
+        rootQueries:
+          description: Queries to be combined with third party case queries. Each
+            of them can have different group by fields, to aggregate differently based
+            on the type of alert.
+          items:
+            $ref: '#/components/schemas/SecurityMonitoringThirdPartyRootQuery'
+          type: array
+        signalTitleTemplate:
+          description: A template for the signal title; if omitted, the title is generated
+            based on the case name.
+          type: string
+      type: object
     SecurityMonitoringRuleTypeCreate:
       description: The rule type.
       enum:
@@ -15162,6 +15868,13 @@ components:
             description: Tag.
             type: string
           type: array
+        thirdPartyCases:
+          description: Cases for generating signals from third party rules. Only available
+            for third party rules.
+          example: []
+          items:
+            $ref: '#/components/schemas/SecurityMonitoringThirdPartyRuleCase'
+          type: array
         version:
           description: The version of the rule being updated.
           example: 1
@@ -15791,6 +16504,13 @@ components:
             description: Tag.
             type: string
           type: array
+        thirdPartyCases:
+          description: Cases for generating signals from third party rules. Only available
+            for third party rules.
+          example: []
+          items:
+            $ref: '#/components/schemas/SecurityMonitoringThirdPartyRuleCaseCreate'
+          type: array
         type:
           $ref: '#/components/schemas/SecurityMonitoringRuleTypeCreate'
       required:
@@ -15912,6 +16632,13 @@ components:
             description: Tag.
             type: string
           type: array
+        thirdPartyCases:
+          description: Cases for generating signals from third party rules. Only available
+            for third party rules.
+          example: []
+          items:
+            $ref: '#/components/schemas/SecurityMonitoringThirdPartyRuleCase'
+          type: array
         type:
           $ref: '#/components/schemas/SecurityMonitoringRuleTypeRead'
         updateAuthorId:
@@ -15922,98 +16649,376 @@ components:
           description: The version of the rule.
           format: int64
           type: integer
-    SecurityMonitoringTriageUser:
-      description: Object representing a given user entity.
+    SecurityMonitoringSuppression:
+      description: The suppression rule's properties.
       properties:
-        handle:
-          description: The handle for this user account.
+        attributes:
+          $ref: '#/components/schemas/SecurityMonitoringSuppressionAttributes'
+        id:
+          $ref: '#/components/schemas/SecurityMonitoringSuppressionID'
+        type:
+          $ref: '#/components/schemas/SecurityMonitoringSuppressionType'
+      type: object
+    SecurityMonitoringSuppressionAttributes:
+      description: The attributes of the suppression rule.
+      properties:
+        creation_date:
+          description: A Unix millisecond timestamp given the creation date of the
+            suppression rule.
+          format: int64
+          type: integer
+        creator:
+          $ref: '#/components/schemas/SecurityMonitoringUser'
+        description:
+          description: A description for the suppression rule.
+          example: This rule suppresses low-severity signals in staging environments.
           type: string
-        icon:
-          description: Gravatar icon associated to the user.
-          example: /path/to/matching/gravatar/icon
-          readOnly: true
+        enabled:
+          description: Whether the suppression rule is enabled.
+          example: true
+          type: boolean
+        expiration_date:
+          description: A Unix millisecond timestamp giving an expiration date for
+            the suppression rule. After this date, it won't suppress signals anymore.
+          example: 1703187336000
+          format: int64
+          type: integer
+        name:
+          description: The name of the suppression rule.
+          example: Custom suppression
+          type: string
+        rule_query:
+          description: The rule query of the suppression rule, with the same syntax
+            as the search bar for detection rules.
+          example: type:log_detection source:cloudtrail
+          type: string
+        suppression_query:
+          description: The suppression query of the suppression rule. If a signal
+            matches this query, it is suppressed and not triggered. Same syntax as
+            the queries to search signals in the signal explorer.
+          example: env:staging status:low
+          type: string
+        update_date:
+          description: A Unix millisecond timestamp given the update date of the suppression
+            rule.
+          format: int64
+          type: integer
+        updater:
+          $ref: '#/components/schemas/SecurityMonitoringUser'
+        version:
+          description: The version of the suppression rule; it starts at 1, and is
+            incremented at each update.
+          example: 42
+          format: int32
+          maximum: 2147483647
+          type: integer
+      type: object
+    SecurityMonitoringSuppressionCreateAttributes:
+      description: Object containing the attributes of the suppression rule to be
+        created.
+      properties:
+        description:
+          description: A description for the suppression rule.
+          example: This rule suppresses low-severity signals in staging environments.
           type: string
-        id:
-          description: Numerical ID assigned by Datadog to this user account.
+        enabled:
+          description: Whether the suppression rule is enabled.
+          example: true
+          type: boolean
+        expiration_date:
+          description: A Unix millisecond timestamp giving an expiration date for
+            the suppression rule. After this date, it won't suppress signals anymore.
+          example: 1703187336000
           format: int64
           type: integer
         name:
-          description: The name for this user account.
-          nullable: true
+          description: The name of the suppression rule.
+          example: Custom suppression
           type: string
-        uuid:
-          description: UUID assigned by Datadog to this user account.
-          example: 773b045d-ccf8-4808-bd3b-955ef6a8c940
+        rule_query:
+          description: The rule query of the suppression rule, with the same syntax
+            as the search bar for detection rules.
+          example: type:log_detection source:cloudtrail
+          type: string
+        suppression_query:
+          description: The suppression query of the suppression rule. If a signal
+            matches this query, it is suppressed and is not triggered . Same syntax
+            as the queries to search signals in the signal explorer.
+          example: env:staging status:low
           type: string
       required:
-      - uuid
-      type: object
-    SensitiveDataScannerConfigRequest:
-      description: Group reorder request.
-      properties:
-        data:
-          $ref: '#/components/schemas/SensitiveDataScannerReorderConfig'
-        meta:
-          $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly'
-      required:
-      - data
-      - meta
+      - name
+      - enabled
+      - rule_query
+      - suppression_query
       type: object
-    SensitiveDataScannerConfiguration:
-      description: A Sensitive Data Scanner configuration.
+    SecurityMonitoringSuppressionCreateData:
+      description: Object for a single suppression rule.
       properties:
-        id:
-          description: ID of the configuration.
-          type: string
+        attributes:
+          $ref: '#/components/schemas/SecurityMonitoringSuppressionCreateAttributes'
         type:
-          $ref: '#/components/schemas/SensitiveDataScannerConfigurationType'
+          $ref: '#/components/schemas/SecurityMonitoringSuppressionType'
+      required:
+      - type
+      - attributes
       type: object
-    SensitiveDataScannerConfigurationData:
-      description: A Sensitive Data Scanner configuration data.
+    SecurityMonitoringSuppressionCreateRequest:
+      description: Request object that includes the suppression rule that you would
+        like to create.
       properties:
         data:
-          $ref: '#/components/schemas/SensitiveDataScannerConfiguration'
+          $ref: '#/components/schemas/SecurityMonitoringSuppressionCreateData'
+      required:
+      - data
       type: object
-    SensitiveDataScannerConfigurationRelationships:
-      description: Relationships of the configuration.
+    SecurityMonitoringSuppressionID:
+      description: The ID of the suppression rule.
+      example: 3dd-0uc-h1s
+      type: string
+    SecurityMonitoringSuppressionResponse:
+      description: Response object containing a single suppression rule.
       properties:
-        groups:
-          $ref: '#/components/schemas/SensitiveDataScannerGroupList'
+        data:
+          $ref: '#/components/schemas/SecurityMonitoringSuppression'
       type: object
-    SensitiveDataScannerConfigurationType:
-      default: sensitive_data_scanner_configuration
-      description: Sensitive Data Scanner configuration type.
+    SecurityMonitoringSuppressionType:
+      default: suppressions
+      description: The type of the resource. The value should always be `suppressions`.
       enum:
-      - sensitive_data_scanner_configuration
-      example: sensitive_data_scanner_configuration
+      - suppressions
+      example: suppressions
       type: string
       x-enum-varnames:
-      - SENSITIVE_DATA_SCANNER_CONFIGURATIONS
-    SensitiveDataScannerCreateGroupResponse:
-      description: Create group response.
+      - SUPPRESSIONS
+    SecurityMonitoringSuppressionUpdateAttributes:
+      description: The suppression rule properties to be updated.
+      properties:
+        description:
+          description: A description for the suppression rule.
+          example: This rule suppresses low-severity signals in staging environments.
+          type: string
+        enabled:
+          description: Whether the suppression rule is enabled.
+          example: true
+          type: boolean
+        expiration_date:
+          description: A Unix millisecond timestamp giving an expiration date for
+            the suppression rule. After this date, it won't suppress signals anymore.
+            If unset, the expiration date of the suppression rule is left untouched.
+            If set to `null`, the expiration date is removed.
+          example: 1703187336000
+          format: int64
+          nullable: true
+          type: integer
+        name:
+          description: The name of the suppression rule.
+          example: Custom suppression
+          type: string
+        rule_query:
+          description: The rule query of the suppression rule, with the same syntax
+            as the search bar for detection rules.
+          example: type:log_detection source:cloudtrail
+          type: string
+        suppression_query:
+          description: The suppression query of the suppression rule. If a signal
+            matches this query, it is suppressed and not triggered. Same syntax as
+            the queries to search signals in the signal explorer.
+          example: env:staging status:low
+          type: string
+        version:
+          description: The current version of the suppression. This is optional, but
+            it can help prevent concurrent modifications.
+          format: int32
+          maximum: 2147483647
+          type: integer
+      type: object
+    SecurityMonitoringSuppressionUpdateData:
+      description: The new suppression properties; partial updates are supported.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/SecurityMonitoringSuppressionUpdateAttributes'
+        type:
+          $ref: '#/components/schemas/SecurityMonitoringSuppressionType'
+      required:
+      - type
+      - attributes
+      type: object
+    SecurityMonitoringSuppressionUpdateRequest:
+      description: Request object containing the fields to update on the suppression
+        rule.
       properties:
         data:
-          $ref: '#/components/schemas/SensitiveDataScannerGroupResponse'
-        meta:
-          $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly'
+          $ref: '#/components/schemas/SecurityMonitoringSuppressionUpdateData'
+      required:
+      - data
       type: object
-    SensitiveDataScannerCreateRuleResponse:
-      description: Create rule response.
+    SecurityMonitoringSuppressionsResponse:
+      description: Response object containing the available suppression rules.
       properties:
         data:
-          $ref: '#/components/schemas/SensitiveDataScannerRuleResponse'
-        meta:
-          $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly'
+          description: A list of suppressions objects.
+          items:
+            $ref: '#/components/schemas/SecurityMonitoringSuppression'
+          type: array
       type: object
-    SensitiveDataScannerFilter:
-      description: Filter for the Scanning Group.
+    SecurityMonitoringThirdPartyRootQuery:
+      description: A query to be combined with the third party case query.
       properties:
+        groupByFields:
+          description: Fields to group by.
+          items:
+            description: Field.
+            type: string
+          type: array
         query:
-          description: Query to filter the events.
+          description: Query to run on logs.
+          example: source:cloudtrail
           type: string
       type: object
-    SensitiveDataScannerGetConfigIncludedArray:
-      description: Included objects from relationships.
+    SecurityMonitoringThirdPartyRuleCase:
+      description: Case when signal is generated by a third party rule.
+      properties:
+        name:
+          description: Name of the case.
+          type: string
+        notifications:
+          description: Notification targets for each rule case.
+          items:
+            description: Notification.
+            type: string
+          type: array
+        query:
+          description: A query to map a third party event to this case.
+          type: string
+        status:
+          $ref: '#/components/schemas/SecurityMonitoringRuleSeverity'
+      type: object
+    SecurityMonitoringThirdPartyRuleCaseCreate:
+      description: Case when a signal is generated by a third party rule.
+      properties:
+        name:
+          description: Name of the case.
+          type: string
+        notifications:
+          description: Notification targets for each rule case.
+          items:
+            description: Notification.
+            type: string
+          type: array
+        query:
+          description: A query to map a third party event to this case.
+          type: string
+        status:
+          $ref: '#/components/schemas/SecurityMonitoringRuleSeverity'
+      required:
+      - status
+      type: object
+    SecurityMonitoringTriageUser:
+      description: Object representing a given user entity.
+      properties:
+        handle:
+          description: The handle for this user account.
+          type: string
+        icon:
+          description: Gravatar icon associated to the user.
+          example: /path/to/matching/gravatar/icon
+          readOnly: true
+          type: string
+        id:
+          description: Numerical ID assigned by Datadog to this user account.
+          format: int64
+          type: integer
+        name:
+          description: The name for this user account.
+          nullable: true
+          type: string
+        uuid:
+          description: UUID assigned by Datadog to this user account.
+          example: 773b045d-ccf8-4808-bd3b-955ef6a8c940
+          type: string
+      required:
+      - uuid
+      type: object
+    SecurityMonitoringUser:
+      description: A user.
+      properties:
+        handle:
+          description: The handle of the user.
+          example: john.doe@datadoghq.com
+          type: string
+        name:
+          description: The name of the user.
+          example: John Doe
+          nullable: true
+          type: string
+      type: object
+    SensitiveDataScannerConfigRequest:
+      description: Group reorder request.
+      properties:
+        data:
+          $ref: '#/components/schemas/SensitiveDataScannerReorderConfig'
+        meta:
+          $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly'
+      required:
+      - data
+      - meta
+      type: object
+    SensitiveDataScannerConfiguration:
+      description: A Sensitive Data Scanner configuration.
+      properties:
+        id:
+          description: ID of the configuration.
+          type: string
+        type:
+          $ref: '#/components/schemas/SensitiveDataScannerConfigurationType'
+      type: object
+    SensitiveDataScannerConfigurationData:
+      description: A Sensitive Data Scanner configuration data.
+      properties:
+        data:
+          $ref: '#/components/schemas/SensitiveDataScannerConfiguration'
+      type: object
+    SensitiveDataScannerConfigurationRelationships:
+      description: Relationships of the configuration.
+      properties:
+        groups:
+          $ref: '#/components/schemas/SensitiveDataScannerGroupList'
+      type: object
+    SensitiveDataScannerConfigurationType:
+      default: sensitive_data_scanner_configuration
+      description: Sensitive Data Scanner configuration type.
+      enum:
+      - sensitive_data_scanner_configuration
+      example: sensitive_data_scanner_configuration
+      type: string
+      x-enum-varnames:
+      - SENSITIVE_DATA_SCANNER_CONFIGURATIONS
+    SensitiveDataScannerCreateGroupResponse:
+      description: Create group response.
+      properties:
+        data:
+          $ref: '#/components/schemas/SensitiveDataScannerGroupResponse'
+        meta:
+          $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly'
+      type: object
+    SensitiveDataScannerCreateRuleResponse:
+      description: Create rule response.
+      properties:
+        data:
+          $ref: '#/components/schemas/SensitiveDataScannerRuleResponse'
+        meta:
+          $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly'
+      type: object
+    SensitiveDataScannerFilter:
+      description: Filter for the Scanning Group.
+      properties:
+        query:
+          description: Query to filter the events.
+          type: string
+      type: object
+    SensitiveDataScannerGetConfigIncludedArray:
+      description: Included objects from relationships.
       items:
         $ref: '#/components/schemas/SensitiveDataScannerGetConfigIncludedItem'
       type: array
@@ -16208,6 +17213,44 @@ components:
         meta:
           $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly'
       type: object
+    SensitiveDataScannerIncludedKeywordConfiguration:
+      description: 'Object defining a set of keywords and a number of characters that
+        help reduce noise.
+
+        You can provide a list of keywords you would like to check within a defined
+        proximity of the matching pattern.
+
+        If any of the keywords are found within the proximity check, the match is
+        kept.
+
+        If none are found, the match is discarded.'
+      properties:
+        character_count:
+          description: 'The number of characters behind a match detected by Sensitive
+            Data Scanner to look for the keywords defined.
+
+            `character_count` should be greater than the maximum length of a keyword
+            defined for a rule.'
+          example: 30
+          format: int64
+          maximum: 50
+          minimum: 1
+          type: integer
+        keywords:
+          description: 'Keyword list that will be checked during scanning in order
+            to validate a match.
+
+            The number of keywords in the list must be less than or equal to 30.'
+          example:
+          - credit card
+          - cc
+          items:
+            type: string
+          type: array
+      required:
+      - keywords
+      - character_count
+      type: object
     SensitiveDataScannerMeta:
       description: Meta response containing information about the API.
       properties:
@@ -16301,6 +17344,8 @@ components:
           items:
             type: string
           type: array
+        included_keyword_configuration:
+          $ref: '#/components/schemas/SensitiveDataScannerIncludedKeywordConfiguration'
         is_enabled:
           description: Whether or not the rule is enabled.
           type: boolean
@@ -16320,6 +17365,12 @@ components:
         pattern:
           description: Not included if there is a relationship to a standard pattern.
           type: string
+        priority:
+          description: Integer from 1 (high) to 5 (low) indicating rule issue severity.
+          format: int64
+          maximum: 5
+          minimum: 1
+          type: integer
         tags:
           description: List of tags.
           items:
@@ -16475,6 +17526,13 @@ components:
         pattern:
           description: Regex to match.
           type: string
+        priority:
+          description: Integer from 1 (high) to 5 (low) indicating standard pattern
+            issue severity.
+          format: int64
+          maximum: 5
+          minimum: 1
+          type: integer
         tags:
           description: List of tags.
           items:
@@ -19272,6 +20330,29 @@ components:
           example: min
           type: string
       type: object
+    UpdateOpenAPIResponse:
+      description: Response for `UpdateOpenAPI`.
+      properties:
+        data:
+          $ref: '#/components/schemas/UpdateOpenAPIResponseData'
+      type: object
+    UpdateOpenAPIResponseAttributes:
+      description: Attributes for `UpdateOpenAPI`.
+      properties:
+        failed_endpoints:
+          description: List of endpoints which couldn't be parsed.
+          items:
+            $ref: '#/components/schemas/OpenAPIEndpoint'
+          type: array
+      type: object
+    UpdateOpenAPIResponseData:
+      description: Data envelope for `UpdateOpenAPIResponse`.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/UpdateOpenAPIResponseAttributes'
+        id:
+          $ref: '#/components/schemas/ApiID'
+      type: object
     UsageApplicationSecurityMonitoringResponse:
       description: Application Security Monitoring usage response.
       properties:
@@ -19589,6 +20670,20 @@ components:
     UserTeamAttributes:
       description: Team membership attributes
       properties:
+        provisioned_by:
+          description: 'The mechanism responsible for provisioning the team relationship.
+
+            Possible values: null for added by a user, "service_account" if added
+            by a service account, and "saml_mapping" if provisioned via SAML mapping.'
+          nullable: true
+          readOnly: true
+          type: string
+        provisioned_by_id:
+          description: UUID of the User or Service Account who provisioned this team
+            membership, or null if provisioned via SAML mapping.
+          nullable: true
+          readOnly: true
+          type: string
         role:
           $ref: '#/components/schemas/UserTeamRole'
       type: object
@@ -19640,6 +20735,8 @@ components:
     UserTeamRelationships:
       description: Relationship between membership and a user
       properties:
+        team:
+          $ref: '#/components/schemas/RelationshipToUserTeamTeam'
         user:
           $ref: '#/components/schemas/RelationshipToUserTeamUser'
       type: object
@@ -19665,6 +20762,15 @@ components:
       type: string
       x-enum-varnames:
       - ADMIN
+    UserTeamTeamType:
+      default: team
+      description: User team team type
+      enum:
+      - team
+      example: team
+      type: string
+      x-enum-varnames:
+      - TEAM
     UserTeamType:
       default: team_memberships
       description: Team membership type
@@ -20073,55 +21179,244 @@ paths:
       tags:
       - Key Management
       x-codegen-request-body-name: body
-  /api/v2/apm/config/metrics:
-    get:
-      description: Get the list of configured span-based metrics with their definitions.
-      operationId: ListSpansMetrics
+  /api/v2/apicatalog/api/{id}:
+    delete:
+      description: Delete a specific API by ID.
+      operationId: DeleteOpenAPI
+      parameters:
+      - description: ID of the API to delete
+        in: path
+        name: id
+        required: true
+        schema:
+          $ref: '#/components/schemas/ApiID'
       responses:
-        '200':
+        '204':
+          description: API deleted successfully
+        '400':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/SpansMetricsResponse'
-          description: OK
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: Bad request
         '403':
-          $ref: '#/components/responses/NotAuthorizedResponse'
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: API not found error
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      summary: Get all span-based metrics
+      summary: Delete an API
       tags:
-      - Spans Metrics
-    post:
-      description: 'Create a metric based on your ingested spans in your organization.
+      - API Management
+      x-unstable: '**Note**: This endpoint is in public beta.
 
-        Returns the span-based metric object from the request body when the request
-        is successful.'
-      operationId: CreateSpansMetric
-      requestBody:
-        content:
-          application/json:
-            schema:
-              $ref: '#/components/schemas/SpansMetricCreateRequest'
-        description: The definition of the new span-based metric.
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+  /api/v2/apicatalog/api/{id}/openapi:
+    get:
+      description: Retrieve information about a specific API in [OpenAPI](https://spec.openapis.org/oas/latest.html)
+        format file.
+      operationId: GetOpenAPI
+      parameters:
+      - description: ID of the API to retrieve
+        in: path
+        name: id
         required: true
+        schema:
+          $ref: '#/components/schemas/ApiID'
       responses:
         '200':
           content:
-            application/json:
+            multipart/form-data:
               schema:
-                $ref: '#/components/schemas/SpansMetricResponse'
+                format: binary
+                type: string
           description: OK
         '400':
-          $ref: '#/components/responses/BadRequestResponse'
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: Bad request
         '403':
-          $ref: '#/components/responses/NotAuthorizedResponse'
-        '409':
-          $ref: '#/components/responses/ConflictResponse'
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: API not found error
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      summary: Create a span-based metric
+      summary: Get an API
       tags:
-      - Spans Metrics
+      - API Management
+      x-unstable: '**Note**: This endpoint is in public beta.
+
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+    put:
+      description: 'Update information about a specific API. The given content will
+        replace all API content of the given ID.
+
+        The ID is returned by the create API, or can be found in the URL in the API
+        catalog UI.
+
+        '
+      operationId: UpdateOpenAPI
+      parameters:
+      - description: ID of the API to modify
+        in: path
+        name: id
+        required: true
+        schema:
+          $ref: '#/components/schemas/ApiID'
+      requestBody:
+        content:
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/OpenAPIFile'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UpdateOpenAPIResponse'
+          description: API updated successfully
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: Bad request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: API not found error
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Update an API
+      tags:
+      - API Management
+      x-unstable: '**Note**: This endpoint is in public beta.
+
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+  /api/v2/apicatalog/openapi:
+    post:
+      description: 'Create a new API from the [OpenAPI](https://spec.openapis.org/oas/latest.html)
+        specification given.
+
+        It supports version `2.0`, `3.0` and `3.1` of the specification. A specific
+        extension section, `x-datadog`,
+
+        let you specify the `teamHandle` for your team responsible for the API in
+        Datadog.
+
+        It returns the created API ID.
+
+        '
+      operationId: CreateOpenAPI
+      requestBody:
+        content:
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/OpenAPIFile'
+        required: true
+      responses:
+        '201':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/CreateOpenAPIResponse'
+          description: API created successfully
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: Bad request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: Forbidden
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Create a new API
+      tags:
+      - API Management
+      x-unstable: '**Note**: This endpoint is in public beta.
+
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+  /api/v2/apm/config/metrics:
+    get:
+      description: Get the list of configured span-based metrics with their definitions.
+      operationId: ListSpansMetrics
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SpansMetricsResponse'
+          description: OK
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Get all span-based metrics
+      tags:
+      - Spans Metrics
+    post:
+      description: 'Create a metric based on your ingested spans in your organization.
+
+        Returns the span-based metric object from the request body when the request
+        is successful.'
+      operationId: CreateSpansMetric
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SpansMetricCreateRequest'
+        description: The definition of the new span-based metric.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SpansMetricResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '409':
+          $ref: '#/components/responses/ConflictResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Create a span-based metric
+      tags:
+      - Spans Metrics
       x-codegen-request-body-name: body
   /api/v2/apm/config/metrics/{metric_id}:
     delete:
@@ -20899,9 +22194,6 @@ paths:
       tags:
       - CI Visibility Pipelines
       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/ci/pipelines/analytics/aggregate:
     post:
       description: Use this API endpoint to aggregate CI Visibility pipeline events
@@ -21271,7 +22563,388 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/ContainerImagesResponse'
+                $ref: '#/components/schemas/ContainerImagesResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Authentication Error
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ: []
+      summary: Get all Container Images
+      tags:
+      - Container Images
+      x-pagination:
+        cursorParam: page[cursor]
+        cursorPath: meta.pagination.next_cursor
+        limitParam: page[size]
+        resultsPath: data
+  /api/v2/containers:
+    get:
+      description: Get all containers for your organization.
+      operationId: ListContainers
+      parameters:
+      - description: Comma-separated list of tags to filter containers by.
+        example: env:prod,short_image:cassandra
+        in: query
+        name: filter[tags]
+        required: false
+        schema:
+          type: string
+      - description: Comma-separated list of tags to group containers by.
+        example: datacenter,cluster
+        in: query
+        name: group_by
+        required: false
+        schema:
+          type: string
+      - description: Attribute to sort containers by.
+        example: started_at
+        in: query
+        name: sort
+        required: false
+        schema:
+          type: string
+      - description: Maximum number of results returned.
+        in: query
+        name: page[size]
+        required: false
+        schema:
+          default: 1000
+          format: int32
+          maximum: 10000
+          minimum: 1
+          type: integer
+      - description: 'String to query the next page of results.
+
+          This key is provided with each valid response from the API in `meta.pagination.next_cursor`.'
+        in: query
+        name: page[cursor]
+        required: false
+        schema:
+          type: string
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ContainersResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Authentication Error
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ: []
+      summary: Get All Containers
+      tags:
+      - Containers
+      x-pagination:
+        cursorParam: page[cursor]
+        cursorPath: meta.pagination.next_cursor
+        limitParam: page[size]
+        resultsPath: data
+  /api/v2/cost/aws_cur_config:
+    get:
+      description: List the AWS CUR configs.
+      operationId: ListCostAWSCURConfigs
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AwsCURConfigsResponse'
+          description: OK
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: List Cloud Cost Management AWS CUR configs
+      tags:
+      - Cloud Cost Management
+      x-permission:
+        operator: OR
+        permissions:
+        - CLOUD_COST_MANAGEMENT_READ
+    post:
+      description: Create a Cloud Cost Management account for an AWS CUR config.
+      operationId: CreateCostAWSCURConfig
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AwsCURConfigPostRequest'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AwsCURConfigResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Create Cloud Cost Management AWS CUR config
+      tags:
+      - Cloud Cost Management
+      x-permission:
+        operator: OR
+        permissions:
+        - CLOUD_COST_MANAGEMENT_WRITE
+  /api/v2/cost/aws_cur_config/{cloud_account_id}:
+    delete:
+      description: Archive a Cloud Cost Management Account.
+      operationId: DeleteCostAWSCURConfig
+      parameters:
+      - $ref: '#/components/parameters/CloudAccountID'
+      responses:
+        '204':
+          description: No Content
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not Found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Delete Cloud Cost Management AWS CUR config
+      tags:
+      - Cloud Cost Management
+      x-permission:
+        operator: OR
+        permissions:
+        - CLOUD_COST_MANAGEMENT_WRITE
+    patch:
+      description: Update the status of an AWS CUR config (active/archived).
+      operationId: UpdateCostAWSCURConfig
+      parameters:
+      - $ref: '#/components/parameters/CloudAccountID'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AwsCURConfigPatchRequest'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AwsCURConfigsResponse'
+          description: OK
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Update Cloud Cost Management AWS CUR config
+      tags:
+      - Cloud Cost Management
+      x-permission:
+        operator: OR
+        permissions:
+        - CLOUD_COST_MANAGEMENT_WRITE
+  /api/v2/cost/aws_related_accounts:
+    get:
+      description: List the AWS accounts in an organization by calling 'organizations:ListAccounts'
+        from the specified management account.
+      operationId: ListAWSRelatedAccounts
+      parameters:
+      - description: The ID of the management account to filter by.
+        example: '123456789123'
+        in: query
+        name: filter[management_account_id]
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AWSRelatedAccountsResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: List related AWS accounts
+      tags:
+      - Cloud Cost Management
+      x-permission:
+        operator: OR
+        permissions:
+        - CLOUD_COST_MANAGEMENT_READ
+  /api/v2/cost/azure_uc_config:
+    get:
+      description: List the Azure configs.
+      operationId: ListCostAzureUCConfigs
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AzureUCConfigsResponse'
+          description: OK
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: List Cloud Cost Management Azure configs
+      tags:
+      - Cloud Cost Management
+      x-permission:
+        operator: OR
+        permissions:
+        - CLOUD_COST_MANAGEMENT_READ
+    post:
+      description: Create a Cloud Cost Management account for an Azure config.
+      operationId: CreateCostAzureUCConfigs
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AzureUCConfigPostRequest'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AzureUCConfigPairsResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Create Cloud Cost Management Azure configs
+      tags:
+      - Cloud Cost Management
+      x-permission:
+        operator: OR
+        permissions:
+        - CLOUD_COST_MANAGEMENT_WRITE
+  /api/v2/cost/azure_uc_config/{cloud_account_id}:
+    delete:
+      description: Archive a Cloud Cost Management Account.
+      operationId: DeleteCostAzureUCConfig
+      parameters:
+      - $ref: '#/components/parameters/CloudAccountID'
+      responses:
+        '204':
+          description: No Content
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not Found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Delete Cloud Cost Management Azure config
+      tags:
+      - Cloud Cost Management
+      x-permission:
+        operator: OR
+        permissions:
+        - CLOUD_COST_MANAGEMENT_WRITE
+    patch:
+      description: Update the status of an  Azure config (active/archived).
+      operationId: UpdateCostAzureUCConfigs
+      parameters:
+      - $ref: '#/components/parameters/CloudAccountID'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AzureUCConfigPatchRequest'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AzureUCConfigPairsResponse'
           description: OK
         '400':
           content:
@@ -21284,98 +22957,42 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: Authentication Error
+          description: Forbidden
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      security:
-      - apiKeyAuth: []
-        appKeyAuth: []
-      - AuthZ: []
-      summary: Get all Container Images
+      summary: Update Cloud Cost Management Azure config
       tags:
-      - Container Images
-      x-pagination:
-        cursorParam: page[cursor]
-        cursorPath: meta.pagination.next_cursor
-        limitParam: page[size]
-        resultsPath: data
-  /api/v2/containers:
+      - Cloud Cost Management
+      x-permission:
+        operator: OR
+        permissions:
+        - CLOUD_COST_MANAGEMENT_WRITE
+  /api/v2/cost/enabled:
     get:
-      description: Get all containers for your organization.
-      operationId: ListContainers
-      parameters:
-      - description: Comma-separated list of tags to filter containers by.
-        example: env:prod,short_image:cassandra
-        in: query
-        name: filter[tags]
-        required: false
-        schema:
-          type: string
-      - description: Comma-separated list of tags to group containers by.
-        example: datacenter,cluster
-        in: query
-        name: group_by
-        required: false
-        schema:
-          type: string
-      - description: Attribute to sort containers by.
-        example: started_at
-        in: query
-        name: sort
-        required: false
-        schema:
-          type: string
-      - description: Maximum number of results returned.
-        in: query
-        name: page[size]
-        required: false
-        schema:
-          default: 1000
-          format: int32
-          maximum: 10000
-          minimum: 1
-          type: integer
-      - description: 'String to query the next page of results.
-
-          This key is provided with each valid response from the API in `meta.pagination.next_cursor`.'
-        in: query
-        name: page[cursor]
-        required: false
-        schema:
-          type: string
+      description: Get the Cloud Cost Management activity.
+      operationId: GetCloudCostActivity
       responses:
         '200':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/ContainersResponse'
+                $ref: '#/components/schemas/CloudCostActivityResponse'
           description: OK
-        '400':
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/APIErrorResponse'
-          description: Bad Request
         '403':
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: Authentication Error
+          description: Forbidden
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      security:
-      - apiKeyAuth: []
-        appKeyAuth: []
-      - AuthZ: []
-      summary: Get All Containers
+      summary: Cloud Cost Enabled
       tags:
-      - Containers
-      x-pagination:
-        cursorParam: page[cursor]
-        cursorPath: meta.pagination.next_cursor
-        limitParam: page[size]
-        resultsPath: data
+      - Cloud Cost Management
+      x-permission:
+        operator: OR
+        permissions:
+        - CLOUD_COST_MANAGEMENT_READ
   /api/v2/cost_by_tag/active_billing_dimensions:
     get:
       description: Get active billing dimensions for cost attribution. Cost data for
@@ -21409,7 +23026,8 @@ paths:
       security:
       - apiKeyAuth: []
         appKeyAuth: []
-      - AuthZ: []
+      - AuthZ:
+        - usage_read
       summary: Get active billing dimensions for cost attribution
       tags:
       - Usage Metering
@@ -21530,7 +23148,8 @@ paths:
       security:
       - apiKeyAuth: []
         appKeyAuth: []
-      - AuthZ: []
+      - AuthZ:
+        - usage_read
       summary: Get Monthly Cost Attribution
       tags:
       - Usage Metering
@@ -21947,8 +23566,7 @@ paths:
       tags:
       - DORA Metrics
       x-codegen-request-body-name: body
-      x-unstable: '**Note**: This endpoint is in private beta for CI Pipeline Visibility
-        customers.
+      x-unstable: '**Note**: This endpoint is in private beta.
 
         If you want to request access, complete the [form](https://forms.gle/Eqq6uXfGjYxmqpjDA).'
   /api/v2/dora/incident:
@@ -21998,8 +23616,7 @@ paths:
       tags:
       - DORA Metrics
       x-codegen-request-body-name: body
-      x-unstable: '**Note**: This endpoint is in private beta for CI Pipeline Visibility
-        customers.
+      x-unstable: '**Note**: This endpoint is in private beta.
 
         If you want to request access, complete the [form](https://forms.gle/Eqq6uXfGjYxmqpjDA).'
   /api/v2/downtime:
@@ -25109,8 +26726,8 @@ paths:
         required: false
         schema:
           type: boolean
-      - description: 'Filter custom metrics that have or have not been queried in
-          the specified window[seconds].
+      - description: '(Beta) Filter custom metrics that have or have not been queried
+          in the specified window[seconds].
 
           If no window is provided or the window is less than 2 hours, a default of
           2 hours will be applied.'
@@ -25578,7 +27195,9 @@ paths:
         queryable.
 
         Can only be used with application keys from users with the `Manage Tags for
-        Metrics` permission.'
+        Metrics` permission. This endpoint requires
+
+        a tag configuration to be created first.'
       operationId: UpdateTagConfiguration
       parameters:
       - $ref: '#/components/parameters/MetricName'
@@ -25931,6 +27550,16 @@ paths:
         schema:
           format: int64
           type: integer
+      - $ref: '#/components/parameters/PageOffset'
+      - description: Maximum number of downtimes in the response.
+        example: 100
+        in: query
+        name: page[limit]
+        required: false
+        schema:
+          default: 30
+          format: int64
+          type: integer
       responses:
         '200':
           content:
@@ -25955,6 +27584,10 @@ paths:
       tags:
       - Downtimes
       x-codegen-request-body-name: body
+      x-pagination:
+        limitParam: page[limit]
+        pageOffsetParam: page[offset]
+        resultsPath: data
   /api/v2/permissions:
     get:
       description: Returns a list of all permissions, including name, description,
@@ -26544,10 +28177,9 @@ paths:
       - Metrics
       x-codegen-request-body-name: body
       x-unstable: '**Note**: This endpoint is GA for Metrics, Real User Monitoring
-        (RUM), and Cloud Cost Management data sources.
+        (RUM), Cloud Cost Management, and Log Management data sources.
 
-        Support for logs is in beta. We are gradually onboarding support for more
-        sources. If you have any
+        We are gradually onboarding support for more sources. If you have any
 
         feedback, contact [Datadog Support](https://docs.datadoghq.com/help/).'
   /api/v2/query/timeseries:
@@ -26587,10 +28219,9 @@ paths:
       - Metrics
       x-codegen-request-body-name: body
       x-unstable: '**Note**: This endpoint is GA for Metrics, Real User Monitoring
-        (RUM), and Cloud Cost Management data sources.
+        (RUM), Cloud Cost Management, and Log Management data sources.
 
-        Support for logs is in beta. We are gradually onboarding support for more
-        sources. If you have any
+        We are gradually onboarding support for more sources. If you have any
 
         feedback, contact [Datadog Support](https://docs.datadoghq.com/help/).'
   /api/v2/restriction_policy/{resource_id}:
@@ -27695,10 +29326,9 @@ paths:
       tags:
       - Service Scorecards
       x-codegen-request-body-name: body
-      x-unstable: '**Note**: This endpoint is in private beta. To request access,
-        fill out this [sign-up form](https://forms.gle/CcEyp1uJmZpxRv8U8),
+      x-unstable: '**Note**: This endpoint is in public beta.
 
-        and we will be in touch. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/scorecard/rules:
     get:
       description: Fetch all rules.
@@ -27823,10 +29453,9 @@ paths:
       tags:
       - Service Scorecards
       x-codegen-request-body-name: body
-      x-unstable: '**Note**: This endpoint is in private beta. To request access,
-        fill out this [sign-up form](https://forms.gle/CcEyp1uJmZpxRv8U8),
+      x-unstable: '**Note**: This endpoint is in public beta.
 
-        and we will be in touch. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/scorecard/rules/{rule_id}:
     delete:
       description: Deletes a single rule.
@@ -27852,10 +29481,9 @@ paths:
       summary: Delete a rule
       tags:
       - Service Scorecards
-      x-unstable: '**Note**: This endpoint is in private beta. To request access,
-        fill out this [sign-up form](https://forms.gle/CcEyp1uJmZpxRv8U8),
+      x-unstable: '**Note**: This endpoint is in public beta.
 
-        and we will be in touch. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/security/cloud_workload/policy/download:
     get:
       description: 'The download endpoint generates a Cloud Workload Security policy
@@ -28158,6 +29786,149 @@ paths:
       tags:
       - Security Monitoring
       x-codegen-request-body-name: body
+  /api/v2/security_monitoring/configuration/suppressions:
+    get:
+      description: Get the list of all suppression rules.
+      operationId: ListSecurityMonitoringSuppressions
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SecurityMonitoringSuppressionsResponse'
+          description: OK
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - security_monitoring_suppressions_read
+      summary: Get all suppression rules
+      tags:
+      - Security Monitoring
+    post:
+      description: Create a new suppression rule.
+      operationId: CreateSecurityMonitoringSuppression
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SecurityMonitoringSuppressionCreateRequest'
+        description: The definition of the new suppression rule.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SecurityMonitoringSuppressionResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '409':
+          $ref: '#/components/responses/ConflictResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - security_monitoring_suppressions_write
+      summary: Create a suppression rule
+      tags:
+      - Security Monitoring
+      x-codegen-request-body-name: body
+  /api/v2/security_monitoring/configuration/suppressions/{suppression_id}:
+    delete:
+      description: Delete a specific suppression rule.
+      operationId: DeleteSecurityMonitoringSuppression
+      parameters:
+      - $ref: '#/components/parameters/SecurityMonitoringSuppressionID'
+      responses:
+        '204':
+          description: OK
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - security_monitoring_suppressions_write
+      summary: Delete a suppression rule
+      tags:
+      - Security Monitoring
+    get:
+      description: Get the details of a specific suppression rule.
+      operationId: GetSecurityMonitoringSuppression
+      parameters:
+      - $ref: '#/components/parameters/SecurityMonitoringSuppressionID'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SecurityMonitoringSuppressionResponse'
+          description: OK
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - security_monitoring_suppressions_read
+      summary: Get a suppression rule
+      tags:
+      - Security Monitoring
+    patch:
+      description: Update a specific suppression rule.
+      operationId: UpdateSecurityMonitoringSuppression
+      parameters:
+      - $ref: '#/components/parameters/SecurityMonitoringSuppressionID'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SecurityMonitoringSuppressionUpdateRequest'
+        description: New definition of the suppression rule. Supports partial updates.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SecurityMonitoringSuppressionResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '409':
+          $ref: '#/components/responses/ConcurrentModificationResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - security_monitoring_suppressions_write
+      summary: Update a suppression rule
+      tags:
+      - Security Monitoring
   /api/v2/security_monitoring/rules:
     get:
       description: List rules.
@@ -30220,6 +31991,10 @@ paths:
       summary: Get team memberships
       tags:
       - Teams
+      x-pagination:
+        limitParam: page[size]
+        pageParam: page[number]
+        resultsPath: data
     post:
       description: Add a user to a team.
       operationId: CreateTeamMembership
@@ -31024,7 +32799,7 @@ paths:
       - Usage Metering
   /api/v2/usage/lambda_traced_invocations:
     get:
-      description: 'Get hourly usage for lambda traced invocations.
+      description: 'Get hourly usage for Lambda traced invocations.
 
         **Note:** hourly usage data for all products is now available in the [Get
         hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
@@ -31078,7 +32853,7 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for lambda traced invocations
+      summary: Get hourly usage for Lambda traced invocations
       tags:
       - Usage Metering
   /api/v2/usage/observability_pipelines:
@@ -31662,41 +33437,59 @@ servers:
       default: api
       description: The subdomain where the API is deployed.
 tags:
+- description: Configure your API endpoints through the Datadog API.
+  name: API Management
 - description: Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters)
     for your organization. You need an API and application key with Admin rights to
-    interact with this endpoint.
+    interact with this endpoint. See [retention filters](https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/#retention-filters)
+    on the Trace Retention page for more information.
   externalDocs:
     description: Find out more at
     url: https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/
   name: APM Retention Filters
 - description: Search your Audit Logs events over HTTP.
   name: Audit
-- description: '[AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example)
+- description: '[The AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example)
 
-    is used to automatically map group of users to roles in Datadog using attributes
+    is used to automatically map groups of users to roles in Datadog using attributes
 
-    sent from Identity Providers.'
+    sent from Identity Providers. Use these endpoints to manage your AuthN Mappings.'
   name: AuthN Mappings
 - description: Search or aggregate your CI Visibility pipeline events and send them
-    to your Datadog site over HTTP.
+    to your Datadog site over HTTP. See the [CI Pipeline Visibility in Datadog page](https://docs.datadoghq.com/continuous_integration/pipelines/)
+    for more information.
   name: CI Visibility Pipelines
-- description: Search or aggregate your CI Visibility test events over HTTP.
+- description: Search or aggregate your CI Visibility test events over HTTP. See the
+    [Test Visibility in Datadog page](https://docs.datadoghq.com/tests/) for more
+    information.
   name: CI Visibility Tests
+- description: The Cloud Cost Management API allows you to set up, edit, and delete
+    Cloud Cost Management accounts for AWS and Azure. See the [Cloud Cost Management
+    page](https://docs.datadoghq.com/cloud_cost_management/) for more information.
+  name: Cloud Cost Management
 - description: Workload activity security rules for generating events using the Datadog
-    security Agent.
+    security Agent. See the [Setting up CSM Workload Security page](https://docs.datadoghq.com/security/cloud_security_management/setup/csm_workload_security/)
+    for more information.
   name: Cloud Workload Security
-- description: Configure your Datadog Cloudflare integration directly through the
-    Datadog API.
+- description: Manage your Datadog Cloudflare integration directly through the Datadog
+    API. See the [Cloudflare integration page](https://docs.datadoghq.com/integrations/cloudflare/)
+    for more information.
   name: Cloudflare Integration
-- description: Configure your Datadog Confluent Cloud integration directly through
-    the Datadog API.
+- description: Manage your Datadog Confluent Cloud integration accounts and account
+    resources directly through the Datadog API. See the [Confluent Cloud page](https://docs.datadoghq.com/integrations/confluent_cloud/)
+    for more information.
   name: Confluent Cloud
 - description: The Container Images API allows you to query Container Image data for
-    your organization.
+    your organization. See the [Container Images View page](https://docs.datadoghq.com/infrastructure/containers/container_images/)
+    for more information.
   name: Container Images
 - description: The Containers API allows you to query container data for your organization.
+    See the [Container Monitoring page](https://docs.datadoghq.com/containers/) for
+    more information.
   name: Containers
 - description: Send events for DORA Metrics to measure and improve software delivery.
+    See the [DORA Metrics page](https://docs.datadoghq.com/dora_metrics/) for more
+    information.
   name: DORA Metrics
 - description: 'Interact with your dashboard lists through the API to
 
@@ -31716,18 +33509,15 @@ tags:
 
     end times, prevent all alerting related to specified Datadog tags.'
   name: Downtimes
-- description: 'The events service allows you to programmatically post events to the
-    event stream
+- description: 'The Event Management API allows you to programmatically post events
+    to the Events Explorer
 
-    and fetch events from the event stream. Events are limited to 4000 characters.
-
-    If an event is sent out with a message containing more than 4000 characters, only
-    the
-
-    first 4000 characters are displayed.'
+    and fetch events from the Events Explorer. See the [Event Management page](https://docs.datadoghq.com/service_management/events/)
+    for more information.'
   name: Events
-- description: Configure your Datadog Fastly integration directly through the Datadog
-    API.
+- description: Manage your Datadog Fastly integration accounts and services directly
+    through the Datadog API. See the [Fastly integration page](https://docs.datadoghq.com/integrations/fastly/)
+    for more information.
   name: Fastly Integration
 - description: 'Configure your Datadog-Google Cloud Platform (GCP) integration directly
 
@@ -31747,12 +33537,15 @@ tags:
     contacting Datadog support.'
   name: IP Allowlist
 - description: Create, update, delete, and retrieve services which can be associated
-    with incidents.
+    with incidents. See the [Incident Management page](https://docs.datadoghq.com/service_management/incident_management/)
+    for more information.
   name: Incident Services
 - description: The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/)
     to create, update, delete, and retrieve teams which can be associated with incidents.
   name: Incident Teams
-- description: Manage incident response.
+- description: Manage incident response, as well as associated attachments, metadata,
+    and todos. See the [Incident Management page](https://docs.datadoghq.com/service_management/incident_management/)
+    for more information.
   name: Incidents
 - description: 'Manage your Datadog API and application keys. You need an API key
     and
@@ -31918,7 +33711,9 @@ tags:
 
     You can retrieve up to 24 hours of hourly usage data for multiple organizations,
 
-    and up to two months of hourly usage data for a single organization in one request.'
+    and up to two months of hourly usage data for a single organization in one request.
+
+    Learn more on the [usage details documentation](https://docs.datadoghq.com/account_management/billing/usage_details/).'
   externalDocs:
     description: Find out more at
     url: https://docs.datadoghq.com/account_management/billing/usage_details/