datadog_api_client 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f8c27f68745fac84ba1e99c2eb2a3b8c5069c9f9eebb75e1613f17c46b881e7
-  data.tar.gz: f76092cc4feefa6da4c37a5fe6518d7f2e43d0f80a3acbf0498f2a2605150052
+  metadata.gz: 966d9a971a8b59a89c3146c840524dfa0681c78a89c79010cc6c49ac432c051e
+  data.tar.gz: c080a88ce308169979c2341d257ae48bcba252ca6c1d6d6f057e0c24d902d0ab
 SHA512:
-  metadata.gz: 5d8522e5a486a3fec4475bed5df0d9fd60a5140d36c8bde7e08680b8948de228504ee9bb85ee753b5629b991ec296dc6cbff0cbff505f3cc7480d6146bee9f77
-  data.tar.gz: d391296273c9822018604c15266617d55ced689c4fe863f1b16eff624c76b48f4dc77c788d2e5c137b4e205a5a4f32a13166fad57da4c1c267105c5b4db3c15e
+  metadata.gz: 917343d9d3726e7d10ee74e9927130e1b3180aba3f2c2221e8da966a80ec765dbf397a482381e5dca8963230777fc612013d4ee2159b272d001602e65511f0fc
+  data.tar.gz: c4fb4d110cc1481ad2324a096cedb1eb7e0668a7da0641efaf3a69449416ea883d4fa74c0043c61fa96398f8229c3b40100762caa961b892a416cae0fb9f036b

data/.apigentools-info

@@ -3,14 +3,14 @@
     "info_version": "2",
     "spec_versions": {
         "v1": {
-            "apigentools_version": "1.4.1.dev6",
-            "regenerated": "2021-05-12 09:43:20.279249",
-            "spec_repo_commit": "62c8ffe"
+            "apigentools_version": "1.4.1.dev8",
+            "regenerated": "2021-06-07 11:36:45.335016",
+            "spec_repo_commit": "cb48df5"
         },
         "v2": {
-            "apigentools_version": "1.4.1.dev6",
-            "regenerated": "2021-05-12 09:44:17.148819",
-            "spec_repo_commit": "62c8ffe"
+            "apigentools_version": "1.4.1.dev8",
+            "regenerated": "2021-06-07 11:37:41.263441",
+            "spec_repo_commit": "cb48df5"
         }
     }
 }

data/.github/workflows/scripts/test_integration.js

@@ -0,0 +1,24 @@
+const SPEC_REPO = "datadog-api-spec"
+
+module.exports.post_status_check = async (github, context, status) => {
+    const pr_num = context.payload.pull_request.head.ref.split("/")[2]
+    const {data: pr} = await github.pulls.get({
+        owner: context.repo.owner,
+        repo: SPEC_REPO,
+        pull_number: pr_num,
+    });
+    const { data: jobs } = await github.actions.listJobsForWorkflowRun({
+        owner: context.repo.owner,
+        repo: context.repo.repo,
+        run_id: context.runId
+    });
+    await github.repos.createCommitStatus({
+        owner: context.repo.owner,
+        repo: SPEC_REPO,
+        sha: pr.head.sha,
+        state: status,
+        target_url: `https://github.com/${context.repo.owner}/${context.repo.repo}/pull/${context.payload.pull_request.number}/checks?check_run_id=${jobs.jobs[0].id}`,
+        description: `${context.repo.repo} integration tests`,
+        context: `${context.repo.repo}_integration_tests`
+    });
+}

data/.github/workflows/test.yml

@@ -5,6 +5,10 @@ on:
     branches:
       - master
 
+concurrency:
+  group: unit-${{ github.head_ref }}
+  cancel-in-progress: true
+
 jobs:
   pre-commit:
     runs-on: ubuntu-latest

data/.github/workflows/test_integration.yml

@@ -0,0 +1,87 @@
+name: Run Integration Tests
+
+on:
+  pull_request:
+    branches:
+      - master
+  schedule:
+    - cron: "0 2 * * *"
+
+concurrency:
+  group: integration-${{ github.head_ref }}
+  cancel-in-progress: true
+
+jobs:
+  test_integration:
+    runs-on: ubuntu-latest
+    if: >
+      (github.event_name == 'pull_request' &&
+      github.event.pull_request.draft == false &&
+      !contains(github.event.pull_request.labels.*.name, 'ci/skip') &&
+      !contains(github.event.pull_request.head.ref, 'datadog-api-spec/test/') &&
+      contains(github.event.pull_request.labels.*.name, 'ci/integrations')) ||
+      github.event_name == 'schedule'
+    services:
+      datadog-agent:
+        image: datadog/agent:latest
+        ports:
+          - 8126:8126
+        env:
+          DD_API_KEY: ${{ secrets.DD_API_KEY }}
+          DD_HOSTNAME: "none"
+          DD_INSIDE_CI: "true"
+    steps:
+    - name: Get GitHub App token
+      if: github.event_name == 'pull_request'
+      id: get_token
+      uses: tibdex/github-app-token@v1.3.0
+      with:
+        app_id: ${{ secrets.PIPELINE_GITHUB_APP_ID }}
+        private_key: ${{ secrets.PIPELINE_GITHUB_APP_PRIVATE_KEY }}
+        repository: DataDog/datadog-api-spec
+    - name: Checkout code
+      uses: actions/checkout@v2
+    - name: Post pending status check
+      if: github.event_name == 'pull_request'
+      uses: actions/github-script@v4.0.2
+      with:
+        github-token: ${{ steps.get_token.outputs.token }}
+        script: |
+          const script = require('.github/workflows/scripts/test_integration.js')
+          await script.post_status_check(github, context, "pending")
+    - name: Set up Ruby 2.7
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 2.7
+        bundler-cache: true
+    - name: Install deps
+      run: bundle install
+    - name: Run integration tests
+      run: ./run-tests.sh
+      shell: bash
+      env:
+        CI: "true"
+        DD_AGENT_HOST: localhost
+        DD_ENV: prod
+        DD_SERVICE: datadog-api-client-ruby
+        DD_TAGS: "team:integration-tools-and-libraries"
+        DD_TEST_CLIENT_API_KEY: ${{ secrets.DD_CLIENT_API_KEY }}
+        DD_TEST_CLIENT_APP_KEY: ${{ secrets.DD_CLIENT_APP_KEY }}
+        DD_TRACE_ANALYTICS_ENABLED: "true"
+        RECORD: "none"
+    - name: Post failure status check
+      if: failure() && github.event_name == 'pull_request'
+      uses: actions/github-script@v4.0.2
+      with:
+        github-token: ${{ steps.get_token.outputs.token }}
+        script: |
+          const script = require('./.github/workflows/scripts/test_integration.js')
+          await script.post_status_check(github, context, "failure")
+    - name: Post success status check
+      if: "!failure() && github.event_name == 'pull_request'"
+      uses: actions/github-script@v4.0.2
+      with:
+        github-token: ${{ steps.get_token.outputs.token }}
+        script: |
+          const script = require('./.github/workflows/scripts/test_integration.js')
+          await script.post_status_check(github, context, "success")

data/.openapi-generator/FILES

@@ -261,6 +261,22 @@ docs/RolesAPI.md
 docs/RolesResponse.md
 docs/RolesSort.md
 docs/RolesType.md
+docs/SecurityFilter.md
+docs/SecurityFilterAttributes.md
+docs/SecurityFilterCreateAttributes.md
+docs/SecurityFilterCreateData.md
+docs/SecurityFilterCreateRequest.md
+docs/SecurityFilterDeleteResponse.md
+docs/SecurityFilterExclusionFilter.md
+docs/SecurityFilterExclusionFilterResponse.md
+docs/SecurityFilterFilteredDataType.md
+docs/SecurityFilterMeta.md
+docs/SecurityFilterResponse.md
+docs/SecurityFilterType.md
+docs/SecurityFilterUpdateAttributes.md
+docs/SecurityFilterUpdateData.md
+docs/SecurityFilterUpdateRequest.md
+docs/SecurityFiltersResponse.md
 docs/SecurityMonitoringAPI.md
 docs/SecurityMonitoringFilter.md
 docs/SecurityMonitoringFilterAction.md
@@ -584,6 +600,22 @@ lib/datadog_api_client/v2/models/role_update_response_data.rb
 lib/datadog_api_client/v2/models/roles_response.rb
 lib/datadog_api_client/v2/models/roles_sort.rb
 lib/datadog_api_client/v2/models/roles_type.rb
+lib/datadog_api_client/v2/models/security_filter.rb
+lib/datadog_api_client/v2/models/security_filter_attributes.rb
+lib/datadog_api_client/v2/models/security_filter_create_attributes.rb
+lib/datadog_api_client/v2/models/security_filter_create_data.rb
+lib/datadog_api_client/v2/models/security_filter_create_request.rb
+lib/datadog_api_client/v2/models/security_filter_delete_response.rb
+lib/datadog_api_client/v2/models/security_filter_exclusion_filter.rb
+lib/datadog_api_client/v2/models/security_filter_exclusion_filter_response.rb
+lib/datadog_api_client/v2/models/security_filter_filtered_data_type.rb
+lib/datadog_api_client/v2/models/security_filter_meta.rb
+lib/datadog_api_client/v2/models/security_filter_response.rb
+lib/datadog_api_client/v2/models/security_filter_type.rb
+lib/datadog_api_client/v2/models/security_filter_update_attributes.rb
+lib/datadog_api_client/v2/models/security_filter_update_data.rb
+lib/datadog_api_client/v2/models/security_filter_update_request.rb
+lib/datadog_api_client/v2/models/security_filters_response.rb
 lib/datadog_api_client/v2/models/security_monitoring_filter.rb
 lib/datadog_api_client/v2/models/security_monitoring_filter_action.rb
 lib/datadog_api_client/v2/models/security_monitoring_list_rules_response.rb
@@ -903,6 +935,22 @@ spec/models/role_update_response_spec.rb
 spec/models/roles_response_spec.rb
 spec/models/roles_sort_spec.rb
 spec/models/roles_type_spec.rb
+spec/models/security_filter_attributes_spec.rb
+spec/models/security_filter_create_attributes_spec.rb
+spec/models/security_filter_create_data_spec.rb
+spec/models/security_filter_create_request_spec.rb
+spec/models/security_filter_delete_response_spec.rb
+spec/models/security_filter_exclusion_filter_response_spec.rb
+spec/models/security_filter_exclusion_filter_spec.rb
+spec/models/security_filter_filtered_data_type_spec.rb
+spec/models/security_filter_meta_spec.rb
+spec/models/security_filter_response_spec.rb
+spec/models/security_filter_spec.rb
+spec/models/security_filter_type_spec.rb
+spec/models/security_filter_update_attributes_spec.rb
+spec/models/security_filter_update_data_spec.rb
+spec/models/security_filter_update_request_spec.rb
+spec/models/security_filters_response_spec.rb
 spec/models/security_monitoring_filter_action_spec.rb
 spec/models/security_monitoring_filter_spec.rb
 spec/models/security_monitoring_list_rules_response_spec.rb

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # CHANGELOG
 
+## 1.1.0 / 2021-06-08
+
+* [Added] Add CWS to usage metering endpoint. See [#376](https://github.com/DataDog/datadog-api-client-ruby/pull/376).
+* [Added] Add endpoint to list Synthetics global variables. See [#377](https://github.com/DataDog/datadog-api-client-ruby/pull/377).
+* [Added] Add monitors search endpoint. See [#373](https://github.com/DataDog/datadog-api-client-ruby/pull/373).
+* [Added] Add `tag_config_source` to usage attribution response. See [#368](https://github.com/DataDog/datadog-api-client-ruby/pull/368).
+* [Added] Add endpoints to configure Security Filters. See [#359](https://github.com/DataDog/datadog-api-client-ruby/pull/359).
+* [Added] Add `active_child` nested downtime object to `Downtime` component for downtime APIs. See [#354](https://github.com/DataDog/datadog-api-client-ruby/pull/354).
+* [Added] Add `override_label` and `is_hidden` attribute for `WidgetCustomLink`. See [#358](https://github.com/DataDog/datadog-api-client-ruby/pull/358).
+* [Added] Add audit logs to usage endpoints. See [#384](https://github.com/DataDog/datadog-api-client-ruby/pull/384).
+* [Fixed] Fix type of day/month response attribute in custom metrics usage. See [#387](https://github.com/DataDog/datadog-api-client-ruby/pull/387).
+* [Fixed] Make `assertions` field optional for multistep synthetics tests, and add `global` config variable type. See [#375](https://github.com/DataDog/datadog-api-client-ruby/pull/375).
+* [Fixed] Properly mark monitor required fields. See [#366](https://github.com/DataDog/datadog-api-client-ruby/pull/366).
+* [Fixed] Rename `incident_integration_metadata` to `incident_integrations` to match API. See [#362](https://github.com/DataDog/datadog-api-client-ruby/pull/362).
+* [Fixed] Properly mark several synthetics attributes as read only. See [#357](https://github.com/DataDog/datadog-api-client-ruby/pull/357).
+* [Fixed] Fix paging attributes of usage attribution endpoints. See [#355](https://github.com/DataDog/datadog-api-client-ruby/pull/355).
+* [Changed] Rename `compliance` to `CSPM` in usage endpoint. See [#384](https://github.com/DataDog/datadog-api-client-ruby/pull/384).
+
 ## 1.0.0 / 2021-05-12
 
 * [Added] Notebooks Public API Documentation. See [#351](https://github.com/DataDog/datadog-api-client-ruby/pull/351).

data/README.md

@@ -111,7 +111,7 @@ where `<unstable_operation_id>` is the name of the method used to interact with
 
 If you are interested in general documentation for all public Datadog API endpoints, checkout the [general documentation site](api docs).
 
-Developer documentation for supported endpoints and models is divided based on API version prefix to [`v1`](/docs/v1/README.md) and [`v2`](/docs/v1/README.md). 
+Developer documentation for supported endpoints and models is divided based on API version prefix to [`v1`](/docs/v1/README.md) and [`v2`](/docs/v2/README.md). 
 
 For contributing, checkout the [contribution guidelines](contribution docs) and [development guide][development docs].
 

data/data/v1/openapi.yaml

@@ -1258,6 +1258,8 @@ components:
           example: true
           readOnly: true
           type: boolean
+        active_child:
+          $ref: '#/components/schemas/DowntimeChild'
         canceled:
           description: If a scheduled downtime is canceled.
           example: 1412799983
@@ -1375,6 +1377,136 @@ components:
           readOnly: true
           type: integer
       type: object
+    DowntimeChild:
+      description: 'The downtime object definition of the active child for the original
+        parent recurring downtime. This
+
+        field will only exist on recurring downtimes.'
+      nullable: true
+      properties:
+        active:
+          description: If a scheduled downtime currently exists.
+          example: true
+          readOnly: true
+          type: boolean
+        canceled:
+          description: If a scheduled downtime is canceled.
+          example: 1412799983
+          format: int64
+          nullable: true
+          readOnly: true
+          type: integer
+        creator_id:
+          description: User ID of the downtime creator.
+          example: 123456
+          format: int32
+          maximum: 2147483647
+          readOnly: true
+          type: integer
+        disabled:
+          description: If a downtime has been disabled.
+          example: false
+          type: boolean
+        downtime_type:
+          description: '`0` for a downtime applied on `*` or all,
+
+            `1` when the downtime is only scoped to hosts,
+
+            or `2` when the downtime is scoped to anything but hosts.'
+          example: 2
+          format: int32
+          maximum: 2147483647
+          readOnly: true
+          type: integer
+        end:
+          description: 'POSIX timestamp to end the downtime. If not provided,
+
+            the downtime is in effect indefinitely until you cancel it.'
+          example: 1412793983
+          format: int64
+          nullable: true
+          type: integer
+        id:
+          description: The downtime ID.
+          example: 1626
+          format: int64
+          readOnly: true
+          type: integer
+        message:
+          description: 'A message to include with notifications for this downtime.
+
+            Email notifications can be sent to specific users by using the same `@username`
+            notation as events.'
+          example: Message on the downtime
+          type: string
+        monitor_id:
+          description: 'A single monitor to which the downtime applies.
+
+            If not provided, the downtime applies to all monitors.'
+          example: 123456
+          format: int64
+          nullable: true
+          type: integer
+        monitor_tags:
+          description: 'A comma-separated list of monitor tags. For example, tags
+            that are applied directly to monitors,
+
+            not tags that are used in monitor queries (which are filtered by the scope
+            parameter), to which the downtime applies.
+
+            The resulting downtime applies to monitors that match ALL provided monitor
+            tags.
+
+            For example, `service:postgres` **AND** `team:frontend`.'
+          example:
+          - '*'
+          items:
+            description: A monitor tag.
+            type: string
+          type: array
+        parent_id:
+          description: ID of the parent Downtime.
+          example: 123
+          format: int64
+          nullable: true
+          type: integer
+        recurrence:
+          $ref: '#/components/schemas/DowntimeRecurrence'
+        scope:
+          description: 'The scope(s) to which the downtime applies. For example, `host:app2`.
+
+            Provide multiple scopes as a comma-separated list like `env:dev,env:prod`.
+
+            The resulting downtime applies to sources that matches ALL provided scopes
+            (`env:dev` **AND** `env:prod`).'
+          example:
+          - env:staging
+          items:
+            description: A scope. For example, `"env:staging"`.
+            type: string
+          type: array
+        start:
+          description: 'POSIX timestamp to start the downtime.
+
+            If not provided, the downtime starts the moment it is created.'
+          example: 1412792983
+          format: int64
+          type: integer
+        timezone:
+          description: The timezone in which to display the downtime's start and end
+            times in Datadog applications.
+          example: America/New_York
+          type: string
+        updater_id:
+          description: ID of the last user that updated the downtime.
+          example: 123456
+          format: int32
+          maximum: 2147483647
+          nullable: true
+          readOnly: true
+          type: integer
+      readOnly: true
+      type: object
     DowntimeRecurrence:
       description: An object defining the recurrence of the downtime.
       nullable: true
@@ -4740,6 +4872,7 @@ components:
           type: integer
         query:
           description: The monitor query.
+          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
@@ -4758,6 +4891,9 @@ components:
           type: array
         type:
           $ref: '#/components/schemas/MonitorType'
+      required:
+      - type
+      - query
       type: object
     MonitorDeviceID:
       description: ID of the device the Synthetics monitor is running on. Same as
@@ -4783,6 +4919,95 @@ components:
       - FIREFOX_LAPTOP_LARGE
       - FIREFOX_TABLET
       - FIREFOX_MOBILE_SMALL
+    MonitorGroupSearchResponse:
+      description: The response of a monitor group search.
+      example:
+        counts:
+          status:
+          - count: 2
+            name: OK
+          type:
+          - count: 2
+            name: metric
+        groups:
+        - group: '*'
+          group_tags:
+          - '*'
+          last_nodata_ts: 0
+          last_triggered_ts: 1525702966
+          monitor_id: 2738266
+          monitor_name: '[demo] Cassandra disk usage is high on {{host.name}}'
+          status: OK
+        - group: '*'
+          group_tags:
+          - '*'
+          last_nodata_ts: 0
+          last_triggered_ts: 1525703008
+          monitor_id: 1576648
+          monitor_name: '[demo] Disk usage is high on {{host.name}}'
+          status: OK
+        metadata:
+          page: 0
+          page_count: 2
+          per_page: 30
+          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
+        groups:
+          description: The list of found monitor groups.
+          items:
+            $ref: '#/components/schemas/MonitorGroupSearchResult'
+          readOnly: true
+          type: array
+        metadata:
+          $ref: '#/components/schemas/MonitorSearchResponseMetadata'
+      type: object
+    MonitorGroupSearchResult:
+      description: A single monitor group search result.
+      properties:
+        group:
+          description: The name of the group.
+          readOnly: true
+          type: string
+        group_tags:
+          description: The list of tags of the monitor group.
+          items:
+            description: One monitor group tag.
+            readOnly: true
+            type: string
+          readOnly: true
+          type: array
+        last_nodata_ts:
+          description: Latest timestamp the monitor group was in NO_DATA state.
+          format: int64
+          readOnly: true
+          type: integer
+        last_triggered_ts:
+          description: Latest timestamp the monitor group triggered.
+          format: int64
+          nullable: true
+          readOnly: true
+          type: integer
+        monitor_id:
+          description: The ID of the monitor.
+          format: int64
+          readOnly: true
+          type: integer
+        monitor_name:
+          description: The name of the monitor.
+          readOnly: true
+          type: string
+        status:
+          $ref: '#/components/schemas/MonitorOverallStates'
+      type: object
     MonitorOptions:
       description: List of options associated with your monitor.
       properties:
@@ -4815,8 +5040,12 @@ components:
           type: boolean
         escalation_message:
           default: none
-          description: 'A message to include with a re-notification. Supports the
-            `@username` notification we allow elsewhere.
+          description: 'We recommend using the [is_renotify](https://docs.datadoghq.com/monitors/notifications/?tab=is_alert#renotify),
+
+            block in the original message instead.
+
+            A message to include with a re-notification. Supports the `@username`
+            notification we allow elsewhere.
 
             Not applicable if `renotify_interval` is `None`.'
           type: string
@@ -4965,6 +5194,199 @@ components:
       - SKIPPED
       - UNKNOWN
       - WARN
+    MonitorSearchCount:
+      description: Search facets.
+      items:
+        description: A facet item.
+        properties:
+          count:
+            description: The number of found monitors with the listed value.
+            format: int64
+            readOnly: true
+            type: integer
+          name:
+            description: The facet value.
+            readOnly: true
+        type: object
+      type: array
+    MonitorSearchResponse:
+      description: The response form a monitor search.
+      example:
+        counts:
+          muted:
+          - count: 3
+            name: false
+          - count: 3
+            name: true
+          status:
+          - count: 4
+            name: No Data
+          - count: 2
+            name: OK
+          tag:
+          - count: 6
+            name: service:cassandra
+          type:
+          - count: 6
+            name: metric
+        metadata:
+          page: 0
+          page_count: 6
+          per_page: 30
+          total_count: 6
+        monitors:
+        - classification: metric
+          creator:
+            handle: john@datadoghq.com
+            name: John Doe
+          id: 2699850
+          last_triggered_ts: null
+          metrics:
+          - system.cpu.user
+          name: Cassandra CPU is high on {{host.name}} in {{availability-zone.name}}
+          notifications:
+          - handle: jane@datadoghq.com
+            name: Jane Doe
+          org_id: 1234
+          scopes:
+          - '!availability-zone:us-east-1c'
+          - name:cassandra
+          status: No Data
+          tags:
+          - service:cassandra
+          type: metric 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
+        metadata:
+          $ref: '#/components/schemas/MonitorSearchResponseMetadata'
+        monitors:
+          description: The list of found monitors.
+          items:
+            $ref: '#/components/schemas/MonitorSearchResult'
+          readOnly: true
+          type: array
+      type: object
+    MonitorSearchResponseMetadata:
+      description: Metadata about the response.
+      properties:
+        page:
+          description: The page to start paginating from.
+          format: int64
+          readOnly: true
+          type: integer
+        page_count:
+          description: The number of pages.
+          format: int64
+          readOnly: true
+          type: integer
+        per_page:
+          description: The number of monitors to return per page.
+          format: int64
+          readOnly: true
+          type: integer
+        total_count:
+          description: The total number of monitors.
+          format: int64
+          readOnly: true
+          type: integer
+      type: object
+    MonitorSearchResult:
+      description: Holds search results.
+      properties:
+        classification:
+          description: Classification of the monitor.
+          readOnly: true
+          type: string
+        creator:
+          $ref: '#/components/schemas/Creator'
+        id:
+          description: ID of the monitor.
+          format: int64
+          readOnly: true
+          type: integer
+        last_triggered_ts:
+          description: Latest timestamp the monitor triggered.
+          format: int64
+          nullable: true
+          readOnly: true
+          type: integer
+        metrics:
+          description: Metrics used by the monitor.
+          items:
+            description: A metric used by the monitor.
+            readOnly: true
+            type: string
+          readOnly: true
+          type: array
+        name:
+          description: The monitor name.
+          readOnly: true
+          type: string
+        notifications:
+          description: The notification triggered by the monitor.
+          items:
+            $ref: '#/components/schemas/MonitorSearchResultNotification'
+          readOnly: true
+          type: array
+        org_id:
+          description: The ID of the organization.
+          format: int64
+          readOnly: true
+          type: integer
+        scopes:
+          description: 'The scope(s) to which the downtime applies, e.g. `host:app2`.
+
+            Provide multiple scopes as a comma-separated list, e.g. `env:dev,env:prod`.
+
+            The resulting downtime applies to sources that matches ALL provided scopes
+
+            (i.e. `env:dev AND env:prod`), NOT any of them.'
+          example:
+          - host:app2
+          - env:dev,env:prod
+          items:
+            description: Scope value(s).
+            readOnly: true
+            type: string
+          type: array
+        status:
+          $ref: '#/components/schemas/MonitorOverallStates'
+        tags:
+          description: Tags associated with the monitor.
+          items:
+            description: A tag associated with the monitor.
+            readOnly: true
+            type: string
+          readOnly: true
+          type: array
+        type:
+          $ref: '#/components/schemas/MonitorType'
+      type: object
+    MonitorSearchResultNotification:
+      description: A notification triggered by the monitor.
+      properties:
+        handle:
+          description: The email address that received the notification.
+          readOnly: true
+          type: string
+        name:
+          description: The username receiving the notification
+          readOnly: true
+          type: string
+      readOnly: true
+      type: object
     MonitorState:
       description: Wrapper object with the different monitor states.
       properties:
@@ -5125,6 +5547,7 @@ components:
       - trace-analytics alert
       - slo alert
       - event-v2 alert
+      example: metric alert
       type: string
       x-enum-varnames:
       - COMPOSITE
@@ -5274,6 +5697,7 @@ components:
       required:
       - start
       - end
+      type: object
     NotebookAuthor:
       description: Attributes of user object returned by the API.
       properties:
@@ -5497,7 +5921,7 @@ components:
             $ref: '#/components/schemas/NotebookCellCreateRequest'
           type: array
         name:
-          description: Notebook name.
+          description: The name of the notebook.
           example: Example Notebook
           maxLength: 80
           minLength: 0
@@ -5520,7 +5944,7 @@ components:
       - data
       type: object
     NotebookDistributionCellAttributes:
-      description: The attributes of a notebook distribution cell.
+      description: The attributes of a notebook `distribution` cell.
       properties:
         definition:
           $ref: '#/components/schemas/DistributionWidgetDefinition'
@@ -5547,6 +5971,7 @@ components:
       - m
       - l
       - xl
+      example: m
       type: string
       x-enum-varnames:
       - EXTRA_SMALL
@@ -5555,7 +5980,7 @@ components:
       - LARGE
       - EXTRA_LARGE
     NotebookHeatMapCellAttributes:
-      description: The attributes of a notebook heat map cell.
+      description: The attributes of a notebook `heatmap` cell.
       properties:
         definition:
           $ref: '#/components/schemas/HeatMapWidgetDefinition'
@@ -5569,7 +5994,7 @@ components:
       - definition
       type: object
     NotebookLogStreamCellAttributes:
-      description: The attributes of a notebook log stream cell.
+      description: The attributes of a notebook `log_stream` cell.
       properties:
         definition:
           $ref: '#/components/schemas/LogStreamWidgetDefinition'
@@ -5581,7 +6006,7 @@ components:
       - definition
       type: object
     NotebookMarkdownCellAttributes:
-      description: The attributes of a notebooks markdown cell.
+      description: The attributes of a notebook `markdown` cell.
       properties:
         definition:
           $ref: '#/components/schemas/NotebookMarkdownCellDefinition'
@@ -5704,19 +6129,19 @@ components:
             $ref: '#/components/schemas/NotebookCellResponse'
           type: array
         created:
-          description: UTC time stamp.
+          description: UTC time stamp for when the notebook was created.
           example: '2021-02-24T23:14:15.173964+00:00'
           format: date-time
           readOnly: true
           type: string
         modified:
-          description: UTC time stamp.
+          description: UTC time stamp for when the notebook was last modified.
           example: '2021-02-24T23:15:23.274966+00:00'
           format: date-time
           readOnly: true
           type: string
         name:
-          description: Notebook name.
+          description: The name of the notebook.
           example: Example Notebook
           maxLength: 80
           minLength: 0
@@ -5733,6 +6158,9 @@ components:
     NotebookSplitBy:
       description: Object describing how to split the graph to display multiple visualizations
         per request.
+      example:
+        keys: []
+        tags: []
       properties:
         keys:
           description: Keys to split on.
@@ -5762,7 +6190,7 @@ components:
       x-enum-varnames:
       - PUBLISHED
     NotebookTimeseriesCellAttributes:
-      description: The attributes of a notebook timeseries cell.
+      description: The attributes of a notebook `timeseries` cell.
       properties:
         definition:
           $ref: '#/components/schemas/TimeseriesWidgetDefinition'
@@ -5776,7 +6204,7 @@ components:
       - definition
       type: object
     NotebookToplistCellAttributes:
-      description: The attributes of a notebook toplist cell.
+      description: The attributes of a notebook `toplist` cell.
       properties:
         definition:
           $ref: '#/components/schemas/ToplistWidgetDefinition'
@@ -5856,7 +6284,7 @@ components:
             $ref: '#/components/schemas/NotebookUpdateCell'
           type: array
         name:
-          description: Notebook name.
+          description: The name of the notebook.
           example: Example Notebook
           maxLength: 80
           minLength: 0
@@ -5884,7 +6312,7 @@ components:
         data:
           description: List of notebook definitions.
           items:
-            $ref: '#/components/schemas/NotebookResponseData'
+            $ref: '#/components/schemas/NotebooksResponseData'
           type: array
         meta:
           description: Metadata returned by the API.
@@ -5893,6 +6321,59 @@ components:
               $ref: '#/components/schemas/NotebooksResponsePage'
           type: object
       type: object
+    NotebooksResponseData:
+      description: The data for a notebook in get all response.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/NotebooksResponseDataAttributes'
+        id:
+          description: Unique notebook ID, assigned when you create the notebook.
+          example: 123456
+          format: int64
+          readOnly: true
+          type: integer
+        type:
+          $ref: '#/components/schemas/NotebookResourceType'
+      required:
+      - id
+      - type
+      - attributes
+      type: object
+    NotebooksResponseDataAttributes:
+      description: The attributes of a notebook in get all response.
+      properties:
+        author:
+          $ref: '#/components/schemas/NotebookAuthor'
+        cells:
+          description: List of cells to display in the notebook.
+          items:
+            $ref: '#/components/schemas/NotebookCellResponse'
+          type: array
+        created:
+          description: UTC time stamp for when the notebook was created.
+          example: '2021-02-24T23:14:15.173964+00:00'
+          format: date-time
+          readOnly: true
+          type: string
+        modified:
+          description: UTC time stamp for when the notebook was last modified.
+          example: '2021-02-24T23:15:23.274966+00:00'
+          format: date-time
+          readOnly: true
+          type: string
+        name:
+          description: The name of the notebook.
+          example: Example Notebook
+          maxLength: 80
+          minLength: 0
+          type: string
+        status:
+          $ref: '#/components/schemas/NotebookStatus'
+        time:
+          $ref: '#/components/schemas/NotebookGlobalTime'
+      required:
+      - name
+      type: object
     NotebooksResponsePage:
       description: Pagination metadata returned by the API.
       properties:
@@ -7813,6 +8294,7 @@ components:
         monitor_id:
           description: The associated monitor ID.
           format: int64
+          readOnly: true
           type: integer
         name:
           description: Name of the test.
@@ -7821,6 +8303,7 @@ components:
           $ref: '#/components/schemas/SyntheticsTestOptions'
         public_id:
           description: The public ID for the test.
+          readOnly: true
           type: string
         status:
           $ref: '#/components/schemas/SyntheticsTestPauseStatus'
@@ -7857,8 +8340,6 @@ components:
           items:
             $ref: '#/components/schemas/SyntheticsAPIStep'
           type: array
-      required:
-      - assertions
       type: object
     SyntheticsAPITestResultData:
       description: Object containing results for your Synthetic API test.
@@ -8151,6 +8632,7 @@ components:
         monitor_id:
           description: The associated monitor ID.
           format: int64
+          readOnly: true
           type: integer
         name:
           description: Name of the test.
@@ -8159,6 +8641,7 @@ components:
           $ref: '#/components/schemas/SyntheticsTestOptions'
         public_id:
           description: The public ID of the test.
+          readOnly: true
           type: string
         status:
           $ref: '#/components/schemas/SyntheticsTestPauseStatus'
@@ -8489,6 +8972,9 @@ components:
         example:
           description: Example for the variable.
           type: string
+        id:
+          description: ID of the variable for global variables.
+          type: string
         name:
           description: Name of the variable.
           example: VARIABLE_NAME
@@ -8499,16 +8985,17 @@ components:
         type:
           $ref: '#/components/schemas/SyntheticsConfigVariableType'
       required:
-      - example
       - type
       - name
       type: object
     SyntheticsConfigVariableType:
       description: Type of the configuration variable.
       enum:
+      - global
       - text
       type: string
       x-enum-varnames:
+      - GLOBAL
       - TEXT
     SyntheticsCoreWebVitals:
       description: Core Web Vitals attached to a browser test step.
@@ -8750,8 +9237,15 @@ components:
             the value will not be present if the variable is secure.'
           example: example-value
           type: string
-      required:
-      - value
+      type: object
+    SyntheticsListGlobalVariablesResponse:
+      description: Object containing an array of Synthetic global variables.
+      properties:
+        variables:
+          description: Array of Synthetic global variables.
+          items:
+            $ref: '#/components/schemas/SyntheticsGlobalVariable'
+          type: array
       type: object
     SyntheticsListTestsResponse:
       description: Object containing an array of Synthetic tests configuration.
@@ -9152,8 +9646,6 @@ components:
           items:
             $ref: '#/components/schemas/SyntheticsBrowserVariable'
           type: array
-      required:
-      - assertions
       type: object
     SyntheticsTestDetails:
       description: Object containing details about your Synthetic test.
@@ -9172,6 +9664,7 @@ components:
         monitor_id:
           description: The associated monitor ID.
           format: int64
+          readOnly: true
           type: integer
         name:
           description: Name of the test.
@@ -9180,6 +9673,7 @@ components:
           $ref: '#/components/schemas/SyntheticsTestOptions'
         public_id:
           description: The test public ID.
+          readOnly: true
           type: string
         status:
           $ref: '#/components/schemas/SyntheticsTestPauseStatus'
@@ -10020,6 +10514,11 @@ components:
         public_id:
           description: The organization public ID.
           type: string
+        tag_config_source:
+          description: The source of the usage attribution tag configuration and the
+            selected tags in the format `<source_org_name>:<selected tag 1>-<selected
+            tag 2>-<selected tag 3>`.
+          type: string
         tags:
           $ref: '#/components/schemas/UsageAttributionTagNames'
         updated_at:
@@ -10038,24 +10537,18 @@ components:
           $ref: '#/components/schemas/UsageAttributionPagination'
       type: object
     UsageAttributionPagination:
-      description: The page count for the current pagination.
+      description: The metadata for the current pagination.
       properties:
         limit:
           description: Maximum amount of records to be returned.
           format: int64
           type: integer
-        offset:
-          description: Records to be skipped before beginning to return.
-          format: int64
-          type: integer
-        sort_direction:
-          description: Direction to sort by.
-          type: string
-        sort_name:
-          description: Field to sort by.
+        next_record_id:
+          description: The cursor to use to get the next results, if any. To make
+            the next request, use the same parameters with the addition of this next_record_id.
           type: string
         total_number_of_records:
-          description: Total number of records.
+          description: Total number of records. (deprecated after May 1st, 2021)
           format: int64
           type: integer
       type: object
@@ -10237,6 +10730,23 @@ components:
           description: The custom metrics usage by tag(s).
           format: double
           type: number
+        cws_container_percentage:
+          description: The percentage of Cloud Workload Security container usage by
+            tag(s)
+          format: double
+          type: number
+        cws_container_usage:
+          description: The Cloud Workload Security container usage by tag(s)
+          format: double
+          type: number
+        cws_host_percentage:
+          description: The percentage of Cloud Workload Security host usage by tag(s)
+          format: double
+          type: number
+        cws_host_usage:
+          description: The Cloud Workload Security host usage by tag(s)
+          format: double
+          type: number
         infra_host_percentage:
           description: The percentage of infrastructure host usage by tag(s).
           format: double
@@ -10308,6 +10818,29 @@ components:
           format: double
           type: number
       type: object
+    UsageAuditLogsHour:
+      description: Audit logs usage for a given organization for a given hour.
+      properties:
+        hour:
+          description: The hour for the usage.
+          format: date-time
+          type: string
+        lines_indexed:
+          description: The total number of audit logs lines indexed during a given
+            hour.
+          format: int64
+          type: integer
+      type: object
+    UsageAuditLogsResponse:
+      description: Response containing the audit logs usage for each hour for a given
+        organization.
+      properties:
+        usage:
+          description: Get hourly usage for audit logs.
+          items:
+            $ref: '#/components/schemas/UsageAuditLogsHour'
+          type: array
+      type: object
     UsageBillableSummaryBody:
       description: Response with properties for each aggregated usage type.
       properties:
@@ -10421,18 +10954,18 @@ components:
             $ref: '#/components/schemas/UsageBillableSummaryHour'
           type: array
       type: object
-    UsageComplianceHour:
-      description: Compliance Monitoring usage for a given organization for a given
+    UsageCWSHour:
+      description: Cloud Workload Security usage for a given organization for a given
         hour.
       properties:
-        compliance_container_count:
-          description: The total number of compliance container hours from the start
-            of the given hour's month until the given hour.
+        cws_container_count:
+          description: "The total number of Cloud Workload Security container hours\
+            \ from the start of the given hour\u2019s month until the given hour."
           format: int64
           type: integer
-        compliance_host_count:
-          description: The total number of compliance hosts hours from the start of
-            the given hour's month until the given hour.
+        cws_host_count:
+          description: "The total number of Cloud Workload Security host hours from\
+            \ the start of the given hour\u2019s month until the given hour."
           format: int64
           type: integer
         hour:
@@ -10440,14 +10973,43 @@ components:
           format: date-time
           type: string
       type: object
-    UsageComplianceResponse:
-      description: The response containing the Compliance Monitoring usage for each
+    UsageCWSResponse:
+      description: Response containing the Cloud Workload Security usage for each
         hour for a given organization.
       properties:
         usage:
-          description: Get hourly usage for Compliance Monitoring.
+          description: Get hourly usage for Cloud Workload Security.
+          items:
+            $ref: '#/components/schemas/UsageCWSHour'
+          type: array
+      type: object
+    UsageCloudSecurityPostureManagementHour:
+      description: Cloud Security Posture Management usage for a given organization
+        for a given hour.
+      properties:
+        container_count:
+          description: The total number of Cloud Security Posture Management containers
+            during a given hour.
+          format: int64
+          type: integer
+        host_count:
+          description: The total number of Cloud Security Posture Management hosts
+            during a given hour.
+          format: int64
+          type: integer
+        hour:
+          description: The hour for the usage.
+          format: date-time
+          type: string
+      type: object
+    UsageCloudSecurityPostureManagementResponse:
+      description: The response containing the Cloud Security Posture Management usage
+        for each hour for a given organization.
+      properties:
+        usage:
+          description: Get hourly usage for Cloud Security Posture Management.
           items:
-            $ref: '#/components/schemas/UsageComplianceHour'
+            $ref: '#/components/schemas/UsageCloudSecurityPostureManagementHour'
           type: array
       type: object
     UsageCustomReportsAttributes:
@@ -11115,6 +11677,11 @@ components:
             hours in the current date for all organizations.
           format: int64
           type: integer
+        audit_logs_lines_indexed_sum:
+          description: Shows the sum of audit logs lines indexed over all hours in
+            the current date for all organizations.
+          format: int64
+          type: integer
         aws_host_top99p:
           description: Shows the 99th percentile of all AWS hosts over all hours in
             the current date for all organizations.
@@ -11140,14 +11707,6 @@ components:
             current date for all organizations.
           format: int64
           type: integer
-        compliance_container_count_sum:
-          description: Shows the sum of compliance containers over all hours in the
-            current date for all organizations.
-        compliance_host_count_sum:
-          description: Shows the sum of compliance hosts over all hours in the current
-            date 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.
@@ -11158,11 +11717,36 @@ components:
             hours in the current date for all organizations.
           format: int64
           type: integer
+        cspm_container_avg:
+          description: Shows the average number of Cloud Security Posture Management
+            containers over all hours in the current date for all organizations.
+          format: int64
+          type: integer
+        cspm_container_hwm:
+          description: Shows the high-water mark of Cloud Security Posture Management
+            containers over all hours in the current date for all organizations.
+          format: int64
+          type: integer
+        cspm_host_top99p:
+          description: Shows the 99th percentile of all Cloud Security Posture Management
+            hosts over all hours in the current date for all organizations.
+          format: int64
+          type: integer
         custom_ts_avg:
           description: Shows the average number of distinct custom metrics over all
             hours in the current date for all organizations.
           format: int64
           type: integer
+        cws_container_count_avg:
+          description: Shows the average of all distinct Cloud Workload Security containers
+            over all hours in the current date for all organizations.
+          format: int64
+          type: integer
+        cws_host_top99p:
+          description: Shows the 99th percentile of all Cloud Workload Security hosts
+            over all hours in the current date for all organizations.
+          format: int64
+          type: integer
         date:
           description: The date for the usage.
           format: date-time
@@ -11313,6 +11897,11 @@ components:
             hours in the current date for the given org.
           format: int64
           type: integer
+        audit_logs_lines_indexed_sum:
+          description: Shows the sum of all audit logs lines indexed over all hours
+            in the current date for the given org.
+          format: int64
+          type: integer
         aws_host_top99p:
           description: Shows the 99th percentile of all AWS hosts over all hours in
             the current date for the given org.
@@ -11338,14 +11927,6 @@ components:
             current date for the given org.
           format: int64
           type: integer
-        compliance_container_agg_sum:
-          description: Shows the sum of all compliance containers over all hours in
-            the current date for the given org.
-        compliance_host_agg_sum:
-          description: Shows the sum of all compliance hosts 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.
@@ -11356,11 +11937,36 @@ components:
             hours in the current date for the given org.
           format: int64
           type: integer
+        cspm_container_avg:
+          description: Shows the average number of Cloud Security Posture Management
+            containers over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        cspm_container_hwm:
+          description: Shows the high-water mark of Cloud Security Posture Management
+            containers over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        cspm_host_top99p:
+          description: Shows the 99th percentile of all Cloud Security Posture Management
+            hosts over all hours in the current date for the given org.
+          format: int64
+          type: integer
         custom_ts_avg:
           description: Shows the average number of distinct custom metrics over all
             hours in the current date for the given org.
           format: int64
           type: integer
+        cws_container_count_avg:
+          description: Shows the average of all distinct Cloud Workload Security containers
+            over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        cws_host_top99p:
+          description: Shows the 99th percentile of all Cloud Workload Security hosts
+            over all hours in the current date for the given org.
+          format: int64
+          type: integer
         fargate_tasks_count_avg:
           description: The average task count for Fargate.
           format: int64
@@ -11509,6 +12115,11 @@ components:
             hours in the current months for all organizations.
           format: int64
           type: integer
+        audit_logs_lines_indexed_agg_sum:
+          description: Shows the sum of all audit logs lines indexed over all hours
+            in the current months for all organizations.
+          format: int64
+          type: integer
         aws_host_top99p_sum:
           description: Shows the 99th percentile of all AWS hosts over all hours in
             the current months for all organizations.
@@ -11539,14 +12150,6 @@ components:
             current months for all organizations.
           format: int64
           type: integer
-        compliance_container_agg_sum:
-          description: Shows the sum of all compliance containers over all hours in
-            the current months for all organizations.
-        compliance_host_agg_sum:
-          description: Shows the sum of all compliance hosts 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.
@@ -11557,11 +12160,37 @@ components:
             over all hours in the current months for all organizations.
           format: int64
           type: integer
+        cspm_container_avg_sum:
+          description: Shows the average number of Cloud Security Posture Management
+            containers over all hours in the current months for all organizations.
+          format: int64
+          type: integer
+        cspm_container_hwm_sum:
+          description: Shows the sum of the the high-water marks of Cloud Security
+            Posture Management containers over all hours in the current months for
+            all organizations.
+          format: int64
+          type: integer
+        cspm_host_top99p_sum:
+          description: Shows the 99th percentile of all Cloud Security Posture Management
+            hosts over all hours in the current months for all organizations.
+          format: int64
+          type: integer
         custom_ts_sum:
           description: Shows the average number of distinct custom metrics over all
             hours in the current months for all organizations.
           format: int64
           type: integer
+        cws_containers_avg_sum:
+          description: Shows the average of all distinct Cloud Workload Security containers
+            over all hours in the current months for all organizations.
+          format: int64
+          type: integer
+        cws_host_top99p_sum:
+          description: Shows the 99th percentile of all Cloud Workload Security hosts
+            over all hours in the current months for all organizations.
+          format: int64
+          type: integer
         end_date:
           description: Shows the last date of usage in the current months for all
             organizations.
@@ -11857,9 +12486,13 @@ components:
         day:
           description: The day value from the user request that contains the returned
             usage data. (If day was used the request)
+          format: date-time
+          type: string
         month:
           description: The month value from the user request that contains the returned
             usage data. (If month was used the request)
+          format: date-time
+          type: string
         pagination:
           $ref: '#/components/schemas/UsageAttributionPagination'
       type: object
@@ -12121,6 +12754,9 @@ components:
       description: Custom links help you connect a data value to a URL, like a Datadog
         page or your AWS console.
       properties:
+        is_hidden:
+          description: The flag for toggling context menu link visibility.
+          type: boolean
         label:
           description: The label for the custom link URL. Keep the label short and
             descriptive. Use metrics and tags as variables.
@@ -12131,9 +12767,11 @@ components:
             A relative URL must start with `/`.
           example: https://app.datadoghq.com/logs?query={{host}}
           type: string
-      required:
-      - label
-      - link
+        override_label:
+          description: The label ID that refers to a context menu link. Can be `logs`,
+            `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`.
+          example: logs
+          type: string
       type: object
     WidgetDefinition:
       description: '[Definition of the widget](https://docs.datadoghq.com/dashboards/widgets/).'
@@ -16556,6 +17194,7 @@ paths:
         name: group_states
         required: false
         schema:
+          example: alert
           type: string
       - description: A string to filter monitors by name.
         in: query
@@ -16571,6 +17210,7 @@ paths:
         name: tags
         required: false
         schema:
+          example: host:host0
           type: string
       - description: 'A comma separated list indicating what service and/or custom
           tags, if any, should be used to filter the list of monitors.
@@ -16581,6 +17221,7 @@ paths:
         name: monitor_tags
         required: false
         schema:
+          example: service:my-app
           type: string
       - description: If this argument is set to true, then the returned data includes
           all current downtimes for each monitor.
@@ -16602,6 +17243,7 @@ paths:
         name: page
         required: false
         schema:
+          example: 0
           format: int64
           type: integer
       - description: The number of monitors to return per page. If the page argument
@@ -16612,6 +17254,7 @@ paths:
         name: page_size
         required: false
         schema:
+          example: 20
           format: int32
           maximum: 1000
           type: integer
@@ -16743,19 +17386,27 @@ paths:
         **Service Check Query**
 
 
-        Example: `"check".over(tags).last(count).count_by_status()`
+        Example: `"check".over(tags).last(count).by(group).count_by_status()`
 
 
         - **`check`** name of the check, e.g. `datadog.agent.up`
 
         - **`tags`** one or more quoted tags (comma-separated), or "*". e.g.: `.over("env:prod",
-        "role:db")`
+        "role:db")`; **`over`** cannot be blank.
 
         - **`count`** must be at greater than or equal to your max threshold (defined
         in the `options`). It is limited to 100.
 
         For example, if you''ve specified to notify on 1 critical, 3 ok, and 2 warn
-        statuses, `count` should be 3.
+        statuses, `count` should be at least 3.
+
+        - **`group`** must be specified for check monitors. Per-check grouping is
+        already explicitly known for some service checks.
+
+        For example, Postgres integration monitors are tagged by `db`, `host`, and
+        `port`, and Network monitors by `host`, `instance`, and `url`. See [Service
+        Checks](https://docs.datadoghq.com/api/latest/service-checks/) documentation
+        for more information.
 
 
         **Event Alert Query**
@@ -16908,6 +17559,19 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              json-request-body:
+                value:
+                  message: You may need to add web hosts if this is consistently high.
+                  name: Bytes received on host0
+                  options:
+                    no_data_timeframe: 20
+                    notify_no_data: true
+                  query: avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100
+                  tags:
+                  - app:webserver
+                  - frontend
+                  type: metric alert
             schema:
               $ref: '#/components/schemas/Monitor'
         description: Create a monitor request body.
@@ -16987,6 +17651,170 @@ paths:
       x-menu-order: 6
       x-undo:
         type: safe
+  /api/v1/monitor/groups/search:
+    get:
+      description: Search and filter your monitor groups details.
+      operationId: SearchMonitorGroups
+      parameters:
+      - description: 'After entering a search query in your [Manage Monitor page][1]
+          use the query parameter value in the
+
+          URL of the page as value for this parameter. Consult the dedicated [manage
+          monitor documentation][2]
+
+          page to learn more.
+
+
+          The query can contain any number of space-separated monitor attributes,
+          for instance `query="type:metric status:alert"`.
+
+
+          [1]: https://app.datadoghq.com/monitors/manage
+
+          [2]: /monitors/manage_monitor/#find-the-monitors'
+        in: query
+        name: query
+        required: false
+        schema:
+          type: string
+      - description: Page to start paginating from.
+        in: query
+        name: page
+        required: false
+        schema:
+          default: 0
+          format: int64
+          type: integer
+      - description: Number of monitors to return per page.
+        in: query
+        name: per_page
+        required: false
+        schema:
+          default: 30
+          format: int64
+          type: integer
+      - description: 'String for sort order, composed of field and sort order separate
+          by a comma, e.g. `name,asc`. Supported sort directions: `asc`, `desc`. Supported
+          fields:
+
+
+          * `name`
+
+          * `status`
+
+          * `tags`'
+        in: query
+        name: sort
+        required: false
+        schema:
+          type: string
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/MonitorGroupSearchResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+      summary: Monitors group search
+      tags:
+      - Monitors
+      x-menu-order: 2
+      x-undo:
+        type: safe
+  /api/v1/monitor/search:
+    get:
+      description: Search and filter your monitors details.
+      operationId: SearchMonitors
+      parameters:
+      - description: 'After entering a search query in your [Manage Monitor page][1]
+          use the query parameter value in the
+
+          URL of the page as value for this parameter. Consult the dedicated [manage
+          monitor documentation][2]
+
+          page to learn more.
+
+
+          The query can contain any number of space-separated monitor attributes,
+          for instance `query="type:metric status:alert"`.
+
+
+          [1]: https://app.datadoghq.com/monitors/manage
+
+          [2]: /monitors/manage_monitor/#find-the-monitors'
+        in: query
+        name: query
+        required: false
+        schema:
+          type: string
+      - description: Page to start paginating from.
+        in: query
+        name: page
+        required: false
+        schema:
+          default: 0
+          format: int64
+          type: integer
+      - description: Number of monitors to return per page.
+        in: query
+        name: per_page
+        required: false
+        schema:
+          default: 30
+          format: int64
+          type: integer
+      - description: 'String for sort order, composed of field and sort order separate
+          by a comma, e.g. `name,asc`. Supported sort directions: `asc`, `desc`. Supported
+          fields:
+
+
+          * `name`
+
+          * `status`
+
+          * `tags`'
+        in: query
+        name: sort
+        required: false
+        schema:
+          type: string
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/MonitorSearchResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+      summary: Monitors search
+      tags:
+      - Monitors
+      x-menu-order: 1
+      x-undo:
+        type: safe
   /api/v1/monitor/validate:
     post:
       description: Validate the monitor provided in the request.
@@ -17003,7 +17831,8 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/Monitor'
+                example: {}
+                type: object
           description: OK
         '400':
           content:
@@ -17042,6 +17871,7 @@ paths:
         name: force
         required: false
         schema:
+          example: 'false'
           type: string
       responses:
         '200':
@@ -17433,6 +18263,43 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              json-request-body:
+                value:
+                  data:
+                    attributes:
+                      cells:
+                      - attributes:
+                          definition:
+                            text: '## Some test markdown
+
+
+                              With some example content.'
+                            type: markdown
+                        type: notebook_cells
+                      - attributes:
+                          definition:
+                            requests:
+                            - display_type: line
+                              q: avg:system.load.1{*}
+                              style:
+                                line_type: solid
+                                line_width: normal
+                                palette: dog_classic
+                            show_legend: true
+                            type: timeseries
+                            yaxis:
+                              scale: linear
+                          graph_size: m
+                          split_by:
+                            keys: []
+                            tags: []
+                          time: null
+                        type: notebook_cells
+                      name: Example Notebook
+                      time:
+                        live_span: 1h
+                    type: notebooks
             schema:
               $ref: '#/components/schemas/NotebookCreateRequest'
         description: The JSON description of the notebook you want to create.
@@ -17565,6 +18432,44 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              json-request-body:
+                value:
+                  data:
+                    attributes:
+                      cells:
+                      - attributes:
+                          definition:
+                            text: '## Some updated test markdown
+
+
+                              With some example content.'
+                            type: markdown
+                        type: notebook_cells
+                      - attributes:
+                          definition:
+                            requests:
+                            - display_type: bars
+                              q: avg:system.load.1{*}
+                              style:
+                                line_type: solid
+                                line_width: normal
+                                palette: warm
+                            show_legend: true
+                            type: timeseries
+                            yaxis:
+                              scale: linear
+                          graph_size: m
+                          split_by:
+                            keys: []
+                            tags: []
+                          time: null
+                        id: abcd1234
+                        type: notebook_cells
+                      name: Example Notebook
+                      time:
+                        live_span: 1h
+                    type: notebooks
             schema:
               $ref: '#/components/schemas/NotebookUpdateRequest'
         description: Update notebook request body.
@@ -17912,13 +18817,13 @@ paths:
     post:
       description: "The metrics end-point allows you to post time-series data that\
         \ can be graphed on Datadog\u2019s dashboards.\nThe maximum payload size is\
-        \ 3.2 megabytes (3200000). Compressed payloads must have a decompressed size\
-        \ of up to 62 megabytes (62914560).\n\nIf you\u2019re submitting metrics directly\
-        \ to the Datadog API without using DogStatsD, expect\n\n- 64 bits for the\
-        \ timestamp\n- 32 bits for the value\n- 20 bytes for the metric names\n- 50\
-        \ bytes for the timeseries\n- The full payload is approximately ~ 100 bytes.\
-        \ However, with the DogStatsD API,\ncompression is applied, which reduces\
-        \ the payload size."
+        \ 3.2 megabytes (3200000 bytes). Compressed payloads must have a decompressed\
+        \ size of less than 62 megabytes (62914560 bytes).\n\nIf you\u2019re submitting\
+        \ metrics directly to the Datadog API without using DogStatsD, expect:\n\n\
+        - 64 bits for the timestamp\n- 32 bits for the value\n- 20 bytes for the metric\
+        \ names\n- 50 bytes for the timeseries\n- The full payload is approximately\
+        \ 100 bytes. However, with the DogStatsD API,\ncompression is applied, which\
+        \ reduces the payload size."
       operationId: SubmitMetrics
       requestBody:
         content:
@@ -18632,7 +19537,7 @@ paths:
       summary: Get all locations (public and private)
       tags:
       - Synthetics
-      x-menu-order: 22
+      x-menu-order: 23
       x-undo:
         type: safe
   /api/v1/synthetics/private-locations:
@@ -18669,7 +19574,7 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
-      x-menu-order: 19
+      x-menu-order: 20
       x-undo:
         operationId: DeletePrivateLocation
         parameters:
@@ -18701,7 +19606,7 @@ paths:
       summary: Delete a private location
       tags:
       - Synthetics
-      x-menu-order: 23
+      x-menu-order: 24
       x-undo:
         type: idempotent
     get:
@@ -18771,7 +19676,7 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
-      x-menu-order: 20
+      x-menu-order: 22
       x-undo:
         type: idempotent
   /api/v1/synthetics/tests:
@@ -19313,7 +20218,7 @@ paths:
       summary: Get a test configuration
       tags:
       - Synthetics
-      x-menu-order: 24
+      x-menu-order: 25
       x-undo:
         type: safe
   /api/v1/synthetics/tests/{public_id}/results:
@@ -19475,6 +20380,28 @@ paths:
       x-undo:
         type: idempotent
   /api/v1/synthetics/variables:
+    get:
+      description: Get the list of all Synthetics global variables.
+      operationId: ListGlobalVariables
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SyntheticsListGlobalVariablesResponse'
+          description: OK
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+      summary: Get all global variables
+      tags:
+      - Synthetics
+      x-menu-order: 15
+      x-undo:
+        type: safe
     post:
       description: Create a Synthetics global variable.
       operationId: CreateGlobalVariable
@@ -19508,7 +20435,7 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
-      x-menu-order: 15
+      x-menu-order: 16
       x-undo:
         operationId: DeleteGlobalVariable
         parameters:
@@ -19550,7 +20477,7 @@ paths:
       summary: Delete a global variable
       tags:
       - Synthetics
-      x-menu-order: 18
+      x-menu-order: 19
       x-undo:
         type: idempotent
     get:
@@ -19585,7 +20512,7 @@ paths:
       summary: Get a global variable
       tags:
       - Synthetics
-      x-menu-order: 17
+      x-menu-order: 18
       x-undo:
         type: safe
     put:
@@ -19628,7 +20555,7 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
-      x-menu-order: 16
+      x-menu-order: 17
       x-undo:
         type: idempotent
   /api/v1/tags/hosts:
@@ -19980,6 +20907,54 @@ paths:
       x-unstable: '**Note**: This endpoint is in public beta.
 
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+  /api/v1/usage/audit_logs:
+    get:
+      description: Get hourly usage for audit logs.
+      operationId: GetUsageAuditLogs
+      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/UsageAuditLogsResponse'
+          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
+      summary: Get hourly usage for audit logs
+      tags:
+      - Usage Metering
+      x-menu-order: 31
+      x-undo:
+        type: safe
   /api/v1/usage/aws_lambda:
     get:
       description: Get hourly usage for lambda.
@@ -20064,10 +21039,10 @@ paths:
       x-menu-order: 19
       x-undo:
         type: safe
-  /api/v1/usage/compliance-monitoring:
+  /api/v1/usage/cspm:
     get:
-      description: Get hourly usage for Compliance Monitoring.
-      operationId: GetUsageComplianceMonitoring
+      description: Get hourly usage for Cloud Security Posture Management (CSPM).
+      operationId: GetUsageCloudSecurityPostureManagement
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
           for usage beginning at this hour.'
@@ -20092,7 +21067,7 @@ paths:
           content:
             application/json;datetime-format=rfc3339:
               schema:
-                $ref: '#/components/schemas/UsageComplianceResponse'
+                $ref: '#/components/schemas/UsageCloudSecurityPostureManagementResponse'
           description: OK
         '400':
           content:
@@ -20106,12 +21081,60 @@ paths:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
           description: Forbidden - User is not authorized
-      summary: Get hourly usage for Compliance Monitoring
+      summary: Get hourly usage for CSPM
       tags:
       - Usage Metering
       x-menu-order: 30
       x-undo:
         type: safe
+  /api/v1/usage/cws:
+    get:
+      description: Get hourly usage for Cloud Workload Security.
+      operationId: GetUsageCWS
+      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/UsageCWSResponse'
+          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
+      summary: Get hourly usage for Cloud Workload Security
+      tags:
+      - Usage Metering
+      x-menu-order: 31
+      x-undo:
+        type: safe
   /api/v1/usage/fargate:
     get:
       description: Get hourly usage for [Fargate](https://docs.datadoghq.com/integrations/ecs_fargate/).
@@ -21026,7 +22049,7 @@ paths:
         type: safe
   /api/v1/usage/top_avg_metrics:
     get:
-      description: Get top [custom metrics](https://docs.datadoghq.com/developers/metrics/custom_metrics/)
+      description: Get all [custom metrics](https://docs.datadoghq.com/developers/metrics/custom_metrics/)
         by hourly average. Use the month parameter to get a month-to-date data resolution
         or use the day parameter to get a daily resolution. One of the two is required,
         and only one of the two is allowed.
@@ -21067,6 +22090,13 @@ paths:
           maximum: 5000
           minimum: 1
           type: integer
+      - description: List following results with a next_record_id provided in the
+          previous query.
+        in: query
+        name: next_record_id
+        required: false
+        schema:
+          type: string
       responses:
         '200':
           content:
@@ -21086,7 +22116,7 @@ paths:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
           description: Forbidden - User is not authorized
-      summary: Get top custom metrics by hourly average
+      summary: Get all custom metrics by hourly average
       tags:
       - Usage Metering
       x-menu-order: 5
@@ -21794,6 +22824,8 @@ tags:
 
     - [Read more about Custom Check monitors.][4]
 
+    - [Read more about Service Check and status codes.][5]
+
 
     [1]: https://docs.datadoghq.com/monitors/monitor_types/host/?tab=checkalert
 
@@ -21801,7 +22833,9 @@ tags:
 
     [3]: https://docs.datadoghq.com/monitors/monitor_types/network/?tab=checkalert
 
-    [4]: https://docs.datadoghq.com/monitors/monitor_types/custom_check/?tab=checkalert'
+    [4]: https://docs.datadoghq.com/monitors/monitor_types/custom_check/?tab=checkalert
+
+    [5]: https://docs.datadoghq.com/developers/service_checks/'
   name: Service Checks
 - description: "SLO Status Corrections allow you to prevent specific time periods\
     \ from negatively impacting\nyour SLO\u2019s status and error budget. You can\