openapi.yaml in datadog_api_client-2.15.0

- old
+ new

@@ -4015,13 +4015,12 @@
       description: Data for the monitor.
       nullable: true
       properties:
         id:
           description: Monitor ID of the downtime.
-          example: 12345
-          format: int64
-          type: integer
+          example: '12345'
+          type: string
         type:
           $ref: '#/components/schemas/DowntimeIncludedMonitorType'
       type: object
     DowntimeResourceType:
       default: downtime
@@ -17217,10 +17216,13 @@
           authorizationUrl: /oauth2/v1/authorize
           scopes:
             apm_service_catalog_read: View service catalog and service definitions.
             apm_service_catalog_write: Add, modify, and delete service catalog definitions
               when those definitions are maintained by Datadog.
+            create_webhooks: Create webhooks integrations.
+            dashboards_public_share: Generate public and authenticated links to share
+              dashboards or embeddable graphs externally.
             dashboards_read: View dashboards.
             dashboards_write: Create and change dashboards.
             events_read: Read Events data.
             incident_notification_settings_write: Configure Incidents Notification
               settings.
@@ -17230,16 +17232,32 @@
             metrics_read: View custom metrics.
             monitors_downtime: Set downtimes to suppress alerts from any monitor in
               an organization. Mute and unmute hosts. The ability to write monitors
               is not required to set downtimes.
             monitors_read: View monitors.
+            monitors_write: Edit, mute, and delete individual monitors.
             security_monitoring_filters_read: Read Security Filters.
             security_monitoring_filters_write: Create, edit, and delete Security Filters.
             security_monitoring_findings_read: View CSPM Findings.
             security_monitoring_rules_read: Read Detection Rules.
             security_monitoring_rules_write: Create and edit Detection Rules.
             security_monitoring_signals_read: View Security Signals.
+            security_monitoring_suppressions_read: Read Rule Suppressions.
+            security_monitoring_suppressions_write: Write Rule Suppressions.
+            slos_corrections: Apply, edit, and delete SLO status corrections. A user
+              with this permission can make status corrections, even if they do not
+              have permission to edit those SLOs.
+            slos_read: View SLOs and status corrections.
+            slos_write: Create, edit, and delete SLOs.
+            synthetics_global_variable_read: View, search, and use Synthetics global
+              variables.
+            synthetics_global_variable_write: Create, edit, and delete global variables
+              for Synthetics.
+            synthetics_private_location_read: View, search, and use Synthetics private
+              locations.
+            synthetics_private_location_write: Create and delete private locations
+              in addition to having access to the associated installation guidelines.
             synthetics_read: List and view configured Synthetic tests and test results.
             synthetics_write: Create, edit, and delete Synthetic tests.
             teams_manage: Manage Teams. Create, delete, rename, and edit metadata
               of all Teams. To control Team membership across all Teams, use the User
               Access Manage permission.
@@ -18796,10 +18814,20 @@
         name: include
         required: false
         schema:
           example: created_by,monitor
           type: string
+      - $ref: '#/components/parameters/PageOffset'
+      - description: Maximum number of downtimes in the response.
+        example: 100
+        in: query
+        name: page[limit]
+        required: false
+        schema:
+          default: 30
+          format: int64
+          type: integer
       responses:
         '200':
           content:
             application/json:
               schema:
@@ -18819,13 +18847,14 @@
       - AuthZ:
         - monitors_downtime
       summary: Get all downtimes
       tags:
       - Downtimes
-      x-unstable: '**Note**: This endpoint is in private beta.
-
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+      x-pagination:
+        limitParam: page[limit]
+        pageOffsetParam: page[offset]
+        resultsPath: data
     post:
       description: Schedule a downtime.
       operationId: CreateDowntime
       requestBody:
         content:
@@ -18862,13 +18891,10 @@
         - monitors_downtime
       summary: Schedule a downtime
       tags:
       - Downtimes
       x-codegen-request-body-name: body
-      x-unstable: '**Note**: This endpoint is in private beta.
-
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/downtime/{downtime_id}:
     delete:
       description: Cancel a downtime.
       operationId: CancelDowntime
       parameters:
@@ -18902,13 +18928,10 @@
       - AuthZ:
         - monitors_downtime
       summary: Cancel a downtime
       tags:
       - Downtimes
-      x-unstable: '**Note**: This endpoint is in private beta.
-
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
     get:
       description: Get downtime detail by `downtime_id`.
       operationId: GetDowntime
       parameters:
       - description: ID of the downtime to fetch.
@@ -18961,13 +18984,10 @@
       - AuthZ:
         - monitors_read
       summary: Get a downtime
       tags:
       - Downtimes
-      x-unstable: '**Note**: This endpoint is in private beta.
-
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
     patch:
       description: Update a downtime by `downtime_id`.
       operationId: UpdateDowntime
       parameters:
       - description: ID of the downtime to update.
@@ -19018,13 +19038,10 @@
         - monitors_downtime
       summary: Update a downtime
       tags:
       - Downtimes
       x-codegen-request-body-name: body
-      x-unstable: '**Note**: This endpoint is in private beta.
-
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/events:
     get:
       description: 'List endpoint returns events that match an events search query.
 
         [Results are paginated similarly to logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination).
@@ -22585,13 +22602,10 @@
         - monitors_downtime
       summary: Get active downtimes for a monitor
       tags:
       - Downtimes
       x-codegen-request-body-name: body
-      x-unstable: '**Note**: This endpoint is in private beta.
-
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/permissions:
     get:
       description: Returns a list of all permissions, including name, description,
         and ID.
       operationId: ListPermissions
@@ -25956,10 +25970,14 @@
       - AuthZ:
         - teams_read
       summary: Get all teams
       tags:
       - Teams
+      x-pagination:
+        limitParam: page[size]
+        pageParam: page[number]
+        resultsPath: data
     post:
       description: 'Create a new team.
 
         User IDs passed through the `users` relationship field are added to the team.'
       operationId: CreateTeam
@@ -27062,12 +27080,12 @@
           `lambda_traced_invocations`, `logs`, `network_flows`, `network_hosts`, `observability_pipelines`,
 
           `online_archive`, `profiling`, `rum`, `rum_browser_sessions`, `rum_mobile_sessions`,
           `sds`, `snmp`,
 
-          `synthetics_api`, `synthetics_browser`, `synthetics_parallel_testing`, and
-          `timeseries`.
+          `synthetics_api`, `synthetics_browser`, `synthetics_mobile`, `synthetics_parallel_testing`,
+          and `timeseries`.
 
           The following product family has been **deprecated**: `audit_logs`.'
         in: query
         name: filter[product_families]
         required: true
@@ -27426,9 +27444,13 @@
         - user_access_read
       summary: List all users
       tags:
       - Users
       x-codegen-request-body-name: body
+      x-pagination:
+        limitParam: page[size]
+        pageParam: page[number]
+        resultsPath: data
     post:
       description: Create a user for your organization.
       operationId: CreateUser
       requestBody:
         content: