datadog_api_client 1.7.0 → 1.8.0

data/.generator/schemas/v1/openapi.yaml

@@ -97,7 +97,7 @@ components:
 
             For example, `env:production,instance-type:c1.*,!region:us-east-1`'
           example:
-          - <KEY>:<VALUE>
+          - $KEY:$VALUE
           items:
             description: The list of the filter_tags.
             type: string
@@ -107,7 +107,7 @@ components:
 
             and metrics reporting through this integration.'
           example:
-          - <KEY>:<VALUE>
+          - $KEY:$VALUE
           items:
             description: The list of the the host_tags.
             type: string
@@ -755,8 +755,7 @@ components:
         event_query:
           $ref: '#/components/schemas/LogQueryDefinition'
         formulas:
-          description: List of formulas that operate on queries. **This feature is
-            currently in beta.**
+          description: List of formulas that operate on queries.
           items:
             $ref: '#/components/schemas/WidgetFormula'
           type: array
@@ -780,7 +779,6 @@ components:
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
-            **This feature is currently in beta.**
           items:
             $ref: '#/components/schemas/FormulaAndFunctionQueryDefinition'
           type: array
@@ -798,17 +796,7 @@ components:
       description: Response of monitor IDs that can or can't be safely deleted.
       properties:
         data:
-          description: Wrapper object with the list of monitor IDs.
-          example: {}
-          properties:
-            ok:
-              description: An array of of Monitor IDs that can be safely deleted.
-              items:
-                description: ID of a monitor that can be safely deleted.
-                format: int64
-                type: integer
-              type: array
-          type: object
+          $ref: '#/components/schemas/CheckCanDeleteMonitorResponseData'
         errors:
           additionalProperties:
             description: Strings denoting where a monitor is used.
@@ -821,19 +809,23 @@ components:
       required:
       - data
       type: object
+    CheckCanDeleteMonitorResponseData:
+      description: Wrapper object with the list of monitor IDs.
+      example: {}
+      properties:
+        ok:
+          description: An array of of Monitor IDs that can be safely deleted.
+          items:
+            description: ID of a monitor that can be safely deleted.
+            format: int64
+            type: integer
+          type: array
+      type: object
     CheckCanDeleteSLOResponse:
       description: A service level objective response containing the requested object.
       properties:
         data:
-          description: An array of service level objective objects.
-          properties:
-            ok:
-              description: An array of of SLO IDs that can be safely deleted.
-              items:
-                description: An SLO ID.
-                type: string
-              type: array
-          type: object
+          $ref: '#/components/schemas/CheckCanDeleteSLOResponseData'
         errors:
           additionalProperties:
             description: Description of the service level objective reference.
@@ -841,6 +833,16 @@ components:
           description: A mapping of SLO id to it's current usages.
           type: object
       type: object
+    CheckCanDeleteSLOResponseData:
+      description: An array of service level objective objects.
+      properties:
+        ok:
+          description: An array of of SLO IDs that can be safely deleted.
+          items:
+            description: An SLO ID.
+            type: string
+          type: array
+      type: object
     CheckStatusWidgetDefinition:
       description: Check status shows the current status or number of results for
         any check performed.
@@ -1905,75 +1907,11 @@ components:
     EventCreateResponse:
       description: Object containing an event response.
       properties:
-        alert_type:
-          $ref: '#/components/schemas/EventAlertType'
-        date_happened:
-          description: 'POSIX timestamp of the event. Must be sent as an integer (that
-            is no quotes).
-
-            Limited to events no older than 7 days.'
-          format: int64
-          type: integer
-        device_name:
-          description: A device name.
-          type: string
-        host:
-          description: 'Host name to associate with the event.
-
-            Any tags associated with the host are also applied to this event.'
-          type: string
-        id:
-          description: Integer ID of the event.
-          format: int64
-          readOnly: true
-          type: integer
-        payload:
-          description: Payload of the event.
-          example: '{}'
-          readOnly: true
-          type: string
-        priority:
-          $ref: '#/components/schemas/EventPriority'
-        related_event_id:
-          description: ID of the parent event. Must be sent as an integer (that is
-            no quotes).
-          format: int64
-          type: integer
-        source_type_name:
-          description: 'The type of event being posted. Option examples include nagios,
-            hudson, jenkins, my_apps, chef, puppet, git, bitbucket, etc.
-
-            A complete list of source attribute values [available here](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).'
-          type: string
+        event:
+          $ref: '#/components/schemas/Event'
         status:
           description: A status.
           type: string
-        tags:
-          description: A list of tags to apply to the event.
-          example:
-          - environment:test
-          items:
-            description: A tag.
-            type: string
-          type: array
-        text:
-          description: 'The body of the event. Limited to 4000 characters. The text
-            supports markdown.
-
-            Use `msg_text` with the Datadog Ruby library.'
-          example: Oh boy!
-          maxLength: 4000
-          type: string
-        title:
-          description: The event title. Limited to 100 characters. Use `msg_title`
-            with the Datadog Ruby library.
-          example: Did you hear the news today?
-          maxLength: 100
-          type: string
-        url:
-          description: URL of the event.
-          readOnly: true
-          type: string
       type: object
     EventListResponse:
       description: An event list response.
@@ -1993,6 +1931,7 @@ components:
       - normal
       - low
       example: normal
+      nullable: true
       type: string
       x-enum-varnames:
       - NORMAL
@@ -2297,22 +2236,7 @@ components:
       description: A formula and functions events query.
       properties:
         compute:
-          description: Compute options.
-          properties:
-            aggregation:
-              $ref: '#/components/schemas/FormulaAndFunctionEventAggregation'
-            interval:
-              description: A time interval in milliseconds.
-              example: 60000
-              format: int64
-              type: integer
-            metric:
-              description: Measurable attribute to compute.
-              example: '@duration'
-              type: string
-          required:
-          - aggregation
-          type: object
+          $ref: '#/components/schemas/FormulaAndFunctionEventQueryDefinitionCompute'
         data_source:
           $ref: '#/components/schemas/FormulaAndFunctionEventsDataSource'
         group_by:
@@ -2337,20 +2261,39 @@ components:
           example: query_errors
           type: string
         search:
-          description: Search options.
-          properties:
-            query:
-              description: Events search string.
-              example: service:query
-              type: string
-          required:
-          - query
-          type: object
+          $ref: '#/components/schemas/FormulaAndFunctionEventQueryDefinitionSearch'
       required:
       - data_source
       - compute
       - name
       type: object
+    FormulaAndFunctionEventQueryDefinitionCompute:
+      description: Compute options.
+      properties:
+        aggregation:
+          $ref: '#/components/schemas/FormulaAndFunctionEventAggregation'
+        interval:
+          description: A time interval in milliseconds.
+          example: 60000
+          format: int64
+          type: integer
+        metric:
+          description: Measurable attribute to compute.
+          example: '@duration'
+          type: string
+      required:
+      - aggregation
+      type: object
+    FormulaAndFunctionEventQueryDefinitionSearch:
+      description: Search options.
+      properties:
+        query:
+          description: Events search string.
+          example: service:query
+          type: string
+      required:
+      - query
+      type: object
     FormulaAndFunctionEventQueryGroupBy:
       description: List of objects used to group by.
       properties:
@@ -2364,21 +2307,23 @@ components:
           format: int64
           type: integer
         sort:
-          description: Options for sorting group by results.
-          properties:
-            aggregation:
-              $ref: '#/components/schemas/FormulaAndFunctionEventAggregation'
-            metric:
-              description: Metric used for sorting group by results.
-              type: string
-            order:
-              $ref: '#/components/schemas/QuerySortOrder'
-          required:
-          - aggregation
-          type: object
+          $ref: '#/components/schemas/FormulaAndFunctionEventQueryGroupBySort'
       required:
       - facet
       type: object
+    FormulaAndFunctionEventQueryGroupBySort:
+      description: Options for sorting group by results.
+      properties:
+        aggregation:
+          $ref: '#/components/schemas/FormulaAndFunctionEventAggregation'
+        metric:
+          description: Metric used for sorting group by results.
+          type: string
+        order:
+          $ref: '#/components/schemas/QuerySortOrder'
+      required:
+      - aggregation
+      type: object
     FormulaAndFunctionEventsDataSource:
       description: Data source for event platform-based queries.
       enum:
@@ -2513,7 +2458,7 @@ components:
       - $ref: '#/components/schemas/FormulaAndFunctionApmResourceStatsQueryDefinition'
       type: object
     FormulaAndFunctionResponseFormat:
-      description: Timeseries or Scalar response. **This feature is currently in beta.**
+      description: Timeseries or Scalar response.
       enum:
       - timeseries
       - scalar
@@ -2687,11 +2632,11 @@ components:
           example: '123456712345671234567'
           type: string
         client_x509_cert_url:
-          description: 'Should be `https://www.googleapis.com/robot/v1/metadata/x509/<CLIENT_EMAIL>`
+          description: 'Should be `https://www.googleapis.com/robot/v1/metadata/x509/$CLIENT_EMAIL`
 
-            where `<CLIENT_EMAIL>` is the email found in your JSON service account
+            where `$CLIENT_EMAIL` is the email found in your JSON service account
             key.'
-          example: https://www.googleapis.com/robot/v1/metadata/x509/<CLIENT_EMAIL>
+          example: https://www.googleapis.com/robot/v1/metadata/x509/$CLIENT_EMAIL
           type: string
         errors:
           description: An array of errors.
@@ -2764,23 +2709,7 @@ components:
           minItems: 1
           type: array
         style:
-          description: The style to apply to the widget.
-          example:
-            palette: hostmap_blues
-            palette_flip: false
-          properties:
-            palette:
-              description: The color palette to apply to the widget.
-              example: hostmap_blues
-              type: string
-            palette_flip:
-              description: Whether to flip the palette tones.
-              example: false
-              type: boolean
-          required:
-          - palette
-          - palette_flip
-          type: object
+          $ref: '#/components/schemas/GeomapWidgetDefinitionStyle'
         time:
           $ref: '#/components/schemas/WidgetTime'
         title:
@@ -2794,24 +2723,31 @@ components:
         type:
           $ref: '#/components/schemas/GeomapWidgetDefinitionType'
         view:
-          description: The view of the world that the map should render.
-          example:
-            focus: WORLD
-          properties:
-            focus:
-              description: The 2-letter ISO code of a country to focus the map on.
-                Or `WORLD`.
-              example: WORLD
-              type: string
-          required:
-          - focus
-          type: object
+          $ref: '#/components/schemas/GeomapWidgetDefinitionView'
       required:
       - type
       - requests
       - style
       - view
       type: object
+    GeomapWidgetDefinitionStyle:
+      description: The style to apply to the widget.
+      example:
+        palette: hostmap_blues
+        palette_flip: false
+      properties:
+        palette:
+          description: The color palette to apply to the widget.
+          example: hostmap_blues
+          type: string
+        palette_flip:
+          description: Whether to flip the palette tones.
+          example: false
+          type: boolean
+      required:
+      - palette
+      - palette_flip
+      type: object
     GeomapWidgetDefinitionType:
       default: geomap
       description: Type of the geomap widget.
@@ -2821,12 +2757,24 @@ components:
       type: string
       x-enum-varnames:
       - GEOMAP
+    GeomapWidgetDefinitionView:
+      description: The view of the world that the map should render.
+      example:
+        focus: WORLD
+      properties:
+        focus:
+          description: The 2-letter ISO code of a country to focus the map on. Or
+            `WORLD`.
+          example: WORLD
+          type: string
+      required:
+      - focus
+      type: object
     GeomapWidgetRequest:
       description: An updated geomap widget.
       properties:
         formulas:
-          description: List of formulas that operate on queries. **This feature is
-            currently in beta.**
+          description: List of formulas that operate on queries.
           items:
             $ref: '#/components/schemas/WidgetFormula'
           type: array
@@ -2837,7 +2785,6 @@ components:
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
-            **This feature is currently in beta.**
           items:
             $ref: '#/components/schemas/FormulaAndFunctionQueryDefinition'
           type: array
@@ -3123,117 +3070,9 @@ components:
           format: int64
           type: integer
         meta:
-          description: Metadata associated with your host.
-          properties:
-            agent_checks:
-              description: A list of Agent checks running on the host.
-              items:
-                $ref: '#/components/schemas/AgentCheck'
-              type: array
-            agent_version:
-              description: The Datadog Agent version.
-              example: 7.32.3
-              type: string
-            cpuCores:
-              description: The number of cores.
-              example: 1
-              format: int64
-              type: integer
-            fbsdV:
-              description: An array of Mac versions.
-              items:
-                description: The version name.
-                example: FreeBSD
-                type: string
-              type: array
-            gohai:
-              description: JSON string containing system information.
-              example: '{"cpu":{"cache_size":"8192 KB","cpu_cores":"1","cpu_logical_processors":"1","family":"6","mhz":"2712.000","model":"142","model_name":"Intel(R)
-                Core(TM) i7-8559U CPU @ 2.70GHz","stepping":"10","vendor_id":"GenuineIntel"},"filesystem":[{"kb_size":"3966896","mounted_on":"/dev","name":"udev"},{"kb_size":"797396","mounted_on":"/run","name":"tmpfs"},{"kb_size":"64800356","mounted_on":"/","name":"/dev/mapper/vagrant--vg-root"},{"kb_size":"3986972","mounted_on":"/dev/shm","name":"tmpfs"},{"kb_size":"5120","mounted_on":"/run/lock","name":"tmpfs"},{"kb_size":"3986972","mounted_on":"/sys/fs/cgroup","name":"tmpfs"},{"kb_size":"488245288","mounted_on":"/vagrant","name":"vagrant"},{"kb_size":"797392","mounted_on":"/run/user/1000","name":"tmpfs"}],"memory":{"swap_total":"1003516kB","total":"7973944kB"},"network":{"interfaces":[{"ipv4":"10.0.2.15","ipv4-network":"10.0.2.0/24","ipv6":"fe80::a00:27ff:fec2:be11","ipv6-network":"fe80::/64","macaddress":"08:00:27:c2:be:11","name":"eth0"},{"ipv4":"192.168.122.1","ipv4-network":"192.168.122.0/24","macaddress":"52:54:00:6f:1c:bf","name":"virbr0"}],"ipaddress":"10.0.2.15","ipaddressv6":"fe80::a00:27ff:fec2:be11","macaddress":"08:00:27:c2:be:11"},"platform":{"GOOARCH":"amd64","GOOS":"linux","goV":"1.16.7","hardware_platform":"x86_64","hostname":"vagrant","kernel_name":"Linux","kernel_release":"4.15.0-29-generic","kernel_version":"#31-Ubuntu
-                SMP Tue Jul 17 15:39:52 UTC 2018","machine":"x86_64","os":"GNU/Linux","processor":"x86_64","pythonV":"2.7.15rc1"}}'
-              type: string
-            install_method:
-              description: Agent install method.
-              properties:
-                installer_version:
-                  description: The installer version.
-                  example: install_script-1.7.1
-                  type: string
-                tool:
-                  description: Tool used to install the agent.
-                  example: install_script
-                  type: string
-                tool_version:
-                  description: The tool version.
-                  example: install_script
-                  type: string
-              type: object
-            macV:
-              description: An array of Mac versions.
-              items:
-                description: Version name.
-                example: Mac
-                type: string
-              type: array
-            machine:
-              description: The machine architecture.
-              example: amd64
-              type: string
-            nixV:
-              description: Array of Unix versions.
-              items:
-                description: Version name.
-                example: Ubuntu
-                type: string
-              type: array
-            platform:
-              description: The OS platform.
-              example: linux
-              type: string
-            processor:
-              description: The processor.
-              example: Intel(R) Core(TM) i7-8559U CPU @ 2.70GHz
-              type: string
-            pythonV:
-              description: The Python version.
-              example: 3.8.11
-              type: string
-            socket-fqdn:
-              description: The socket fqdn.
-              example: vagrant.vm.
-              type: string
-            socket-hostname:
-              description: The socket hostname.
-              example: vagrant
-              type: string
-            winV:
-              description: An array of Windows versions.
-              items:
-                description: Version name.
-                example: Windows
-                type: string
-              type: array
-          type: object
+          $ref: '#/components/schemas/HostMeta'
         metrics:
-          description: Host Metrics collected.
-          properties:
-            cpu:
-              description: The percent of CPU used (everything but idle).
-              example: 99.0
-              format: double
-              type: number
-            iowait:
-              description: The percent of CPU spent waiting on the IO (not reported
-                for all platforms).
-              example: 3.2
-              format: double
-              type: number
-            load:
-              description: The system load over the last 15 minutes.
-              example: 0.5
-              format: double
-              type: number
-          type: object
+          $ref: '#/components/schemas/HostMetrics'
         mute_timeout:
           description: Timeout of the mute applied to your host.
           format: int64
@@ -3334,14 +3173,7 @@ components:
           description: Notes on the title.
           type: string
         requests:
-          description: List of definitions.
-          example: {}
-          properties:
-            fill:
-              $ref: '#/components/schemas/HostMapRequest'
-            size:
-              $ref: '#/components/schemas/HostMapRequest'
-          type: object
+          $ref: '#/components/schemas/HostMapWidgetDefinitionRequests'
         scope:
           description: List of tags used to filter the map.
           items:
@@ -3349,21 +3181,7 @@ components:
             type: string
           type: array
         style:
-          description: The style to apply to the widget.
-          properties:
-            fill_max:
-              description: Max value to use to color the map.
-              type: string
-            fill_min:
-              description: Min value to use to color the map.
-              type: string
-            palette:
-              description: Color palette to apply to the widget.
-              type: string
-            palette_flip:
-              description: Whether to flip the palette tones.
-              type: boolean
-          type: object
+          $ref: '#/components/schemas/HostMapWidgetDefinitionStyle'
         title:
           description: Title of the widget.
           type: string
@@ -3378,6 +3196,31 @@ components:
       - type
       - requests
       type: object
+    HostMapWidgetDefinitionRequests:
+      description: List of definitions.
+      example: {}
+      properties:
+        fill:
+          $ref: '#/components/schemas/HostMapRequest'
+        size:
+          $ref: '#/components/schemas/HostMapRequest'
+      type: object
+    HostMapWidgetDefinitionStyle:
+      description: The style to apply to the widget.
+      properties:
+        fill_max:
+          description: Max value to use to color the map.
+          type: string
+        fill_min:
+          description: Min value to use to color the map.
+          type: string
+        palette:
+          description: Color palette to apply to the widget.
+          type: string
+        palette_flip:
+          description: Whether to flip the palette tones.
+          type: boolean
+      type: object
     HostMapWidgetDefinitionType:
       default: hostmap
       description: Type of the host map widget.
@@ -3387,6 +3230,120 @@ components:
       type: string
       x-enum-varnames:
       - HOSTMAP
+    HostMeta:
+      description: Metadata associated with your host.
+      properties:
+        agent_checks:
+          description: A list of Agent checks running on the host.
+          items:
+            $ref: '#/components/schemas/AgentCheck'
+          type: array
+        agent_version:
+          description: The Datadog Agent version.
+          example: 7.32.3
+          type: string
+        cpuCores:
+          description: The number of cores.
+          example: 1
+          format: int64
+          type: integer
+        fbsdV:
+          description: An array of Mac versions.
+          items:
+            description: The version name.
+            example: FreeBSD
+            type: string
+          type: array
+        gohai:
+          description: JSON string containing system information.
+          example: '{"cpu":{"cache_size":"8192 KB","cpu_cores":"1","cpu_logical_processors":"1","family":"6","mhz":"2712.000","model":"142","model_name":"Intel(R)
+            Core(TM) i7-8559U CPU @ 2.70GHz","stepping":"10","vendor_id":"GenuineIntel"},"filesystem":[{"kb_size":"3966896","mounted_on":"/dev","name":"udev"},{"kb_size":"797396","mounted_on":"/run","name":"tmpfs"},{"kb_size":"64800356","mounted_on":"/","name":"/dev/mapper/vagrant--vg-root"},{"kb_size":"3986972","mounted_on":"/dev/shm","name":"tmpfs"},{"kb_size":"5120","mounted_on":"/run/lock","name":"tmpfs"},{"kb_size":"3986972","mounted_on":"/sys/fs/cgroup","name":"tmpfs"},{"kb_size":"488245288","mounted_on":"/vagrant","name":"vagrant"},{"kb_size":"797392","mounted_on":"/run/user/1000","name":"tmpfs"}],"memory":{"swap_total":"1003516kB","total":"7973944kB"},"network":{"interfaces":[{"ipv4":"10.0.2.15","ipv4-network":"10.0.2.0/24","ipv6":"fe80::a00:27ff:fec2:be11","ipv6-network":"fe80::/64","macaddress":"08:00:27:c2:be:11","name":"eth0"},{"ipv4":"192.168.122.1","ipv4-network":"192.168.122.0/24","macaddress":"52:54:00:6f:1c:bf","name":"virbr0"}],"ipaddress":"10.0.2.15","ipaddressv6":"fe80::a00:27ff:fec2:be11","macaddress":"08:00:27:c2:be:11"},"platform":{"GOOARCH":"amd64","GOOS":"linux","goV":"1.16.7","hardware_platform":"x86_64","hostname":"vagrant","kernel_name":"Linux","kernel_release":"4.15.0-29-generic","kernel_version":"#31-Ubuntu
+            SMP Tue Jul 17 15:39:52 UTC 2018","machine":"x86_64","os":"GNU/Linux","processor":"x86_64","pythonV":"2.7.15rc1"}}'
+          type: string
+        install_method:
+          $ref: '#/components/schemas/HostMetaInstallMethod'
+        macV:
+          description: An array of Mac versions.
+          items:
+            description: Version name.
+            example: Mac
+            type: string
+          type: array
+        machine:
+          description: The machine architecture.
+          example: amd64
+          type: string
+        nixV:
+          description: Array of Unix versions.
+          items:
+            description: Version name.
+            example: Ubuntu
+            type: string
+          type: array
+        platform:
+          description: The OS platform.
+          example: linux
+          type: string
+        processor:
+          description: The processor.
+          example: Intel(R) Core(TM) i7-8559U CPU @ 2.70GHz
+          type: string
+        pythonV:
+          description: The Python version.
+          example: 3.8.11
+          type: string
+        socket-fqdn:
+          description: The socket fqdn.
+          example: vagrant.vm.
+          type: string
+        socket-hostname:
+          description: The socket hostname.
+          example: vagrant
+          type: string
+        winV:
+          description: An array of Windows versions.
+          items:
+            description: Version name.
+            example: Windows
+            type: string
+          type: array
+      type: object
+    HostMetaInstallMethod:
+      description: Agent install method.
+      properties:
+        installer_version:
+          description: The installer version.
+          example: install_script-1.7.1
+          type: string
+        tool:
+          description: Tool used to install the agent.
+          example: install_script
+          type: string
+        tool_version:
+          description: The tool version.
+          example: install_script
+          type: string
+      type: object
+    HostMetrics:
+      description: Host Metrics collected.
+      properties:
+        cpu:
+          description: The percent of CPU used (everything but idle).
+          example: 99.0
+          format: double
+          type: number
+        iowait:
+          description: The percent of CPU spent waiting on the IO (not reported for
+            all platforms).
+          example: 3.2
+          format: double
+          type: number
+        load:
+          description: The system load over the last 15 minutes.
+          example: 0.5
+          format: double
+          type: number
+      type: object
     HostMuteResponse:
       description: Response with the list of muted host for your organization.
       properties:
@@ -3947,90 +3904,83 @@ components:
       description: Object describing a log after being processed and stored by Datadog.
       properties:
         content:
-          description: JSON object containing all log attributes and their associated
-            values.
-          properties:
-            attributes:
-              additionalProperties: {}
-              description: JSON object of attributes from your log.
-              example:
-                customAttribute: 123
-                duration: 2345
-              type: object
-            host:
-              description: Name of the machine from where the logs are being sent.
-              example: i-0123
-              type: string
-            message:
-              description: 'The message [reserved attribute](https://docs.datadoghq.com/logs/log_collection/#reserved-attributes)
-
-                of your log. By default, Datadog ingests the value of the message
-                attribute as the body of the log entry.
-
-                That value is then highlighted and displayed in the Logstream, where
-                it is indexed for full text search.'
-              example: Host connected to remote
-              type: string
-            service:
-              description: 'The name of the application or service generating the
-                log events.
-
-                It is used to switch from Logs to APM, so make sure you define the
-                same
-
-                value when you use both products.'
-              example: agent
-              type: string
-            tags:
-              description: Array of tags associated with your log.
-              example:
-              - team:A
-              format: array
-              items:
-                description: Tag associated with your log.
-                format: string
-            timestamp:
-              description: Timestamp of your log.
-              example: '2020-05-26T13:36:14Z'
-              format: date-time
-              type: string
-          type: object
+          $ref: '#/components/schemas/LogContent'
         id:
           description: Unique ID of the Log.
           example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA
           type: string
       type: object
-    LogQueryDefinition:
-      description: The log query.
+    LogContent:
+      description: JSON object containing all log attributes and their associated
+        values.
       properties:
-        compute:
-          $ref: '#/components/schemas/LogsQueryCompute'
-        group_by:
-          description: List of tag prefixes to group by in the case of a cluster check.
-          items:
-            $ref: '#/components/schemas/LogQueryDefinitionGroupBy'
-          type: array
-        index:
-          description: A coma separated-list of index names. Use "*" query all indexes
-            at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes/#multiple-indexes)
-          example: days-3,days-7
-          type: string
-        multi_compute:
-          description: This field is mutually exclusive with `compute`.
-          items:
-            $ref: '#/components/schemas/LogsQueryCompute'
-          type: array
-        search:
-          description: The query being made on the logs.
-          properties:
-            query:
-              description: Search value to apply.
-              example: ''
-              type: string
-          required:
-          - query
+        attributes:
+          additionalProperties: {}
+          description: JSON object of attributes from your log.
+          example:
+            customAttribute: 123
+            duration: 2345
           type: object
-      type: object
+        host:
+          description: Name of the machine from where the logs are being sent.
+          example: i-0123
+          type: string
+        message:
+          description: 'The message [reserved attribute](https://docs.datadoghq.com/logs/log_collection/#reserved-attributes)
+
+            of your log. By default, Datadog ingests the value of the message attribute
+            as the body of the log entry.
+
+            That value is then highlighted and displayed in the Logstream, where it
+            is indexed for full text search.'
+          example: Host connected to remote
+          type: string
+        service:
+          description: 'The name of the application or service generating the log
+            events.
+
+            It is used to switch from Logs to APM, so make sure you define the same
+
+            value when you use both products.'
+          example: agent
+          type: string
+        tags:
+          description: Array of tags associated with your log.
+          example:
+          - team:A
+          format: array
+          items:
+            description: Tag associated with your log.
+            format: string
+        timestamp:
+          description: Timestamp of your log.
+          example: '2020-05-26T13:36:14Z'
+          format: date-time
+          type: string
+      type: object
+    LogQueryDefinition:
+      description: The log query.
+      properties:
+        compute:
+          $ref: '#/components/schemas/LogsQueryCompute'
+        group_by:
+          description: List of tag prefixes to group by in the case of a cluster check.
+          items:
+            $ref: '#/components/schemas/LogQueryDefinitionGroupBy'
+          type: array
+        index:
+          description: A coma separated-list of index names. Use "*" query all indexes
+            at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes/#multiple-indexes)
+          example: days-3,days-7
+          type: string
+        multi_compute:
+          description: This field is mutually exclusive with `compute`.
+          items:
+            $ref: '#/components/schemas/LogsQueryCompute'
+          type: array
+        search:
+          $ref: '#/components/schemas/LogQueryDefinitionSearch'
+      type: object
     LogQueryDefinitionGroupBy:
       description: Defined items in the group.
       properties:
@@ -4044,25 +3994,37 @@ components:
           format: int64
           type: integer
         sort:
-          description: Define a sorting method.
-          properties:
-            aggregation:
-              description: The aggregation method.
-              example: avg
-              type: string
-            facet:
-              description: Facet name.
-              example: '@string_query.interval'
-              type: string
-            order:
-              $ref: '#/components/schemas/WidgetSort'
-          required:
-          - aggregation
-          - order
-          type: object
+          $ref: '#/components/schemas/LogQueryDefinitionGroupBySort'
       required:
       - facet
       type: object
+    LogQueryDefinitionGroupBySort:
+      description: Define a sorting method.
+      properties:
+        aggregation:
+          description: The aggregation method.
+          example: avg
+          type: string
+        facet:
+          description: Facet name.
+          example: '@string_query.interval'
+          type: string
+        order:
+          $ref: '#/components/schemas/WidgetSort'
+      required:
+      - aggregation
+      - order
+      type: object
+    LogQueryDefinitionSearch:
+      description: The query being made on the logs.
+      properties:
+        query:
+          description: Search value to apply.
+          example: ''
+          type: string
+      required:
+      - query
+      type: object
     LogStreamWidgetDefinition:
       description: The Log Stream displays a log flow matching the defined query.
         Only available on FREE layout dashboards.
@@ -4273,15 +4235,7 @@ components:
       description: Object containing logs usage data broken down by retention period.
       properties:
         orgs:
-          description: Indexed logs usage summary for each organization for each retention
-            period with usage.
-          properties:
-            usage:
-              description: Indexed logs usage summary for each organization.
-              items:
-                $ref: '#/components/schemas/LogsByRetentionOrgUsage'
-              type: array
-          type: object
+          $ref: '#/components/schemas/LogsByRetentionOrgs'
         usage:
           description: Aggregated index logs usage for each retention period with
             usage.
@@ -4297,7 +4251,7 @@ components:
       properties:
         date:
           description: The month for the usage.
-          format: datetime
+          format: date-time
           type: string
         usage:
           description: Indexed logs usage for each active retention for the month.
@@ -4314,6 +4268,16 @@ components:
             $ref: '#/components/schemas/LogsRetentionSumUsage'
           type: array
       type: object
+    LogsByRetentionOrgs:
+      description: Indexed logs usage summary for each organization for each retention
+        period with usage.
+      properties:
+        usage:
+          description: Indexed logs usage summary for each organization.
+          items:
+            $ref: '#/components/schemas/LogsByRetentionOrgUsage'
+          type: array
+      type: object
     LogsCategoryProcessor:
       description: "Use the Category Processor to add a new attribute (without spaces
         or special characters in the new attribute name)\nto a log matching a provided
@@ -4735,31 +4699,32 @@ components:
             is out of the scope of the specified time window.'
           type: string
         time:
-          description: Timeframe to retrieve the log from.
-          properties:
-            from:
-              description: Minimum timestamp for requested logs.
-              example: '2020-02-02T02:02:02Z'
-              format: date-time
-              type: string
-            timezone:
-              description: 'Timezone can be specified both as an offset (for example
-                "UTC+03:00")
-
-                or a regional zone (for example "Europe/Paris").'
-              type: string
-            to:
-              description: Maximum timestamp for requested logs.
-              example: '2020-02-02T20:20:20Z'
-              format: date-time
-              type: string
-          required:
-          - from
-          - to
-          type: object
+          $ref: '#/components/schemas/LogsListRequestTime'
       required:
       - time
       type: object
+    LogsListRequestTime:
+      description: Timeframe to retrieve the log from.
+      properties:
+        from:
+          description: Minimum timestamp for requested logs.
+          example: '2020-02-02T02:02:02Z'
+          format: date-time
+          type: string
+        timezone:
+          description: 'Timezone can be specified both as an offset (for example "UTC+03:00")
+
+            or a regional zone (for example "Europe/Paris").'
+          type: string
+        to:
+          description: Maximum timestamp for requested logs.
+          example: '2020-02-02T20:20:20Z'
+          format: date-time
+          type: string
+      required:
+      - from
+      - to
+      type: object
     LogsListResponse:
       description: Response object with all logs matching the request and pagination
         information.
@@ -5394,15 +5359,17 @@ components:
       description: Object containing the list of metrics matching the search query.
       properties:
         results:
-          description: Search result.
-          properties:
-            metrics:
-              description: List of metrics that match the search query.
-              items:
-                description: Metric name.
-                type: string
-              type: array
-          type: object
+          $ref: '#/components/schemas/MetricSearchResponseResults'
+      type: object
+    MetricSearchResponseResults:
+      description: Search result.
+      properties:
+        metrics:
+          description: List of metrics that match the search query.
+          items:
+            description: Metric name.
+            type: string
+          type: array
       type: object
     MetricsListResponse:
       description: Object listing all metric names stored by Datadog since a given
@@ -5652,8 +5619,12 @@ components:
           example: avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100
           type: string
         restricted_roles:
-          description: A list of role identifiers that can be pulled from the Roles
-            API. Cannot be used with `locked` option.
+          description: A list of unique role identifiers to define which roles are
+            allowed to edit the monitor. Editing a monitor includes any updates to
+            the monitor configuration, monitor deletion, and muting of the monitor
+            for any amount of time. Roles unique identifiers can be pulled from the
+            [Roles API](https://docs.datadoghq.com/api/latest/roles/#list-roles) in
+            the `data.id` field.
           items:
             description: A role UUID.
             type: string
@@ -5866,14 +5837,7 @@ components:
           total_count: 2
       properties:
         counts:
-          description: The counts of monitor groups per different criteria.
-          properties:
-            status:
-              $ref: '#/components/schemas/MonitorSearchCount'
-            type:
-              $ref: '#/components/schemas/MonitorSearchCount'
-          readOnly: true
-          type: object
+          $ref: '#/components/schemas/MonitorGroupSearchResponseCounts'
         groups:
           description: The list of found monitor groups.
           items:
@@ -5883,6 +5847,15 @@ components:
         metadata:
           $ref: '#/components/schemas/MonitorSearchResponseMetadata'
       type: object
+    MonitorGroupSearchResponseCounts:
+      description: The counts of monitor groups per different criteria.
+      properties:
+        status:
+          $ref: '#/components/schemas/MonitorSearchCount'
+        type:
+          $ref: '#/components/schemas/MonitorSearchCount'
+      readOnly: true
+      type: object
     MonitorGroupSearchResult:
       description: A single monitor group search result.
       properties:
@@ -5925,22 +5898,7 @@ components:
       description: List of options associated with your monitor.
       properties:
         aggregation:
-          description: Type of aggregation performed in the monitor query.
-          properties:
-            group_by:
-              description: Group to break down the monitor on.
-              example: host
-              type: string
-            metric:
-              description: Metric name used in the monitor.
-              example: metrics.name
-              type: string
-            type:
-              description: Metric type used in the monitor.
-              example: count
-              type: string
-          readOnly: true
-          type: object
+          $ref: '#/components/schemas/MonitorOptionsAggregation'
         device_ids:
           deprecated: true
           description: IDs of the device the Synthetics monitor is running on.
@@ -5991,8 +5949,9 @@ components:
             - If `False`, `[Triggered] Monitor Title`'
           type: boolean
         locked:
+          deprecated: true
           description: Whether or not the monitor is locked (only editable by creator
-            and admins).
+            and admins). Use `restricted_roles` instead.
           type: boolean
         min_failure_duration:
           default: 0
@@ -6123,6 +6082,23 @@ components:
             $ref: '#/components/schemas/MonitorFormulaAndFunctionQueryDefinition'
           type: array
       type: object
+    MonitorOptionsAggregation:
+      description: Type of aggregation performed in the monitor query.
+      properties:
+        group_by:
+          description: Group to break down the monitor on.
+          example: host
+          type: string
+        metric:
+          description: Metric name used in the monitor.
+          example: metrics.name
+          type: string
+        type:
+          description: Metric type used in the monitor.
+          example: count
+          type: string
+      readOnly: true
+      type: object
     MonitorOverallStates:
       description: The different states your monitor can be in.
       enum:
@@ -6217,18 +6193,7 @@ components:
           type: query alert
       properties:
         counts:
-          description: The counts of monitors per different criteria.
-          properties:
-            muted:
-              $ref: '#/components/schemas/MonitorSearchCount'
-            status:
-              $ref: '#/components/schemas/MonitorSearchCount'
-            tag:
-              $ref: '#/components/schemas/MonitorSearchCount'
-            type:
-              $ref: '#/components/schemas/MonitorSearchCount'
-          readOnly: true
-          type: object
+          $ref: '#/components/schemas/MonitorSearchResponseCounts'
         metadata:
           $ref: '#/components/schemas/MonitorSearchResponseMetadata'
         monitors:
@@ -6238,6 +6203,19 @@ components:
           readOnly: true
           type: array
       type: object
+    MonitorSearchResponseCounts:
+      description: The counts of monitors per different criteria.
+      properties:
+        muted:
+          $ref: '#/components/schemas/MonitorSearchCount'
+        status:
+          $ref: '#/components/schemas/MonitorSearchCount'
+        tag:
+          $ref: '#/components/schemas/MonitorSearchCount'
+        type:
+          $ref: '#/components/schemas/MonitorSearchCount'
+      readOnly: true
+      type: object
     MonitorSearchResponseMetadata:
       description: Metadata about the response.
       properties:
@@ -6513,6 +6491,7 @@ components:
       - event-v2 alert
       - audit alert
       - ci-pipelines alert
+      - error-tracking alert
       example: query alert
       type: string
       x-enum-varnames:
@@ -6530,6 +6509,7 @@ components:
       - EVENT_V2_ALERT
       - AUDIT_ALERT
       - CI_PIPELINES_ALERT
+      - ERROR_TRACKING_ALERT
     MonitorUpdateRequest:
       description: Object describing a monitor update request.
       properties:
@@ -6580,8 +6560,12 @@ components:
           description: The monitor query.
           type: string
         restricted_roles:
-          description: A list of role identifiers that can be pulled from the Roles
-            API. Cannot be used with `locked` option.
+          description: A list of unique role identifiers to define which roles are
+            allowed to edit the monitor. Editing a monitor includes any updates to
+            the monitor configuration, monitor deletion, and muting of the monitor
+            for any amount of time. Roles unique identifiers can be pulled from the
+            [Roles API](https://docs.datadoghq.com/api/latest/roles/#list-roles) in
+            the `data.id` field.
           items:
             description: A role UUID.
             type: string
@@ -7592,11 +7576,7 @@ components:
             $ref: '#/components/schemas/NotebooksResponseData'
           type: array
         meta:
-          description: Searches metadata returned by the API.
-          properties:
-            page:
-              $ref: '#/components/schemas/NotebooksResponsePage'
-          type: object
+          $ref: '#/components/schemas/NotebooksResponseMeta'
       type: object
     NotebooksResponseData:
       description: The data for a notebook in get all response.
@@ -7653,6 +7633,12 @@ components:
       required:
       - name
       type: object
+    NotebooksResponseMeta:
+      description: Searches metadata returned by the API.
+      properties:
+        page:
+          $ref: '#/components/schemas/NotebooksResponsePage'
+      type: object
     NotebooksResponsePage:
       description: Pagination metadata returned by the API.
       properties:
@@ -7683,91 +7669,14 @@ components:
         name:
           description: The name of the new child-organization, limited to 32 characters.
           example: New child org
-          maximum: 32
+          maxLength: 32
           type: string
         public_id:
           description: The `public_id` of the organization you are operating within.
           example: abcdef12345
           type: string
         settings:
-          description: A JSON array of settings.
-          properties:
-            private_widget_share:
-              description: Whether or not the organization users can share widgets
-                outside of Datadog.
-              example: false
-              type: boolean
-            saml:
-              description: 'Set the boolean property enabled to enable or disable
-                single sign on with SAML.
-
-                See the SAML documentation for more information about all SAML settings.'
-              properties:
-                enabled:
-                  description: Whether or not SAML is enabled for this organization.
-                  example: false
-                  type: boolean
-              type: object
-            saml_autocreate_access_role:
-              $ref: '#/components/schemas/AccessRole'
-            saml_autocreate_users_domains:
-              description: Has two properties, `enabled` (boolean) and `domains`,
-                which is a list of domains without the @ symbol.
-              properties:
-                domains:
-                  description: List of domains where the SAML automated user creation
-                    is enabled.
-                  items:
-                    description: Domain to automate user creation from.
-                    example: example.com
-                    type: string
-                  type: array
-                enabled:
-                  description: Whether or not the automated user creation based on
-                    SAML domain is enabled.
-                  example: false
-                  type: boolean
-              type: object
-            saml_can_be_enabled:
-              description: Whether or not SAML can be enabled for this organization.
-              example: false
-              type: boolean
-            saml_idp_endpoint:
-              description: Identity provider endpoint for SAML authentication.
-              example: https://my.saml.endpoint
-              type: string
-            saml_idp_initiated_login:
-              description: Has one property enabled (boolean).
-              properties:
-                enabled:
-                  description: 'Whether SAML IdP initiated login is enabled, learn
-                    more
-
-                    in the [SAML documentation](https://docs.datadoghq.com/account_management/saml/#idp-initiated-login).'
-                  example: false
-                  type: boolean
-              type: object
-            saml_idp_metadata_uploaded:
-              description: Whether or not a SAML identity provider metadata file was
-                provided to the Datadog organization.
-              example: false
-              type: boolean
-            saml_login_url:
-              description: URL for SAML logging.
-              example: https://my.saml.login.url
-              type: string
-            saml_strict_mode:
-              description: Has one property enabled (boolean).
-              properties:
-                enabled:
-                  description: 'Whether or not the SAML strict mode is enabled. If
-                    true, all users must log in with SAML.
-
-                    Learn more on the [SAML Strict documentation](https://docs.datadoghq.com/account_management/saml/#saml-strict).'
-                  example: false
-                  type: boolean
-              type: object
-          type: object
+          $ref: '#/components/schemas/OrganizationSettings'
         subscription:
           $ref: '#/components/schemas/OrganizationSubscription'
       type: object
@@ -7789,7 +7698,7 @@ components:
         name:
           description: The name of the new child-organization, limited to 32 characters.
           example: New child org
-          maximum: 32
+          maxLength: 32
           type: string
         subscription:
           $ref: '#/components/schemas/OrganizationSubscription'
@@ -7823,6 +7732,91 @@ components:
         org:
           $ref: '#/components/schemas/Organization'
       type: object
+    OrganizationSettings:
+      description: A JSON array of settings.
+      properties:
+        private_widget_share:
+          description: Whether or not the organization users can share widgets outside
+            of Datadog.
+          example: false
+          type: boolean
+        saml:
+          $ref: '#/components/schemas/OrganizationSettingsSaml'
+        saml_autocreate_access_role:
+          $ref: '#/components/schemas/AccessRole'
+        saml_autocreate_users_domains:
+          $ref: '#/components/schemas/OrganizationSettingsSamlAutocreateUsersDomains'
+        saml_can_be_enabled:
+          description: Whether or not SAML can be enabled for this organization.
+          example: false
+          type: boolean
+        saml_idp_endpoint:
+          description: Identity provider endpoint for SAML authentication.
+          example: https://my.saml.endpoint
+          type: string
+        saml_idp_initiated_login:
+          $ref: '#/components/schemas/OrganizationSettingsSamlIdpInitiatedLogin'
+        saml_idp_metadata_uploaded:
+          description: Whether or not a SAML identity provider metadata file was provided
+            to the Datadog organization.
+          example: false
+          type: boolean
+        saml_login_url:
+          description: URL for SAML logging.
+          example: https://my.saml.login.url
+          type: string
+        saml_strict_mode:
+          $ref: '#/components/schemas/OrganizationSettingsSamlStrictMode'
+      type: object
+    OrganizationSettingsSaml:
+      description: 'Set the boolean property enabled to enable or disable single sign
+        on with SAML.
+
+        See the SAML documentation for more information about all SAML settings.'
+      properties:
+        enabled:
+          description: Whether or not SAML is enabled for this organization.
+          example: false
+          type: boolean
+      type: object
+    OrganizationSettingsSamlAutocreateUsersDomains:
+      description: Has two properties, `enabled` (boolean) and `domains`, which is
+        a list of domains without the @ symbol.
+      properties:
+        domains:
+          description: List of domains where the SAML automated user creation is enabled.
+          items:
+            description: Domain to automate user creation from.
+            example: example.com
+            type: string
+          type: array
+        enabled:
+          description: Whether or not the automated user creation based on SAML domain
+            is enabled.
+          example: false
+          type: boolean
+      type: object
+    OrganizationSettingsSamlIdpInitiatedLogin:
+      description: Has one property enabled (boolean).
+      properties:
+        enabled:
+          description: 'Whether SAML IdP initiated login is enabled, learn more
+
+            in the [SAML documentation](https://docs.datadoghq.com/account_management/saml/#idp-initiated-login).'
+          example: false
+          type: boolean
+      type: object
+    OrganizationSettingsSamlStrictMode:
+      description: Has one property enabled (boolean).
+      properties:
+        enabled:
+          description: 'Whether or not the SAML strict mode is enabled. If true, all
+            users must log in with SAML.
+
+            Learn more on the [SAML Strict documentation](https://docs.datadoghq.com/account_management/saml/#saml-strict).'
+          example: false
+          type: boolean
+      type: object
     OrganizationSubscription:
       deprecated: true
       description: Subscription definition.
@@ -8008,8 +8002,7 @@ components:
         event_query:
           $ref: '#/components/schemas/LogQueryDefinition'
         formulas:
-          description: List of formulas that operate on queries. **This feature is
-            currently in beta.**
+          description: List of formulas that operate on queries.
           items:
             $ref: '#/components/schemas/WidgetFormula'
           type: array
@@ -8026,7 +8019,6 @@ components:
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
-            **This feature is currently in beta.**
           items:
             $ref: '#/components/schemas/FormulaAndFunctionQueryDefinition'
           type: array
@@ -8093,33 +8085,35 @@ components:
         fields in this response indicate which deletions succeeded and failed.'
       properties:
         data:
-          description: An array of service level objective objects.
-          properties:
-            deleted:
-              description: 'An array of service level objective object IDs that indicates
-
-                which objects that were completely deleted.'
-              items:
-                description: A deleted SLO ID.
-                type: string
-              type: array
-            updated:
-              description: 'An array of service level objective object IDs that indicates
-
-                which objects that were modified (objects for which at least one
-
-                threshold was deleted, but that were not completely deleted).'
-              items:
-                description: An updated SLO ID.
-                type: string
-              type: array
-          type: object
+          $ref: '#/components/schemas/SLOBulkDeleteResponseData'
         errors:
           description: Array of errors object returned.
           items:
             $ref: '#/components/schemas/SLOBulkDeleteError'
           type: array
       type: object
+    SLOBulkDeleteResponseData:
+      description: An array of service level objective objects.
+      properties:
+        deleted:
+          description: 'An array of service level objective object IDs that indicates
+
+            which objects that were completely deleted.'
+          items:
+            description: A deleted SLO ID.
+            type: string
+          type: array
+        updated:
+          description: 'An array of service level objective object IDs that indicates
+
+            which objects that were modified (objects for which at least one
+
+            threshold was deleted, but that were not completely deleted).'
+          items:
+            description: An updated SLO ID.
+            type: string
+          type: array
+      type: object
     SLOCorrection:
       description: The response object of a list of SLO corrections.
       properties:
@@ -8253,19 +8247,7 @@ components:
           format: int64
           type: integer
         modifier:
-          description: Modifier of the object.
-          nullable: true
-          properties:
-            email:
-              description: Email of the Modifier.
-              type: string
-            handle:
-              description: Handle of the Modifier.
-              type: string
-            name:
-              description: Name of the Modifier.
-              type: string
-          type: object
+          $ref: '#/components/schemas/SLOCorrectionResponseAttributesModifier'
         rrule:
           description: 'The recurrence rules as defined in the iCalendar RFC 5545.
             The supported rules for SLO corrections
@@ -8286,6 +8268,20 @@ components:
             (defaults to "UTC").
           type: string
       type: object
+    SLOCorrectionResponseAttributesModifier:
+      description: Modifier of the object.
+      nullable: true
+      properties:
+        email:
+          description: Email of the Modifier.
+          type: string
+        handle:
+          description: Handle of the Modifier.
+          type: string
+        name:
+          description: Name of the Modifier.
+          type: string
+      type: object
     SLOCorrectionType:
       default: correction
       description: SLO correction resource type.
@@ -8453,47 +8449,7 @@ components:
           format: int64
           type: integer
         metadata:
-          description: Query metadata.
-          example: {}
-          properties:
-            aggr:
-              description: Query aggregator function.
-              type: string
-            expression:
-              description: Query expression.
-              type: string
-            metric:
-              description: Query metric used.
-              type: string
-            query_index:
-              description: Query index from original combined query.
-              format: int64
-              type: integer
-            scope:
-              description: Query scope.
-              type: string
-            unit:
-              description: 'An array of metric units that contains up to two unit
-                objects.
-
-                For example, bytes represents one unit object and bytes per second
-                represents two unit objects.
-
-                If a metric query only has one unit object, the second array element
-                is null.'
-              example:
-              - family: bytes
-                id: 2
-                name: byte
-                plural: bytes
-                scale_factor: 1.0
-                short_name: B
-              - null
-              items:
-                $ref: '#/components/schemas/SLOHistoryMetricsSeriesMetadataUnit'
-              nullable: true
-              type: array
-          type: object
+          $ref: '#/components/schemas/SLOHistoryMetricsSeriesMetadata'
         sum:
           description: Total sum of the query.
           example: 0.0
@@ -8512,6 +8468,47 @@ components:
       - sum
       - values
       type: object
+    SLOHistoryMetricsSeriesMetadata:
+      description: Query metadata.
+      example: {}
+      properties:
+        aggr:
+          description: Query aggregator function.
+          type: string
+        expression:
+          description: Query expression.
+          type: string
+        metric:
+          description: Query metric used.
+          type: string
+        query_index:
+          description: Query index from original combined query.
+          format: int64
+          type: integer
+        scope:
+          description: Query scope.
+          type: string
+        unit:
+          description: 'An array of metric units that contains up to two unit objects.
+
+            For example, bytes represents one unit object and bytes per second represents
+            two unit objects.
+
+            If a metric query only has one unit object, the second array element is
+            null.'
+          example:
+          - family: bytes
+            id: 2
+            name: byte
+            plural: bytes
+            scale_factor: 1.0
+            short_name: B
+          - null
+          items:
+            $ref: '#/components/schemas/SLOHistoryMetricsSeriesMetadataUnit'
+          nullable: true
+          type: array
+      type: object
     SLOHistoryMetricsSeriesMetadataUnit:
       description: An Object of metric units.
       nullable: true
@@ -8632,64 +8629,7 @@ components:
       description: A service level objective history response.
       properties:
         data:
-          description: An array of service level objective objects.
-          properties:
-            from_ts:
-              description: The `from` timestamp in epoch seconds.
-              example: 1615323990
-              format: int64
-              type: integer
-            group_by:
-              description: 'For `metric` based SLOs where the query includes a group-by
-                clause, this represents the list of grouping parameters.
-
-
-                This is not included in responses for `monitor` based SLOs.'
-              items:
-                description: A grouping parameter.
-                type: string
-              type: array
-            groups:
-              description: 'For grouped SLOs, this represents SLI data for specific
-                groups.
-
-
-                This is not included in the responses for `metric` based SLOs.'
-              items:
-                $ref: '#/components/schemas/SLOHistoryMonitor'
-              type: array
-            monitors:
-              description: 'For multi-monitor SLOs, this represents SLI data for specific
-                monitors.
-
-
-                This is not included in the responses for `metric` based SLOs.'
-              items:
-                $ref: '#/components/schemas/SLOHistoryMonitor'
-              type: array
-            overall:
-              $ref: '#/components/schemas/SLOHistorySLIData'
-            series:
-              $ref: '#/components/schemas/SLOHistoryMetrics'
-            thresholds:
-              additionalProperties:
-                $ref: '#/components/schemas/SLOThreshold'
-              description: mapping of string timeframe to the SLO threshold.
-              example:
-                my_service:
-                  target: 95
-                  timeframe: 7d
-              type: object
-            to_ts:
-              description: The `to` timestamp in epoch seconds.
-              example: 1615928790
-              format: int64
-              type: integer
-            type:
-              $ref: '#/components/schemas/SLOType'
-            type_id:
-              $ref: '#/components/schemas/SLOTypeNumeric'
-          type: object
+          $ref: '#/components/schemas/SLOHistoryResponseData'
         errors:
           description: A list of errors while querying the history data for the service
             level objective.
@@ -8697,32 +8637,90 @@ components:
             $ref: '#/components/schemas/SLOHistoryResponseError'
           type: array
       type: object
-    SLOHistoryResponseError:
-      description: A list of errors while querying the history data for the service
-        level objective.
-      properties:
-        error:
-          description: Human readable error.
-          type: string
-      type: object
-    SLOHistoryResponseErrorWithType:
-      description: An object describing the error with error type and error message.
+    SLOHistoryResponseData:
+      description: An array of service level objective objects.
       properties:
-        error_message:
-          description: A message with more details about the error.
-          example: ''
-          type: string
-        error_type:
-          description: Type of the error.
-          example: ''
-          type: string
-      required:
-      - error_type
-      - error_message
-      type: object
-    SLOHistorySLIData:
-      description: 'An object that holds an SLI value and its associated data. It
-        can represent an SLO''s overall SLI value.
+        from_ts:
+          description: The `from` timestamp in epoch seconds.
+          example: 1615323990
+          format: int64
+          type: integer
+        group_by:
+          description: 'For `metric` based SLOs where the query includes a group-by
+            clause, this represents the list of grouping parameters.
+
+
+            This is not included in responses for `monitor` based SLOs.'
+          items:
+            description: A grouping parameter.
+            type: string
+          type: array
+        groups:
+          description: 'For grouped SLOs, this represents SLI data for specific groups.
+
+
+            This is not included in the responses for `metric` based SLOs.'
+          items:
+            $ref: '#/components/schemas/SLOHistoryMonitor'
+          type: array
+        monitors:
+          description: 'For multi-monitor SLOs, this represents SLI data for specific
+            monitors.
+
+
+            This is not included in the responses for `metric` based SLOs.'
+          items:
+            $ref: '#/components/schemas/SLOHistoryMonitor'
+          type: array
+        overall:
+          $ref: '#/components/schemas/SLOHistorySLIData'
+        series:
+          $ref: '#/components/schemas/SLOHistoryMetrics'
+        thresholds:
+          additionalProperties:
+            $ref: '#/components/schemas/SLOThreshold'
+          description: mapping of string timeframe to the SLO threshold.
+          example:
+            my_service:
+              target: 95
+              timeframe: 7d
+          type: object
+        to_ts:
+          description: The `to` timestamp in epoch seconds.
+          example: 1615928790
+          format: int64
+          type: integer
+        type:
+          $ref: '#/components/schemas/SLOType'
+        type_id:
+          $ref: '#/components/schemas/SLOTypeNumeric'
+      type: object
+    SLOHistoryResponseError:
+      description: A list of errors while querying the history data for the service
+        level objective.
+      properties:
+        error:
+          description: Human readable error.
+          type: string
+      type: object
+    SLOHistoryResponseErrorWithType:
+      description: An object describing the error with error type and error message.
+      properties:
+        error_message:
+          description: A message with more details about the error.
+          example: ''
+          type: string
+        error_type:
+          description: Type of the error.
+          example: ''
+          type: string
+      required:
+      - error_type
+      - error_message
+      type: object
+    SLOHistorySLIData:
+      description: 'An object that holds an SLI value and its associated data. It
+        can represent an SLO''s overall SLI value.
 
         This can also represent the SLI value for a specific monitor in multi-monitor
         SLOs, or a group in grouped SLOs.'
@@ -8829,179 +8827,184 @@ components:
             type: string
           type: array
         metadata:
-          description: The metadata object containing additional information about
-            the list of SLOs.
-          properties:
-            page:
-              description: The object containing information about the pages of the
-                list of SLOs.
-              properties:
-                total_count:
-                  description: The total number of resources that could be retrieved
-                    ignoring the parameters and filters in the request.
-                  format: int64
-                  type: integer
-                total_filtered_count:
-                  description: The total number of resources that match the parameters
-                    and filters in the request. This attribute can be used by a client
-                    to determine the total number of pages.
-                  format: int64
-                  type: integer
-              type: object
-          type: object
+          $ref: '#/components/schemas/SLOListResponseMetadata'
+      type: object
+    SLOListResponseMetadata:
+      description: The metadata object containing additional information about the
+        list of SLOs.
+      properties:
+        page:
+          $ref: '#/components/schemas/SLOListResponseMetadataPage'
+      type: object
+    SLOListResponseMetadataPage:
+      description: The object containing information about the pages of the list of
+        SLOs.
+      properties:
+        total_count:
+          description: The total number of resources that could be retrieved ignoring
+            the parameters and filters in the request.
+          format: int64
+          type: integer
+        total_filtered_count:
+          description: The total number of resources that match the parameters and
+            filters in the request. This attribute can be used by a client to determine
+            the total number of pages.
+          format: int64
+          type: integer
       type: object
     SLOResponse:
       description: A service level objective response containing a single service
         level objective.
       properties:
         data:
-          description: 'A service level objective object includes a service level
-            indicator, thresholds
-
-            for one or more timeframes, and metadata (`name`, `description`, `tags`,
-            etc.).'
-          properties:
-            configured_alert_ids:
-              description: A list of SLO monitors IDs that reference this SLO. This
-                field is returned only when `with_configured_alert_ids` parameter
-                is true in query.
-              example:
-              - 123
-              - 456
-              - 789
-              items:
-                description: A monitor ID.
-                format: int64
-                type: integer
-              type: array
-            created_at:
-              description: 'Creation timestamp (UNIX time in seconds)
-
-
-                Always included in service level objective responses.'
-              format: int64
-              readOnly: true
-              type: integer
-            creator:
-              $ref: '#/components/schemas/Creator'
-            description:
-              description: 'A user-defined description of the service level objective.
-
-
-                Always included in service level objective responses (but may be `null`).
-
-                Optional in create/update requests.'
-              nullable: true
-              type: string
-            groups:
-              description: 'A list of (up to 20) monitor groups that narrow the scope
-                of a monitor service level objective.
+          $ref: '#/components/schemas/SLOResponseData'
+        errors:
+          description: 'An array of error messages. Each endpoint documents how/whether
+            this field is
 
+            used.'
+          items:
+            description: The error message.
+            type: string
+          type: array
+      type: object
+    SLOResponseData:
+      description: 'A service level objective object includes a service level indicator,
+        thresholds
 
-                Included in service level objective responses if it is not empty.
-                Optional in
+        for one or more timeframes, and metadata (`name`, `description`, `tags`, etc.).'
+      properties:
+        configured_alert_ids:
+          description: A list of SLO monitors IDs that reference this SLO. This field
+            is returned only when `with_configured_alert_ids` parameter is true in
+            query.
+          example:
+          - 123
+          - 456
+          - 789
+          items:
+            description: A monitor ID.
+            format: int64
+            type: integer
+          type: array
+        created_at:
+          description: 'Creation timestamp (UNIX time in seconds)
 
-                create/update requests for monitor service level objectives, but may
-                only be
 
-                used when then length of the `monitor_ids` field is one.'
-              example:
-              - env:prod
-              - role:mysql
-              items:
-                description: A group name, for instance `env:prod`.
-                type: string
-              type: array
-            id:
-              description: 'A unique identifier for the service level objective object.
+            Always included in service level objective responses.'
+          format: int64
+          readOnly: true
+          type: integer
+        creator:
+          $ref: '#/components/schemas/Creator'
+        description:
+          description: 'A user-defined description of the service level objective.
 
 
-                Always included in service level objective responses.'
-              readOnly: true
-              type: string
-            modified_at:
-              description: 'Modification timestamp (UNIX time in seconds)
-
-
-                Always included in service level objective responses.'
-              format: int64
-              readOnly: true
-              type: integer
-            monitor_ids:
-              description: 'A list of monitor ids that defines the scope of a monitor
-                service level
-
-                objective. **Required if type is `monitor`**.'
-              items:
-                description: A monitor ID.
-                format: int64
-                type: integer
-              type: array
-            monitor_tags:
-              description: 'The union of monitor tags for all monitors referenced
-                by the `monitor_ids`
-
-                field.
-
-                Always included in service level objective responses for monitor service
-                level
-
-                objectives (but may be empty). Ignored in create/update requests.
-                Does not
-
-                affect which monitors are included in the service level objective
-                (that is
-
-                determined entirely by the `monitor_ids` field).'
-              items:
-                description: A monitor tag.
-                type: string
-              type: array
-            name:
-              description: The name of the service level objective object.
-              example: Custom Metric SLO
-              type: string
-            query:
-              $ref: '#/components/schemas/ServiceLevelObjectiveQuery'
-            tags:
-              description: 'A list of tags associated with this service level objective.
-
-                Always included in service level objective responses (but may be empty).
-
-                Optional in create/update requests.'
-              example:
-              - env:prod
-              - app:core
-              items:
-                description: A tag to apply to your SLO.
-                type: string
-              type: array
-            thresholds:
-              description: 'The thresholds (timeframes and associated targets) for
-                this service level
-
-                objective object.'
-              example:
-              - target: 95
-                timeframe: 7d
-              - target: 95
-                timeframe: 30d
-                warning: 97
-              items:
-                $ref: '#/components/schemas/SLOThreshold'
-              type: array
-            type:
-              $ref: '#/components/schemas/SLOType'
-          type: object
-        errors:
-          description: 'An array of error messages. Each endpoint documents how/whether
-            this field is
+            Always included in service level objective responses (but may be `null`).
 
-            used.'
+            Optional in create/update requests.'
+          nullable: true
+          type: string
+        groups:
+          description: 'A list of (up to 20) monitor groups that narrow the scope
+            of a monitor service level objective.
+
+
+            Included in service level objective responses if it is not empty. Optional
+            in
+
+            create/update requests for monitor service level objectives, but may only
+            be
+
+            used when then length of the `monitor_ids` field is one.'
+          example:
+          - env:prod
+          - role:mysql
           items:
-            description: The error message.
+            description: A group name, for instance `env:prod`.
+            type: string
+          type: array
+        id:
+          description: 'A unique identifier for the service level objective object.
+
+
+            Always included in service level objective responses.'
+          readOnly: true
+          type: string
+        modified_at:
+          description: 'Modification timestamp (UNIX time in seconds)
+
+
+            Always included in service level objective responses.'
+          format: int64
+          readOnly: true
+          type: integer
+        monitor_ids:
+          description: 'A list of monitor ids that defines the scope of a monitor
+            service level
+
+            objective. **Required if type is `monitor`**.'
+          items:
+            description: A monitor ID.
+            format: int64
+            type: integer
+          type: array
+        monitor_tags:
+          description: 'The union of monitor tags for all monitors referenced by the
+            `monitor_ids`
+
+            field.
+
+            Always included in service level objective responses for monitor service
+            level
+
+            objectives (but may be empty). Ignored in create/update requests. Does
+            not
+
+            affect which monitors are included in the service level objective (that
+            is
+
+            determined entirely by the `monitor_ids` field).'
+          items:
+            description: A monitor tag.
+            type: string
+          type: array
+        name:
+          description: The name of the service level objective object.
+          example: Custom Metric SLO
+          type: string
+        query:
+          $ref: '#/components/schemas/ServiceLevelObjectiveQuery'
+        tags:
+          description: 'A list of tags associated with this service level objective.
+
+            Always included in service level objective responses (but may be empty).
+
+            Optional in create/update requests.'
+          example:
+          - env:prod
+          - app:core
+          items:
+            description: A tag to apply to your SLO.
             type: string
           type: array
+        thresholds:
+          description: 'The thresholds (timeframes and associated targets) for this
+            service level
+
+            objective object.'
+          example:
+          - target: 95
+            timeframe: 7d
+          - target: 95
+            timeframe: 30d
+            warning: 97
+          items:
+            $ref: '#/components/schemas/SLOThreshold'
+          type: array
+        type:
+          $ref: '#/components/schemas/SLOType'
       type: object
     SLOThreshold:
       description: SLO thresholds (target and optionally warning) for a single time
@@ -9179,20 +9182,7 @@ components:
             $ref: '#/components/schemas/WidgetCustomLink'
           type: array
         requests:
-          description: Widget definition.
-          example:
-            x:
-              q: system.cpu.user
-            y:
-              q: system.mem.used
-          properties:
-            table:
-              $ref: '#/components/schemas/ScatterplotTableRequest'
-            x:
-              $ref: '#/components/schemas/ScatterPlotRequest'
-            y:
-              $ref: '#/components/schemas/ScatterPlotRequest'
-          type: object
+          $ref: '#/components/schemas/ScatterPlotWidgetDefinitionRequests'
         time:
           $ref: '#/components/schemas/WidgetTime'
         title:
@@ -9213,6 +9203,21 @@ components:
       - type
       - requests
       type: object
+    ScatterPlotWidgetDefinitionRequests:
+      description: Widget definition.
+      example:
+        x:
+          q: system.cpu.user
+        y:
+          q: system.mem.used
+      properties:
+        table:
+          $ref: '#/components/schemas/ScatterplotTableRequest'
+        x:
+          $ref: '#/components/schemas/ScatterPlotRequest'
+        y:
+          $ref: '#/components/schemas/ScatterPlotRequest'
+      type: object
     ScatterPlotWidgetDefinitionType:
       default: scatterplot
       description: Type of the scatter plot widget.
@@ -9240,14 +9245,12 @@ components:
       description: Scatterplot request containing formulas and functions.
       properties:
         formulas:
-          description: List of Scatterplot formulas that operate on queries. **This
-            feature is currently in beta.**
+          description: List of Scatterplot formulas that operate on queries.
           items:
             $ref: '#/components/schemas/ScatterplotWidgetFormula'
           type: array
         queries:
           description: List of queries that can be returned directly or used in formulas.
-            **This feature is currently in beta.**
           items:
             $ref: '#/components/schemas/FormulaAndFunctionQueryDefinition'
           type: array
@@ -9735,30 +9738,32 @@ components:
       description: The Slack channel configuration.
       properties:
         display:
-          description: Configuration options for what is shown in an alert event message.
-          properties:
-            message:
-              default: true
-              description: Show the main body of the alert event.
-              type: boolean
-            notified:
-              default: true
-              description: Show the list of @-handles in the alert event.
-              type: boolean
-            snapshot:
-              default: true
-              description: Show the alert event's snapshot image.
-              type: boolean
-            tags:
-              default: true
-              description: Show the scopes on which the monitor alerted.
-              type: boolean
-          type: object
+          $ref: '#/components/schemas/SlackIntegrationChannelDisplay'
         name:
           description: Your channel name.
           example: '#general'
           type: string
       type: object
+    SlackIntegrationChannelDisplay:
+      description: Configuration options for what is shown in an alert event message.
+      properties:
+        message:
+          default: true
+          description: Show the main body of the alert event.
+          type: boolean
+        notified:
+          default: true
+          description: Show the list of @-handles in the alert event.
+          type: boolean
+        snapshot:
+          default: true
+          description: Show the alert event's snapshot image.
+          type: boolean
+        tags:
+          default: true
+          description: Show the scopes on which the monitor alerted.
+          type: boolean
+      type: object
     SlackIntegrationChannels:
       description: A list of configured Slack channels.
       example:
@@ -9880,8 +9885,7 @@ components:
         event_query:
           $ref: '#/components/schemas/LogQueryDefinition'
         formulas:
-          description: List of formulas that operate on queries. **This feature is
-            currently in beta.**
+          description: List of formulas that operate on queries.
           items:
             $ref: '#/components/schemas/WidgetFormula'
           type: array
@@ -9898,7 +9902,6 @@ components:
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
-            **This feature is currently in beta.**
           items:
             $ref: '#/components/schemas/FormulaAndFunctionQueryDefinition'
           type: array
@@ -10091,13 +10094,7 @@ components:
       description: Object returned describing a API test result.
       properties:
         check:
-          description: Object describing the API test configuration.
-          properties:
-            config:
-              $ref: '#/components/schemas/SyntheticsTestConfig'
-          required:
-          - config
-          type: object
+          $ref: '#/components/schemas/SyntheticsAPITestResultFullCheck'
         check_time:
           description: When the API test was conducted.
           format: double
@@ -10117,6 +10114,14 @@ components:
         status:
           $ref: '#/components/schemas/SyntheticsTestMonitorStatus'
       type: object
+    SyntheticsAPITestResultFullCheck:
+      description: Object describing the API test configuration.
+      properties:
+        config:
+          $ref: '#/components/schemas/SyntheticsTestConfig'
+      required:
+      - config
+      type: object
     SyntheticsAPITestResultShort:
       description: Object with the results of a single Synthetic API test.
       properties:
@@ -10128,20 +10133,22 @@ components:
           description: Location from which the API test was performed.
           type: string
         result:
-          description: Result of the last API test run.
-          properties:
-            passed:
-              description: Describes if the test run has passed or failed.
-              type: boolean
-            timings:
-              $ref: '#/components/schemas/SyntheticsTiming'
-          type: object
+          $ref: '#/components/schemas/SyntheticsAPITestResultShortResult'
         result_id:
           description: ID of the API test result.
           type: string
         status:
           $ref: '#/components/schemas/SyntheticsTestMonitorStatus'
       type: object
+    SyntheticsAPITestResultShortResult:
+      description: Result of the last API test run.
+      properties:
+        passed:
+          description: Describes if the test run has passed or failed.
+          type: boolean
+        timings:
+          $ref: '#/components/schemas/SyntheticsTiming'
+      type: object
     SyntheticsAPITestType:
       default: api
       description: Type of the Synthetic test, `api`.
@@ -10243,23 +10250,25 @@ components:
           description: The associated assertion property.
           type: string
         target:
-          description: Composed target for `validatesJSONPath` operator.
-          properties:
-            jsonPath:
-              description: The JSON path to assert.
-              type: string
-            operator:
-              description: The specific operator to use on the path.
-              type: string
-            targetValue:
-              description: The path target value to compare to.
-          type: object
+          $ref: '#/components/schemas/SyntheticsAssertionJSONPathTargetTarget'
         type:
           $ref: '#/components/schemas/SyntheticsAssertionType'
       required:
       - type
       - operator
       type: object
+    SyntheticsAssertionJSONPathTargetTarget:
+      description: Composed target for `validatesJSONPath` operator.
+      properties:
+        jsonPath:
+          description: The JSON path to assert.
+          type: string
+        operator:
+          description: The specific operator to use on the path.
+          type: string
+        targetValue:
+          description: The path target value to compare to.
+      type: object
     SyntheticsAssertionOperator:
       description: Assertion operator to apply.
       enum:
@@ -10762,13 +10771,7 @@ components:
       description: Object returned describing a browser test result.
       properties:
         check:
-          description: Object describing the browser test configuration.
-          properties:
-            config:
-              $ref: '#/components/schemas/SyntheticsTestConfig'
-          required:
-          - config
-          type: object
+          $ref: '#/components/schemas/SyntheticsBrowserTestResultFullCheck'
         check_time:
           description: When the browser test was conducted.
           format: double
@@ -10788,6 +10791,14 @@ components:
         status:
           $ref: '#/components/schemas/SyntheticsTestMonitorStatus'
       type: object
+    SyntheticsBrowserTestResultFullCheck:
+      description: Object describing the browser test configuration.
+      properties:
+        config:
+          $ref: '#/components/schemas/SyntheticsTestConfig'
+      required:
+      - config
+      type: object
     SyntheticsBrowserTestResultShort:
       description: Object with the results of a single Synthetic browser test.
       properties:
@@ -10799,27 +10810,7 @@ components:
           description: Location from which the Browser test was performed.
           type: string
         result:
-          description: Object with the result of the last browser test run.
-          properties:
-            device:
-              $ref: '#/components/schemas/SyntheticsDevice'
-            duration:
-              description: Length in milliseconds of the browser test run.
-              format: double
-              type: number
-            errorCount:
-              description: Amount of errors collected for a single browser test run.
-              format: int64
-              type: integer
-            stepCountCompleted:
-              description: Amount of browser test steps completed before failing.
-              format: int64
-              type: integer
-            stepCountTotal:
-              description: Total amount of browser test steps.
-              format: int64
-              type: integer
-          type: object
+          $ref: '#/components/schemas/SyntheticsBrowserTestResultShortResult'
         result_id:
           description: ID of the browser test result.
           type: string
@@ -10829,6 +10820,28 @@ components:
       - from_ts
       - to_ts
       type: object
+    SyntheticsBrowserTestResultShortResult:
+      description: Object with the result of the last browser test run.
+      properties:
+        device:
+          $ref: '#/components/schemas/SyntheticsDevice'
+        duration:
+          description: Length in milliseconds of the browser test run.
+          format: double
+          type: number
+        errorCount:
+          description: Amount of errors collected for a single browser test run.
+          format: int64
+          type: integer
+        stepCountCompleted:
+          description: Amount of browser test steps completed before failing.
+          format: int64
+          type: integer
+        stepCountTotal:
+          description: Total amount of browser test steps.
+          format: int64
+          type: integer
+      type: object
     SyntheticsBrowserTestType:
       default: browser
       description: Type of the Synthetic test, `browser`.
@@ -11187,16 +11200,7 @@ components:
       description: Synthetics global variable.
       properties:
         attributes:
-          description: Attributes of the global variable.
-          properties:
-            restricted_roles:
-              description: List of role identifiers that can be pulled from the Roles
-                API.
-              items:
-                description: UUID for a role.
-                type: string
-              type: array
-          type: object
+          $ref: '#/components/schemas/SyntheticsGlobalVariableAttributes'
         description:
           description: Description of the global variable.
           example: Example description
@@ -11211,22 +11215,7 @@ components:
           example: MY_VARIABLE
           type: string
         parse_test_options:
-          description: Parser options to use for retrieving a Synthetics global variable
-            from a Synthetics Test. Used in conjunction with `parse_test_public_id`.
-          properties:
-            field:
-              description: When type is `http_header`, name of the header to use to
-                extract the value.
-              example: content-type
-              type: string
-            parser:
-              $ref: '#/components/schemas/SyntheticsVariableParser'
-            type:
-              $ref: '#/components/schemas/SyntheticsGlobalVariableParseTestOptionsType'
-          required:
-          - type
-          - parser
-          type: object
+          $ref: '#/components/schemas/SyntheticsGlobalVariableParseTestOptions'
         parse_test_public_id:
           description: A Synthetic test ID to use as a test to generate the variable
             value.
@@ -11249,6 +11238,34 @@ components:
       - tags
       - value
       type: object
+    SyntheticsGlobalVariableAttributes:
+      description: Attributes of the global variable.
+      properties:
+        restricted_roles:
+          description: List of role identifiers that can be pulled from the Roles
+            API.
+          items:
+            description: UUID for a role.
+            type: string
+          type: array
+      type: object
+    SyntheticsGlobalVariableParseTestOptions:
+      description: Parser options to use for retrieving a Synthetics global variable
+        from a Synthetics Test. Used in conjunction with `parse_test_public_id`.
+      properties:
+        field:
+          description: When type is `http_header`, name of the header to use to extract
+            the value.
+          example: content-type
+          type: string
+        parser:
+          $ref: '#/components/schemas/SyntheticsVariableParser'
+        type:
+          $ref: '#/components/schemas/SyntheticsGlobalVariableParseTestOptionsType'
+      required:
+      - type
+      - parser
+      type: object
     SyntheticsGlobalVariableParseTestOptionsType:
       description: Property of the Synthetics Test Response to use for a Synthetics
         global variable.
@@ -11380,31 +11397,7 @@ components:
           example: New private location
           type: string
         secrets:
-          description: Secrets for the private location. Only present in the response
-            when creating the private location.
-          properties:
-            authentication:
-              description: Authentication part of the secrets.
-              properties:
-                id:
-                  description: Access key for the private location.
-                  readOnly: true
-                  type: string
-                key:
-                  description: Secret access key for the private location.
-                  readOnly: true
-                  type: string
-              type: object
-            config_decryption:
-              description: Private key for the private location.
-              properties:
-                key:
-                  description: Private key for the private location.
-                  readOnly: true
-                  type: string
-              type: object
-          readOnly: true
-          type: object
+          $ref: '#/components/schemas/SyntheticsPrivateLocationSecrets'
         tags:
           description: Array of tags attached to the private location.
           example:
@@ -11430,15 +11423,47 @@ components:
         private_location:
           $ref: '#/components/schemas/SyntheticsPrivateLocation'
         result_encryption:
-          description: Public key for the result encryption.
-          properties:
-            id:
-              description: Fingerprint for the encryption key.
-              type: string
-            key:
-              description: Public key for result encryption.
-              type: string
-          type: object
+          $ref: '#/components/schemas/SyntheticsPrivateLocationCreationResponseResultEncryption'
+      type: object
+    SyntheticsPrivateLocationCreationResponseResultEncryption:
+      description: Public key for the result encryption.
+      properties:
+        id:
+          description: Fingerprint for the encryption key.
+          type: string
+        key:
+          description: Public key for result encryption.
+          type: string
+      type: object
+    SyntheticsPrivateLocationSecrets:
+      description: Secrets for the private location. Only present in the response
+        when creating the private location.
+      properties:
+        authentication:
+          $ref: '#/components/schemas/SyntheticsPrivateLocationSecretsAuthentication'
+        config_decryption:
+          $ref: '#/components/schemas/SyntheticsPrivateLocationSecretsConfigDecryption'
+      readOnly: true
+      type: object
+    SyntheticsPrivateLocationSecretsAuthentication:
+      description: Authentication part of the secrets.
+      properties:
+        id:
+          description: Access key for the private location.
+          readOnly: true
+          type: string
+        key:
+          description: Secret access key for the private location.
+          readOnly: true
+          type: string
+      type: object
+    SyntheticsPrivateLocationSecretsConfigDecryption:
+      description: Private key for the private location.
+      properties:
+        key:
+          description: Private key for the private location.
+          readOnly: true
+          type: string
       type: object
     SyntheticsSSLCertificate:
       description: Object describing the SSL certificate used for a Synthetic test.
@@ -11463,61 +11488,18 @@ components:
           description: SHA-1 digest of the DER-encoded Certificate information.
           type: string
         issuer:
-          description: Object describing the issuer of a SSL certificate.
-          properties:
-            C:
-              description: Country Name that issued the certificate.
-              type: string
-            CN:
-              description: Common Name that issued certificate.
-              type: string
-            L:
-              description: Locality that issued the certificate.
-              type: string
-            O:
-              description: Organization that issued the certificate.
-              type: string
-            OU:
-              description: Organizational Unit that issued the certificate.
-              type: string
-            ST:
-              description: State Or Province Name that issued the certificate.
-              type: string
-          type: object
+          $ref: '#/components/schemas/SyntheticsSSLCertificateIssuer'
         modulus:
           description: Modulus associated to the SSL certificate private key.
           type: string
-        protocol:
-          description: TLS protocol used for the test.
-          type: string
-        serialNumber:
-          description: Serial Number assigned by Symantec to the SSL certificate.
-          type: string
-        subject:
-          description: Object describing the SSL certificate used for the test.
-          properties:
-            C:
-              description: Country Name associated with the certificate.
-              type: string
-            CN:
-              description: Common Name that associated with the certificate.
-              type: string
-            L:
-              description: Locality associated with the certificate.
-              type: string
-            O:
-              description: Organization associated with the certificate.
-              type: string
-            OU:
-              description: Organizational Unit associated with the certificate.
-              type: string
-            ST:
-              description: State Or Province Name associated with the certificate.
-              type: string
-            altName:
-              description: Subject Alternative Name associated with the certificate.
-              type: string
-          type: object
+        protocol:
+          description: TLS protocol used for the test.
+          type: string
+        serialNumber:
+          description: Serial Number assigned by Symantec to the SSL certificate.
+          type: string
+        subject:
+          $ref: '#/components/schemas/SyntheticsSSLCertificateSubject'
         validFrom:
           description: Date from which the SSL certificate is valid.
           format: date-time
@@ -11527,6 +11509,53 @@ components:
           format: date-time
           type: string
       type: object
+    SyntheticsSSLCertificateIssuer:
+      description: Object describing the issuer of a SSL certificate.
+      properties:
+        C:
+          description: Country Name that issued the certificate.
+          type: string
+        CN:
+          description: Common Name that issued certificate.
+          type: string
+        L:
+          description: Locality that issued the certificate.
+          type: string
+        O:
+          description: Organization that issued the certificate.
+          type: string
+        OU:
+          description: Organizational Unit that issued the certificate.
+          type: string
+        ST:
+          description: State Or Province Name that issued the certificate.
+          type: string
+      type: object
+    SyntheticsSSLCertificateSubject:
+      description: Object describing the SSL certificate used for the test.
+      properties:
+        C:
+          description: Country Name associated with the certificate.
+          type: string
+        CN:
+          description: Common Name that associated with the certificate.
+          type: string
+        L:
+          description: Locality associated with the certificate.
+          type: string
+        O:
+          description: Organization associated with the certificate.
+          type: string
+        OU:
+          description: Organizational Unit associated with the certificate.
+          type: string
+        ST:
+          description: State Or Province Name associated with the certificate.
+          type: string
+        altName:
+          description: Subject Alternative Name associated with the certificate.
+          type: string
+      type: object
     SyntheticsStatus:
       description: Determines whether or not the batch has passed, failed, or is in
         progress.
@@ -11846,6 +11875,10 @@ components:
         allow_insecure:
           description: Allows loading insecure content for an HTTP request.
           type: boolean
+        checkCertificateRevocation:
+          description: For SSL test, whether or not the test should fail on revoked
+            certificate in stapled OCSP.
+          type: boolean
         device_ids:
           description: For browser test, array with the different device IDs used
             to run the test.
@@ -11873,20 +11906,7 @@ components:
             all monitor dashboard widgets and SLOs.
           type: string
         monitor_options:
-          description: 'Object containing the options for a Synthetic test as a monitor
-
-            (for example, renotification).'
-          properties:
-            renotify_interval:
-              description: 'Time interval before renotifying if the test is still
-                failing
-
-                (in minutes).'
-              format: int64
-              maximum: 1440
-              minimum: 0
-              type: integer
-          type: object
+          $ref: '#/components/schemas/SyntheticsTestOptionsMonitorOptions'
         monitor_priority:
           description: Integer from 1 (high) to 5 (low) indicating alert severity.
           format: int32
@@ -11905,6 +11925,20 @@ components:
           minimum: 30
           type: integer
       type: object
+    SyntheticsTestOptionsMonitorOptions:
+      description: 'Object containing the options for a Synthetic test as a monitor
+
+        (for example, renotification).'
+      properties:
+        renotify_interval:
+          description: 'Time interval before renotifying if the test is still failing
+
+            (in minutes).'
+          format: int64
+          maximum: 1440
+          minimum: 0
+          type: integer
+      type: object
     SyntheticsTestOptionsRetry:
       description: Object describing the retry strategy to apply to a Synthetic test.
       properties:
@@ -12295,8 +12329,7 @@ components:
         event_query:
           $ref: '#/components/schemas/LogQueryDefinition'
         formulas:
-          description: List of formulas that operate on queries. **This feature is
-            currently in beta.**
+          description: List of formulas that operate on queries.
           items:
             $ref: '#/components/schemas/WidgetFormula'
           type: array
@@ -12320,7 +12353,6 @@ components:
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
-            **This feature is currently in beta.**
           items:
             $ref: '#/components/schemas/FormulaAndFunctionQueryDefinition'
           type: array
@@ -12484,8 +12516,7 @@ components:
         event_query:
           $ref: '#/components/schemas/LogQueryDefinition'
         formulas:
-          description: List of formulas that operate on queries. **This feature is
-            currently in beta.**
+          description: List of formulas that operate on queries.
           items:
             $ref: '#/components/schemas/WidgetFormula'
           type: array
@@ -12510,7 +12541,6 @@ components:
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
-            **This feature is currently in beta.**
           items:
             $ref: '#/components/schemas/FormulaAndFunctionQueryDefinition'
           type: array
@@ -12585,8 +12615,7 @@ components:
         event_query:
           $ref: '#/components/schemas/LogQueryDefinition'
         formulas:
-          description: List of formulas that operate on queries. **This feature is
-            currently in beta.**
+          description: List of formulas that operate on queries.
           items:
             $ref: '#/components/schemas/WidgetFormula'
           type: array
@@ -12603,7 +12632,6 @@ components:
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
-            **This feature is currently in beta.**
           items:
             $ref: '#/components/schemas/FormulaAndFunctionQueryDefinition'
           type: array
@@ -12691,8 +12719,7 @@ components:
       description: An updated treemap widget.
       properties:
         formulas:
-          description: List of formulas that operate on queries. **This feature is
-            currently in beta.**
+          description: List of formulas that operate on queries.
           items:
             $ref: '#/components/schemas/WidgetFormula'
           type: array
@@ -12701,7 +12728,6 @@ components:
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
-            **This feature is currently in beta.**
           items:
             $ref: '#/components/schemas/FormulaAndFunctionQueryDefinition'
           type: array
@@ -13319,6 +13345,41 @@ components:
             $ref: '#/components/schemas/UsageBillableSummaryHour'
           type: array
       type: object
+    UsageCIVisibilityHour:
+      description: CI visibility usage in a given hour.
+      properties:
+        ci_pipeline_indexed_spans:
+          description: The number of spans for pipelines in the queried hour.
+          type: integer
+        ci_test_indexed_spans:
+          description: The number of spans for tests in the queried hour.
+          type: integer
+        ci_visibility_pipeline_committers:
+          description: Shows the total count of all active Git committers for Pipelines
+            in the current month. A committer is active if they commit at least 3
+            times in a given month.
+          type: integer
+        ci_visibility_test_committers:
+          description: The total count of all active Git committers for tests in the
+            current month. A committer is active if they commit at least 3 times in
+            a given month.
+          type: integer
+        org_name:
+          description: The organization name.
+          type: string
+        public_id:
+          description: The organization public ID.
+          type: string
+      type: object
+    UsageCIVisibilityResponse:
+      description: CI visibility usage response
+      properties:
+        usage:
+          description: Response containing CI visibility usage.
+          items:
+            $ref: '#/components/schemas/UsageCIVisibilityHour'
+          type: array
+      type: object
     UsageCWSHour:
       description: Cloud Workload Security usage for a given organization for a given
         hour.
@@ -13992,6 +14053,32 @@ components:
             $ref: '#/components/schemas/UsageNetworkHostsHour'
           type: array
       type: object
+    UsageOnlineArchiveHour:
+      description: Online Archive usage in a given hour.
+      properties:
+        hour:
+          description: The hour for the usage.
+          format: date-time
+          type: string
+        online_archive_events_count:
+          description: Total count of online archived events within the hour.
+          type: integer
+        org_name:
+          description: The organization name.
+          type: string
+        public_id:
+          description: The organization public ID.
+          type: string
+      type: object
+    UsageOnlineArchiveResponse:
+      description: Online Archive usage response.
+      properties:
+        usage:
+          description: Response containing Online Archive usage.
+          items:
+            $ref: '#/components/schemas/UsageOnlineArchiveHour'
+          type: array
+      type: object
     UsageProfilingHour:
       description: The number of profiled hosts for each hour for a given organization.
       properties:
@@ -14328,6 +14415,26 @@ components:
             current date for all organizations.
           format: int64
           type: integer
+        ci_pipeline_indexed_spans_sum:
+          description: Shows the sum of all CI pipeline indexed spans over all hours
+            in the current month for all organizations.
+          format: int64
+          type: integer
+        ci_test_indexed_spans_sum:
+          description: Shows the sum of all CI test indexed spans over all hours in
+            the current month for all organizations.
+          format: int64
+          type: integer
+        ci_visibility_pipeline_committers_hwm:
+          description: Shows the high-water mark of all CI visibility pipeline committers
+            over all hours in the current month for all organizations.
+          format: int64
+          type: integer
+        ci_visibility_test_committers_hwm:
+          description: Shows the high-water mark of all CI visibility test committers
+            over all hours in the current month for all organizations.
+          format: int64
+          type: integer
         container_avg:
           description: Shows the average of all distinct containers over all hours
             in the current date for all organizations.
@@ -14477,6 +14584,11 @@ components:
             all hours in the current date for all organizations.
           format: int64
           type: integer
+        online_archive_events_count_sum:
+          description: Sum of all online archived events over all hours in the current
+            date for all organizations.
+          format: int64
+          type: integer
         opentelemetry_host_top99p:
           description: Shows the 99th percentile of all hosts reported by the Datadog
             exporter for the OpenTelemetry Collector over all hours in the current
@@ -14618,6 +14730,26 @@ components:
             current date for the given org.
           format: int64
           type: integer
+        ci_pipeline_indexed_spans_sum:
+          description: Shows the sum of all CI pipeline indexed spans over all hours
+            in the current date for the given org.
+          format: int64
+          type: integer
+        ci_test_indexed_spans_sum:
+          description: Shows the sum of all CI test indexed spans over all hours in
+            the current date for the given org.
+          format: int64
+          type: integer
+        ci_visibility_pipeline_committers_hwm:
+          description: Shows the high-water mark of all CI visibility pipeline committers
+            over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        ci_visibility_test_committers_hwm:
+          description: Shows the high-water mark of all CI visibility test committers
+            over all hours in the current date for the given org.
+          format: int64
+          type: integer
         container_avg:
           description: Shows the average of all distinct containers over all hours
             in the current date for the given org.
@@ -14769,6 +14901,11 @@ components:
             all hours in the current date for the given org.
           format: int64
           type: integer
+        online_archive_events_count_sum:
+          description: Sum of all online archived events over all hours in the current
+            date for the given org.
+          format: int64
+          type: integer
         opentelemetry_host_top99p:
           description: Shows the 99th percentile of all hosts reported by the Datadog
             exporter for the OpenTelemetry Collector over all hours in the current
@@ -14914,6 +15051,26 @@ components:
             current months for all organizations.
           format: int64
           type: integer
+        ci_pipeline_indexed_spans_agg_sum:
+          description: Shows the sum of all CI pipeline indexed spans over all hours
+            in the current months for all organizations.
+          format: int64
+          type: integer
+        ci_test_indexed_spans_agg_sum:
+          description: Shows the sum of all CI test indexed spans over all hours in
+            the current months for all organizations.
+          format: int64
+          type: integer
+        ci_visibility_pipeline_committers_hwm_sum:
+          description: Shows the high-water mark of all CI visibility pipeline committers
+            over all hours in the current months for all organizations.
+          format: int64
+          type: integer
+        ci_visibility_test_committers_hwm_sum:
+          description: Shows the high-water mark of all CI visibility test committers
+            over all hours in the current months for all organizations.
+          format: int64
+          type: integer
         container_avg_sum:
           description: Shows the average of all distinct containers over all hours
             in the current months for all organizations.
@@ -15085,6 +15242,11 @@ components:
             all hours in the current months for all organizations.
           format: int64
           type: integer
+        online_archive_events_count_agg_sum:
+          description: Sum of all online archived events over all hours in the current
+            months for all organizations.
+          format: int64
+          type: integer
         opentelemetry_host_top99p_sum:
           description: Shows the 99th percentile of all hosts reported by the Datadog
             exporter for the OpenTelemetry Collector over all hours in the current
@@ -15825,18 +15987,20 @@ components:
           example: func(a) + b
           type: string
         limit:
-          description: Options for limiting results returned.
-          properties:
-            count:
-              description: Number of results to return.
-              format: int64
-              type: integer
-            order:
-              $ref: '#/components/schemas/QuerySortOrder'
-          type: object
+          $ref: '#/components/schemas/WidgetFormulaLimit'
       required:
       - formula
       type: object
+    WidgetFormulaLimit:
+      description: Options for limiting results returned.
+      properties:
+        count:
+          description: Number of results to return.
+          format: int64
+          type: integer
+        order:
+          $ref: '#/components/schemas/QuerySortOrder'
+      type: object
     WidgetGrouping:
       description: The kind of grouping to use.
       enum:
@@ -16312,31 +16476,31 @@ components:
         authorizationCode:
           authorizationUrl: /oauth2/v1/authorize
           scopes:
-            dashboards_public_share: The ability to share dashboards externally.
-            dashboards_read: The ability to view dashboards.
-            dashboards_write: The ability to create and change dashboards.
-            events_read: The ability to read Events data.
-            metrics_read: The ability to view custom metrics.
-            monitors_downtime: The ability to set downtimes to suppress alerts from
-              any monitor in an organization. The ability to write monitors is not
-              required to set downtimes.
-            monitors_read: The ability to view monitors.
-            monitors_write: The ability to change, mute, and delete individual monitors.
-            synthetics_global_variable_read: The ability to view, search and use in
-              tests the list of global variables available for Synthetics.
-            synthetics_global_variable_write: The ability to create, edit, and delete
-              global variables for Synthetics.
-            synthetics_private_location_read: The ability to view, search and use
-              in tests the list of private locations available.
-            synthetics_private_location_write: The ability to create and delete private
-              locations as well as seeing the associated installation guidelines.
-            synthetics_read: The ability to list and view configured Synthetic tests.
-            synthetics_write: The ability to create, edit, and delete Synthetic tests.
-            timeseries_query: The ability to query Timeseries data.
-            usage_read: The ability to view your organization's usage and usage attribution.
-            user_access_invite: The ability to invite other users to your organization.
-            user_access_manage: The ability to disable users, manage user roles, and
-              manage SAML-to-role mappings.
+            dashboards_public_share: Share dashboards externally.
+            dashboards_read: View dashboards.
+            dashboards_write: Create and change dashboards.
+            events_read: Read Events data.
+            metrics_read: View custom metrics.
+            monitors_downtime: Set downtimes to suppress alerts from any monitor in
+              an organization. The ability to write monitors is not required to set
+              downtimes.
+            monitors_read: View monitors.
+            monitors_write: Change, mute, and delete individual monitors.
+            synthetics_global_variable_read: View, search, and use in tests the list
+              of global variables available for Synthetics.
+            synthetics_global_variable_write: Create, edit, and delete global variables
+              for Synthetics.
+            synthetics_private_location_read: View, search, and use in tests the list
+              of available private locations.
+            synthetics_private_location_write: Create and delete private locations
+              as well as seeing the associated installation guidelines.
+            synthetics_read: List and view configured Synthetic tests.
+            synthetics_write: Create, edit, and delete Synthetic tests.
+            timeseries_query: Query Timeseries data.
+            usage_read: View your organization's usage and usage attribution.
+            user_access_invite: Invite other users to your organization.
+            user_access_manage: Disable users, manage user roles, and manage SAML-to-role
+              mappings.
           tokenUrl: /oauth2/v1/token
       type: oauth2
     apiKeyAuth:
@@ -21096,6 +21260,8 @@ paths:
 
         - audit: `audit alert`
 
+        - error-tracking: `error-tracking alert`
+
 
         #### Query Types
 
@@ -21372,7 +21538,32 @@ paths:
         - **`#`** an integer or decimal number used to set the threshold.
 
 
-        **NOTE** Only available in closed beta on US1, EU, US3 and US5.'
+        **NOTE** Only available in closed beta on US1, EU, US3 and US5.
+
+
+        **Error Tracking Alert Query**
+
+
+        Example(RUM): `error-tracking-rum(query).rollup(rollup_method[, measure]).last(time_window)
+        operator #`
+
+        Example(APM Traces): `error-tracking-traces(query).rollup(rollup_method[,
+        measure]).last(time_window) operator #`
+
+
+        - **`query`** The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
+
+        - **`rollup_method`** The stats roll-up method - supports `count`, `avg`,
+        and `cardinality`.
+
+        - **`measure`** For `avg` and cardinality `rollup_method` - specify the measure
+        or the facet name you want to use.
+
+        - **`time_window`** #m (between 1 and 2880), #h (between 1 and 48).
+
+        - **`operator`** `<`, `<=`, `>`, `>=`, `==`, or `!=`.
+
+        - **`#`** an integer or decimal number used to set the threshold.'
       operationId: CreateMonitor
       requestBody:
         content:
@@ -22184,10 +22375,6 @@ paths:
           description: Authentication Error
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      security:
-      - apiKeyAuth: []
-        appKeyAuth: []
-      - AuthZ: []
       summary: Get all notebooks
       tags:
       - Notebooks
@@ -22355,10 +22542,6 @@ paths:
           description: Not Found
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      security:
-      - apiKeyAuth: []
-        appKeyAuth: []
-      - AuthZ: []
       summary: Get a notebook
       tags:
       - Notebooks
@@ -22810,13 +22993,8 @@ paths:
               dynamic-points:
                 description: "Post time-series data that can be graphed on Datadog\u2019s
                   dashboards."
+                externalValue: examples/metrics/dynamic-points.json.sh
                 summary: Dynamic Points
-                value:
-                  series:
-                  - metric: system.load.1
-                    points:
-                    - - ${NOW}
-                      - 1234.5
                 x-variables:
                   NOW: $(date +%s)
             schema:
@@ -24052,7 +24230,7 @@ paths:
       x-given:
         synthetics_api_test:
           parameters:
-          - file: synthetics_api_test_payload.json
+          - file: synthetics_api_http_test_payload.json
             name: body
           step: there is a valid "synthetics_api_test" in the system
         synthetics_api_test_with_wrong_dns:
@@ -25612,6 +25790,66 @@ paths:
       x-menu-order: 19
       x-undo:
         type: safe
+  /api/v1/usage/ci-app:
+    get:
+      description: Get hourly usage for CI Visibility (Tests, Pipeline, Combo, and
+        Spans).
+      operationId: GetUsageCIApp
+      parameters:
+      - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
+          for usage beginning at this hour.'
+        in: query
+        name: start_hr
+        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: end_hr
+        required: false
+        schema:
+          format: date-time
+          type: string
+      responses:
+        '200':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/UsageCIVisibilityResponse'
+          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 for CI Visibility
+      tags:
+      - Usage Metering
+      x-menu-order: 38
+      x-undo:
+        type: safe
   /api/v1/usage/cspm:
     get:
       description: Get hourly usage for Cloud Security Posture Management (CSPM).
@@ -26598,6 +26836,65 @@ paths:
       x-menu-order: 14
       x-undo:
         type: safe
+  /api/v1/usage/online-archive:
+    get:
+      description: Get hourly usage for Online Archive.
+      operationId: GetUsageOnlineArchive
+      parameters:
+      - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
+          for usage beginning at this hour.'
+        in: query
+        name: start_hr
+        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: end_hr
+        required: false
+        schema:
+          format: date-time
+          type: string
+      responses:
+        '200':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/UsageOnlineArchiveResponse'
+          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 for Online Archive
+      tags:
+      - Usage Metering
+      x-menu-order: 38
+      x-undo:
+        type: safe
   /api/v1/usage/profiling:
     get:
       description: Get hourly usage for profiled hosts.