datadog_api_client 2.26.1 → 2.28.1

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

@@ -3314,6 +3314,12 @@ components:
             to be set to true.'
           example: true
           type: boolean
+        is_resource_change_collection_enabled:
+          default: false
+          description: When enabled, Datadog scans for all resource change data in
+            your Google Cloud environment.
+          example: true
+          type: boolean
         is_security_command_center_enabled:
           default: false
           description: 'When enabled, Datadog will attempt to collect Security Command
@@ -4182,15 +4188,14 @@ components:
       - custom_timeseries_usage
       - cws_containers_usage
       - cws_hosts_usage
+      - data_jobs_monitoring_usage
+      - data_stream_monitoring_usage
       - dbm_hosts_usage
       - dbm_queries_usage
       - error_tracking_usage
       - error_tracking_percentage
-      - estimated_indexed_logs_usage
       - estimated_indexed_spans_usage
-      - estimated_ingested_logs_usage
       - estimated_ingested_spans_usage
-      - estimated_rum_sessions_usage
       - fargate_usage
       - functions_usage
       - incident_management_monthly_active_users_usage
@@ -4255,15 +4260,14 @@ components:
       - CUSTOM_TIMESERIES_USAGE
       - CWS_CONTAINERS_USAGE
       - CWS_HOSTS_USAGE
+      - DATA_JOBS_MONITORING_USAGE
+      - DATA_STREAM_MONITORING_USAGE
       - DBM_HOSTS_USAGE
       - DBM_QUERIES_USAGE
       - ERROR_TRACKING_USAGE
       - ERROR_TRACKING_PERCENTAGE
-      - ESTIMATED_INDEXED_LOGS_USAGE
       - ESTIMATED_INDEXED_SPANS_USAGE
-      - ESTIMATED_INGESTED_LOGS_USAGE
       - ESTIMATED_INGESTED_SPANS_USAGE
-      - ESTIMATED_RUM_SESSIONS_USAGE
       - FARGATE_USAGE
       - FUNCTIONS_USAGE
       - INCIDENT_MANAGEMENT_MONTHLY_ACTIVE_USERS_USAGE
@@ -4786,6 +4790,7 @@ components:
       - logs_transaction_stream
       - event_stream
       - rum_stream
+      - llm_observability_stream
       example: apm_issue_stream
       type: string
       x-enum-varnames:
@@ -4801,6 +4806,7 @@ components:
       - LOGS_TRANSACTION_STREAM
       - EVENT_STREAM
       - RUM_STREAM
+      - LLM_OBSERVABILITY_STREAM
     ListStreamWidgetDefinition:
       description: 'The list stream visualization displays a table of recent events
         in your application that
@@ -7935,16 +7941,16 @@ components:
       - cws_containers_usage
       - cws_hosts_percentage
       - cws_hosts_usage
+      - data_jobs_monitoring_usage
+      - data_jobs_monitoring_percentage
+      - data_stream_monitoring_usage
+      - data_stream_monitoring_percentage
       - dbm_hosts_percentage
       - dbm_hosts_usage
       - dbm_queries_percentage
       - dbm_queries_usage
       - error_tracking_usage
       - error_tracking_percentage
-      - estimated_indexed_logs_usage
-      - estimated_indexed_logs_percentage
-      - estimated_ingested_logs_usage
-      - estimated_ingested_logs_percentage
       - estimated_indexed_spans_usage
       - estimated_indexed_spans_percentage
       - estimated_ingested_spans_usage
@@ -7983,8 +7989,6 @@ components:
       - serverless_apps_percentage
       - snmp_usage
       - snmp_percentage
-      - estimated_rum_sessions_usage
-      - estimated_rum_sessions_percentage
       - universal_service_monitoring_usage
       - universal_service_monitoring_percentage
       - vuln_management_hosts_usage
@@ -8076,16 +8080,16 @@ components:
       - CWS_CONTAINERS_USAGE
       - CWS_HOSTS_PERCENTAGE
       - CWS_HOSTS_USAGE
+      - DATA_JOBS_MONITORING_USAGE
+      - DATA_JOBS_MONITORING_PERCENTAGE
+      - DATA_STREAM_MONITORING_USAGE
+      - DATA_STREAM_MONITORING_PERCENTAGE
       - DBM_HOSTS_PERCENTAGE
       - DBM_HOSTS_USAGE
       - DBM_QUERIES_PERCENTAGE
       - DBM_QUERIES_USAGE
       - ERROR_TRACKING_USAGE
       - ERROR_TRACKING_PERCENTAGE
-      - ESTIMATED_INDEXED_LOGS_USAGE
-      - ESTIMATED_INDEXED_LOGS_PERCENTAGE
-      - ESTIMATED_INGESTED_LOGS_USAGE
-      - ESTIMATED_INGESTED_LOGS_PERCENTAGE
       - ESTIMATED_INDEXED_SPANS_USAGE
       - ESTIMATED_INDEXED_SPANS_PERCENTAGE
       - ESTIMATED_INGESTED_SPANS_USAGE
@@ -8124,8 +8128,6 @@ components:
       - SERVERLESS_APPS_PERCENTAGE
       - SNMP_USAGE
       - SNMP_PERCENTAGE
-      - ESTIMATED_RUM_SESSIONS_USAGE
-      - ESTIMATED_RUM_SESSIONS_PERCENTAGE
       - UNIVERSAL_SERVICE_MONITORING_USAGE
       - UNIVERSAL_SERVICE_MONITORING_PERCENTAGE
       - VULN_MANAGEMENT_HOSTS_USAGE
@@ -8363,6 +8365,14 @@ components:
           description: The Cloud Workload Security host usage by tag(s).
           format: double
           type: number
+        data_jobs_monitoring_usage:
+          description: The Data Jobs Monitoring usage by tag(s).
+          format: double
+          type: number
+        data_stream_monitoring_usage:
+          description: The Data Stream Monitoring usage by tag(s).
+          format: double
+          type: number
         dbm_hosts_percentage:
           description: The percentage of Database Monitoring host usage by tag(s).
           format: double
@@ -8387,14 +8397,6 @@ components:
           description: The error tracking events usage by tag(s).
           format: double
           type: number
-        estimated_indexed_logs_percentage:
-          description: The percentage of estimated live indexed logs usage by tag(s).
-          format: double
-          type: number
-        estimated_indexed_logs_usage:
-          description: The estimated live indexed logs usage by tag(s).
-          format: double
-          type: number
         estimated_indexed_spans_percentage:
           description: The percentage of estimated indexed spans usage by tag(s).
           format: double
@@ -8403,14 +8405,6 @@ components:
           description: The estimated indexed spans usage by tag(s).
           format: double
           type: number
-        estimated_ingested_logs_percentage:
-          description: The percentage of estimated live ingested logs usage by tag(s).
-          format: double
-          type: number
-        estimated_ingested_logs_usage:
-          description: The estimated live ingested logs usage by tag(s).
-          format: double
-          type: number
         estimated_ingested_spans_percentage:
           description: The percentage of estimated ingested spans usage by tag(s).
           format: double
@@ -8419,14 +8413,6 @@ components:
           description: The estimated ingested spans usage by tag(s).
           format: double
           type: number
-        estimated_rum_sessions_percentage:
-          description: The percentage of estimated rum sessions usage by tag(s).
-          format: double
-          type: number
-        estimated_rum_sessions_usage:
-          description: The estimated rum sessions usage by tag(s).
-          format: double
-          type: number
         fargate_percentage:
           description: The percentage of Fargate usage by tags.
           format: double
@@ -10827,7 +10813,7 @@ components:
             Periods of no data are counted either as uptime or downtime depending
             on monitor settings.
 
-            See [SLO documentatio](https://docs.datadoghq.com/service_management/service_level_objectives/monitor/#missing-data)
+            See [SLO documentation](https://docs.datadoghq.com/service_management/service_level_objectives/monitor/#missing-data)
 
             for detailed information.'
           example:
@@ -14432,7 +14418,7 @@ components:
             $ref: '#/components/schemas/SyntheticsBatchResult'
           type: array
         status:
-          $ref: '#/components/schemas/SyntheticsStatus'
+          $ref: '#/components/schemas/SyntheticsBatchStatus'
       type: object
     SyntheticsBatchResult:
       description: Object with the results of a Synthetic batch.
@@ -14456,7 +14442,7 @@ components:
           format: double
           type: number
         status:
-          $ref: '#/components/schemas/SyntheticsStatus'
+          $ref: '#/components/schemas/SyntheticsBatchStatus'
         test_name:
           description: Name of the test.
           type: string
@@ -14466,6 +14452,17 @@ components:
         test_type:
           $ref: '#/components/schemas/SyntheticsTestDetailsType'
       type: object
+    SyntheticsBatchStatus:
+      description: Determines whether the batch has passed, failed, or is in progress.
+      enum:
+      - passed
+      - skipped
+      - failed
+      type: string
+      x-enum-varnames:
+      - PASSED
+      - SKIPPED
+      - FAILED
     SyntheticsBrowserError:
       description: Error response object for a browser test.
       properties:
@@ -15051,11 +15048,13 @@ components:
       enum:
       - global
       - text
+      - email
       example: text
       type: string
       x-enum-varnames:
       - GLOBAL
       - TEXT
+      - EMAIL
     SyntheticsCoreWebVitals:
       description: Core Web Vitals attached to a browser test step.
       properties:
@@ -15182,6 +15181,32 @@ components:
       - EDGE_LAPTOP_LARGE
       - EDGE_TABLET
       - EDGE_MOBILE_SMALL
+    SyntheticsFetchUptimesPayload:
+      description: Object containing IDs of Synthetic tests and a timeframe.
+      properties:
+        from_ts:
+          description: Timestamp in seconds (Unix epoch) for the start of uptime.
+          example: 0
+          format: int64
+          type: integer
+        public_ids:
+          description: An array of Synthetic test IDs you want to delete.
+          example: []
+          items:
+            description: A Synthetic test ID.
+            example: abc-def-123
+            type: string
+          type: array
+        to_ts:
+          description: Timestamp in seconds (Unix epoch) for the end of uptime.
+          example: 0
+          format: int64
+          type: integer
+      required:
+      - from_ts
+      - to_ts
+      - public_ids
+      type: object
     SyntheticsGetAPITestLatestResultsResponse:
       description: Object with the latest Synthetic API test run.
       properties:
@@ -15458,179 +15483,639 @@ components:
             $ref: '#/components/schemas/SyntheticsLocation'
           type: array
       type: object
-    SyntheticsParsingOptions:
-      description: Parsing options for variables to extract.
-      example: {}
+    SyntheticsMobileDeviceID:
+      description: The device ID.
+      example: synthetics:mobile:device:apple_ipad_10th_gen_2022_ios_16
+      type: string
+    SyntheticsMobileStep:
+      description: The steps used in a Synthetic mobile test.
       properties:
-        field:
-          description: When type is `http_header` or `grpc_metadata`, name of the
-            header or metadatum to extract.
-          example: content-type
-          type: string
+        allowFailure:
+          description: A boolean set to allow this step to fail.
+          type: boolean
+        hasNewStepElement:
+          description: A boolean set to determine if the step has a new step element.
+          type: boolean
+        isCritical:
+          description: A boolean to use in addition to `allowFailure` to determine
+            if the test should be marked as failed when the step fails.
+          type: boolean
         name:
-          description: Name of the variable to extract.
+          description: The name of the step.
+          example: ''
+          maxLength: 1500
           type: string
-        parser:
-          $ref: '#/components/schemas/SyntheticsVariableParser'
-        secure:
-          description: Determines whether or not the extracted value will be obfuscated.
+        noScreenshot:
+          description: A boolean set to not take a screenshot for the step.
           type: boolean
+        params:
+          $ref: '#/components/schemas/SyntheticsMobileStepParams'
+        publicId:
+          description: The public ID of the step.
+          example: pub-lic-id0
+          type: string
+        timeout:
+          description: The time before declaring a step failed.
+          format: int64
+          type: integer
         type:
-          $ref: '#/components/schemas/SyntheticsLocalVariableParsingOptionsType'
-      type: object
-    SyntheticsPatchTestBody:
-      description: Wrapper around an array of [JSON Patch](https://jsonpatch.com)
-        operations to perform on the test
-      properties:
-        data:
-          description: Array of [JSON Patch](https://jsonpatch.com) operations to
-            perform on the test
-          example:
-          - op: replace
-            path: /name
-            value: New test name
-          - op: remove
-            path: /config/assertions/0
-          items:
-            $ref: '#/components/schemas/SyntheticsPatchTestOperation'
-          type: array
+          $ref: '#/components/schemas/SyntheticsMobileStepType'
+      required:
+      - name
+      - params
+      - type
       type: object
-    SyntheticsPatchTestOperation:
-      description: A single [JSON Patch](https://jsonpatch.com) operation to perform
-        on the test
+    SyntheticsMobileStepParams:
+      description: The parameters of a mobile step.
       properties:
-        op:
-          $ref: '#/components/schemas/SyntheticsPatchTestOperationName'
-        path:
-          description: The path to the value to modify
-          example: /name
+        check:
+          $ref: '#/components/schemas/SyntheticsCheckType'
+        delay:
+          description: Number of milliseconds to wait between inputs in a `typeText`
+            step type.
+          format: int64
+          maximum: 5000
+          minimum: 0
+          type: integer
+        direction:
+          $ref: '#/components/schemas/SyntheticsMobileStepParamsDirection'
+        element:
+          $ref: '#/components/schemas/SyntheticsMobileStepParamsElement'
+        enabled:
+          description: Boolean to change the state of the wifi for a `toggleWiFi`
+            step type.
+          type: boolean
+        maxScrolls:
+          description: Maximum number of scrolls to do for a `scrollToElement` step
+            type.
+          format: int64
+          type: integer
+        positions:
+          $ref: '#/components/schemas/SyntheticsMobileStepParamsPositions'
+        subtestPublicId:
+          description: Public ID of the test to be played as part of a `playSubTest`
+            step type.
           type: string
         value:
-          description: A value to use in a [JSON Patch](https://jsonpatch.com) operation
-          example: New Test Name
+          $ref: '#/components/schemas/SyntheticsMobileStepParamsValue'
+        variable:
+          $ref: '#/components/schemas/SyntheticsMobileStepParamsVariable'
+        withEnter:
+          description: Boolean to indicate if `Enter` should be pressed at the end
+            of the `typeText` step type.
+          type: boolean
+        x:
+          description: Amount to scroll by on the `x` axis for a `scroll` step type.
+          format: double
+          type: number
+        y:
+          description: Amount to scroll by on the `y` axis for a `scroll` step type.
+          format: double
+          type: number
       type: object
-    SyntheticsPatchTestOperationName:
-      description: The operation to perform
+    SyntheticsMobileStepParamsDirection:
+      description: The direction of the scroll for a `scrollToElement` step type.
       enum:
-      - add
-      - remove
-      - replace
-      - move
-      - copy
-      - test
-      example: replace
+      - up
+      - down
+      - left
+      - right
       type: string
       x-enum-varnames:
-      - ADD
-      - REMOVE
-      - REPLACE
-      - MOVE
-      - COPY
-      - TEST
-    SyntheticsPlayingTab:
-      description: Navigate between different tabs for your browser test.
-      enum:
-      - -1
-      - 0
-      - 1
-      - 2
-      - 3
-      format: int64
-      type: integer
-      x-enum-varnames:
-      - MAIN_TAB
-      - NEW_TAB
-      - TAB_1
-      - TAB_2
-      - TAB_3
-    SyntheticsPrivateLocation:
-      description: Object containing information about the private location to create.
+      - UP
+      - DOWN
+      - LEFT
+      - RIGHT
+    SyntheticsMobileStepParamsElement:
+      description: Information about the element used for a step.
       properties:
-        description:
-          description: Description of the private location.
-          example: Description of private location
-          type: string
-        id:
-          description: Unique identifier of the private location.
-          readOnly: true
+        context:
+          description: Context of the element.
           type: string
-        metadata:
-          $ref: '#/components/schemas/SyntheticsPrivateLocationMetadata'
-        name:
-          description: Name of the private location.
-          example: New private location
+        contextType:
+          $ref: '#/components/schemas/SyntheticsMobileStepParamsElementContextType'
+        elementDescription:
+          description: Description of the element.
           type: string
-        secrets:
-          $ref: '#/components/schemas/SyntheticsPrivateLocationSecrets'
-        tags:
-          description: Array of tags attached to the private location.
-          example:
-          - team:front
-          items:
-            description: A tag attached to the private location.
-            example: team:front
-            type: string
-          type: array
-      required:
-      - name
-      - description
-      - tags
-      type: object
-    SyntheticsPrivateLocationCreationResponse:
-      description: Object that contains the new private location, the public key for
-        result encryption, and the configuration skeleton.
-      properties:
-        config:
-          description: Configuration skeleton for the private location. See installation
-            instructions of the private location on how to use this configuration.
+        multiLocator:
+          description: Multi-locator to find the element.
           type: object
-        private_location:
-          $ref: '#/components/schemas/SyntheticsPrivateLocation'
-        result_encryption:
-          $ref: '#/components/schemas/SyntheticsPrivateLocationCreationResponseResultEncryption'
-      type: object
-    SyntheticsPrivateLocationCreationResponseResultEncryption:
-      description: Public key for the result encryption.
-      properties:
-        id:
-          description: Fingerprint for the encryption key.
+        relativePosition:
+          $ref: '#/components/schemas/SyntheticsMobileStepParamsElementRelativePosition'
+        textContent:
+          description: Text content of the element.
           type: string
-        key:
-          description: Public key for result encryption.
+        userLocator:
+          $ref: '#/components/schemas/SyntheticsMobileStepParamsElementUserLocator'
+        viewName:
+          description: Name of the view of the element.
           type: string
       type: object
-    SyntheticsPrivateLocationMetadata:
-      description: Object containing metadata about the private location.
+    SyntheticsMobileStepParamsElementContextType:
+      description: Type of the context that the element is in.
+      enum:
+      - native
+      - web
+      type: string
+      x-enum-varnames:
+      - NATIVE
+      - WEB
+    SyntheticsMobileStepParamsElementRelativePosition:
+      description: Position of the action relative to the element.
       properties:
-        restricted_roles:
-          $ref: '#/components/schemas/SyntheticsRestrictedRoles'
+        x:
+          description: The `relativePosition` on the `x` axis for the element.
+          format: double
+          type: number
+        y:
+          description: The `relativePosition` on the `y` axis for the element.
+          format: double
+          type: number
       type: object
-    SyntheticsPrivateLocationSecrets:
-      description: Secrets for the private location. Only present in the response
-        when creating the private location.
+    SyntheticsMobileStepParamsElementUserLocator:
+      description: User locator to find the element.
       properties:
-        authentication:
-          $ref: '#/components/schemas/SyntheticsPrivateLocationSecretsAuthentication'
-        config_decryption:
-          $ref: '#/components/schemas/SyntheticsPrivateLocationSecretsConfigDecryption'
-      readOnly: true
+        failTestOnCannotLocate:
+          description: Whether if the the test should fail if the element cannot be
+            found.
+          type: boolean
+        values:
+          description: Values of the user locator.
+          items:
+            $ref: '#/components/schemas/SyntheticsMobileStepParamsElementUserLocatorValuesItems'
+          type: array
       type: object
-    SyntheticsPrivateLocationSecretsAuthentication:
-      description: Authentication part of the secrets.
+    SyntheticsMobileStepParamsElementUserLocatorValuesItems:
+      description: A single user locator object.
       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:
+          $ref: '#/components/schemas/SyntheticsMobileStepParamsElementUserLocatorValuesItemsType'
+        value:
+          description: Value of a user locator.
           type: string
       type: object
-    SyntheticsPrivateLocationSecretsConfigDecryption:
-      description: Private key for the private location.
-      properties:
-        key:
+    SyntheticsMobileStepParamsElementUserLocatorValuesItemsType:
+      description: Type of a user locator.
+      enum:
+      - accessibility-id
+      - id
+      - ios-predicate-string
+      - ios-class-chain
+      - xpath
+      type: string
+      x-enum-varnames:
+      - ACCESSIBILITY_ID
+      - ID
+      - IOS_PREDICATE_STRING
+      - IOS_CLASS_CHAIN
+      - XPATH
+    SyntheticsMobileStepParamsPositions:
+      description: List of positions for the `flick` step type. The maximum is 10
+        flicks per step
+      items:
+        $ref: '#/components/schemas/SyntheticsMobileStepParamsPositionsItems'
+      type: array
+    SyntheticsMobileStepParamsPositionsItems:
+      description: A description of a single position for a `flick` step type.
+      properties:
+        x:
+          description: The `x` position for the flick.
+          format: double
+          type: number
+        y:
+          description: The `y` position for the flick.
+          format: double
+          type: number
+      type: object
+    SyntheticsMobileStepParamsValue:
+      description: Values used in the step for in multiple step types.
+      oneOf:
+      - $ref: '#/components/schemas/SyntheticsMobileStepParamsValueString'
+      - $ref: '#/components/schemas/SyntheticsMobileStepParamsValueNumber'
+    SyntheticsMobileStepParamsValueNumber:
+      description: Value used in the step for in multiple step types.
+      format: int64
+      type: integer
+    SyntheticsMobileStepParamsValueString:
+      description: Value used in the step for in multiple step types.
+      type: string
+    SyntheticsMobileStepParamsVariable:
+      description: Variable object for `extractVariable` step type.
+      properties:
+        example:
+          description: An example for the variable.
+          example: ''
+          type: string
+        name:
+          description: The variable name.
+          example: VAR_NAME
+          type: string
+      required:
+      - name
+      - example
+      type: object
+    SyntheticsMobileStepType:
+      description: Step type used in your mobile Synthetic test.
+      enum:
+      - assertElementContent
+      - assertScreenContains
+      - assertScreenLacks
+      - doubleTap
+      - extractVariable
+      - flick
+      - openDeeplink
+      - playSubTest
+      - pressBack
+      - restartApplication
+      - rotate
+      - scroll
+      - scrollToElement
+      - tap
+      - toggleWiFi
+      - typeText
+      - wait
+      example: assertElementContent
+      type: string
+      x-enum-varnames:
+      - ASSERTELEMENTCONTENT
+      - ASSERTSCREENCONTAINS
+      - ASSERTSCREENLACKS
+      - DOUBLETAP
+      - EXTRACTVARIABLE
+      - FLICK
+      - OPENDEEPLINK
+      - PLAYSUBTEST
+      - PRESSBACK
+      - RESTARTAPPLICATION
+      - ROTATE
+      - SCROLL
+      - SCROLLTOELEMENT
+      - TAP
+      - TOGGLEWIFI
+      - TYPETEXT
+      - WAIT
+    SyntheticsMobileTest:
+      description: Object containing details about a Synthetic mobile test.
+      properties:
+        config:
+          $ref: '#/components/schemas/SyntheticsMobileTestConfig'
+        device_ids:
+          description: Array with the different device IDs used to run the test.
+          items:
+            $ref: '#/components/schemas/SyntheticsMobileDeviceID'
+          type: array
+        message:
+          description: Notification message associated with the test.
+          example: Notification message
+          type: string
+        monitor_id:
+          description: The associated monitor ID.
+          example: 12345678
+          format: int64
+          readOnly: true
+          type: integer
+        name:
+          description: Name of the test.
+          example: Example test name
+          type: string
+        options:
+          $ref: '#/components/schemas/SyntheticsMobileTestOptions'
+        public_id:
+          description: The public ID of the test.
+          example: 123-abc-456
+          readOnly: true
+          type: string
+        status:
+          $ref: '#/components/schemas/SyntheticsTestPauseStatus'
+        steps:
+          description: Array of steps for the test.
+          items:
+            $ref: '#/components/schemas/SyntheticsMobileStep'
+          type: array
+        tags:
+          description: Array of tags attached to the test.
+          example:
+          - env:production
+          items:
+            description: A tag attached to the test.
+            type: string
+          type: array
+        type:
+          $ref: '#/components/schemas/SyntheticsMobileTestType'
+      required:
+      - config
+      - name
+      - options
+      - type
+      type: object
+    SyntheticsMobileTestConfig:
+      description: Configuration object for a Synthetic mobile test.
+      properties:
+        initialApplicationArguments:
+          $ref: '#/components/schemas/SyntheticsMobileTestInitialApplicationArguments'
+        variables:
+          description: Array of variables used for the test steps.
+          items:
+            $ref: '#/components/schemas/SyntheticsConfigVariable'
+          type: array
+      type: object
+    SyntheticsMobileTestInitialApplicationArguments:
+      additionalProperties:
+        description: A single application argument.
+        type: string
+      description: Initial application arguments for a mobile test.
+      type: object
+    SyntheticsMobileTestOptions:
+      description: Object describing the extra options for a Synthetic test.
+      properties:
+        allowApplicationCrash:
+          description: A boolean to set if an application crash would mark the test
+            as failed.
+          type: boolean
+        bindings:
+          description: Array of bindings used for the mobile test.
+          items:
+            $ref: '#/components/schemas/SyntheticsTestRestrictionPolicyBinding'
+          type: array
+        ci:
+          $ref: '#/components/schemas/SyntheticsTestCiOptions'
+        defaultStepTimeout:
+          description: The default timeout for steps in the test (in seconds).
+          format: int32
+          maximum: 300
+          minimum: 1
+          type: integer
+        device_ids:
+          description: For mobile test, array with the different device IDs used to
+            run the test.
+          example:
+          - synthetics:mobile:device:apple_ipad_10th_gen_2022_ios_16
+          items:
+            $ref: '#/components/schemas/SyntheticsMobileDeviceID'
+          type: array
+        disableAutoAcceptAlert:
+          description: A boolean to disable auto accepting alerts.
+          type: boolean
+        min_failure_duration:
+          description: Minimum amount of time in failure required to trigger an alert.
+          format: int64
+          maximum: 7200
+          minimum: 0
+          type: integer
+        mobileApplication:
+          $ref: '#/components/schemas/SyntheticsMobileTestsMobileApplication'
+        monitor_name:
+          description: The monitor name is used for the alert title as well as for
+            all monitor dashboard widgets and SLOs.
+          type: string
+        monitor_options:
+          $ref: '#/components/schemas/SyntheticsTestOptionsMonitorOptions'
+        monitor_priority:
+          description: Integer from 1 (high) to 5 (low) indicating alert severity.
+          format: int32
+          maximum: 5
+          minimum: 1
+          type: integer
+        noScreenshot:
+          description: A boolean set to not take a screenshot for the step.
+          type: boolean
+        restricted_roles:
+          $ref: '#/components/schemas/SyntheticsRestrictedRoles'
+        retry:
+          $ref: '#/components/schemas/SyntheticsTestOptionsRetry'
+        scheduling:
+          $ref: '#/components/schemas/SyntheticsTestOptionsScheduling'
+        tick_every:
+          description: The frequency at which to run the Synthetic test (in seconds).
+          example: 300
+          format: int64
+          maximum: 604800
+          minimum: 300
+          type: integer
+        verbosity:
+          description: The level of verbosity for the mobile test.
+          format: int32
+          maximum: 5
+          minimum: 0
+          type: integer
+      required:
+      - device_ids
+      - tick_every
+      - mobileApplication
+      type: object
+    SyntheticsMobileTestType:
+      default: mobile
+      description: Type of the Synthetic test, `mobile`.
+      enum:
+      - mobile
+      example: mobile
+      type: string
+      x-enum-varnames:
+      - MOBILE
+    SyntheticsMobileTestsMobileApplication:
+      description: Mobile application for mobile synthetics test.
+      properties:
+        applicationId:
+          description: Application ID of the mobile application.
+          example: 00000000-0000-0000-0000-aaaaaaaaaaaa
+          maxLength: 1500
+          type: string
+        referenceId:
+          description: Reference ID of the mobile application.
+          example: 00000000-0000-0000-0000-aaaaaaaaaaab
+          maxLength: 1500
+          type: string
+        referenceType:
+          $ref: '#/components/schemas/SyntheticsMobileTestsMobileApplicationReferenceType'
+      required:
+      - applicationId
+      - referenceId
+      - referenceType
+      type: object
+    SyntheticsMobileTestsMobileApplicationReferenceType:
+      description: Reference type for the mobile application for a mobile synthetics
+        test.
+      enum:
+      - latest
+      - version
+      example: latest
+      type: string
+      x-enum-varnames:
+      - LATEST
+      - VERSION
+    SyntheticsParsingOptions:
+      description: Parsing options for variables to extract.
+      example: {}
+      properties:
+        field:
+          description: When type is `http_header` or `grpc_metadata`, name of the
+            header or metadatum to extract.
+          example: content-type
+          type: string
+        name:
+          description: Name of the variable to extract.
+          type: string
+        parser:
+          $ref: '#/components/schemas/SyntheticsVariableParser'
+        secure:
+          description: Determines whether or not the extracted value will be obfuscated.
+          type: boolean
+        type:
+          $ref: '#/components/schemas/SyntheticsLocalVariableParsingOptionsType'
+      type: object
+    SyntheticsPatchTestBody:
+      description: Wrapper around an array of [JSON Patch](https://jsonpatch.com)
+        operations to perform on the test
+      properties:
+        data:
+          description: Array of [JSON Patch](https://jsonpatch.com) operations to
+            perform on the test
+          example:
+          - op: replace
+            path: /name
+            value: New test name
+          - op: remove
+            path: /config/assertions/0
+          items:
+            $ref: '#/components/schemas/SyntheticsPatchTestOperation'
+          type: array
+      type: object
+    SyntheticsPatchTestOperation:
+      description: A single [JSON Patch](https://jsonpatch.com) operation to perform
+        on the test
+      properties:
+        op:
+          $ref: '#/components/schemas/SyntheticsPatchTestOperationName'
+        path:
+          description: The path to the value to modify
+          example: /name
+          type: string
+        value:
+          description: A value to use in a [JSON Patch](https://jsonpatch.com) operation
+          example: New Test Name
+      type: object
+    SyntheticsPatchTestOperationName:
+      description: The operation to perform
+      enum:
+      - add
+      - remove
+      - replace
+      - move
+      - copy
+      - test
+      example: replace
+      type: string
+      x-enum-varnames:
+      - ADD
+      - REMOVE
+      - REPLACE
+      - MOVE
+      - COPY
+      - TEST
+    SyntheticsPlayingTab:
+      description: Navigate between different tabs for your browser test.
+      enum:
+      - -1
+      - 0
+      - 1
+      - 2
+      - 3
+      format: int64
+      type: integer
+      x-enum-varnames:
+      - MAIN_TAB
+      - NEW_TAB
+      - TAB_1
+      - TAB_2
+      - TAB_3
+    SyntheticsPrivateLocation:
+      description: Object containing information about the private location to create.
+      properties:
+        description:
+          description: Description of the private location.
+          example: Description of private location
+          type: string
+        id:
+          description: Unique identifier of the private location.
+          readOnly: true
+          type: string
+        metadata:
+          $ref: '#/components/schemas/SyntheticsPrivateLocationMetadata'
+        name:
+          description: Name of the private location.
+          example: New private location
+          type: string
+        secrets:
+          $ref: '#/components/schemas/SyntheticsPrivateLocationSecrets'
+        tags:
+          description: Array of tags attached to the private location.
+          example:
+          - team:front
+          items:
+            description: A tag attached to the private location.
+            example: team:front
+            type: string
+          type: array
+      required:
+      - name
+      - description
+      - tags
+      type: object
+    SyntheticsPrivateLocationCreationResponse:
+      description: Object that contains the new private location, the public key for
+        result encryption, and the configuration skeleton.
+      properties:
+        config:
+          description: Configuration skeleton for the private location. See installation
+            instructions of the private location on how to use this configuration.
+          type: object
+        private_location:
+          $ref: '#/components/schemas/SyntheticsPrivateLocation'
+        result_encryption:
+          $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
+    SyntheticsPrivateLocationMetadata:
+      description: Object containing metadata about the private location.
+      properties:
+        restricted_roles:
+          $ref: '#/components/schemas/SyntheticsRestrictedRoles'
+      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
@@ -15736,24 +16221,19 @@ components:
           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.
-      enum:
-      - passed
-      - skipped
-      - failed
-      type: string
-      x-enum-varnames:
-      - PASSED
-      - skipped
-      - failed
     SyntheticsStep:
       description: The steps used in a Synthetic browser test.
       properties:
         allowFailure:
           description: A boolean set to allow this step to fail.
           type: boolean
+        alwaysExecute:
+          description: A boolean set to always execute this step even if the previous
+            step failed or was skipped.
+          type: boolean
+        exitIfSucceed:
+          description: A boolean set to exit the test if the step succeeds.
+          type: boolean
         isCritical:
           description: A boolean to use in addition to `allowFailure` to determine
             if the test should be marked as failed when the step fails.
@@ -15762,7 +16242,7 @@ components:
           description: The name of the step.
           type: string
         noScreenshot:
-          description: A boolean set to not take a screenshot for the step.
+          description: A boolean set to skip taking a screenshot for the step.
           type: boolean
         params:
           description: The parameters of the step.
@@ -15777,6 +16257,9 @@ components:
     SyntheticsStepDetail:
       description: Object describing a step for a Synthetic test.
       properties:
+        allowFailure:
+          description: Whether or not the step was allowed to fail.
+          type: boolean
         browserErrors:
           description: Array of errors collected for a browser test.
           items:
@@ -15794,6 +16277,8 @@ components:
         error:
           description: Error returned by the test.
           type: string
+        failure:
+          $ref: '#/components/schemas/SyntheticsBrowserTestResultFailure'
         playingTab:
           $ref: '#/components/schemas/SyntheticsPlayingTab'
         screenshotBucketKey:
@@ -15922,6 +16407,8 @@ components:
       properties:
         executionRule:
           $ref: '#/components/schemas/SyntheticsTestExecutionRule'
+      required:
+      - executionRule
       type: object
     SyntheticsTestConfig:
       description: Configuration object for a Synthetic test.
@@ -16028,16 +16515,19 @@ components:
       enum:
       - api
       - browser
+      - mobile
       type: string
       x-enum-varnames:
       - API
       - BROWSER
+      - MOBILE
     SyntheticsTestExecutionRule:
       description: Execution rule for a Synthetic test.
       enum:
       - blocking
       - non_blocking
       - skipped
+      example: blocking
       type: string
       x-enum-varnames:
       - BLOCKING
@@ -16180,6 +16670,11 @@ components:
 
         (for example, renotification).'
       properties:
+        escalation_message:
+          description: Message to include in the escalation notification.
+          type: string
+        notification_preset_name:
+          $ref: '#/components/schemas/SyntheticsTestOptionsMonitorOptionsNotificationPresetName'
         renotify_interval:
           description: 'Time interval before renotifying if the test is still failing
 
@@ -16187,7 +16682,24 @@ components:
           format: int64
           minimum: 0
           type: integer
+        renotify_occurrences:
+          description: The number of times to renotify if the test is still failing.
+          format: int64
+          type: integer
       type: object
+    SyntheticsTestOptionsMonitorOptionsNotificationPresetName:
+      description: The name of the preset for the notification for the monitor.
+      enum:
+      - show_all
+      - hide_all
+      - hide_query
+      - hide_handles
+      type: string
+      x-enum-varnames:
+      - SHOW_ALL
+      - HIDE_ALL
+      - HIDE_QUERY
+      - HIDE_HANDLES
     SyntheticsTestOptionsRetry:
       description: Object describing the retry strategy to apply to a Synthetic test.
       properties:
@@ -16226,6 +16738,9 @@ components:
           description: Timezone in which the timeframe is based.
           example: America/New_York
           type: string
+      required:
+      - timeframes
+      - timezone
       type: object
     SyntheticsTestOptionsSchedulingTimeframe:
       description: Object describing a timeframe.
@@ -16245,6 +16760,10 @@ components:
           description: The hour of the day on which scheduling ends.
           example: '16:00'
           type: string
+      required:
+      - day
+      - from
+      - to
       type: object
     SyntheticsTestPauseStatus:
       description: 'Define whether you want to start (`live`) or pause (`paused`)
@@ -16352,8 +16871,7 @@ components:
           description: Persist cookies across redirects.
           type: boolean
         port:
-          description: Port to use when performing the test.
-          type: string
+          $ref: '#/components/schemas/SyntheticsTestRequestPort'
         proxy:
           $ref: '#/components/schemas/SyntheticsTestRequestProxy'
         query:
@@ -16457,6 +16975,15 @@ components:
           description: Date of update of the certificate or key, ISO format.
           type: string
       type: object
+    SyntheticsTestRequestNumericalPort:
+      description: Integer Port number to use when performing the test.
+      format: int64
+      type: integer
+    SyntheticsTestRequestPort:
+      description: Port to use when performing the test.
+      oneOf:
+      - $ref: '#/components/schemas/SyntheticsTestRequestNumericalPort'
+      - $ref: '#/components/schemas/SyntheticsTestRequestVariablePort'
     SyntheticsTestRequestProxy:
       description: The proxy to perform the test.
       properties:
@@ -16469,6 +16996,52 @@ components:
       required:
       - url
       type: object
+    SyntheticsTestRequestVariablePort:
+      description: String Port number to use when performing the test. Supports templated
+        variables.
+      type: string
+    SyntheticsTestRestrictionPolicyBinding:
+      description: Objects describing the binding used for a mobile test.
+      properties:
+        principals:
+          $ref: '#/components/schemas/SyntheticsTestRestrictionPolicyBindingPrincipals'
+        relation:
+          $ref: '#/components/schemas/SyntheticsTestRestrictionPolicyBindingRelation'
+      type: object
+    SyntheticsTestRestrictionPolicyBindingPrincipals:
+      description: List of principals for a mobile test binding.
+      items:
+        description: A principal for a mobile test binding.
+        maxLength: 1500
+        type: string
+      type: array
+    SyntheticsTestRestrictionPolicyBindingRelation:
+      description: The type of relation for the binding.
+      enum:
+      - editor
+      - viewer
+      type: string
+      x-enum-varnames:
+      - EDITOR
+      - VIEWER
+    SyntheticsTestUptime:
+      description: Object containing the uptime for a Synthetic test ID.
+      properties:
+        from_ts:
+          description: Timestamp in seconds for the start of uptime.
+          format: int64
+          type: integer
+        overall:
+          $ref: '#/components/schemas/SyntheticsUptime'
+        public_id:
+          description: A Synthetic test ID.
+          example: abc-def-123
+          type: string
+        to_ts:
+          description: Timestamp in seconds for the end of uptime.
+          format: int64
+          type: integer
+      type: object
     SyntheticsTiming:
       description: 'Object containing all metrics and their values collected for a
         Synthetic API test.
@@ -16592,6 +17165,62 @@ components:
         new_status:
           $ref: '#/components/schemas/SyntheticsTestPauseStatus'
       type: object
+    SyntheticsUptime:
+      description: Object containing the uptime information.
+      properties:
+        errors:
+          description: An array of error objects returned while querying the history
+            data for the service level objective.
+          items:
+            $ref: '#/components/schemas/SLOHistoryResponseErrorWithType'
+          nullable: true
+          type: array
+        group:
+          description: The location name
+          example: name
+          type: string
+        history:
+          description: 'The state transition history for the monitor, represented
+            as an array of
+
+            pairs. Each pair is an array where the first element is the transition
+            timestamp
+
+            in Unix epoch format (integer) and the second element is the state (integer).
+
+            For the state, an integer value of `0` indicates uptime, `1` indicates
+            downtime,
+
+            and `2` indicates no data.'
+          example:
+          - - 1579212382
+            - 0
+          items:
+            description: An array of transitions
+            example:
+            - 1579212382
+            - 0
+            items:
+              description: A timeseries data point which is a tuple of (timestamp,
+                value).
+              format: double
+              type: number
+            maxItems: 2
+            minItems: 2
+            type: array
+          type: array
+        span_precision:
+          description: The number of decimal places to which the SLI value is accurate
+            for the given from-to timestamps.
+          example: 2.0
+          format: double
+          type: number
+        uptime:
+          description: The overall uptime.
+          example: 99.99
+          format: double
+          type: number
+      type: object
     SyntheticsVariableParser:
       description: Details of the parser to use for the global variable.
       example:
@@ -16740,6 +17369,181 @@ components:
           $ref: '#/components/schemas/LogQueryDefinition'
         sort:
           $ref: '#/components/schemas/WidgetSortBy'
+        text_formats:
+          description: List of text formats for columns produced by tags.
+          items:
+            $ref: '#/components/schemas/TableWidgetTextFormat'
+          type: array
+      type: object
+    TableWidgetTextFormat:
+      description: Text format rules for a tag-based column within a table widget.
+      example:
+      - match:
+          type: is
+          value: fruit
+        replace:
+          type: all
+          with: vegetable
+      - match:
+          type: is
+          value: cake
+        palette: white_on_green
+      items:
+        $ref: '#/components/schemas/TableWidgetTextFormatRule'
+      minItems: 1
+      type: array
+    TableWidgetTextFormatMatch:
+      description: Match rule for the table widget text format.
+      example:
+        type: is
+        value: fruit
+      properties:
+        type:
+          $ref: '#/components/schemas/TableWidgetTextFormatMatchType'
+        value:
+          description: Table Widget Match String.
+          example: Match Value
+          type: string
+      required:
+      - type
+      - value
+      type: object
+    TableWidgetTextFormatMatchType:
+      description: Match or compare option.
+      enum:
+      - is
+      - is_not
+      - contains
+      - does_not_contain
+      - starts_with
+      - ends_with
+      example: is
+      type: string
+      x-enum-varnames:
+      - IS
+      - IS_NOT
+      - CONTAINS
+      - DOES_NOT_CONTAIN
+      - STARTS_WITH
+      - ENDS_WITH
+    TableWidgetTextFormatPalette:
+      default: white_on_green
+      description: Color-on-color palette to highlight replaced text.
+      enum:
+      - white_on_red
+      - white_on_yellow
+      - white_on_green
+      - black_on_light_red
+      - black_on_light_yellow
+      - black_on_light_green
+      - red_on_white
+      - yellow_on_white
+      - green_on_white
+      - custom_bg
+      - custom_text
+      type: string
+      x-enum-varnames:
+      - WHITE_ON_RED
+      - WHITE_ON_YELLOW
+      - WHITE_ON_GREEN
+      - BLACK_ON_LIGHT_RED
+      - BLACK_ON_LIGHT_YELLOW
+      - BLACK_ON_LIGHT_GREEN
+      - RED_ON_WHITE
+      - YELLOW_ON_WHITE
+      - GREEN_ON_WHITE
+      - CUSTOM_BG
+      - CUSTOM_TEXT
+    TableWidgetTextFormatReplace:
+      description: Replace rule for the table widget text format.
+      example:
+        type: all
+        with: vegetable
+      oneOf:
+      - $ref: '#/components/schemas/TableWidgetTextFormatReplaceAll'
+      - $ref: '#/components/schemas/TableWidgetTextFormatReplaceSubstring'
+    TableWidgetTextFormatReplaceAll:
+      description: Match All definition.
+      example:
+        type: all
+        with: vegetable
+      properties:
+        type:
+          $ref: '#/components/schemas/TableWidgetTextFormatReplaceAllType'
+        with:
+          description: Replace All type.
+          example: all
+          type: string
+      required:
+      - type
+      - with
+      type: object
+    TableWidgetTextFormatReplaceAllType:
+      description: Table widget text format replace all type.
+      enum:
+      - all
+      example: all
+      type: string
+      x-enum-varnames:
+      - ALL
+    TableWidgetTextFormatReplaceSubstring:
+      description: Match Sub-string definition.
+      example:
+        substring: fruit
+        type: substring
+        with: vegetable
+      properties:
+        substring:
+          description: Text that will be replaced.
+          example: string to replace
+          type: string
+        type:
+          $ref: '#/components/schemas/TableWidgetTextFormatReplaceSubstringType'
+        with:
+          description: Text that will replace original sub-string.
+          example: replacement
+          type: string
+      required:
+      - type
+      - with
+      - substring
+      type: object
+    TableWidgetTextFormatReplaceSubstringType:
+      description: Table widget text format replace sub-string type.
+      enum:
+      - substring
+      example: substring
+      type: string
+      x-enum-varnames:
+      - SUBSTRING
+    TableWidgetTextFormatRule:
+      description: Text format rules.
+      example:
+        match:
+          type: is
+          value: apple
+        replace:
+          type: all
+          with: vegetable
+      properties:
+        custom_bg_color:
+          description: Hex representation of the custom background color. Used with
+            custom background palette option.
+          example: '#632ca6'
+          type: string
+        custom_fg_color:
+          description: Hex representation of the custom text color. Used with custom
+            text palette option.
+          example: '#632ca6'
+          type: string
+        match:
+          $ref: '#/components/schemas/TableWidgetTextFormatMatch'
+        palette:
+          $ref: '#/components/schemas/TableWidgetTextFormatPalette'
+        replace:
+          $ref: '#/components/schemas/TableWidgetTextFormatReplace'
+      required:
+      - match
       type: object
     TagToHosts:
       description: In this object, the key is the tag, the value is a list of host
@@ -17099,7 +17903,6 @@ components:
           $ref: '#/components/schemas/ToplistWidgetStackedType'
       required:
       - type
-      - legend
       type: object
     ToplistWidgetStackedType:
       default: stacked
@@ -18973,6 +19776,16 @@ components:
             events over all hours in the current date for the given org.
           format: int64
           type: integer
+        code_analysis_sa_committers_hwm:
+          description: Shows the high-water mark of all Static Analysis committers
+            over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        code_analysis_sca_committers_hwm:
+          description: Shows the high-water mark of all static Software Composition
+            Analysis 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 all organizations.
@@ -19096,6 +19909,11 @@ components:
             over all hours in the current date for all organizations.
           format: int64
           type: integer
+        data_jobs_monitoring_host_hr_sum:
+          description: Shows the sum of all Data Jobs Monitoring hosts over all hours
+            in the current date for the given org.
+          format: int64
+          type: integer
         date:
           description: The date for the usage.
           format: date-time
@@ -19288,6 +20106,16 @@ components:
             hours in the current date for the given org.
           format: int64
           type: integer
+        oci_host_sum:
+          description: Shows the sum of all Oracle Cloud Infrastructure hosts over
+            all hours in the current date for the given org.
+          format: int64
+          type: integer
+        oci_host_top99p:
+          description: Shows the 99th percentile of all Oracle Cloud Infrastructure
+            hosts over 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 all organizations.
@@ -19698,6 +20526,16 @@ components:
             events over all hours in the current date for the given org.
           format: int64
           type: integer
+        code_analysis_sa_committers_hwm:
+          description: Shows the high-water mark of all Static Analysis committers
+            over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        code_analysis_sca_committers_hwm:
+          description: Shows the high-water mark of all static Software Composition
+            Analysis 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.
@@ -19831,6 +20669,11 @@ components:
             over all hours in the current date for the given org.
           format: int64
           type: integer
+        data_jobs_monitoring_host_hr_sum:
+          description: Shows the sum of all Data Jobs Monitoring hosts over all hours
+            in the current date for the given org.
+          format: int64
+          type: integer
         dbm_host_top99p_sum:
           description: Shows the 99th percentile of all Database Monitoring hosts
             over all hours in the current month for the given org.
@@ -20022,6 +20865,16 @@ components:
             hours in the current date for the given org.
           format: int64
           type: integer
+        oci_host_sum:
+          description: Shows the sum of all Oracle Cloud Infrastructure hosts over
+            all hours in the current date for the given org.
+          format: int64
+          type: integer
+        oci_host_top99p:
+          description: Shows the 99th percentile of all Oracle Cloud Infrastructure
+            hosts over 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.
@@ -20434,6 +21287,16 @@ components:
             events over all hours in the current month for all organizations.
           format: int64
           type: integer
+        code_analysis_sa_committers_hwm_sum:
+          description: Shows the high-water mark of all Static Analysis committers
+            over all hours in the current month for all organizations.
+          format: int64
+          type: integer
+        code_analysis_sca_committers_hwm_sum:
+          description: Shows the high-water mark of all static Software Composition
+            Analysis committers over all hours in the current month for all organizations.
+          format: int64
+          type: integer
         container_avg_sum:
           description: Shows the average of all distinct containers over all hours
             in the current month for all organizations.
@@ -20565,6 +21428,11 @@ components:
             over all hours in the current month for all organizations.
           format: int64
           type: integer
+        data_jobs_monitoring_host_hr_agg_sum:
+          description: Shows the sum of Data Jobs Monitoring hosts over all hours
+            in the current months for all organizations
+          format: int64
+          type: integer
         dbm_host_top99p_sum:
           description: Shows the 99th percentile of all Database Monitoring hosts
             over all hours in the current month for all organizations.
@@ -20779,6 +21647,16 @@ components:
             hours in the current month for all organizations.
           format: int64
           type: integer
+        oci_host_agg_sum:
+          description: Shows the sum of Oracle Cloud Infrastructure hosts over all
+            hours in the current months for all organizations
+          format: int64
+          type: integer
+        oci_host_top99p_sum:
+          description: Shows the 99th percentile of Oracle Cloud Infrastructure hosts
+            over 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
             month for all organizations.
@@ -22395,6 +23273,7 @@ components:
               access to the cloud cost data source in dashboards and notebooks.
             cloud_cost_management_write: Configure cloud cost accounts and global
               customizations.
+            code_analysis_read: View Code Analysis.
             continuous_profiler_pgo_read: Read and query Continuous Profiler data
               for Profile-Guided Optimization (PGO).
             create_webhooks: Create webhooks integrations.
@@ -22409,6 +23288,7 @@ components:
             incident_notification_settings_write: Configure Incidents Notification
               settings.
             incident_read: View incidents in Datadog.
+            incident_settings_read: View Incident Settings.
             incident_settings_write: Configure Incident Settings.
             incident_write: Create, view, and manage incidents in Datadog.
             metrics_read: View custom metrics.
@@ -22430,6 +23310,8 @@ components:
             security_monitoring_signals_read: View Security Signals.
             security_monitoring_suppressions_read: Read Rule Suppressions.
             security_monitoring_suppressions_write: Write Rule Suppressions.
+            security_pipelines_read: View Security Pipelines.
+            security_pipelines_write: Create, edit, and delete CSM Security Pipelines.
             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.
@@ -22565,6 +23447,10 @@ paths:
       summary: Get all API keys
       tags:
       - Key Management
+      x-permission:
+        operator: OR
+        permissions:
+        - api_keys_read
     post:
       description: Creates an API key with a given name.
       operationId: CreateAPIKey
@@ -22599,6 +23485,10 @@ paths:
       tags:
       - Key Management
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - api_keys_write
   /api/v1/api_key/{key}:
     delete:
       description: Delete a given API key.
@@ -22640,6 +23530,10 @@ paths:
       summary: Delete an API key
       tags:
       - Key Management
+      x-permission:
+        operator: OR
+        permissions:
+        - api_keys_delete
     get:
       description: Get a given API key.
       operationId: GetAPIKey
@@ -22674,6 +23568,10 @@ paths:
       summary: Get API key
       tags:
       - Key Management
+      x-permission:
+        operator: OR
+        permissions:
+        - api_keys_read
     put:
       description: Edit an API key name.
       operationId: UpdateAPIKey
@@ -22721,6 +23619,10 @@ paths:
       tags:
       - Key Management
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - api_keys_write
   /api/v1/application_key:
     get:
       description: Get all application keys available for your Datadog account.
@@ -22743,6 +23645,11 @@ paths:
       summary: Get all application keys
       tags:
       - Key Management
+      x-permission:
+        operator: OR
+        permissions:
+        - org_app_keys_read
+        - user_app_keys
     post:
       description: Create an application key with a given name.
       operationId: CreateApplicationKey
@@ -22783,6 +23690,10 @@ paths:
       tags:
       - Key Management
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - user_app_keys
   /api/v1/application_key/{key}:
     delete:
       description: Delete a given application key.
@@ -22818,6 +23729,11 @@ paths:
       summary: Delete an application key
       tags:
       - Key Management
+      x-permission:
+        operator: OR
+        permissions:
+        - org_app_keys_write
+        - user_app_keys
     get:
       description: Get a given application key.
       operationId: GetApplicationKey
@@ -22852,6 +23768,11 @@ paths:
       summary: Get an application key
       tags:
       - Key Management
+      x-permission:
+        operator: OR
+        permissions:
+        - org_app_keys_read
+        - user_app_keys
     put:
       description: Edit an application key name.
       operationId: UpdateApplicationKey
@@ -22905,6 +23826,11 @@ paths:
       tags:
       - Key Management
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - org_app_keys_write
+        - user_app_keys
   /api/v1/check_run:
     post:
       description: 'Submit a list of Service Checks.
@@ -23022,6 +23948,10 @@ paths:
       summary: Get the list of available daily custom reports
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/daily_custom_reports/{report_id}:
     get:
       deprecated: true
@@ -23067,6 +23997,10 @@ paths:
       summary: Get specified daily custom reports
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/dashboard:
     delete:
       description: Delete dashboards using the specified IDs. If there are any failures,
@@ -23119,6 +24053,10 @@ paths:
       tags:
       - Dashboards
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_write
     get:
       description: 'Get all dashboards.
 
@@ -23186,6 +24124,10 @@ paths:
         limitParam: count
         pageOffsetParam: start
         resultsPath: dashboards
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_read
     patch:
       description: Restore dashboards using the specified IDs. If there are any failures,
         no dashboards will be restored (partial success is not allowed).
@@ -23237,6 +24179,10 @@ paths:
       tags:
       - Dashboards
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_write
     post:
       description: 'Create a dashboard using the specified options. When defining
         queries in your widgets, take note of which queries should have the `as_count()`
@@ -23282,6 +24228,10 @@ paths:
       tags:
       - Dashboards
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_write
   /api/v1/dashboard/lists/manual:
     get:
       description: Fetch all of your existing dashboard list definitions.
@@ -23309,6 +24259,10 @@ paths:
       summary: Get all dashboard lists
       tags:
       - Dashboard Lists
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_read
     post:
       description: Create an empty dashboard list.
       operationId: CreateDashboardList
@@ -23349,6 +24303,10 @@ paths:
       tags:
       - Dashboard Lists
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_write
   /api/v1/dashboard/lists/manual/{list_id}:
     delete:
       description: Delete a dashboard list.
@@ -23390,6 +24348,10 @@ paths:
       summary: Delete a dashboard list
       tags:
       - Dashboard Lists
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_write
     get:
       description: Fetch an existing dashboard list's definition.
       operationId: GetDashboardList
@@ -23430,6 +24392,10 @@ paths:
       summary: Get a dashboard list
       tags:
       - Dashboard Lists
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_read
     put:
       description: Update the name of a dashboard list.
       operationId: UpdateDashboardList
@@ -23484,6 +24450,10 @@ paths:
       tags:
       - Dashboard Lists
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_write
   /api/v1/dashboard/public:
     post:
       description: Share a specified private dashboard, generating a URL at which
@@ -23538,6 +24508,10 @@ paths:
       tags:
       - Dashboards
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_public_share
   /api/v1/dashboard/public/{token}:
     delete:
       description: Revoke the public URL for a dashboard (rendering it private) associated
@@ -23579,6 +24553,10 @@ paths:
       summary: Revoke a shared dashboard URL
       tags:
       - Dashboards
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_public_share
     get:
       description: Fetch an existing shared dashboard's sharing metadata associated
         with the specified token.
@@ -23620,6 +24598,10 @@ paths:
       summary: Get a shared dashboard
       tags:
       - Dashboards
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_read
     put:
       description: Update a shared dashboard associated with the specified token.
       operationId: UpdatePublicDashboard
@@ -23689,6 +24671,10 @@ paths:
       tags:
       - Dashboards
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_public_share
   /api/v1/dashboard/public/{token}/invitation:
     delete:
       description: Revoke previously sent invitation emails and active sessions used
@@ -23741,6 +24727,10 @@ paths:
       tags:
       - Dashboards
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_public_share
     get:
       description: Describe the invitations that exist for the given shared dashboard
         (paginated).
@@ -23795,6 +24785,10 @@ paths:
       summary: Get all invitations for a shared dashboard
       tags:
       - Dashboards
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_public_share
     post:
       description: Send emails to specified email addresses containing links to access
         a given authenticated shared dashboard. Email addresses must already belong
@@ -23857,6 +24851,10 @@ paths:
       tags:
       - Dashboards
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_public_share
   /api/v1/dashboard/{dashboard_id}:
     delete:
       description: Delete a dashboard using the specified ID.
@@ -23897,6 +24895,10 @@ paths:
       summary: Delete a dashboard
       tags:
       - Dashboards
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_write
     get:
       description: Get a dashboard using the specified ID.
       operationId: GetDashboard
@@ -23936,6 +24938,10 @@ paths:
       summary: Get a dashboard
       tags:
       - Dashboards
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_read
     put:
       description: Update a dashboard using the specified ID.
       operationId: UpdateDashboard
@@ -23989,6 +24995,10 @@ paths:
       tags:
       - Dashboards
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - dashboards_write
   /api/v1/distribution_points:
     post:
       description: "The distribution points end-point allows you to post distribution
@@ -24098,6 +25108,10 @@ paths:
       summary: Get all downtimes
       tags:
       - Downtimes
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_read
     post:
       deprecated: true
       description: Schedule a downtime. **Note:** This endpoint has been deprecated.
@@ -24140,6 +25154,10 @@ paths:
       tags:
       - Downtimes
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_downtime
   /api/v1/downtime/cancel/by_scope:
     post:
       deprecated: true
@@ -24191,6 +25209,10 @@ paths:
       tags:
       - Downtimes
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_downtime
   /api/v1/downtime/{downtime_id}:
     delete:
       deprecated: true
@@ -24231,6 +25253,10 @@ paths:
       summary: Cancel a downtime
       tags:
       - Downtimes
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_downtime
     get:
       deprecated: true
       description: Get downtime detail by `downtime_id`. **Note:** This endpoint has
@@ -24274,6 +25300,10 @@ paths:
       summary: Get a downtime
       tags:
       - Downtimes
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_read
     put:
       deprecated: true
       description: Update a single downtime by `downtime_id`. **Note:** This endpoint
@@ -24332,6 +25362,10 @@ paths:
       tags:
       - Downtimes
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_downtime
   /api/v1/events:
     get:
       description: "The event stream can be queried and filtered by time, priority,
@@ -24442,6 +25476,10 @@ paths:
       summary: Get a list of events
       tags:
       - Events
+      x-permission:
+        operator: OR
+        permissions:
+        - events_read
     post:
       description: 'This endpoint allows you to post events to the stream.
 
@@ -24518,6 +25556,10 @@ paths:
       summary: Get an event
       tags:
       - Events
+      x-permission:
+        operator: OR
+        permissions:
+        - events_read
   /api/v1/graph/snapshot:
     get:
       description: 'Take graph snapshots.
@@ -24613,6 +25655,9 @@ paths:
       summary: Take graph snapshots
       tags:
       - Snapshots
+      x-permission:
+        operator: OPEN
+        permissions: []
   /api/v1/host/{host_name}/mute:
     post:
       description: Mute a host. **Note:** This creates a [Downtime V2](https://docs.datadoghq.com/api/latest/downtimes/#schedule-a-downtime)
@@ -24789,6 +25834,10 @@ paths:
       summary: Get all hosts for your organization
       tags:
       - Hosts
+      x-permission:
+        operator: OR
+        permissions:
+        - hosts_read
   /api/v1/hosts/totals:
     get:
       description: 'This endpoint returns the total number of active and up hosts
@@ -24835,6 +25884,10 @@ paths:
       summary: Get the total number of active hosts
       tags:
       - Hosts
+      x-permission:
+        operator: OR
+        permissions:
+        - hosts_read
   /api/v1/integration/aws:
     delete:
       description: Delete a Datadog-AWS integration matching the specified `account_id`
@@ -24878,6 +25931,10 @@ paths:
       tags:
       - AWS Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - aws_configurations_manage
     get:
       description: List all Datadog-AWS integrations available in your Datadog organization.
       operationId: ListAWSAccounts
@@ -24924,6 +25981,10 @@ paths:
       summary: List all AWS integrations
       tags:
       - AWS Integration
+      x-permission:
+        operator: OR
+        permissions:
+        - aws_configuration_read
     post:
       description: 'Create a Datadog-Amazon Web Services integration.
 
@@ -24971,6 +26032,10 @@ paths:
       tags:
       - AWS Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - aws_configurations_manage
     put:
       description: Update a Datadog-Amazon Web Services integration.
       operationId: UpdateAWSAccount
@@ -25035,6 +26100,10 @@ paths:
       tags:
       - AWS Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - aws_configuration_edit
   /api/v1/integration/aws/available_namespace_rules:
     get:
       description: List all namespace rules for a given Datadog-AWS integration. This
@@ -25064,6 +26133,10 @@ paths:
       summary: List namespace rules
       tags:
       - AWS Integration
+      x-permission:
+        operator: OR
+        permissions:
+        - aws_configuration_read
   /api/v1/integration/aws/event_bridge:
     delete:
       description: Delete an Amazon EventBridge source.
@@ -25101,6 +26174,10 @@ paths:
       tags:
       - AWS Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - manage_integrations
     get:
       description: Get all Amazon EventBridge sources.
       operationId: ListAWSEventBridgeSources
@@ -25129,6 +26206,9 @@ paths:
       summary: Get all Amazon EventBridge sources
       tags:
       - AWS Integration
+      x-permission:
+        operator: OPEN
+        permissions: []
     post:
       description: Create an Amazon EventBridge source.
       operationId: CreateAWSEventBridgeSource
@@ -25165,6 +26245,10 @@ paths:
       tags:
       - AWS Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - manage_integrations
   /api/v1/integration/aws/filtering:
     delete:
       description: Delete a tag filtering entry.
@@ -25203,6 +26287,10 @@ paths:
       tags:
       - AWS Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - aws_configuration_edit
     get:
       description: Get all AWS tag filters.
       operationId: ListAWSTagFilters
@@ -25237,6 +26325,10 @@ paths:
       summary: Get all AWS tag filters
       tags:
       - AWS Integration
+      x-permission:
+        operator: OR
+        permissions:
+        - aws_configuration_read
     post:
       description: Set an AWS tag filter.
       operationId: CreateAWSTagFilter
@@ -25277,6 +26369,10 @@ paths:
       tags:
       - AWS Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - aws_configuration_edit
   /api/v1/integration/aws/generate_new_external_id:
     put:
       description: Generate a new AWS external ID for a given AWS account ID and role
@@ -25318,6 +26414,10 @@ paths:
       tags:
       - AWS Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - aws_configuration_edit
   /api/v1/integration/aws/logs:
     delete:
       description: Delete a Datadog-AWS logs configuration by removing the specific
@@ -25355,6 +26455,10 @@ paths:
       tags:
       - AWS Logs Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - aws_configuration_edit
     get:
       description: List all Datadog-AWS Logs integrations configured in your Datadog
         account.
@@ -25395,6 +26499,10 @@ paths:
       summary: List all AWS Logs integrations
       tags:
       - AWS Logs Integration
+      x-permission:
+        operator: OR
+        permissions:
+        - aws_configuration_read
     post:
       description: Attach the Lambda ARN of the Lambda created for the Datadog-AWS
         log collection to your AWS account ID to enable log collection.
@@ -25431,6 +26539,10 @@ paths:
       tags:
       - AWS Logs Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - aws_configuration_edit
   /api/v1/integration/aws/logs/check_async:
     post:
       description: 'Test if permissions are present to add a log-forwarding triggers
@@ -25483,6 +26595,10 @@ paths:
       tags:
       - AWS Logs Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - aws_configuration_read
   /api/v1/integration/aws/logs/services:
     get:
       description: Get the list of current AWS services that Datadog offers automatic
@@ -25522,6 +26638,10 @@ paths:
       summary: Get list of AWS log ready services
       tags:
       - AWS Logs Integration
+      x-permission:
+        operator: OR
+        permissions:
+        - aws_configuration_read
     post:
       description: Enable automatic log collection for a list of services. This should
         be run after running `CreateAWSLambdaARN` to save the configuration.
@@ -25558,6 +26678,10 @@ paths:
       tags:
       - AWS Logs Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - aws_configuration_edit
   /api/v1/integration/aws/logs/services_async:
     post:
       description: "Test if permissions are present to add log-forwarding triggers
@@ -25600,6 +26724,10 @@ paths:
       tags:
       - AWS Logs Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - aws_configuration_read
   /api/v1/integration/azure:
     delete:
       description: Delete a given Datadog-Azure integration from your Datadog account.
@@ -25637,6 +26765,10 @@ paths:
       tags:
       - Azure Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - azure_configurations_manage
     get:
       description: List all Datadog-Azure integrations configured in your Datadog
         account.
@@ -25665,6 +26797,10 @@ paths:
       summary: List all Azure integrations
       tags:
       - Azure Integration
+      x-permission:
+        operator: OR
+        permissions:
+        - azure_configuration_read
     post:
       description: 'Create a Datadog-Azure integration.
 
@@ -25714,6 +26850,10 @@ paths:
       tags:
       - Azure Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - azure_configurations_manage
     put:
       description: 'Update a Datadog-Azure integration. Requires an existing `tenant_name`
         and `client_id`.
@@ -25757,6 +26897,10 @@ paths:
       tags:
       - Azure Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - azure_configuration_edit
   /api/v1/integration/azure/host_filters:
     post:
       description: Update the defined list of host filters for a given Datadog-Azure
@@ -25795,6 +26939,10 @@ paths:
       tags:
       - Azure Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - azure_configuration_edit
   /api/v1/integration/gcp:
     delete:
       deprecated: true
@@ -25834,6 +26982,10 @@ paths:
       tags:
       - GCP Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - gcp_configurations_manage
     get:
       deprecated: true
       description: "This endpoint is deprecated \u2013 use the V2 endpoints instead.
@@ -25863,6 +27015,10 @@ paths:
       summary: List all GCP integrations
       tags:
       - GCP Integration
+      x-permission:
+        operator: OR
+        permissions:
+        - gcp_configuration_read
     post:
       deprecated: true
       description: "This endpoint is deprecated \u2013 use the V2 endpoints instead.
@@ -25901,6 +27057,10 @@ paths:
       tags:
       - GCP Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - gcp_configurations_manage
     put:
       deprecated: true
       description: "This endpoint is deprecated \u2013 use the V2 endpoints instead.
@@ -25942,6 +27102,10 @@ paths:
       tags:
       - GCP Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - gcp_configuration_edit
   /api/v1/integration/pagerduty/configuration/services:
     post:
       description: Create a new service object in the PagerDuty integration.
@@ -25978,6 +27142,10 @@ paths:
       tags:
       - PagerDuty Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - manage_integrations
   /api/v1/integration/pagerduty/configuration/services/{service_name}:
     delete:
       description: Delete a single service object in the Datadog-PagerDuty integration.
@@ -26009,6 +27177,10 @@ paths:
       summary: Delete a single service object
       tags:
       - PagerDuty Integration
+      x-permission:
+        operator: OR
+        permissions:
+        - manage_integrations
     get:
       description: Get service name in the Datadog-PagerDuty integration.
       operationId: GetPagerDutyIntegrationService
@@ -26043,6 +27215,10 @@ paths:
       summary: Get a single service object
       tags:
       - PagerDuty Integration
+      x-permission:
+        operator: OR
+        permissions:
+        - integrations_read
     put:
       description: Update a single service object in the Datadog-PagerDuty integration.
       operationId: UpdatePagerDutyIntegrationService
@@ -26087,6 +27263,10 @@ paths:
       tags:
       - PagerDuty Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - manage_integrations
   /api/v1/integration/slack/configuration/accounts/{account_name}/channels:
     get:
       description: Get a list of all channels configured for your Datadog-Slack integration.
@@ -26123,6 +27303,10 @@ paths:
       summary: Get all channels in a Slack integration
       tags:
       - Slack Integration
+      x-permission:
+        operator: OR
+        permissions:
+        - integrations_read
     post:
       description: Add a channel to your Datadog-Slack integration.
       operationId: CreateSlackIntegrationChannel
@@ -26166,6 +27350,10 @@ paths:
       tags:
       - Slack Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - manage_integrations
   /api/v1/integration/slack/configuration/accounts/{account_name}/channels/{channel_name}:
     delete:
       description: Remove a channel from your Datadog-Slack integration.
@@ -26199,6 +27387,10 @@ paths:
       summary: Remove a Slack integration channel
       tags:
       - Slack Integration
+      x-permission:
+        operator: OR
+        permissions:
+        - manage_integrations
     get:
       description: Get a channel configured for your Datadog-Slack integration.
       operationId: GetSlackIntegrationChannel
@@ -26235,6 +27427,10 @@ paths:
       summary: Get a Slack integration channel
       tags:
       - Slack Integration
+      x-permission:
+        operator: OR
+        permissions:
+        - integrations_read
     patch:
       description: Update a channel used in your Datadog-Slack integration.
       operationId: UpdateSlackIntegrationChannel
@@ -26279,6 +27475,10 @@ paths:
       tags:
       - Slack Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - manage_integrations
   /api/v1/integration/webhooks/configuration/custom-variables:
     post:
       description: Creates an endpoint with the name `<CUSTOM_VARIABLE_NAME>`.
@@ -26315,6 +27515,10 @@ paths:
       tags:
       - Webhooks Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - manage_integrations
   /api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}:
     delete:
       description: Deletes the endpoint with the name `<CUSTOM_VARIABLE_NAME>`.
@@ -26346,6 +27550,10 @@ paths:
       summary: Delete a custom variable
       tags:
       - Webhooks Integration
+      x-permission:
+        operator: OR
+        permissions:
+        - manage_integrations
     get:
       description: 'Shows the content of the custom variable with the name `<CUSTOM_VARIABLE_NAME>`.
 
@@ -26391,6 +27599,10 @@ paths:
       summary: Get a custom variable
       tags:
       - Webhooks Integration
+      x-permission:
+        operator: OR
+        permissions:
+        - integrations_read
     put:
       description: Updates the endpoint with the name `<CUSTOM_VARIABLE_NAME>`.
       operationId: UpdateWebhooksIntegrationCustomVariable
@@ -26439,6 +27651,10 @@ paths:
       tags:
       - Webhooks Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - manage_integrations
   /api/v1/integration/webhooks/configuration/webhooks:
     post:
       description: Creates an endpoint with the name `<WEBHOOK_NAME>`.
@@ -26480,6 +27696,10 @@ paths:
       tags:
       - Webhooks Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - create_webhooks
   /api/v1/integration/webhooks/configuration/webhooks/{webhook_name}:
     delete:
       description: Deletes the endpoint with the name `<WEBHOOK NAME>`.
@@ -26511,6 +27731,10 @@ paths:
       summary: Delete a webhook
       tags:
       - Webhooks Integration
+      x-permission:
+        operator: OR
+        permissions:
+        - manage_integrations
     get:
       description: Gets the content of the webhook with the name `<WEBHOOK_NAME>`.
       operationId: GetWebhooksIntegration
@@ -26551,6 +27775,10 @@ paths:
       summary: Get a webhook integration
       tags:
       - Webhooks Integration
+      x-permission:
+        operator: OR
+        permissions:
+        - integrations_read
     put:
       description: Updates the endpoint with the name `<WEBHOOK_NAME>`.
       operationId: UpdateWebhooksIntegration
@@ -26599,6 +27827,10 @@ paths:
       tags:
       - Webhooks Integration
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - manage_integrations
   /api/v1/logs-queries/list:
     post:
       description: 'List endpoint returns logs that match a log search query.
@@ -26649,6 +27881,10 @@ paths:
       tags:
       - Logs
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - logs_read_data
   /api/v1/logs/config/index-order:
     get:
       description: Get the current order of your log indexes. This endpoint takes
@@ -26672,6 +27908,9 @@ paths:
       summary: Get indexes order
       tags:
       - Logs Indexes
+      x-permission:
+        operator: OPEN
+        permissions: []
     put:
       description: 'This endpoint updates the index order of your organization.
 
@@ -26710,6 +27949,10 @@ paths:
       tags:
       - Logs Indexes
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - logs_modify_indexes
   /api/v1/logs/config/indexes:
     get:
       description: 'The Index object describes the configuration of a log index.
@@ -26738,6 +27981,9 @@ paths:
       summary: Get all indexes
       tags:
       - Logs Indexes
+      x-permission:
+        operator: OPEN
+        permissions: []
     post:
       description: Creates a new index. Returns the Index object passed in the request
         body when the request is successful.
@@ -26774,6 +28020,10 @@ paths:
       tags:
       - Logs Indexes
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - logs_modify_indexes
   /api/v1/logs/config/indexes/{name}:
     get:
       description: Get one log index from your organization. This endpoint takes no
@@ -26883,6 +28133,9 @@ paths:
       summary: Get pipeline order
       tags:
       - Logs Pipelines
+      x-permission:
+        operator: OPEN
+        permissions: []
     put:
       description: 'Update the order of your pipelines. Since logs are processed sequentially,
         reordering a pipeline may change
@@ -26934,6 +28187,10 @@ paths:
       tags:
       - Logs Pipelines
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - logs_write_pipelines
   /api/v1/logs/config/pipelines:
     get:
       description: 'Get all pipelines from your organization.
@@ -26958,6 +28215,9 @@ paths:
       summary: Get all pipelines
       tags:
       - Logs Pipelines
+      x-permission:
+        operator: OPEN
+        permissions: []
     post:
       description: Create a pipeline in your organization.
       operationId: CreateLogsPipeline
@@ -26993,6 +28253,10 @@ paths:
       tags:
       - Logs Pipelines
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - logs_write_pipelines
   /api/v1/logs/config/pipelines/{pipeline_id}:
     delete:
       description: 'Delete a given pipeline from your organization.
@@ -27026,6 +28290,10 @@ paths:
       summary: Delete a pipeline
       tags:
       - Logs Pipelines
+      x-permission:
+        operator: OR
+        permissions:
+        - logs_write_pipelines
     get:
       description: 'Get a specific pipeline from your organization.
 
@@ -27062,6 +28330,9 @@ paths:
       summary: Get a pipeline
       tags:
       - Logs Pipelines
+      x-permission:
+        operator: OPEN
+        permissions: []
     put:
       description: "Update a given pipeline configuration to change it\u2019s processors
         or their order.\n\n**Note**: Using this method updates your pipeline configuration
@@ -27107,6 +28378,10 @@ paths:
       tags:
       - Logs Pipelines
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - logs_write_pipelines
   /api/v1/metrics:
     get:
       description: Get the list of actively reporting metrics from a given time until
@@ -27167,6 +28442,10 @@ paths:
       summary: Get active metrics list
       tags:
       - Metrics
+      x-permission:
+        operator: OR
+        permissions:
+        - metrics_read
   /api/v1/metrics/{metric_name}:
     get:
       description: Get metadata about a specific metric.
@@ -27207,6 +28486,10 @@ paths:
       summary: Get metric metadata
       tags:
       - Metrics
+      x-permission:
+        operator: OR
+        permissions:
+        - metrics_read
     put:
       description: Edit metadata of a specific metric. Find out more about [supported
         types](https://docs.datadoghq.com/developers/metrics).
@@ -27256,6 +28539,10 @@ paths:
       tags:
       - Metrics
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - metrics_metadata_write
   /api/v1/monitor:
     get:
       description: Get details about the specified monitor from your organization.
@@ -27370,6 +28657,10 @@ paths:
       x-pagination:
         limitParam: page_size
         pageParam: page
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_read
     post:
       description: 'Create a monitor using the specified options.
 
@@ -27422,6 +28713,8 @@ paths:
 
         - network-performance: `network-performance alert`
 
+        - cloud cost: `cost alert`
+
 
         **Notes**:
 
@@ -27692,21 +28985,27 @@ paths:
         ##### Error Tracking Alert Query
 
 
-        Example(RUM): `error-tracking-rum(query).rollup(rollup_method[, measure]).last(time_window)
-        operator #`
+        "New issue" example: `error-tracking(query).source(issue_source).new().rollup(rollup_method[,
+        measure]).by(group_by).last(time_window) operator #`
 
-        Example(APM Traces): `error-tracking-traces(query).rollup(rollup_method[,
-        measure]).last(time_window) operator #`
+        "High impact issue" example: `error-tracking(query).source(issue_source).impact().rollup(rollup_method[,
+        measure]).by(group_by).last(time_window) operator #`
 
 
         - `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
 
+        - `issue_source` The issue source - supports `all`, `browser`, `mobile` and
+        `backend` and defaults to `all` if omitted.
+
         - `rollup_method` The stats roll-up method - supports `count`, `avg`, and
-        `cardinality`.
+        `cardinality` and defaults to `count` if omitted.
 
         - `measure` For `avg` and cardinality `rollup_method` - specify the measure
         or the facet name you want to use.
 
+        - `group by` Comma-separated list of attributes to group by - should contain
+        at least `issue.id`.
+
         - `time_window` #m (between 1 and 2880), #h (between 1 and 48).
 
         - `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.
@@ -27807,6 +29106,10 @@ paths:
       tags:
       - Monitors
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_write
   /api/v1/monitor/can_delete:
     get:
       description: Check if the given monitors can be deleted.
@@ -27859,6 +29162,10 @@ paths:
       summary: Check if a monitor can be deleted
       tags:
       - Monitors
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_read
   /api/v1/monitor/groups/search:
     get:
       description: Search and filter your monitor groups details.
@@ -27943,6 +29250,10 @@ paths:
       summary: Monitors group search
       tags:
       - Monitors
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_read
   /api/v1/monitor/search:
     get:
       description: Search and filter your monitors details.
@@ -28029,6 +29340,10 @@ paths:
       summary: Monitors search
       tags:
       - Monitors
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_read
   /api/v1/monitor/validate:
     post:
       description: 'Validate the monitor provided in the request.
@@ -28074,6 +29389,10 @@ paths:
       tags:
       - Monitors
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_write
   /api/v1/monitor/{monitor_id}:
     delete:
       description: Delete the specified monitor
@@ -28136,6 +29455,10 @@ paths:
       summary: Delete a monitor
       tags:
       - Monitors
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_write
     get:
       description: Get details about the specified monitor from your organization.
       operationId: GetMonitor
@@ -28197,6 +29520,10 @@ paths:
       summary: Get a monitor's details
       tags:
       - Monitors
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_read
     put:
       description: Edit the specified monitor.
       operationId: UpdateMonitor
@@ -28258,6 +29585,10 @@ paths:
       tags:
       - Monitors
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_write
   /api/v1/monitor/{monitor_id}/downtimes:
     get:
       deprecated: true
@@ -28304,6 +29635,10 @@ paths:
       tags:
       - Downtimes
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_read
   /api/v1/monitor/{monitor_id}/validate:
     post:
       description: Validate the monitor provided in the request.
@@ -28355,6 +29690,10 @@ paths:
       tags:
       - Monitors
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - monitors_write
   /api/v1/monthly_custom_reports:
     get:
       deprecated: true
@@ -28415,6 +29754,10 @@ paths:
       summary: Get the list of available monthly custom reports
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/monthly_custom_reports/{report_id}:
     get:
       deprecated: true
@@ -28466,6 +29809,10 @@ paths:
       summary: Get specified monthly custom reports
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/notebooks:
     get:
       description: 'Get all notebooks. This can also be used to search for notebooks
@@ -28593,6 +29940,10 @@ paths:
         limitParam: count
         pageOffsetParam: start
         resultsPath: data
+      x-permission:
+        operator: OR
+        permissions:
+        - notebooks_read
     post:
       description: Create a notebook using the specified options.
       operationId: CreateNotebook
@@ -28665,6 +30016,10 @@ paths:
       tags:
       - Notebooks
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - notebooks_write
   /api/v1/notebooks/{notebook_id}:
     delete:
       description: Delete a notebook using the specified ID.
@@ -28703,6 +30058,10 @@ paths:
       summary: Delete a notebook
       tags:
       - Notebooks
+      x-permission:
+        operator: OR
+        permissions:
+        - notebooks_write
     get:
       description: Get a notebook using the specified notebook ID.
       operationId: GetNotebook
@@ -28744,6 +30103,10 @@ paths:
       summary: Get a notebook
       tags:
       - Notebooks
+      x-permission:
+        operator: OR
+        permissions:
+        - notebooks_read
     put:
       description: Update a notebook using the specified ID.
       operationId: UpdateNotebook
@@ -28837,6 +30200,10 @@ paths:
       tags:
       - Notebooks
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - notebooks_write
   /api/v1/org:
     get:
       description: This endpoint returns data on your top-level organization.
@@ -28859,6 +30226,10 @@ paths:
       summary: List your managed organizations
       tags:
       - Organizations
+      x-permission:
+        operator: OR
+        permissions:
+        - org_management
     post:
       description: 'Create a child organization.
 
@@ -28910,6 +30281,10 @@ paths:
       tags:
       - Organizations
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - org_management
   /api/v1/org/{public_id}:
     get:
       description: Get organization information.
@@ -29138,6 +30513,10 @@ paths:
       summary: Query timeseries points
       tags:
       - Metrics
+      x-permission:
+        operator: OR
+        permissions:
+        - timeseries_query
   /api/v1/search:
     get:
       description: Search for metrics from the last 24 hours in Datadog.
@@ -29178,6 +30557,9 @@ paths:
       summary: Search metrics
       tags:
       - Metrics
+      x-permission:
+        operator: OPEN
+        permissions: []
   /api/v1/security_analytics/signals/{signal_id}/add_to_incident:
     patch:
       description: Add a security signal to an incident. This makes it possible to
@@ -29224,6 +30606,10 @@ paths:
       tags:
       - Security Monitoring
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - security_monitoring_signals_write
   /api/v1/security_analytics/signals/{signal_id}/assignee:
     patch:
       description: Modify the triage assignee of a security signal.
@@ -29268,6 +30654,10 @@ paths:
       tags:
       - Security Monitoring
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - security_monitoring_signals_write
   /api/v1/security_analytics/signals/{signal_id}/state:
     patch:
       description: Change the triage state of a security signal.
@@ -29312,6 +30702,10 @@ paths:
       tags:
       - Security Monitoring
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - security_monitoring_signals_write
   /api/v1/series:
     post:
       description: "The metrics end-point allows you to post time-series data that
@@ -29473,6 +30867,10 @@ paths:
         limitParam: limit
         pageOffsetParam: offset
         resultsPath: data
+      x-permission:
+        operator: OR
+        permissions:
+        - slos_read
     post:
       description: Create a service level objective object.
       operationId: CreateSLO
@@ -29513,6 +30911,10 @@ paths:
       tags:
       - Service Level Objectives
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - slos_write
   /api/v1/slo/bulk_delete:
     post:
       description: 'Delete (or partially delete) multiple service level objective
@@ -29563,6 +30965,10 @@ paths:
       tags:
       - Service Level Objectives
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - slos_write
   /api/v1/slo/can_delete:
     get:
       description: 'Check if an SLO can be safely deleted. For example,
@@ -29613,6 +31019,10 @@ paths:
       summary: Check if SLOs can be safely deleted
       tags:
       - Service Level Objectives
+      x-permission:
+        operator: OR
+        permissions:
+        - slos_read
   /api/v1/slo/correction:
     get:
       description: Get all Service Level Objective corrections.
@@ -29661,6 +31071,10 @@ paths:
         limitParam: limit
         pageOffsetParam: offset
         resultsPath: data
+      x-permission:
+        operator: OR
+        permissions:
+        - slos_read
     post:
       description: Create an SLO Correction.
       operationId: CreateSLOCorrection
@@ -29707,6 +31121,10 @@ paths:
       tags:
       - Service Level Objective Corrections
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - slos_corrections
   /api/v1/slo/correction/{slo_correction_id}:
     delete:
       description: Permanently delete the specified SLO correction object.
@@ -29885,6 +31303,10 @@ paths:
       summary: Search for SLOs
       tags:
       - Service Level Objectives
+      x-permission:
+        operator: OR
+        permissions:
+        - slos_read
   /api/v1/slo/{slo_id}:
     delete:
       description: 'Permanently delete the specified service level objective object.
@@ -29943,6 +31365,10 @@ paths:
       summary: Delete an SLO
       tags:
       - Service Level Objectives
+      x-permission:
+        operator: OR
+        permissions:
+        - slos_write
     get:
       description: Get a service level objective object.
       operationId: GetSLO
@@ -29989,6 +31415,10 @@ paths:
       summary: Get an SLO's details
       tags:
       - Service Level Objectives
+      x-permission:
+        operator: OR
+        permissions:
+        - slos_read
     put:
       description: Update the specified service level objective object.
       operationId: UpdateSLO
@@ -30042,6 +31472,10 @@ paths:
       tags:
       - Service Level Objectives
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - slos_write
   /api/v1/slo/{slo_id}/corrections:
     get:
       description: Get corrections applied to an SLO
@@ -30088,6 +31522,10 @@ paths:
       summary: Get Corrections For an SLO
       tags:
       - Service Level Objectives
+      x-permission:
+        operator: OR
+        permissions:
+        - slos_read
   /api/v1/slo/{slo_id}/history:
     get:
       description: "Get a specific SLO\u2019s history, regardless of its SLO type.\n\nThe
@@ -30174,6 +31612,10 @@ paths:
       summary: Get an SLO's history
       tags:
       - Service Level Objectives
+      x-permission:
+        operator: OR
+        permissions:
+        - slos_read
   /api/v1/synthetics/ci/batch/{batch_id}:
     get:
       description: Get a batch's updated details.
@@ -30208,6 +31650,10 @@ paths:
       summary: Get details of batch
       tags:
       - Synthetics
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_read
   /api/v1/synthetics/locations:
     get:
       description: 'Get the list of public and private locations available for Synthetic
@@ -30231,6 +31677,10 @@ paths:
       summary: Get all locations (public and private)
       tags:
       - Synthetics
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_private_location_read
   /api/v1/synthetics/private-locations:
     post:
       description: Create a new Synthetic private location.
@@ -30272,6 +31722,10 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_private_location_write
   /api/v1/synthetics/private-locations/{location_id}:
     delete:
       description: Delete a Synthetic private location.
@@ -30304,6 +31758,10 @@ paths:
       summary: Delete a private location
       tags:
       - Synthetics
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_private_location_write
     get:
       description: Get a Synthetic private location.
       operationId: GetPrivateLocation
@@ -30339,6 +31797,10 @@ paths:
       summary: Get a private location
       tags:
       - Synthetics
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_private_location_read
     put:
       description: Edit a Synthetic private location.
       operationId: UpdatePrivateLocation
@@ -30382,6 +31844,10 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_private_location_write
   /api/v1/synthetics/settings/default_locations:
     get:
       description: Get the default locations settings.
@@ -30398,6 +31864,10 @@ paths:
       summary: Get the default locations
       tags:
       - Synthetics
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_default_settings_read
   /api/v1/synthetics/tests:
     get:
       description: Get the list of all Synthetic tests.
@@ -30452,6 +31922,10 @@ paths:
         limitParam: page_size
         pageParam: page_number
         resultsPath: tests
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_read
   /api/v1/synthetics/tests/api:
     post:
       description: Create a Synthetic API test.
@@ -30620,6 +32094,10 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_write
   /api/v1/synthetics/tests/api/{public_id}:
     get:
       description: 'Get the detailed configuration associated with
@@ -30664,6 +32142,10 @@ paths:
       summary: Get an API test
       tags:
       - Synthetics
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_read
     put:
       description: Edit the configuration of a Synthetic API test.
       operationId: UpdateAPITest
@@ -30723,6 +32205,10 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_write
   /api/v1/synthetics/tests/browser:
     post:
       description: Create a Synthetic browser test.
@@ -30772,6 +32258,10 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_write
   /api/v1/synthetics/tests/browser/{public_id}:
     get:
       description: 'Get the detailed configuration (including steps) associated with
@@ -30816,6 +32306,10 @@ paths:
       summary: Get a browser test
       tags:
       - Synthetics
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_read
     put:
       description: Edit the configuration of a Synthetic browser test.
       operationId: UpdateBrowserTest
@@ -30875,6 +32369,10 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_write
   /api/v1/synthetics/tests/browser/{public_id}/results:
     get:
       description: Get the last 150 test results summaries for a given Synthetic browser
@@ -30943,6 +32441,10 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_read
   /api/v1/synthetics/tests/browser/{public_id}/results/{result_id}:
     get:
       description: Get a specific full result from a given Synthetic browser test.
@@ -30993,6 +32495,10 @@ paths:
       summary: Get a browser test result
       tags:
       - Synthetics
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_read
   /api/v1/synthetics/tests/delete:
     post:
       description: Delete multiple Synthetic tests by ID.
@@ -31047,6 +32553,174 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_write
+  /api/v1/synthetics/tests/mobile:
+    post:
+      description: Create a Synthetic mobile test.
+      operationId: CreateSyntheticsMobileTest
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SyntheticsMobileTest'
+        description: Details of the test to create.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SyntheticsMobileTest'
+          description: OK - Returns the created test details.
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: '- JSON format is wrong
+
+            - Creation failed'
+        '402':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Test quota is reached
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - synthetics_write
+      summary: Create a mobile test
+      tags:
+      - Synthetics
+      x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_write
+  /api/v1/synthetics/tests/mobile/{public_id}:
+    get:
+      description: 'Get the detailed configuration associated with
+
+        a Synthetic Mobile test.'
+      operationId: GetMobileTest
+      parameters:
+      - description: The public ID of the test to get details from.
+        in: path
+        name: public_id
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SyntheticsMobileTest'
+          description: OK
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: '- Synthetic Monitoring is not activated for the user
+
+            - Test is not owned by the user'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - synthetics_read
+      summary: Get a Mobile test
+      tags:
+      - Synthetics
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_read
+    put:
+      description: Edit the configuration of a Synthetic Mobile test.
+      operationId: UpdateMobileTest
+      parameters:
+      - description: The public ID of the test to get details from.
+        in: path
+        name: public_id
+        required: true
+        schema:
+          type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SyntheticsMobileTest'
+        description: New test details to be saved.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SyntheticsMobileTest'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: '- JSON format is wrong
+
+            - Updating sub-type is forbidden'
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: '- Synthetic Monitoring is not activated for the user
+
+            - Test is not owned by the user
+
+            - Test can''t be found'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - synthetics_write
+      summary: Edit a Mobile test
+      tags:
+      - Synthetics
+      x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_write
   /api/v1/synthetics/tests/trigger:
     post:
       description: Trigger a set of Synthetic tests.
@@ -31082,6 +32756,10 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_write
   /api/v1/synthetics/tests/trigger/ci:
     post:
       description: Trigger a set of Synthetic tests for continuous integration.
@@ -31117,6 +32795,57 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_write
+  /api/v1/synthetics/tests/uptimes:
+    post:
+      description: Fetch uptime for multiple Synthetic tests by ID.
+      operationId: FetchUptimes
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SyntheticsFetchUptimesPayload'
+        description: Public ID list of the Synthetic tests and timeframe.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                items:
+                  $ref: '#/components/schemas/SyntheticsTestUptime'
+                type: array
+          description: OK.
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: '- JSON format is wrong'
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - synthetics_read
+      summary: Fetch uptime for multiple tests
+      tags:
+      - Synthetics
+      x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_read
   /api/v1/synthetics/tests/{public_id}:
     get:
       description: Get the detailed configuration associated with a Synthetic test.
@@ -31159,6 +32888,10 @@ paths:
       summary: Get a test configuration
       tags:
       - Synthetics
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_read
     patch:
       description: Patch the configuration of a Synthetic test with partial data.
       operationId: PatchTest
@@ -31218,6 +32951,10 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_write
   /api/v1/synthetics/tests/{public_id}/results:
     get:
       description: Get the last 150 test results summaries for a given Synthetic API
@@ -31284,6 +33021,10 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_read
   /api/v1/synthetics/tests/{public_id}/results/{result_id}:
     get:
       description: Get a specific full result from a given Synthetic API test.
@@ -31332,6 +33073,10 @@ paths:
       summary: Get an API test result
       tags:
       - Synthetics
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_read
   /api/v1/synthetics/tests/{public_id}/status:
     put:
       description: Pause or start a Synthetic test by changing the status.
@@ -31388,6 +33133,10 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_write
   /api/v1/synthetics/variables:
     get:
       description: Get the list of all Synthetic global variables.
@@ -31415,6 +33164,10 @@ paths:
       summary: Get all global variables
       tags:
       - Synthetics
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_global_variable_read
     post:
       description: Create a Synthetic global variable.
       operationId: CreateGlobalVariable
@@ -31461,6 +33214,10 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_global_variable_write
   /api/v1/synthetics/variables/{variable_id}:
     delete:
       description: Delete a Synthetic global variable.
@@ -31503,6 +33260,10 @@ paths:
       summary: Delete a global variable
       tags:
       - Synthetics
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_global_variable_write
     get:
       description: Get the detailed configuration of a global variable.
       operationId: GetGlobalVariable
@@ -31589,6 +33350,10 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_global_variable_write
   /api/v1/tags/hosts:
     get:
       description: Return a mapping of tags to hosts for your whole infrastructure.
@@ -31629,6 +33394,9 @@ paths:
       summary: Get Tags
       tags:
       - Tags
+      x-permission:
+        operator: OPEN
+        permissions: []
   /api/v1/tags/hosts/{host_name}:
     delete:
       description: 'This endpoint allows you to remove all user-assigned tags
@@ -31881,6 +33649,10 @@ paths:
       summary: Get hourly usage for analyzed logs
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/audit_logs:
     get:
       deprecated: true
@@ -31940,6 +33712,10 @@ paths:
       summary: Get hourly usage for audit logs
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/aws_lambda:
     get:
       deprecated: true
@@ -32000,6 +33776,10 @@ paths:
       summary: Get hourly usage for Lambda
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/billable-summary:
     get:
       description: 'Get billable usage across your account.
@@ -32058,6 +33838,10 @@ paths:
       summary: Get billable usage across your account
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/ci-app:
     get:
       deprecated: true
@@ -32120,6 +33904,10 @@ paths:
       summary: Get hourly usage for CI visibility
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/cspm:
     get:
       deprecated: true
@@ -32182,6 +33970,10 @@ paths:
       summary: Get hourly usage for CSM Pro
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/cws:
     get:
       deprecated: true
@@ -32244,6 +34036,10 @@ paths:
       summary: Get hourly usage for cloud workload security
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/dbm:
     get:
       deprecated: true
@@ -32306,6 +34102,10 @@ paths:
       summary: Get hourly usage for database monitoring
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/fargate:
     get:
       deprecated: true
@@ -32366,6 +34166,10 @@ paths:
       summary: Get hourly usage for Fargate
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/hosts:
     get:
       deprecated: true
@@ -32426,6 +34230,10 @@ paths:
       summary: Get hourly usage for hosts and containers
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/hourly-attribution:
     get:
       description: "Get hourly usage attribution. Multi-region data is available starting
@@ -32514,6 +34322,10 @@ paths:
       summary: Get hourly usage attribution
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/incident-management:
     get:
       deprecated: true
@@ -32576,6 +34388,10 @@ paths:
       summary: Get hourly usage for incident management
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/indexed-spans:
     get:
       deprecated: true
@@ -32636,6 +34452,10 @@ paths:
       summary: Get hourly usage for indexed spans
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/ingested-spans:
     get:
       deprecated: true
@@ -32698,6 +34518,10 @@ paths:
       summary: Get hourly usage for ingested spans
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/iot:
     get:
       deprecated: true
@@ -32760,6 +34584,10 @@ paths:
       summary: Get hourly usage for IoT
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/logs:
     get:
       deprecated: true
@@ -32820,6 +34648,10 @@ paths:
       summary: Get hourly usage for logs
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/logs-by-retention:
     get:
       deprecated: true
@@ -32882,6 +34714,10 @@ paths:
       summary: Get hourly logs usage by retention
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/logs_by_index:
     get:
       description: Get hourly usage for logs by index.
@@ -32944,6 +34780,10 @@ paths:
       summary: Get hourly usage for logs by index
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/monthly-attribution:
     get:
       description: "Get monthly usage attribution. Multi-region data is available
@@ -33045,6 +34885,10 @@ paths:
       summary: Get monthly usage attribution
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/network_flows:
     get:
       deprecated: true
@@ -33107,6 +34951,10 @@ paths:
       summary: get hourly usage for network flows
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/network_hosts:
     get:
       deprecated: true
@@ -33167,6 +35015,10 @@ paths:
       summary: Get hourly usage for network hosts
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/online-archive:
     get:
       deprecated: true
@@ -33229,6 +35081,10 @@ paths:
       summary: Get hourly usage for online archive
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/profiling:
     get:
       deprecated: true
@@ -33291,6 +35147,10 @@ paths:
       summary: Get hourly usage for profiled hosts
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/rum:
     get:
       deprecated: true
@@ -33352,6 +35212,10 @@ paths:
       summary: Get hourly usage for RUM units
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/rum_sessions:
     get:
       deprecated: true
@@ -33419,6 +35283,10 @@ paths:
       summary: Get hourly usage for RUM sessions
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/sds:
     get:
       deprecated: true
@@ -33481,6 +35349,10 @@ paths:
       summary: Get hourly usage for sensitive data scanner
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/snmp:
     get:
       deprecated: true
@@ -33543,6 +35415,10 @@ paths:
       summary: Get hourly usage for SNMP devices
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/summary:
     get:
       description: 'Get all usage across your account.
@@ -33617,6 +35493,10 @@ paths:
       summary: Get usage across your account
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/synthetics:
     get:
       deprecated: true
@@ -33677,6 +35557,10 @@ paths:
       summary: Get hourly usage for synthetics checks
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/synthetics_api:
     get:
       deprecated: true
@@ -33737,6 +35621,10 @@ paths:
       summary: Get hourly usage for synthetics API checks
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/synthetics_browser:
     get:
       deprecated: true
@@ -33797,6 +35685,10 @@ paths:
       summary: Get hourly usage for synthetics browser checks
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/timeseries:
     get:
       deprecated: true
@@ -33857,6 +35749,10 @@ paths:
       summary: Get hourly usage for custom metrics
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/usage/top_avg_metrics:
     get:
       description: Get all [custom metrics](https://docs.datadoghq.com/developers/metrics/custom_metrics/)
@@ -33940,6 +35836,10 @@ paths:
       summary: Get all custom metrics by hourly average
       tags:
       - Usage Metering
+      x-permission:
+        operator: OR
+        permissions:
+        - usage_read
   /api/v1/user:
     get:
       description: List all users for your organization.
@@ -33967,6 +35867,10 @@ paths:
       summary: List all users
       tags:
       - Users
+      x-permission:
+        operator: OR
+        permissions:
+        - user_access_read
     post:
       description: 'Create a user for your organization.
 
@@ -34013,6 +35917,10 @@ paths:
       tags:
       - Users
       x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+        - user_access_invite
   /api/v1/user/{user_handle}:
     delete:
       description: 'Delete a user from an organization.
@@ -34172,6 +36080,9 @@ paths:
       summary: Validate API key
       tags:
       - Authentication
+      x-permission:
+        operator: OPEN
+        permissions: []
   /v1/input:
     post:
       deprecated: true