datadog_api_client 1.10.0 → 2.0.1

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

@@ -224,6 +224,13 @@ components:
       required: true
       schema:
         type: string
+    OpsgenieServiceIDPathParameter:
+      description: The UUID of the service.
+      in: path
+      name: integration_service_id
+      required: true
+      schema:
+        type: string
     PageNumber:
       description: Specific page number to return.
       in: query
@@ -283,6 +290,13 @@ components:
       schema:
         example: 00000000-0000-1234-0000-000000000000
         type: string
+    SignalID:
+      description: The ID of the signal.
+      in: path
+      name: signal_id
+      required: true
+      schema:
+        type: string
     UserID:
       description: The ID of the user.
       in: path
@@ -1496,6 +1510,340 @@ components:
       - INTEGRATION_SCREENBOARD
       - INTEGRATION_TIMEBOARD
       - HOST_TIMEBOARD
+    Event:
+      description: The metadata associated with a request.
+      properties:
+        id:
+          description: Event ID.
+          example: '6509751066204996294'
+          type: string
+        name:
+          description: The event name.
+          type: string
+        source_id:
+          description: Event source ID.
+          example: 36
+          type: integer
+        type:
+          description: Event type.
+          example: error_tracking_alert
+          type: string
+      type: object
+    EventAttributes:
+      description: Object description of attributes from your event.
+      properties:
+        aggregation_key:
+          description: Aggregation key of the event.
+          type: string
+        date_happened:
+          description: 'POSIX timestamp of the event. Must be sent as an integer (no
+            quotation marks).
+
+            Limited to events no older than 18 hours.'
+          format: int64
+          type: integer
+        device_name:
+          description: A device name.
+          type: string
+        duration:
+          description: The duration between the triggering of the event and its recovery
+            in nanoseconds.
+          format: int64
+          type: integer
+        event_object:
+          description: The event title.
+          example: Did you hear the news today?
+          type: string
+        evt:
+          $ref: '#/components/schemas/Event'
+        hostname:
+          description: 'Host name to associate with the event.
+
+            Any tags associated with the host are also applied to this event.'
+          type: string
+        monitor:
+          $ref: '#/components/schemas/MonitorType'
+        monitor_groups:
+          description: List of groups referred to in the event.
+          items:
+            description: Group referred to in the event.
+            type: string
+          nullable: true
+          type: array
+        monitor_id:
+          description: ID of the monitor that triggered the event. When an event isn't
+            related to a monitor, this field is empty.
+          nullable: true
+          type: integer
+        priority:
+          $ref: '#/components/schemas/EventPriority'
+        related_event_id:
+          description: Related event ID.
+          type: integer
+        service:
+          description: Service that triggered the event.
+          example: datadog-api
+          type: string
+        source_type_name:
+          description: 'The type of event being posted.
+
+            For example, `nagios`, `hudson`, `jenkins`, `my_apps`, `chef`, `puppet`,
+            `git` or `bitbucket`.
+
+            The list of standard source attribute values is [available here](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).'
+          type: string
+        sourcecategory:
+          description: Identifier for the source of the event, such as a monitor alert,
+            an externally-submitted event, or an integration.
+          type: string
+        status:
+          $ref: '#/components/schemas/EventStatusType'
+        tags:
+          description: A list of tags to apply to the event.
+          example:
+          - environment:test
+          items:
+            description: A tag.
+            type: string
+          type: array
+        timestamp:
+          description: POSIX timestamp of your event in milliseconds.
+          example: 1652274265000
+          format: int64
+          type: integer
+        title:
+          description: The event title.
+          example: Oh boy!
+          type: string
+      type: object
+    EventPriority:
+      description: The priority of the event's monitor. For example, `normal` or `low`.
+      enum:
+      - normal
+      - low
+      example: normal
+      nullable: true
+      type: string
+      x-enum-varnames:
+      - NORMAL
+      - LOW
+    EventResponse:
+      description: The object description of an event after being processed and stored
+        by Datadog.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/EventResponseAttributes'
+        id:
+          description: the unique ID of the event.
+          example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA
+          type: string
+        type:
+          $ref: '#/components/schemas/EventType'
+      type: object
+    EventResponseAttributes:
+      description: The object description of an event response attribute.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/EventAttributes'
+        tags:
+          description: An array of tags associated with the event.
+          example:
+          - team:A
+          items:
+            description: The tag associated with the event.
+            type: string
+          type: array
+        timestamp:
+          description: The timestamp of the event.
+          example: '2019-01-02T09:42:36.320Z'
+          format: date-time
+          type: string
+      type: object
+    EventStatusType:
+      description: 'If an alert event is enabled, its status is one of the following:
+
+        `failure`, `error`, `warning`, `info`, `success`, `user_update`,
+
+        `recommendation`, or `snapshot`.'
+      enum:
+      - failure
+      - error
+      - warning
+      - info
+      - success
+      - user_update
+      - recommendation
+      - snapshot
+      example: info
+      type: string
+      x-enum-varnames:
+      - FAILURE
+      - ERROR
+      - WARNING
+      - INFO
+      - SUCCESS
+      - USER_UPDATE
+      - RECOMMENDATION
+      - SNAPSHOT
+    EventType:
+      default: event
+      description: Type of the event.
+      enum:
+      - event
+      example: event
+      type: string
+      x-enum-varnames:
+      - EVENT
+    EventsListRequest:
+      description: The object sent with the request to retrieve a list of events from
+        your organization.
+      properties:
+        filter:
+          $ref: '#/components/schemas/EventsQueryFilter'
+        options:
+          $ref: '#/components/schemas/EventsQueryOptions'
+        page:
+          $ref: '#/components/schemas/EventsRequestPage'
+        sort:
+          $ref: '#/components/schemas/EventsSort'
+      type: object
+    EventsListResponse:
+      description: The response object with all events matching the request and pagination
+        information.
+      properties:
+        data:
+          description: An array of events matching the request.
+          items:
+            $ref: '#/components/schemas/EventResponse'
+          type: array
+        links:
+          $ref: '#/components/schemas/EventsListResponseLinks'
+        meta:
+          $ref: '#/components/schemas/EventsResponseMetadata'
+      type: object
+    EventsListResponseLinks:
+      description: Links attributes.
+      properties:
+        next:
+          description: 'Link for the next set of results. Note that the request can
+            also be made using the
+
+            POST endpoint.'
+          example: https://app.datadoghq.com/api/v2/events?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==
+          type: string
+      type: object
+    EventsQueryFilter:
+      description: The search and filter query settings.
+      properties:
+        from:
+          default: now-15m
+          description: The minimum time for the requested events. Supports date math
+            and regular timestamps in milliseconds.
+          example: now-15m
+          type: string
+        query:
+          default: '*'
+          description: The search query following the event search syntax.
+          example: service:web* AND @http.status_code:[200 TO 299]
+          type: string
+        to:
+          default: now
+          description: The maximum time for the requested events. Supports date math
+            and regular timestamps in milliseconds.
+          example: now
+          type: string
+      type: object
+    EventsQueryOptions:
+      description: 'The global query options that are used. Either provide a timezone
+        or a time offset but not both,
+
+        otherwise the query fails.'
+      properties:
+        timeOffset:
+          description: The time offset to apply to the query in seconds.
+          format: int64
+          type: integer
+        timezone:
+          default: UTC
+          description: 'The timezone can be specified as an offset, for example: `UTC+03:00`.'
+          example: GMT
+          type: string
+      type: object
+    EventsRequestPage:
+      description: Pagination settings.
+      properties:
+        cursor:
+          description: The returned paging point to use to get the next results.
+          example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==
+          type: string
+        limit:
+          default: 10
+          description: The maximum number of logs in the response.
+          example: 25
+          format: int32
+          maximum: 1000
+          type: integer
+      type: object
+    EventsResponseMetadata:
+      description: The metadata associated with a request.
+      properties:
+        elapsed:
+          description: The time elapsed in milliseconds.
+          example: 132
+          format: int64
+          type: integer
+        page:
+          $ref: '#/components/schemas/EventsResponseMetadataPage'
+        request_id:
+          description: The identifier of the request.
+          example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR
+          type: string
+        warnings:
+          description: 'A list of warnings (non-fatal errors) encountered. Partial
+            results might be returned if
+
+            warnings are present in the response.'
+          items:
+            $ref: '#/components/schemas/EventsWarning'
+          type: array
+      type: object
+    EventsResponseMetadataPage:
+      description: Pagination attributes.
+      properties:
+        after:
+          description: 'The cursor to use to get the next results, if any. To make
+            the next request, use the same
+
+            parameters with the addition of the `page[cursor]`.'
+          example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==
+          type: string
+      type: object
+    EventsSort:
+      description: The sort parameters when querying events.
+      enum:
+      - timestamp
+      - -timestamp
+      type: string
+      x-enum-varnames:
+      - TIMESTAMP_ASCENDING
+      - TIMESTAMP_DESCENDING
+    EventsWarning:
+      description: A warning message indicating something is wrong with the query.
+      properties:
+        code:
+          description: A unique code for this type of warning.
+          example: unknown_index
+          type: string
+        detail:
+          description: A detailed explanation of this specific warning.
+          example: 'indexes: foo, bar'
+          type: string
+        title:
+          description: A short human-readable summary of the warning.
+          example: One or several indexes are missing or invalid. Results hold data
+            from the other indexes.
+          type: string
+      type: object
     FullAPIKey:
       description: Datadog API key.
       properties:
@@ -1669,6 +2017,84 @@ components:
       required:
       - message
       type: object
+    HourlyUsage:
+      description: Hourly usage for a product family for an org.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/HourlyUsageAttributes'
+        id:
+          description: Unique ID of the response.
+          type: string
+        type:
+          $ref: '#/components/schemas/UsageTimeSeriesType'
+      type: object
+    HourlyUsageAttributes:
+      description: Attributes of hourly usage for a product family for an org for
+        a time period.
+      properties:
+        measurements:
+          description: List of the measured usage values for the product family for
+            the org for the time period.
+          items:
+            $ref: '#/components/schemas/HourlyUsageMeasurement'
+          type: array
+        org_name:
+          description: The organization name.
+          type: string
+        product_family:
+          description: The product for which usage is being reported.
+          type: string
+        public_id:
+          description: The organization public ID.
+          type: string
+        region:
+          description: The region of the Datadog instance that the organization belongs
+            to.
+          type: string
+        timestamp:
+          description: Datetime in ISO-8601 format, UTC. The hour for the usage.
+          format: date-time
+          type: string
+      type: object
+    HourlyUsageMeasurement:
+      description: Usage amount for a given usage type.
+      properties:
+        usage_type:
+          description: Type of usage.
+          type: string
+        value:
+          description: Contains the number measured for the given usage_type during
+            the hour.
+          format: int64
+          nullable: true
+          type: integer
+      type: object
+    HourlyUsageMetadata:
+      description: The object containing document metadata.
+      properties:
+        pagination:
+          $ref: '#/components/schemas/HourlyUsagePagination'
+      type: object
+    HourlyUsagePagination:
+      description: The metadata for the current pagination.
+      properties:
+        next_record_id:
+          description: The cursor to get the next results (if any). To make the next
+            request, use the same parameters and add `next_record_id`.
+          nullable: true
+          type: string
+      type: object
+    HourlyUsageResponse:
+      description: Hourly usage response.
+      properties:
+        data:
+          description: Response containing hourly usage.
+          items:
+            $ref: '#/components/schemas/HourlyUsage'
+          type: array
+        meta:
+          $ref: '#/components/schemas/HourlyUsageMetadata'
+      type: object
     HourlyUsageType:
       description: Usage type that is being measured.
       enum:
@@ -2605,11 +3031,13 @@ components:
     IntakePayloadAccepted:
       description: The payload accepted for intake.
       properties:
-        status:
-          description: The status of the intake payload.
-          example: ok
-          type: string
-      type: object
+        errors:
+          description: A list of errors.
+          items:
+            description: An empty error list.
+            type: string
+          type: array
+      type: object
     ListApplicationKeysResponse:
       description: Response for a list of application keys.
       properties:
@@ -4101,13 +4529,13 @@ components:
       x-enum-varnames:
       - METRIC_VOLUMES
     MetricIntakeType:
-      description: The type of metric.
+      description: The type of metric. The available types are `0` (unspecified),
+        `1` (count), `2` (rate), and `3` (gauge).
       enum:
       - 0
       - 1
       - 2
       - 3
-      - 15
       format: int32
       type: integer
       x-enum-varnames:
@@ -4115,7 +4543,6 @@ components:
       - COUNT
       - RATE
       - GAUGE
-      - UNSPECIFIED_LEGACY
     MetricMetadata:
       description: Metadata for the metric.
       properties:
@@ -4158,6 +4585,9 @@ components:
             points:
             - timestamp: 1475317847
               value: 0.7
+            resources:
+            - name: dummyhost
+              type: host
           items:
             $ref: '#/components/schemas/MetricSeries'
           type: array
@@ -4185,12 +4615,15 @@ components:
       type: object
     MetricResource:
       description: Metric resource.
+      example:
+        name: dummyhost
+        type: host
       properties:
         name:
-          description: The name of the metric.
+          description: The name of the resource.
           type: string
         type:
-          description: The type of metric.
+          description: The type of the resource.
           type: string
       type: object
     MetricSeries:
@@ -4310,7 +4743,6 @@ components:
         aggregations:
           $ref: '#/components/schemas/MetricCustomAggregations'
         include_percentiles:
-          default: false
           description: 'Toggle to include/exclude percentiles for a distribution metric.
 
             Defaults to false. Can only be applied to metrics that have a `metric_type`
@@ -4402,7 +4834,6 @@ components:
         aggregations:
           $ref: '#/components/schemas/MetricCustomAggregations'
         include_percentiles:
-          default: false
           description: 'Toggle to include/exclude percentiles for a distribution metric.
 
             Defaults to false. Can only be applied to metrics that have a `metric_type`
@@ -4488,6 +4919,54 @@ components:
           type: array
       readOnly: true
       type: object
+    MonitorType:
+      description: Attributes from the monitor that triggered the event.
+      nullable: true
+      properties:
+        created_at:
+          description: The POSIX timestamp of the monitor's creation in nanoseconds.
+          example: 1646318692000
+          type: integer
+        group_status:
+          description: Monitor group status used when there is no `result_groups`.
+          type: integer
+        groups:
+          description: Groups to which the monitor belongs.
+          items:
+            description: A group.
+            type: string
+          type: array
+        id:
+          description: The monitor ID.
+          type: integer
+        message:
+          description: The monitor message.
+          type: string
+        modified:
+          description: The monitor's last-modified timestamp.
+          type: integer
+        name:
+          description: The monitor name.
+          type: string
+        query:
+          description: The query that triggers the alert.
+          type: string
+        tags:
+          description: A list of tags attached to the monitor.
+          example:
+          - environment:test
+          items:
+            description: A tag.
+            type: string
+          type: array
+        templated_name:
+          description: The templated name of the monitor before resolving any template
+            variables.
+          type: string
+        type:
+          description: The monitor type.
+          type: string
+      type: object
     NullableRelationshipToUser:
       description: Relationship to user.
       properties:
@@ -4510,6 +4989,174 @@ components:
       - id
       - type
       type: object
+    OpsgenieServiceCreateAttributes:
+      description: The Opsgenie service attributes for a create request.
+      properties:
+        custom_url:
+          description: The custom URL for a custom region.
+          example: https://example.com
+          type: string
+        name:
+          description: The name for the Opsgenie service.
+          example: fake-opsgenie-service-name
+          type: string
+        opsgenie_api_key:
+          description: The Opsgenie API key for your Opsgenie service.
+          example: 00000000-0000-0000-0000-000000000000
+          type: string
+        region:
+          $ref: '#/components/schemas/OpsgenieServiceRegionType'
+      required:
+      - name
+      - opsgenie_api_key
+      - region
+      type: object
+    OpsgenieServiceCreateData:
+      description: Opsgenie service data for a create request.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/OpsgenieServiceCreateAttributes'
+        type:
+          $ref: '#/components/schemas/OpsgenieServiceType'
+      required:
+      - type
+      - attributes
+      type: object
+    OpsgenieServiceCreateRequest:
+      description: Create request for an Opsgenie service.
+      properties:
+        data:
+          $ref: '#/components/schemas/OpsgenieServiceCreateData'
+      required:
+      - data
+      type: object
+    OpsgenieServiceRegionType:
+      description: The region for the Opsgenie service.
+      enum:
+      - us
+      - eu
+      - custom
+      example: us
+      type: string
+      x-enum-varnames:
+      - US
+      - EU
+      - CUSTOM
+    OpsgenieServiceResponse:
+      description: Response of an Opsgenie service.
+      properties:
+        data:
+          $ref: '#/components/schemas/OpsgenieServiceResponseData'
+      required:
+      - data
+      type: object
+    OpsgenieServiceResponseAttributes:
+      description: The attributes from an Opsgenie service response.
+      properties:
+        custom_url:
+          description: The custom URL for a custom region.
+          example: null
+          nullable: true
+          type: string
+        name:
+          description: The name for the Opsgenie service.
+          example: fake-opsgenie-service-name
+          type: string
+        region:
+          $ref: '#/components/schemas/OpsgenieServiceRegionType'
+      type: object
+    OpsgenieServiceResponseData:
+      description: Opsgenie service data from a response.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/OpsgenieServiceResponseAttributes'
+        id:
+          description: The ID of the Opsgenie service.
+          example: 596da4af-0563-4097-90ff-07230c3f9db3
+          type: string
+        type:
+          $ref: '#/components/schemas/OpsgenieServiceType'
+      required:
+      - id
+      - type
+      - attributes
+      type: object
+    OpsgenieServiceType:
+      default: opsgenie-service
+      description: Opsgenie service resource type.
+      enum:
+      - opsgenie-service
+      example: opsgenie-service
+      type: string
+      x-enum-varnames:
+      - OPSGENIE_SERVICE
+    OpsgenieServiceUpdateAttributes:
+      description: The Opsgenie service attributes for an update request.
+      properties:
+        custom_url:
+          description: The custom URL for a custom region.
+          example: https://example.com
+          nullable: true
+          type: string
+        name:
+          description: The name for the Opsgenie service.
+          example: fake-opsgenie-service-name
+          type: string
+        opsgenie_api_key:
+          description: The Opsgenie API key for your Opsgenie service.
+          example: 00000000-0000-0000-0000-000000000000
+          type: string
+        region:
+          $ref: '#/components/schemas/OpsgenieServiceRegionType'
+      type: object
+    OpsgenieServiceUpdateData:
+      description: Opsgenie service for an update request.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/OpsgenieServiceUpdateAttributes'
+        id:
+          description: The ID of the Opsgenie service.
+          example: 596da4af-0563-4097-90ff-07230c3f9db3
+          type: string
+        type:
+          $ref: '#/components/schemas/OpsgenieServiceType'
+      required:
+      - id
+      - type
+      - attributes
+      type: object
+    OpsgenieServiceUpdateRequest:
+      description: Update request for an Opsgenie service.
+      properties:
+        data:
+          $ref: '#/components/schemas/OpsgenieServiceUpdateData'
+      required:
+      - data
+      type: object
+    OpsgenieServicesResponse:
+      description: Response with a list of Opsgenie services.
+      properties:
+        data:
+          description: An array of Opsgenie services.
+          example:
+          - attributes:
+              custom_url: null
+              name: fake-opsgenie-service-name
+              region: us
+            id: 596da4af-0563-4097-90ff-07230c3f9db3
+            type: opsgenie-service
+          - attributes:
+              custom_url: null
+              name: fake-opsgenie-service-name-2
+              region: eu
+            id: 0d2937f1-b561-44fa-914a-99910f848014
+            type: opsgenie-service
+          items:
+            $ref: '#/components/schemas/OpsgenieServiceResponseData'
+          type: array
+      required:
+      - data
+      type: object
     Organization:
       description: Organization object.
       properties:
@@ -6167,6 +6814,17 @@ components:
       - cases
       - message
       type: object
+    SecurityMonitoringRuleDecreaseCriticalityBasedOnEnv:
+      description: 'If true, signals in non-production environments have a lower severity
+        than what is defined by the rule case, which can reduce signal noise.
+
+        The severity is decreased by one level: `CRITICAL` in production becomes `HIGH`
+        in non-production, `HIGH` becomes `MEDIUM` and so on. `INFO` remains `INFO`.
+
+        The decrement is applied when the environment tag of the signal starts with
+        `staging`, `test` or `dev`.'
+      example: false
+      type: boolean
     SecurityMonitoringRuleDetectionMethod:
       description: The detection method.
       enum:
@@ -6294,6 +6952,10 @@ components:
           $ref: '#/components/schemas/SecurityMonitoringRuleNewValueOptionsForgetAfter'
         learningDuration:
           $ref: '#/components/schemas/SecurityMonitoringRuleNewValueOptionsLearningDuration'
+        learningMethod:
+          $ref: '#/components/schemas/SecurityMonitoringRuleNewValueOptionsLearningMethod'
+        learningThreshold:
+          $ref: '#/components/schemas/SecurityMonitoringRuleNewValueOptionsLearningThreshold'
       type: object
     SecurityMonitoringRuleNewValueOptionsForgetAfter:
       description: The duration in days after which a learned value is forgotten.
@@ -6314,6 +6976,7 @@ components:
       - THREE_WEEKS
       - FOUR_WEEKS
     SecurityMonitoringRuleNewValueOptionsLearningDuration:
+      default: 0
       description: 'The duration in days during which values are learned, and after
         which signals will be generated for values that
 
@@ -6329,9 +6992,34 @@ components:
       - ZERO_DAYS
       - ONE_DAY
       - SEVEN_DAYS
+    SecurityMonitoringRuleNewValueOptionsLearningMethod:
+      default: duration
+      description: The learning method used to determine when signals should be generated
+        for values that weren't learned.
+      enum:
+      - duration
+      - threshold
+      type: string
+      x-enum-varnames:
+      - DURATION
+      - THRESHOLD
+    SecurityMonitoringRuleNewValueOptionsLearningThreshold:
+      default: 0
+      description: A number of occurrences after which signals will be generated for
+        values that weren't learned.
+      enum:
+      - 0
+      - 1
+      format: int32
+      type: integer
+      x-enum-varnames:
+      - ZERO_OCCURRENCES
+      - ONE_OCCURRENCE
     SecurityMonitoringRuleOptions:
       description: Options on rules.
       properties:
+        decreaseCriticalityBasedOnEnv:
+          $ref: '#/components/schemas/SecurityMonitoringRuleDecreaseCriticalityBasedOnEnv'
         detectionMethod:
           $ref: '#/components/schemas/SecurityMonitoringRuleDetectionMethod'
         evaluationWindow:
@@ -6369,6 +7057,13 @@ components:
 
             aggregations.'
           type: string
+        metrics:
+          description: Group of target fields to aggregate over when using the new
+            value aggregations.
+          items:
+            description: Field.
+            type: string
+          type: array
         name:
           description: Name of the query.
           type: string
@@ -6415,6 +7110,13 @@ components:
 
             aggregations.'
           type: string
+        metrics:
+          description: Group of target fields to aggregate over when using the new
+            value aggregations.
+          items:
+            description: Field.
+            type: string
+          type: array
         name:
           description: Name of the query.
           type: string
@@ -6590,6 +7292,49 @@ components:
         type:
           $ref: '#/components/schemas/SecurityMonitoringSignalType'
       type: object
+    SecurityMonitoringSignalArchiveComment:
+      description: Optional comment to display on archived signals.
+      type: string
+    SecurityMonitoringSignalArchiveReason:
+      description: Reason a signal is archived.
+      enum:
+      - none
+      - false_positive
+      - testing_or_maintenance
+      - other
+      type: string
+      x-enum-varnames:
+      - NONE
+      - FALSE_POSITIVE
+      - TESTING_OR_MAINTENANCE
+      - OTHER
+    SecurityMonitoringSignalAssigneeUpdateAttributes:
+      description: Attributes describing the new assignee of a security signal.
+      properties:
+        assignee:
+          $ref: '#/components/schemas/SecurityMonitoringTriageUser'
+        version:
+          $ref: '#/components/schemas/SecurityMonitoringSignalVersion'
+      required:
+      - assignee
+      type: object
+    SecurityMonitoringSignalAssigneeUpdateData:
+      description: Data containing the patch for changing the assignee of a signal.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/SecurityMonitoringSignalAssigneeUpdateAttributes'
+      required:
+      - attributes
+      type: object
+    SecurityMonitoringSignalAssigneeUpdateRequest:
+      description: Request body for changing the assignee of a given security monitoring
+        signal.
+      properties:
+        data:
+          $ref: '#/components/schemas/SecurityMonitoringSignalAssigneeUpdateData'
+      required:
+      - data
+      type: object
     SecurityMonitoringSignalAttributes:
       description: 'The object containing all signal attributes and their
 
@@ -6627,6 +7372,44 @@ components:
           format: date-time
           type: string
       type: object
+    SecurityMonitoringSignalIncidentIds:
+      description: Array of incidents that are associated with this signal.
+      items:
+        description: Public ID attribute of the incident that is associated with the
+          signal.
+        example: 2066
+        format: int64
+        type: integer
+      type: array
+    SecurityMonitoringSignalIncidentsUpdateAttributes:
+      description: Attributes describing the new list of related signals for a security
+        signal.
+      properties:
+        incident_ids:
+          $ref: '#/components/schemas/SecurityMonitoringSignalIncidentIds'
+        version:
+          $ref: '#/components/schemas/SecurityMonitoringSignalVersion'
+      required:
+      - incident_ids
+      type: object
+    SecurityMonitoringSignalIncidentsUpdateData:
+      description: Data containing the patch for changing the related incidents of
+        a signal.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/SecurityMonitoringSignalIncidentsUpdateAttributes'
+      required:
+      - attributes
+      type: object
+    SecurityMonitoringSignalIncidentsUpdateRequest:
+      description: Request body for changing the related incidents of a given security
+        monitoring signal.
+      properties:
+        data:
+          $ref: '#/components/schemas/SecurityMonitoringSignalIncidentsUpdateData'
+      required:
+      - data
+      type: object
     SecurityMonitoringSignalListRequest:
       description: The request for a security signal list.
       properties:
@@ -6671,6 +7454,96 @@ components:
           maximum: 1000
           type: integer
       type: object
+    SecurityMonitoringSignalState:
+      description: The new triage state of the signal.
+      enum:
+      - open
+      - archived
+      - under_review
+      type: string
+      x-enum-varnames:
+      - OPEN
+      - ARCHIVED
+      - UNDER_REVIEW
+    SecurityMonitoringSignalStateUpdateAttributes:
+      description: Attributes describing the change of state of a security signal.
+      properties:
+        archive_comment:
+          $ref: '#/components/schemas/SecurityMonitoringSignalArchiveComment'
+        archive_reason:
+          $ref: '#/components/schemas/SecurityMonitoringSignalArchiveReason'
+        state:
+          $ref: '#/components/schemas/SecurityMonitoringSignalState'
+        version:
+          $ref: '#/components/schemas/SecurityMonitoringSignalVersion'
+      required:
+      - state
+      type: object
+    SecurityMonitoringSignalStateUpdateData:
+      description: Data containing the patch for changing the state of a signal.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/SecurityMonitoringSignalStateUpdateAttributes'
+      required:
+      - attributes
+      type: object
+    SecurityMonitoringSignalStateUpdateRequest:
+      description: Request body for changing the state of a given security monitoring
+        signal.
+      properties:
+        data:
+          $ref: '#/components/schemas/SecurityMonitoringSignalStateUpdateData'
+      required:
+      - data
+      type: object
+    SecurityMonitoringSignalTriageAttributes:
+      description: Attributes describing a triage state update operation over a security
+        signal.
+      properties:
+        archive_comment:
+          $ref: '#/components/schemas/SecurityMonitoringSignalArchiveComment'
+        archive_comment_timestamp:
+          description: Timestamp of the last edit to the comment.
+          format: int64
+          minimum: 0
+          type: integer
+        archive_comment_user:
+          $ref: '#/components/schemas/SecurityMonitoringTriageUser'
+        archive_reason:
+          $ref: '#/components/schemas/SecurityMonitoringSignalArchiveReason'
+        assignee:
+          $ref: '#/components/schemas/SecurityMonitoringTriageUser'
+        incident_ids:
+          $ref: '#/components/schemas/SecurityMonitoringSignalIncidentIds'
+        state:
+          $ref: '#/components/schemas/SecurityMonitoringSignalState'
+        state_update_timestamp:
+          description: Timestamp of the last update to the signal state.
+          format: int64
+          minimum: 0
+          type: integer
+        state_update_user:
+          $ref: '#/components/schemas/SecurityMonitoringTriageUser'
+      required:
+      - assignee
+      - state
+      - incident_ids
+      type: object
+    SecurityMonitoringSignalTriageUpdateData:
+      description: Data containing the updated triage attributes of the signal.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/SecurityMonitoringSignalTriageAttributes'
+      type: object
+    SecurityMonitoringSignalTriageUpdateResponse:
+      description: The response returned after all triage operations, containing the
+        updated signal triage data.
+      properties:
+        data:
+          $ref: '#/components/schemas/SecurityMonitoringSignalTriageUpdateData'
+      required:
+      - data
+      type: object
     SecurityMonitoringSignalType:
       default: signal
       description: The type of event.
@@ -6680,6 +7553,11 @@ components:
       type: string
       x-enum-varnames:
       - SIGNAL
+    SecurityMonitoringSignalVersion:
+      description: Version of the updated signal. If server side version is higher,
+        update will be rejected.
+      format: int64
+      type: integer
     SecurityMonitoringSignalsListResponse:
       description: 'The response object with all security signals matching the request
 
@@ -6732,6 +7610,26 @@ components:
       x-enum-varnames:
       - TIMESTAMP_ASCENDING
       - TIMESTAMP_DESCENDING
+    SecurityMonitoringTriageUser:
+      description: Object representing a given user entity.
+      properties:
+        handle:
+          description: The handle for this user account.
+          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.
+          type: string
+        uuid:
+          description: UUID assigned by Datadog to this user account.
+          example: 773b045d-ccf8-4808-bd3b-955ef6a8c940
+          type: string
+      required:
+      - uuid
+      type: object
     ServiceAccountCreateAttributes:
       description: Attributes of the created user.
       properties:
@@ -7136,7 +8034,6 @@ components:
         authorizationCode:
           authorizationUrl: /oauth2/v1/authorize
           scopes:
-            dashboards_public_share: Share dashboards externally.
             dashboards_read: View dashboards.
             dashboards_write: Create and change dashboards.
             events_read: Read Events data.
@@ -7144,6 +8041,7 @@ components:
             incident_settings_write: Configure Incidents settings.
             incident_write: Create, view, and manage incidents in Datadog.
             metrics_read: View custom metrics.
+            monitors_read: View monitors.
             security_monitoring_filters_read: Read Security Filters.
             security_monitoring_filters_write: Create, edit, and delete Security Filters.
             security_monitoring_rules_read: Read Detection Rules.
@@ -8304,35 +9202,162 @@ paths:
       x-menu-order: 3
       x-undo:
         type: safe
-  /api/v2/incidents:
+  /api/v2/events:
     get:
-      description: Get all incidents for the user's organization.
-      operationId: ListIncidents
+      description: 'List endpoint returns events that match an events search query.
+
+        [Results are paginated similarly to logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination).
+
+
+        Use this endpoint to see your latest events.'
+      operationId: ListEvents
       parameters:
-      - $ref: '#/components/parameters/IncidentIncludeQueryParameter'
-      - $ref: '#/components/parameters/PageSize'
-      - $ref: '#/components/parameters/PageOffset'
-      responses:
-        '200':
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/IncidentsResponse'
-          description: OK
-        '400':
-          $ref: '#/components/responses/BadRequestResponse'
-        '401':
-          $ref: '#/components/responses/UnauthorizedResponse'
-        '403':
-          $ref: '#/components/responses/ForbiddenResponse'
-        '404':
-          $ref: '#/components/responses/NotFoundResponse'
-        '429':
-          $ref: '#/components/responses/TooManyRequestsResponse'
-      security:
-      - apiKeyAuth: []
-        appKeyAuth: []
-      - AuthZ:
+      - description: Search query following events syntax.
+        in: query
+        name: filter[query]
+        required: false
+        schema:
+          type: string
+      - description: Minimum timestamp for requested events.
+        in: query
+        name: filter[from]
+        required: false
+        schema:
+          type: string
+      - description: Maximum timestamp for requested events.
+        in: query
+        name: filter[to]
+        required: false
+        schema:
+          type: string
+      - description: Order of events in results.
+        in: query
+        name: sort
+        required: false
+        schema:
+          $ref: '#/components/schemas/EventsSort'
+      - description: List following results with a cursor provided in the previous
+          query.
+        example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==
+        in: query
+        name: page[cursor]
+        required: false
+        schema:
+          type: string
+      - description: Maximum number of events in the response.
+        example: 25
+        in: query
+        name: page[limit]
+        required: false
+        schema:
+          default: 10
+          format: int32
+          maximum: 1000
+          type: integer
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/EventsListResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - events_read
+      summary: Get a list of events
+      tags:
+      - Events
+      x-menu-order: 1
+      x-pagination:
+        cursorParam: page[cursor]
+        cursorPath: meta.page.after
+        limitParam: page[limit]
+        resultsPath: data
+      x-undo:
+        type: safe
+      x-unstable: '**Note**: This endpoint is in private beta.
+
+        For access, contact [Datadog support](https://docs.datadoghq.com/help/).'
+  /api/v2/events/search:
+    post:
+      description: 'List endpoint returns events that match an events search query.
+
+        [Results are paginated similarly to logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination).
+
+
+        Use this endpoint to build complex events filtering and search.'
+      operationId: SearchEvents
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/EventsListRequest'
+        required: false
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/EventsListResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Search events
+      tags:
+      - Events
+      x-codegen-request-body-name: body
+      x-menu-order: 2
+      x-pagination:
+        cursorParam: body.page.cursor
+        cursorPath: meta.page.after
+        limitParam: body.page.limit
+        resultsPath: data
+      x-undo:
+        type: safe
+      x-unstable: '**Note**: This endpoint is in private beta.
+
+        For access, contact [Datadog support](https://docs.datadoghq.com/help/).'
+  /api/v2/incidents:
+    get:
+      description: Get all incidents for the user's organization.
+      operationId: ListIncidents
+      parameters:
+      - $ref: '#/components/parameters/IncidentIncludeQueryParameter'
+      - $ref: '#/components/parameters/PageSize'
+      - $ref: '#/components/parameters/PageOffset'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/IncidentsResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '401':
+          $ref: '#/components/responses/UnauthorizedResponse'
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
         - incident_read
       summary: Get a list of incidents
       tags:
@@ -8512,6 +9537,159 @@ paths:
       x-unstable: '**Note**: This endpoint is in public beta.
 
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+  /api/v2/integration/opsgenie/services:
+    get:
+      description: Get a list of all services from the Datadog Opsgenie integration.
+      operationId: ListOpsgenieServices
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/OpsgenieServicesResponse'
+          description: OK
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Get all service objects
+      tags:
+      - Opsgenie Integration
+      x-menu-order: 1
+      x-undo:
+        type: safe
+    post:
+      description: Create a new service object in the Opsgenie integration.
+      operationId: CreateOpsgenieService
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/OpsgenieServiceCreateRequest'
+        description: Opsgenie service payload
+        required: true
+      responses:
+        '201':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/OpsgenieServiceResponse'
+          description: CREATED
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '409':
+          $ref: '#/components/responses/ConflictResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Create a new service object
+      tags:
+      - Opsgenie Integration
+      x-codegen-request-body-name: body
+      x-given:
+        opsgenie_service:
+          parameters:
+          - name: body
+            value: "{\n  \"data\": {\n    \"attributes\": {\n      \"name\": \"{{
+              unique }}\",\n      \"opsgenie_api_key\": \"00000000-0000-0000-0000-000000000000\",\n
+              \     \"region\": \"us\"\n     },\n     \"type\": \"opsgenie-service\"\n
+              \ }\n}"
+          step: there is a valid "opsgenie_service" in the system
+      x-menu-order: 2
+      x-undo:
+        operationId: DeleteOpsgenieService
+        parameters:
+        - name: integration_service_id
+          source: data.id
+        type: unsafe
+  /api/v2/integration/opsgenie/services/{integration_service_id}:
+    delete:
+      description: Delete a single service object in the Datadog Opsgenie integration.
+      operationId: DeleteOpsgenieService
+      parameters:
+      - $ref: '#/components/parameters/OpsgenieServiceIDPathParameter'
+      responses:
+        '204':
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Delete a single service object
+      tags:
+      - Opsgenie Integration
+      x-menu-order: 5
+      x-undo:
+        type: idempotent
+    get:
+      description: Get a single service from the Datadog Opsgenie integration.
+      operationId: GetOpsgenieService
+      parameters:
+      - $ref: '#/components/parameters/OpsgenieServiceIDPathParameter'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/OpsgenieServiceResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '409':
+          $ref: '#/components/responses/ConflictResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Get a single service object
+      tags:
+      - Opsgenie Integration
+      x-menu-order: 3
+      x-undo:
+        type: safe
+    patch:
+      description: Update a single service object in the Datadog Opsgenie integration.
+      operationId: UpdateOpsgenieService
+      parameters:
+      - $ref: '#/components/parameters/OpsgenieServiceIDPathParameter'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/OpsgenieServiceUpdateRequest'
+        description: Opsgenie service payload.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/OpsgenieServiceResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '409':
+          $ref: '#/components/responses/ConflictResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Update a single service object
+      tags:
+      - Opsgenie Integration
+      x-codegen-request-body-name: body
+      x-menu-order: 4
+      x-undo:
+        type: idempotent
   /api/v2/logs:
     post:
       description: 'Send your logs to your Datadog platform over HTTP. Limits per
@@ -9575,10 +10753,6 @@ paths:
       x-menu-order: 5
       x-undo:
         type: safe
-      x-unstable: "**Note: Use of this endpoint for count/gauge/rate metric types
-        is only accessible for Metrics without Limits™ beta customers.\nIf you\u2019re
-        interested in Metrics without Limits™, please contact your Customer
-        Success Manager.**"
   /api/v2/metrics/config/bulk-tags:
     delete:
       description: 'Delete all custom lists of queryable tag keys for a set of existing
@@ -9885,10 +11059,6 @@ paths:
       x-menu-order: 4
       x-undo:
         type: idempotent
-      x-unstable: "**Note: Use of this endpoint for count/gauge/rate metric types
-        is only accessible for Metrics without Limits™ beta customers.\nIf you\u2019re
-        interested in Metrics without Limits™, please contact your Customer
-        Success Manager.**"
     get:
       description: Returns the tag configuration for the given metric name.
       operationId: ListTagConfigurationByName
@@ -9919,16 +11089,17 @@ paths:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
           description: Too Many Requests
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - metrics_read
       summary: List tag configuration by name
       tags:
       - Metrics
       x-menu-order: 2
       x-undo:
         type: safe
-      x-unstable: "**Note: Use of this endpoint for count/gauge/rate metric types
-        is only accessible for Metrics without Limits™ beta customers.\nIf you\u2019re
-        interested in Metrics without Limits™, please contact your Customer
-        Success Manager.**"
     patch:
       description: 'Update the tag configuration of a metric or percentile aggregations
         of a distribution metric or custom aggregations
@@ -9984,10 +11155,6 @@ paths:
       x-menu-order: 3
       x-undo:
         type: idempotent
-      x-unstable: "**Note: Use of this endpoint for count/gauge/rate metric types
-        is only accessible for Metrics without Limits™ beta customers.\nIf you\u2019re
-        interested in Metrics without Limits™, please contact your Customer
-        Success Manager.**"
     post:
       description: 'Create and define a list of queryable tag keys for an existing
         count/gauge/rate/distribution metric.
@@ -10061,21 +11228,11 @@ paths:
         - name: metric_name
           source: data.id
         type: unsafe
-      x-unstable: "**Note: Use of this endpoint for count/gauge/rate metric types
-        is only accessible for Metrics without Limits™ beta customers.\nIf you\u2019re
-        interested in Metrics without Limits™, please contact your Customer
-        Success Manager.**"
   /api/v2/metrics/{metric_name}/volumes:
     get:
       description: 'View distinct metrics volumes for the given metric name.
 
 
-        Custom distribution metrics will return both ingested and indexed custom metric
-        volumes.
-
-        For Metrics without Limits™ beta customers, all metrics will return
-        both ingested/indexed volumes.
-
         Custom metrics generated in-app from other products will return `null` for
         ingested volumes.'
       operationId: ListVolumesByMetricName
@@ -11096,11 +12253,6 @@ paths:
           $ref: '#/components/responses/NotAuthorizedResponse'
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      security:
-      - apiKeyAuth: []
-        appKeyAuth: []
-      - AuthZ:
-        - security_monitoring_rules_read
       summary: Get the latest Cloud Workload Security policy
       tags:
       - Cloud Workload Security
@@ -11702,9 +12854,6 @@ paths:
         resultsPath: data
       x-undo:
         type: safe
-      x-unstable: '**Note**: This endpoint is in public beta.
-
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/security_monitoring/signals/search:
     post:
       description: 'Returns security signals that match a search query.
@@ -11749,9 +12898,159 @@ paths:
         resultsPath: data
       x-undo:
         type: safe
-      x-unstable: '**Note**: This endpoint is in public beta.
-
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+  /api/v2/security_monitoring/signals/{signal_id}/assignee:
+    patch:
+      description: Modify the triage assignee of a security signal.
+      operationId: EditSecurityMonitoringSignalAssignee
+      parameters:
+      - $ref: '#/components/parameters/SignalID'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SecurityMonitoringSignalAssigneeUpdateRequest'
+        description: Attributes describing the signal update.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SecurityMonitoringSignalTriageUpdateResponse'
+          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
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not Found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - security_monitoring_signals_write
+      summary: Modify the triage assignee of a security signal
+      tags:
+      - Security Monitoring
+      x-codegen-request-body-name: body
+      x-undo:
+        type: idempotent
+  /api/v2/security_monitoring/signals/{signal_id}/incidents:
+    patch:
+      description: Change the related incidents for a security signal.
+      operationId: EditSecurityMonitoringSignalIncidents
+      parameters:
+      - $ref: '#/components/parameters/SignalID'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SecurityMonitoringSignalIncidentsUpdateRequest'
+        description: Attributes describing the signal update.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SecurityMonitoringSignalTriageUpdateResponse'
+          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
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not Found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - security_monitoring_signals_write
+      summary: Change the related incidents of a security signal
+      tags:
+      - Security Monitoring
+      x-codegen-request-body-name: body
+      x-undo:
+        type: idempotent
+  /api/v2/security_monitoring/signals/{signal_id}/state:
+    patch:
+      description: Change the triage state of a security signal.
+      operationId: EditSecurityMonitoringSignalState
+      parameters:
+      - $ref: '#/components/parameters/SignalID'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SecurityMonitoringSignalStateUpdateRequest'
+        description: Attributes describing the signal update.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SecurityMonitoringSignalTriageUpdateResponse'
+          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
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not Found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - security_monitoring_signals_write
+      summary: Change the triage state of a security signal
+      tags:
+      - Security Monitoring
+      x-codegen-request-body-name: body
+      x-undo:
+        type: idempotent
   /api/v2/series:
     post:
       description: "The metrics end-point allows you to post time-series data that
@@ -11761,7 +13060,7 @@ paths:
         metrics directly to the Datadog API without using DogStatsD, expect:\n\n-
         64 bits for the timestamp\n- 64 bits for the value\n- 20 bytes for the metric
         names\n- 50 bytes for the timeseries\n- The full payload is approximately
-        100 bytes."
+        100 bytes.\n\nHost name is one of the resources in the Resources field."
       operationId: SubmitMetrics
       parameters:
       - description: HTTP header used to compress the media-type.
@@ -12500,7 +13799,10 @@ paths:
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/usage/application_security:
     get:
-      description: Get hourly usage for Application Security .
+      description: 'Get hourly usage for application security .
+
+        **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)'
       operationId: GetUsageApplicationSecurityMonitoring
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -12551,10 +13853,10 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for Application Security
+      summary: Get hourly usage for application security
       tags:
       - Usage Metering
-      x-menu-order: 38
+      x-menu-order: 37
       x-undo:
         type: safe
   /api/v2/usage/cost_by_org:
@@ -12612,12 +13914,220 @@ paths:
       summary: Get cost across multi-org account
       tags:
       - Usage Metering
+      x-menu-order: 5
+      x-undo:
+        type: safe
+  /api/v2/usage/estimated_cost:
+    get:
+      description: 'Get estimated cost across multi-org and single root-org accounts.
+
+        Estimated cost data is only available for the current month and previous month.
+        To access historical costs prior to this, use the /cost_by_org endpoint.'
+      operationId: GetEstimatedCostByOrg
+      parameters:
+      - description: String to specify whether cost is broken down at a parent-org
+          level or at the sub-org level. Currently, only the 'sub-org' view is supported.
+        in: query
+        name: view
+        required: true
+        schema:
+          type: string
+      - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]`
+          for cost beginning this month. Either start_month or start_date should be
+          specified, but not both. (start_month cannot go beyond two months in the
+          past)'
+        in: query
+        name: start_month
+        required: false
+        schema:
+          format: date-time
+          type: string
+      - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]`
+          for cost ending this month.'
+        in: query
+        name: end_month
+        required: false
+        schema:
+          format: date-time
+          type: string
+      - description: 'Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]`
+          for cost beginning this day. Either start_month or start_date should be
+          specified, but not both. (start_date cannot go beyond two months in the
+          past)'
+        in: query
+        name: start_date
+        required: false
+        schema:
+          format: date-time
+          type: string
+      - description: 'Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]`
+          for cost ending this day.'
+        in: query
+        name: end_date
+        required: false
+        schema:
+          format: date-time
+          type: string
+      responses:
+        '200':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/CostByOrgResponse'
+          description: OK
+        '400':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden - User is not authorized
+        '429':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Too many requests
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - usage_read
+      summary: Get estimated cost across your account
+      tags:
+      - Usage Metering
       x-menu-order: 39
       x-undo:
         type: safe
+      x-unstable: '**Note**: This endpoint is in public beta.
+
+        Only the sub-org view is available currently, the summary view will be released
+        at a later date.'
+  /api/v2/usage/hourly_usage:
+    get:
+      description: Get hourly usage by product family
+      operationId: GetHourlyUsage
+      parameters:
+      - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
+          for usage beginning at this hour.'
+        in: query
+        name: filter[timestamp][start]
+        required: true
+        schema:
+          format: date-time
+          type: string
+      - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
+          for usage ending **before** this hour.'
+        in: query
+        name: filter[timestamp][end]
+        required: false
+        schema:
+          format: date-time
+          type: string
+      - description: 'Comma separated list of product families to retrieve. Available
+          families are `all`, `analyzed_logs`,
+
+          `application_security`, `audit_logs`, `serverless`, `ci_app`, `cspm`, `custom_events`,
+          `cws`, `dbm`, `fargate`,
+
+          `infra_hosts`, `incident_management`, `indexed_logs`, `indexed_spans`, `ingested_spans`,
+          `iot`,
+
+          `lambda_traced_invocations`, `logs`, `network_flows`, `network_hosts`, `observability_pipelines`,
+
+          `online_archive`, `profiling`, `rum`, `rum_browser_sessions`, `rum_mobile_sessions`,
+          `sds`, `snmp`,
+
+          `synthetics_api`, `synthetics_browser`, and `timeseries`.'
+        in: query
+        name: filter[product_families]
+        required: true
+        schema:
+          type: string
+      - description: Include child org usage in the response. Defaults to false.
+        in: query
+        name: filter[include_descendants]
+        required: false
+        schema:
+          default: false
+          type: boolean
+      - description: 'Comma separated list of product family versions to use in the
+          format `product_family:version`. For example,
+
+          `infra_hosts:1.0.0`. If this parameter is not used, the API will use the
+          latest version of each requested
+
+          product family. Currently all families have one version `1.0.0`.'
+        in: query
+        name: filter[versions]
+        required: false
+        schema:
+          type: string
+      - description: Maximum number of results to return (between 1 and 500) - defaults
+          to 500 if limit not specified.
+        in: query
+        name: page[limit]
+        required: false
+        schema:
+          default: 500
+          format: int32
+          maximum: 500
+          minimum: 1
+          type: integer
+      - description: List following results with a next_record_id provided in the
+          previous query.
+        in: query
+        name: page[next_record_id]
+        required: false
+        schema:
+          type: string
+      responses:
+        '200':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/HourlyUsageResponse'
+          description: OK
+        '400':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden - User is not authorized
+        '429':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Too many requests
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - usage_read
+      summary: Get hourly usage by product family
+      tags:
+      - Usage Metering
+      x-menu-order: 1
+      x-undo:
+        type: safe
   /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)'
       operationId: GetUsageLambdaTracedInvocations
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -12668,15 +14178,18 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for Lambda Traced Invocations
+      summary: Get hourly usage for lambda traced invocations
       tags:
       - Usage Metering
-      x-menu-order: 38
+      x-menu-order: 36
       x-undo:
         type: safe
   /api/v2/usage/observability_pipelines:
     get:
-      description: Get hourly usage for Observability Pipelines.
+      description: 'Get hourly usage for observability pipelines.
+
+        **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)'
       operationId: GetUsageObservabilityPipelines
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -12727,7 +14240,7 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for Observability Pipelines
+      summary: Get hourly usage for observability pipelines
       tags:
       - Usage Metering
       x-menu-order: 38
@@ -13227,6 +14740,16 @@ tags:
 
     organization.'
   name: Dashboard Lists
+- description: 'The events service allows you to programmatically post events to the
+    event stream
+
+    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.'
+  name: Events
 - description: Create, update, delete, and retrieve services which can be associated
     with incidents.
   name: Incident Services
@@ -13273,6 +14796,12 @@ tags:
     that set number.\n\nThe Post, Patch, and Delete `manage_tags` API methods can
     only be performed by\na user who has the `Manage Tags for Metrics` permission."
   name: Metrics
+- description: 'Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/)
+
+    directly through the Datadog API.'
+  externalDocs:
+    url: https://docs.datadoghq.com/api/latest/opsgenie-integration
+  name: Opsgenie Integration
 - description: Create, edit, and manage your organizations. Read more about [multi-org
     accounts](https://docs.datadoghq.com/account_management/multi_organization).
   externalDocs: