datadog_api_client 2.9.0 → 2.11.0

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

@@ -830,6 +830,7 @@ components:
               type: string
             type: array
           description: A mapping of Monitor ID to strings denoting where it's used.
+          nullable: true
           type: object
       required:
       - data
@@ -1006,6 +1007,14 @@ components:
             description: A role UUID.
             type: string
           type: array
+        tags:
+          description: List of team names representing ownership of a dashboard.
+          items:
+            description: The name of a Datadog team of the form `team:<name>`
+            type: string
+          maxItems: 5
+          nullable: true
+          type: array
         template_variable_presets:
           description: Array of template variables saved views.
           items:
@@ -1084,10 +1093,46 @@ components:
           description: ID of the deleted dashboard.
           type: string
       type: object
+    DashboardGlobalTime:
+      description: Object containing the live span selection for the dashboard.
+      properties:
+        live_span:
+          $ref: '#/components/schemas/DashboardGlobalTimeLiveSpan'
+      type: object
+    DashboardGlobalTimeLiveSpan:
+      description: Dashboard global time live_span selection
+      enum:
+      - 15m
+      - 1h
+      - 4h
+      - 1d
+      - 2d
+      - 1w
+      - 1mo
+      - 3mo
+      example: 1h
+      type: string
+      x-enum-varnames:
+      - PAST_FIFTEEN_MINUTES
+      - PAST_ONE_HOUR
+      - PAST_FOUR_HOURS
+      - PAST_ONE_DAY
+      - PAST_TWO_DAYS
+      - PAST_ONE_WEEK
+      - PAST_ONE_MONTH
+      - PAST_THREE_MONTHS
     DashboardID:
       description: Dashboard resource ID.
       example: 123-abc-456
       type: string
+    DashboardInviteType:
+      description: Type for shared dashboard invitation request body.
+      enum:
+      - public_dashboard_invitation
+      example: public_dashboard_invitation
+      type: string
+      x-enum-varnames:
+      - PUBLIC_DASHBOARD_INVITATION
     DashboardLayoutType:
       description: Layout type of the dashboard.
       enum:
@@ -1192,6 +1237,17 @@ components:
       required:
       - data
       type: object
+    DashboardShareType:
+      description: Type of sharing access (either open to anyone who has the public
+        URL or invite-only).
+      enum:
+      - open
+      - invite
+      nullable: true
+      type: string
+      x-enum-varnames:
+      - OPEN
+      - INVITE
     DashboardSummary:
       description: Dashboard summary response.
       properties:
@@ -1318,6 +1374,23 @@ components:
           minItems: 1
           type: array
       type: object
+    DashboardType:
+      description: The type of the associated private dashboard.
+      enum:
+      - custom_timeboard
+      - custom_screenboard
+      example: custom_timeboard
+      type: string
+      x-enum-varnames:
+      - CUSTOM_TIMEBOARD
+      - CUSTOM_SCREENBOARD
+    DeleteSharedDashboardResponse:
+      description: Response containing token of deleted shared dashboard.
+      properties:
+        deleted_public_dashboard_token:
+          description: Token associated with the shared dashboard that was revoked.
+          type: string
+      type: object
     DeletedMonitor:
       description: Response from the delete monitor call.
       properties:
@@ -1639,6 +1712,7 @@ components:
             Email notifications can be sent to specific users by using the same `@username`
             notation as events.'
           example: Message on the downtime
+          nullable: true
           type: string
         monitor_id:
           description: 'A single monitor to which the downtime applies.
@@ -1670,6 +1744,10 @@ components:
             be muted.
           example: false
           type: boolean
+        notify_end_states:
+          $ref: '#/components/schemas/NotifyEndStates'
+        notify_end_types:
+          $ref: '#/components/schemas/NotifyEndTypes'
         parent_id:
           description: ID of the parent Downtime.
           example: 123
@@ -1774,6 +1852,7 @@ components:
             Email notifications can be sent to specific users by using the same `@username`
             notation as events.'
           example: Message on the downtime
+          nullable: true
           type: string
         monitor_id:
           description: 'A single monitor to which the downtime applies.
@@ -1805,6 +1884,10 @@ components:
             be muted.
           example: false
           type: boolean
+        notify_end_states:
+          $ref: '#/components/schemas/NotifyEndStates'
+        notify_end_types:
+          $ref: '#/components/schemas/NotifyEndTypes'
         parent_id:
           description: ID of the parent Downtime.
           example: 123
@@ -2645,6 +2728,7 @@ components:
       - $ref: '#/components/schemas/FormulaAndFunctionProcessQueryDefinition'
       - $ref: '#/components/schemas/FormulaAndFunctionApmDependencyStatsQueryDefinition'
       - $ref: '#/components/schemas/FormulaAndFunctionApmResourceStatsQueryDefinition'
+      - $ref: '#/components/schemas/FormulaAndFunctionSLOQueryDefinition'
       type: object
     FormulaAndFunctionResponseFormat:
       description: Timeseries or Scalar response.
@@ -2656,6 +2740,81 @@ components:
       x-enum-varnames:
       - TIMESERIES
       - SCALAR
+    FormulaAndFunctionSLODataSource:
+      description: Data source for SLO measures queries.
+      enum:
+      - slo
+      example: slo
+      type: string
+      x-enum-varnames:
+      - SLO
+    FormulaAndFunctionSLOGroupMode:
+      description: Group mode to query measures.
+      enum:
+      - overall
+      - components
+      example: overall
+      type: string
+      x-enum-varnames:
+      - OVERALL
+      - COMPONENTS
+    FormulaAndFunctionSLOMeasure:
+      description: SLO measures queries.
+      enum:
+      - good_events
+      - bad_events
+      - slo_status
+      - error_budget_remaining
+      - burn_rate
+      - error_budget_burndown
+      example: slo_status
+      type: string
+      x-enum-varnames:
+      - GOOD_EVENTS
+      - BAD_EVENTS
+      - SLO_STATUS
+      - ERROR_BUDGET_REMAINING
+      - BURN_RATE
+      - ERROR_BUDGET_BURNDOWN
+    FormulaAndFunctionSLOQueryDefinition:
+      description: A formula and functions metrics query.
+      example:
+        data_source: slo
+        group_mode: overall
+        measure: good_events
+        name: my_slo
+        slo_id: '12345678910'
+        slo_query_type: metric
+      properties:
+        data_source:
+          $ref: '#/components/schemas/FormulaAndFunctionSLODataSource'
+        group_mode:
+          $ref: '#/components/schemas/FormulaAndFunctionSLOGroupMode'
+        measure:
+          $ref: '#/components/schemas/FormulaAndFunctionSLOMeasure'
+        name:
+          description: Name of the query for use in formulas.
+          example: my_slo
+          type: string
+        slo_id:
+          description: ID of an SLO to query measures.
+          example: '12345678910'
+          type: string
+        slo_query_type:
+          $ref: '#/components/schemas/FormulaAndFunctionSLOQueryType'
+      required:
+      - data_source
+      - slo_id
+      - measure
+      type: object
+    FormulaAndFunctionSLOQueryType:
+      description: Name of the query for use in formulas.
+      enum:
+      - metric
+      example: metric
+      type: string
+      x-enum-varnames:
+      - METRIC
     FreeTextWidgetDefinition:
       description: Free text is a widget that allows you to add headings to your screenboard.
         Commonly used to state the overall purpose of the dashboard. Only available
@@ -3254,6 +3413,7 @@ components:
         mute_timeout:
           description: Timeout of the mute applied to your host.
           format: int64
+          nullable: true
           type: integer
         name:
           description: The host name.
@@ -3598,6 +3758,10 @@ components:
         public_id:
           description: The organization public ID.
           type: string
+        region:
+          description: The region of the Datadog instance that the organization belongs
+            to.
+          type: string
         tag_config_source:
           description: The source of the usage attribution tag configuration and the
             selected tags in the format of `<source_org_name>:::<selected tag 1>///<selected
@@ -3655,6 +3819,7 @@ components:
       - container_usage
       - cspm_containers_usage
       - cspm_hosts_usage
+      - custom_ingested_timeseries_usage
       - custom_timeseries_usage
       - cws_containers_usage
       - cws_hosts_usage
@@ -3669,11 +3834,14 @@ components:
       - infra_host_usage
       - invocations_usage
       - npm_host_usage
+      - obs_pipeline_bytes_usage
       - profiled_container_usage
       - profiled_fargate_usage
       - profiled_host_usage
       - snmp_usage
       - estimated_rum_sessions_usage
+      - universal_service_monitoring_usage
+      - vuln_management_hosts_usage
       type: string
       x-enum-varnames:
       - API_USAGE
@@ -3686,6 +3854,7 @@ components:
       - CONTAINER_USAGE
       - CSPM_CONTAINERS_USAGE
       - CSPM_HOSTS_USAGE
+      - CUSTOM_INGESTED_TIMESERIES_USAGE
       - CUSTOM_TIMESERIES_USAGE
       - CWS_CONTAINERS_USAGE
       - CWS_HOSTS_USAGE
@@ -3700,11 +3869,14 @@ components:
       - INFRA_HOST_USAGE
       - INVOCATIONS_USAGE
       - NPM_HOST_USAGE
+      - OBS_PIPELINE_BYTES_USAGE
       - PROFILED_CONTAINER_USAGE
       - PROFILED_FARGATE_USAGE
       - PROFILED_HOST_USAGE
       - SNMP_USAGE
       - ESTIMATED_RUM_SESSIONS_USAGE
+      - UNIVERSAL_SERVICE_MONITORING_USAGE
+      - VULN_MANAGEMENT_HOSTS_USAGE
     IFrameWidgetDefinition:
       description: The iframe widget allows you to embed a portion of any other web
         page on your dashboard. Only available on FREE layout dashboards.
@@ -4117,6 +4289,8 @@ components:
           description: Widget query.
           example: '@service:app'
           type: string
+        sort:
+          $ref: '#/components/schemas/WidgetFieldSort'
         storage:
           description: Option for storage location. Feature in Private Beta.
           example: indexes
@@ -5076,6 +5250,7 @@ components:
           description: 'Hash identifier of the next log to return in the list.
 
             This parameter is used for the pagination feature.'
+          nullable: true
           type: string
         status:
           description: Status of the response.
@@ -5658,6 +5833,43 @@ components:
       type: string
       x-enum-varnames:
       - USER_AGENT_PARSER
+    MatchingDowntime:
+      description: Object describing a downtime that matches this monitor.
+      properties:
+        end:
+          description: POSIX timestamp to end the downtime.
+          example: 1412792983
+          format: int64
+          nullable: true
+          type: integer
+        id:
+          description: The downtime ID.
+          example: 1625
+          format: int64
+          readOnly: true
+          type: integer
+        scope:
+          description: 'The scope(s) to which the downtime applies. Must be in `key:value`
+            format. For example, `host:app2`.
+
+            Provide multiple scopes as a comma-separated list like `env:dev,env:prod`.
+
+            The resulting downtime applies to sources that matches ALL provided scopes
+            (`env:dev` **AND** `env:prod`).'
+          example:
+          - env:staging
+          items:
+            description: A scope. For example, `"env:staging"`.
+            type: string
+          type: array
+        start:
+          description: POSIX timestamp to start the downtime.
+          example: 1412792983
+          format: int64
+          type: integer
+      required:
+      - id
+      type: object
     MetricContentEncoding:
       default: deflate
       description: HTTP header used to compress the media-type.
@@ -5772,7 +5984,7 @@ components:
           readOnly: true
           type: string
         interval:
-          description: Number of seconds between data samples.
+          description: Number of milliseconds between data samples.
           format: int64
           readOnly: true
           type: integer
@@ -5787,10 +5999,10 @@ components:
           readOnly: true
           type: string
         pointlist:
-          description: List of points of the time series.
+          description: List of points of the time series in milliseconds.
           example:
-          - - 1575317847.0
-            - 0.5
+          - - 1681683300000.0
+            - 77.62145685254418
           items:
             $ref: '#/components/schemas/Point'
           readOnly: true
@@ -5938,6 +6150,11 @@ components:
           format: int64
           readOnly: true
           type: integer
+        matching_downtimes:
+          description: A list of active downtimes that match this monitor.
+          items:
+            $ref: '#/components/schemas/MatchingDowntime'
+          type: array
         message:
           description: A message to include with notifications for this monitor.
           type: string
@@ -7056,6 +7273,10 @@ components:
         public_id:
           description: The organization public ID.
           type: string
+        region:
+          description: The region of the Datadog instance that the organization belongs
+            to.
+          type: string
         tag_config_source:
           description: The source of the usage attribution tag configuration and the
             selected tags in the format `<source_org_name>:::<selected tag 1>///<selected
@@ -7123,6 +7344,8 @@ components:
       - cspm_hosts_usage
       - custom_timeseries_usage
       - custom_timeseries_percentage
+      - custom_ingested_timeseries_usage
+      - custom_ingested_timeseries_percentage
       - cws_containers_percentage
       - cws_containers_usage
       - cws_hosts_percentage
@@ -7149,6 +7372,8 @@ components:
       - invocations_percentage
       - npm_host_usage
       - npm_host_percentage
+      - obs_pipeline_bytes_usage
+      - obs_pipeline_bytes_percentage
       - profiled_container_usage
       - profiled_container_percentage
       - profiled_fargate_usage
@@ -7159,6 +7384,10 @@ components:
       - snmp_percentage
       - estimated_rum_sessions_usage
       - estimated_rum_sessions_percentage
+      - universal_service_monitoring_usage
+      - universal_service_monitoring_percentage
+      - vuln_management_hosts_usage
+      - vuln_management_hosts_percentage
       - '*'
       type: string
       x-enum-varnames:
@@ -7184,6 +7413,8 @@ components:
       - CSPM_HOSTS_USAGE
       - CUSTOM_TIMESERIES_USAGE
       - CUSTOM_TIMESERIES_PERCENTAGE
+      - CUSTOM_INGESTED_TIMESERIES_USAGE
+      - CUSTOM_INGESTED_TIMESERIES_PERCENTAGE
       - CWS_CONTAINERS_PERCENTAGE
       - CWS_CONTAINERS_USAGE
       - CWS_HOSTS_PERCENTAGE
@@ -7210,6 +7441,8 @@ components:
       - INVOCATIONS_PERCENTAGE
       - NPM_HOST_USAGE
       - NPM_HOST_PERCENTAGE
+      - OBS_PIPELINE_BYTES_USAGE
+      - OBS_PIPELINE_BYTES_PERCENTAGE
       - PROFILED_CONTAINER_USAGE
       - PROFILED_CONTAINER_PERCENTAGE
       - PROFILED_FARGATE_USAGE
@@ -7220,6 +7453,10 @@ components:
       - SNMP_PERCENTAGE
       - ESTIMATED_RUM_SESSIONS_USAGE
       - ESTIMATED_RUM_SESSIONS_PERCENTAGE
+      - UNIVERSAL_SERVICE_MONITORING_USAGE
+      - UNIVERSAL_SERVICE_MONITORING_PERCENTAGE
+      - VULN_MANAGEMENT_HOSTS_USAGE
+      - VULN_MANAGEMENT_HOSTS_PERCENTAGE
       - ALL
     MonthlyUsageAttributionValues:
       description: Fields in Usage Summary by tag(s).
@@ -7308,12 +7545,20 @@ components:
           description: The CSPM host usage by tag(s).
           format: double
           type: number
+        custom_ingested_timeseries_percentage:
+          description: The percentage of ingested custom metrics usage by tag(s).
+          format: double
+          type: number
+        custom_ingested_timeseries_usage:
+          description: The ingested custom metrics usage by tag(s).
+          format: double
+          type: number
         custom_timeseries_percentage:
-          description: The percentage of custom metrics usage by tag(s).
+          description: The percentage of indexed custom metrics usage by tag(s).
           format: double
           type: number
         custom_timeseries_usage:
-          description: The custom metrics usage by tag(s).
+          description: The indexed custom metrics usage by tag(s).
           format: double
           type: number
         cws_containers_percentage:
@@ -7429,6 +7674,14 @@ components:
           description: The network host usage by tag(s).
           format: double
           type: number
+        obs_pipeline_bytes_percentage:
+          description: The percentage of observability pipeline bytes usage by tag(s).
+          format: double
+          type: number
+        obs_pipeline_bytes_usage:
+          description: The observability pipeline bytes usage by tag(s).
+          format: double
+          type: number
         profiled_container_percentage:
           description: The percentage of profiled container usage by tag(s).
           format: double
@@ -7461,6 +7714,23 @@ components:
           description: The network device usage by tag(s).
           format: double
           type: number
+        universal_service_monitoring_percentage:
+          description: The percentage of universal service monitoring usage by tag(s).
+          format: double
+          type: number
+        universal_service_monitoring_usage:
+          description: The universal service monitoring usage by tag(s).
+          format: double
+          type: number
+        vuln_management_hosts_percentage:
+          description: The percentage of Application Vulnerability Management usage
+            by tag(s).
+          format: double
+          type: number
+        vuln_management_hosts_usage:
+          description: The Application Vulnerability Management usage by tag(s).
+          format: double
+          type: number
       type: object
     NoteWidgetDefinition:
       description: The notes and links widget is similar to free text widget, but
@@ -8286,6 +8556,60 @@ components:
           format: int64
           type: integer
       type: object
+    NotifyEndState:
+      description: A notification end state.
+      enum:
+      - alert
+      - no data
+      - warn
+      example: alert
+      type: string
+      x-enum-varnames:
+      - ALERT
+      - NO_DATA
+      - WARN
+    NotifyEndStates:
+      default:
+      - alert
+      - no data
+      - warn
+      description: States for which `notify_end_types` sends out notifications for.
+      example:
+      - alert
+      - no data
+      - warn
+      items:
+        $ref: '#/components/schemas/NotifyEndState'
+      type: array
+    NotifyEndType:
+      description: A notification end type.
+      enum:
+      - canceled
+      - expired
+      example: expired
+      type: string
+      x-enum-varnames:
+      - CANCELED
+      - EXPIRED
+    NotifyEndTypes:
+      default:
+      - expired
+      description: 'If set, notifies if a monitor is in an alert-worthy state (`ALERT`,
+        `WARNING`, or `NO DATA`)
+
+        when this downtime expires or is canceled. Applied to monitors that change
+        states during
+
+        the downtime (such as from `OK` to `ALERT`, `WARNING`, or `NO DATA`), and
+        to monitors that
+
+        already have an alert-worthy state when downtime begins.'
+      example:
+      - canceled
+      - expired
+      items:
+        $ref: '#/components/schemas/NotifyEndType'
+      type: array
     OnMissingDataOption:
       description: 'Controls how groups or monitors are treated if an evaluation does
         not return any data points.
@@ -9003,6 +9327,7 @@ components:
         created_at:
           description: The epoch timestamp of when the correction was created at.
           format: int64
+          nullable: true
           type: integer
         creator:
           $ref: '#/components/schemas/Creator'
@@ -9019,10 +9344,12 @@ components:
         end:
           description: Ending time of the correction in epoch seconds.
           format: int64
+          nullable: true
           type: integer
         modified_at:
           description: The epoch timestamp of when the correction was modified at.
           format: int64
+          nullable: true
           type: integer
         modifier:
           $ref: '#/components/schemas/SLOCorrectionResponseAttributesModifier'
@@ -9133,6 +9460,7 @@ components:
           type: integer
         name:
           description: Name of the creator.
+          nullable: true
           type: string
       type: object
     SLODeleteResponse:
@@ -9404,6 +9732,7 @@ components:
           description: The current SLI value of the SLO over the history window.
           example: 99.99
           format: double
+          nullable: true
           type: number
         span_precision:
           description: The amount of decimal places the SLI value is accurate to for
@@ -9428,6 +9757,7 @@ components:
             level objective.
           items:
             $ref: '#/components/schemas/SLOHistoryResponseError'
+          nullable: true
           type: array
       type: object
     SLOHistoryResponseData:
@@ -9588,6 +9918,7 @@ components:
           description: The current SLI value of the SLO over the history window.
           example: 99.99
           format: double
+          nullable: true
           type: number
         span_precision:
           description: The amount of decimal places the SLI value is accurate to for
@@ -9600,6 +9931,7 @@ components:
           description: Use `sli_value` instead.
           example: 99.99
           format: double
+          nullable: true
           type: number
       type: object
     SLOListResponse:
@@ -10101,6 +10433,9 @@ components:
       description: Use the SLO and uptime widget to track your SLOs (Service Level
         Objectives) and uptime on screenboards and timeboards.
       properties:
+        additional_query_filters:
+          description: Additional filters applied to the SLO query.
+          type: string
         global_time_target:
           description: Defined global time target.
           type: string
@@ -10683,6 +11018,28 @@ components:
           description: The type of the object, must be `slo`.
           type: string
       type: object
+    SelectableTemplateVariableItems:
+      description: Object containing the template variable's name, associated tag/attribute,
+        default value and selectable values.
+      properties:
+        default_value:
+          description: The default value of the template variable.
+          type: string
+        name:
+          description: Name of the template variable.
+          type: string
+        prefix:
+          description: The tag/attribute key associated with the template variable.
+          type: string
+        visible_tags:
+          description: List of visible tag values on the shared dashboard.
+          items:
+            description: Other values for this tag that can be selected on the shared
+              dashboard.
+            type: string
+          nullable: true
+          type: array
+      type: object
     Series:
       description: 'A metric to submit to Datadog.
 
@@ -11178,49 +11535,305 @@ components:
       type: string
       x-enum-varnames:
       - TRACE_SERVICE
-    SignalArchiveReason:
-      description: Reason why a signal has been archived.
-      enum:
-      - none
-      - false_positive
-      - testing_or_maintenance
-      - other
-      type: string
-      x-enum-varnames:
-      - NONE
-      - FALSE_POSITIVE
-      - TESTING_OR_MAINTENANCE
-      - OTHER
-    SignalAssigneeUpdateRequest:
-      description: Attributes describing an assignee update operation over a security
-        signal.
+    SharedDashboard:
+      description: The metadata object associated with how a dashboard has been/will
+        be shared.
       properties:
-        assignee:
-          description: The UUID of the user being assigned. Use empty string to return
-            signal to unassigned.
-          example: 773b045d-ccf8-4808-bd3b-955ef6a8c940
+        author:
+          $ref: '#/components/schemas/SharedDashboardAuthor'
+        created_at:
+          description: Date the dashboard was shared.
+          format: date-time
+          readOnly: true
+          type: string
+        dashboard_id:
+          description: ID of the dashboard to share.
+          example: 123-abc-456
+          type: string
+        dashboard_type:
+          $ref: '#/components/schemas/DashboardType'
+        global_time:
+          $ref: '#/components/schemas/DashboardGlobalTime'
+        global_time_selectable_enabled:
+          description: Whether to allow viewers to select a different global time
+            setting for the shared dashboard.
+          nullable: true
+          type: boolean
+        public_url:
+          description: URL of the shared dashboard.
+          readOnly: true
+          type: string
+        selectable_template_vars:
+          description: List of objects representing template variables on the shared
+            dashboard which can have selectable values.
+          example:
+          - default_value: '*'
+            name: exampleVar
+            prefix: test
+            visible_tags:
+            - selectableValue1
+            - selectableValue2
+          items:
+            $ref: '#/components/schemas/SelectableTemplateVariableItems'
+          nullable: true
+          type: array
+        share_list:
+          description: List of email addresses that can receive an invitation to access
+            to the shared dashboard.
+          example:
+          - test@datadoghq.com
+          - test2@email.com
+          items:
+            description: Email address that can receive an invitation to access the
+              shared dashboard.
+            format: email
+            type: string
+          nullable: true
+          type: array
+        share_type:
+          $ref: '#/components/schemas/DashboardShareType'
+        token:
+          description: A unique token assigned to the shared dashboard.
+          readOnly: true
           type: string
-        version:
-          $ref: '#/components/schemas/Version'
       required:
-      - assignee
+      - dashboard_id
+      - dashboard_type
       type: object
-    SignalStateUpdateRequest:
-      description: Attributes describing the change of state for a given state.
+    SharedDashboardAuthor:
+      description: User who shared the dashboard.
       properties:
-        archiveComment:
-          description: Optional comment to explain why a signal is being archived.
+        handle:
+          description: Identifier of the user who shared the dashboard.
+          example: test@datadoghq.com
+          readOnly: true
           type: string
-        archiveReason:
-          $ref: '#/components/schemas/SignalArchiveReason'
-        state:
-          $ref: '#/components/schemas/SignalTriageState'
-        version:
-          $ref: '#/components/schemas/Version'
+        name:
+          description: Name of the user who shared the dashboard.
+          nullable: true
+          readOnly: true
+          type: string
+      readOnly: true
+      type: object
+    SharedDashboardInvites:
+      description: Invitations data and metadata that exists for a shared dashboard
+        returned by the API.
+      example:
+        data:
+        - attributes:
+            email: test@datadoghq.com
+          type: public_dashboard_invitation
+      properties:
+        data:
+          $ref: '#/components/schemas/SharedDashboardInvitesData'
+        meta:
+          $ref: '#/components/schemas/SharedDashboardInvitesMeta'
       required:
-      - state
+      - data
       type: object
-    SignalTriageState:
+    SharedDashboardInvitesData:
+      description: An object or list of objects containing the information for an
+        invitation to a shared dashboard.
+      example:
+      - attributes:
+          email: test@datadoghq.com
+        type: public_dashboard_invitation
+      oneOf:
+      - $ref: '#/components/schemas/SharedDashboardInvitesDataObject'
+      - $ref: '#/components/schemas/SharedDashboardInvitesDataList'
+    SharedDashboardInvitesDataList:
+      description: A list of objects containing the information for an invitation(s)
+        to a shared dashboard.
+      example:
+      - attributes:
+          email: test@datadoghq.com
+        type: public_dashboard_invitation
+      items:
+        $ref: '#/components/schemas/SharedDashboardInvitesDataObject'
+      type: array
+    SharedDashboardInvitesDataObject:
+      description: Object containing the information for an invitation to a shared
+        dashboard.
+      example:
+        attributes:
+          created_at: '2020-12-07T20:16:27.846985+00:00'
+          email: test@datadoghq.com
+          has_session: false
+          invitation_expiry: '2020-12-07T21:16:27.840542+00:00'
+          session_expiry: null
+          share_token: XXXXXX-123456abcedfg7890hijklmnopqrstuv
+        type: public_dashboard_invitation
+      properties:
+        attributes:
+          $ref: '#/components/schemas/SharedDashboardInvitesDataObjectAttributes'
+        type:
+          $ref: '#/components/schemas/DashboardInviteType'
+      required:
+      - type
+      - attributes
+      type: object
+    SharedDashboardInvitesDataObjectAttributes:
+      description: Attributes of the shared dashboard invitation
+      example:
+        created_at: '2020-12-07T20:16:27.846985+00:00'
+        email: test@datadoghq.com
+        has_session: false
+        invitation_expiry: '2020-12-07T21:16:27.840542+00:00'
+        session_expiry: null
+        share_token: XXXXXX-123456abcedfg7890hijklmnopqrstuv
+      properties:
+        created_at:
+          description: When the invitation was sent.
+          format: date-time
+          readOnly: true
+          type: string
+        email:
+          description: An email address that an invitation has been (or if used in
+            invitation request, will be) sent to.
+          nullable: false
+          type: string
+        has_session:
+          description: Indicates whether an active session exists for the invitation
+            (produced when a user clicks the link in the email).
+          readOnly: true
+          type: boolean
+        invitation_expiry:
+          description: When the invitation expires.
+          format: date-time
+          readOnly: true
+          type: string
+        session_expiry:
+          description: When the invited user's session expires. null if the invitation
+            has no associated session.
+          format: date-time
+          nullable: true
+          readOnly: true
+          type: string
+        share_token:
+          description: The unique token of the shared dashboard that was (or is to
+            be) shared.
+          readOnly: true
+          type: string
+      type: object
+    SharedDashboardInvitesMeta:
+      description: Pagination metadata returned by the API.
+      properties:
+        page:
+          $ref: '#/components/schemas/SharedDashboardInvitesMetaPage'
+      readOnly: true
+      type: object
+    SharedDashboardInvitesMetaPage:
+      description: Object containing the total count of invitations across all pages
+      properties:
+        total_count:
+          description: The total number of invitations on this shared board, across
+            all pages.
+          format: int64
+          type: integer
+      type: object
+    SharedDashboardUpdateRequest:
+      description: Update a shared dashboard's settings.
+      example:
+        global_time:
+          live_span: 1h
+        share_list:
+        - test@datadoghq.com
+        - test2@datadoghq.com
+        share_type: invite
+      properties:
+        global_time:
+          $ref: '#/components/schemas/SharedDashboardUpdateRequestGlobalTime'
+        global_time_selectable_enabled:
+          description: Whether to allow viewers to select a different global time
+            setting for the shared dashboard.
+          nullable: true
+          type: boolean
+        selectable_template_vars:
+          description: List of objects representing template variables on the shared
+            dashboard which can have selectable values.
+          example:
+          - default_value: '*'
+            name: exampleVar
+            prefix: test
+            visible_tags:
+            - selectableValue1
+            - selectableValue2
+          items:
+            $ref: '#/components/schemas/SelectableTemplateVariableItems'
+          nullable: true
+          type: array
+        share_list:
+          description: List of email addresses that can be given access to the shared
+            dashboard.
+          example:
+          - test@datadoghq.com
+          - test2@email.com
+          items:
+            description: Email address that can receive an invitation to access the
+              shared dashboard.
+            format: email
+            type: string
+          nullable: true
+          type: array
+        share_type:
+          $ref: '#/components/schemas/DashboardShareType'
+      required:
+      - global_time
+      type: object
+    SharedDashboardUpdateRequestGlobalTime:
+      description: Timeframe setting for the shared dashboard.
+      example:
+        live_span: 1h
+      nullable: true
+      properties:
+        live_span:
+          $ref: '#/components/schemas/DashboardGlobalTimeLiveSpan'
+      type: object
+    SignalArchiveReason:
+      description: Reason why a signal has been archived.
+      enum:
+      - none
+      - false_positive
+      - testing_or_maintenance
+      - investigated_case_opened
+      - other
+      type: string
+      x-enum-varnames:
+      - NONE
+      - FALSE_POSITIVE
+      - TESTING_OR_MAINTENANCE
+      - INVESTIGATED_CASE_OPENED
+      - OTHER
+    SignalAssigneeUpdateRequest:
+      description: Attributes describing an assignee update operation over a security
+        signal.
+      properties:
+        assignee:
+          description: The UUID of the user being assigned. Use empty string to return
+            signal to unassigned.
+          example: 773b045d-ccf8-4808-bd3b-955ef6a8c940
+          type: string
+        version:
+          $ref: '#/components/schemas/Version'
+      required:
+      - assignee
+      type: object
+    SignalStateUpdateRequest:
+      description: Attributes describing the change of state for a given state.
+      properties:
+        archiveComment:
+          description: Optional comment to explain why a signal is being archived.
+          type: string
+        archiveReason:
+          $ref: '#/components/schemas/SignalArchiveReason'
+        state:
+          $ref: '#/components/schemas/SignalTriageState'
+        version:
+          $ref: '#/components/schemas/Version'
+      required:
+      - state
+      type: object
+    SignalTriageState:
       description: The new triage state of the signal.
       enum:
       - open
@@ -11418,7 +12031,7 @@ components:
           $ref: '#/components/schemas/LogQueryDefinition'
       type: object
     SyntheticsAPIStep:
-      description: The steps used in a Synthetics multistep API test.
+      description: The steps used in a Synthetic multistep API test.
       properties:
         allowFailure:
           description: Determines whether or not to continue with test if this step
@@ -11846,6 +12459,8 @@ components:
       - networkHop
       - receivedMessage
       - grpcHealthcheckStatus
+      - grpcMetadata
+      - grpcProto
       - connection
       example: statusCode
       type: string
@@ -11866,6 +12481,8 @@ components:
       - NETWORK_HOP
       - RECEIVED_MESSAGE
       - GRPC_HEALTHCHECK_STATUS
+      - GRPC_METADATA
+      - GRPC_PROTO
       - CONNECTION
     SyntheticsAssertionXPathOperator:
       description: Assertion operator to apply.
@@ -12180,7 +12797,7 @@ components:
           $ref: '#/components/schemas/SyntheticsStatus'
       type: object
     SyntheticsBatchResult:
-      description: Object with the results of a Synthetics batch.
+      description: Object with the results of a Synthetic batch.
       properties:
         device:
           $ref: '#/components/schemas/SyntheticsDeviceID'
@@ -12585,7 +13202,7 @@ components:
     SyntheticsBrowserVariable:
       description: 'Object defining a variable that can be used in your browser test.
 
-        Learn more in the [Browser test Actions documentation](https://docs.datadoghq.com/synthetics/browser_tests/actions#variable).'
+        See the [Recording Steps documentation](https://docs.datadoghq.com/synthetics/browser_tests/actions/?tab=testanelementontheactivepage#variables).'
       properties:
         example:
           description: Example for the variable.
@@ -12600,6 +13217,10 @@ components:
         pattern:
           description: Pattern of the variable.
           type: string
+        secure:
+          description: Determines whether or not the browser test variable is obfuscated.
+            Can only be used with browser variables of type `text`.
+          type: boolean
         type:
           $ref: '#/components/schemas/SyntheticsBrowserVariableType'
       required:
@@ -12623,7 +13244,7 @@ components:
       - JAVASCRIPT
       - TEXT
     SyntheticsCIBatchMetadata:
-      description: Metadata for the Synthetics tests run.
+      description: Metadata for the Synthetic tests run.
       properties:
         ci:
           $ref: '#/components/schemas/SyntheticsCIBatchMetadataCI'
@@ -12663,7 +13284,7 @@ components:
           type: string
       type: object
     SyntheticsCITest:
-      description: Test configuration for Synthetics CI
+      description: Configuration for Continuous Testing.
       properties:
         allowInsecureCertificates:
           description: Disable certificate checks in API tests.
@@ -12674,7 +13295,7 @@ components:
           description: Body to include in the test.
           type: string
         bodyType:
-          description: Type of the data sent in a synthetics API test.
+          description: Type of the data sent in a Synthetic API test.
           type: string
         cookies:
           description: Cookies for the request.
@@ -12701,7 +13322,7 @@ components:
         metadata:
           $ref: '#/components/schemas/SyntheticsCIBatchMetadata'
         public_id:
-          description: The public ID of the Synthetics test to trigger.
+          description: The public ID of the Synthetic test to trigger.
           example: aaa-aaa-aaa
           type: string
         retry:
@@ -12935,7 +13556,7 @@ components:
           type: array
       type: object
     SyntheticsGlobalVariable:
-      description: Synthetics global variable.
+      description: Synthetic global variable.
       properties:
         attributes:
           $ref: '#/components/schemas/SyntheticsGlobalVariableAttributes'
@@ -12948,7 +13569,7 @@ components:
           readOnly: true
           type: string
         name:
-          description: Name of the global variable. Unique across Synthetics global
+          description: Name of the global variable. Unique across Synthetic global
             variables.
           example: MY_VARIABLE
           type: string
@@ -12989,8 +13610,8 @@ components:
           $ref: '#/components/schemas/SyntheticsGlobalVariableTOTPParameters'
       type: object
     SyntheticsGlobalVariableParseTestOptions:
-      description: Parser options to use for retrieving a Synthetics global variable
-        from a Synthetics Test. Used in conjunction with `parse_test_public_id`.
+      description: Parser options to use for retrieving a Synthetic global variable
+        from a Synthetic test. Used in conjunction with `parse_test_public_id`.
       properties:
         field:
           description: When type is `http_header`, name of the header to use to extract
@@ -13010,7 +13631,7 @@ components:
       - type
       type: object
     SyntheticsGlobalVariableParseTestOptionsType:
-      description: Property of the Synthetics Test Response to use for a Synthetics
+      description: Property of the Synthetic Test Response to use for a Synthetic
         global variable.
       enum:
       - http_body
@@ -13023,7 +13644,7 @@ components:
       - HTTP_HEADER
       - LOCAL_VARIABLE
     SyntheticsGlobalVariableParserType:
-      description: Type of parser for a Synthetics global variable from a synthetics
+      description: Type of parser for a Synthetic global variable from a synthetics
         test.
       enum:
       - raw
@@ -13105,10 +13726,10 @@ components:
           type: string
       type: object
     SyntheticsLocations:
-      description: List of Synthetics locations.
+      description: List of Synthetic locations.
       properties:
         locations:
-          description: List of Synthetics locations.
+          description: List of Synthetic locations.
           items:
             $ref: '#/components/schemas/SyntheticsLocation'
           type: array
@@ -13127,6 +13748,9 @@ components:
           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/SyntheticsGlobalVariableParseTestOptionsType'
       type: object
@@ -13352,7 +13976,7 @@ components:
       - skipped
       - failed
     SyntheticsStep:
-      description: The steps used in a Synthetics browser test.
+      description: The steps used in a Synthetic browser test.
       properties:
         allowFailure:
           description: A boolean set to allow this step to fail.
@@ -13413,7 +14037,7 @@ components:
           format: int64
           type: integer
         subTestStepDetails:
-          description: 'If this steps include a sub-test.
+          description: 'If this step includes a sub-test.
 
             [Subtests documentation](https://docs.datadoghq.com/synthetics/browser_tests/advanced_options/#subtests).'
           items:
@@ -13636,7 +14260,7 @@ components:
       - API
       - BROWSER
     SyntheticsTestExecutionRule:
-      description: Execution rule for a Synthetics test.
+      description: Execution rule for a Synthetic test.
       enum:
       - blocking
       - non_blocking
@@ -13896,6 +14520,10 @@ components:
             example: ''
             type: string
           type: array
+        compressedJsonDescriptor:
+          description: A protobuf JSON descriptor that needs to be gzipped first then
+            base64 encoded.
+          type: string
         dnsServer:
           description: DNS server to use for DNS tests.
           type: string
@@ -14021,7 +14649,7 @@ components:
       description: 'Object containing all metrics and their values collected for a
         Synthetic API test.
 
-        Learn more about those metrics in [Synthetics documentation](https://docs.datadoghq.com/synthetics/#metrics).'
+        See the [Synthetic Monitoring Metrics documentation](https://docs.datadoghq.com/synthetics/metrics/).'
       properties:
         dns:
           description: The duration in millisecond of the DNS lookup.
@@ -14061,10 +14689,10 @@ components:
           type: number
       type: object
     SyntheticsTriggerBody:
-      description: Object describing the synthetics tests to trigger.
+      description: Object describing the Synthetic tests to trigger.
       properties:
         tests:
-          description: Individual synthetics test.
+          description: Individual Synthetic test.
           items:
             $ref: '#/components/schemas/SyntheticsTriggerTest'
           type: array
@@ -14072,7 +14700,7 @@ components:
       - tests
       type: object
     SyntheticsTriggerCITestLocation:
-      description: Synthetics location.
+      description: Synthetic location.
       properties:
         id:
           description: Unique identifier of the location.
@@ -14092,7 +14720,7 @@ components:
           format: int64
           type: integer
         public_id:
-          description: The public ID of the Synthetics test.
+          description: The public ID of the Synthetic test.
           type: string
         result_id:
           description: ID of the result.
@@ -14106,7 +14734,7 @@ components:
           nullable: true
           type: string
         locations:
-          description: List of Synthetics locations.
+          description: List of Synthetic locations.
           items:
             $ref: '#/components/schemas/SyntheticsTriggerCITestLocation'
           type: array
@@ -14116,9 +14744,9 @@ components:
             $ref: '#/components/schemas/SyntheticsTriggerCITestRunResult'
           type: array
         triggered_check_ids:
-          description: The public IDs of the Synthetics test triggered.
+          description: The public IDs of the Synthetic test triggered.
           items:
-            description: The public ID of the Synthetics test.
+            description: The public ID of the Synthetic test.
             type: string
           type: array
       type: object
@@ -14128,7 +14756,7 @@ components:
         metadata:
           $ref: '#/components/schemas/SyntheticsCIBatchMetadata'
         public_id:
-          description: The public ID of the Synthetics test to trigger.
+          description: The public ID of the Synthetic test to trigger.
           example: aaa-aaa-aaa
           type: string
       required:
@@ -14784,6 +15412,7 @@ components:
         analyzed_logs:
           description: Contains the number of analyzed logs.
           format: int64
+          nullable: true
           type: integer
         hour:
           description: The hour for the usage.
@@ -15110,6 +15739,7 @@ components:
         configured for usage attribution](https://docs.datadoghq.com/account_management/billing/usage_attribution/#getting-started).
 
         In this scenario the API returns the total usage, not broken down by tags.'
+      nullable: true
       type: object
     UsageAttributionValues:
       description: Fields in Usage Summary by tag(s).
@@ -15445,7 +16075,7 @@ components:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
         application_security_host_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
-        application_security_host_top99:
+        application_security_host_top99p:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
         ci_pipeline_indexed_spans_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
@@ -15619,22 +16249,26 @@ components:
         ci_pipeline_indexed_spans:
           description: The number of spans for pipelines in the queried hour.
           format: int64
+          nullable: true
           type: integer
         ci_test_indexed_spans:
           description: The number of spans for tests in the queried hour.
           format: int64
+          nullable: true
           type: integer
         ci_visibility_pipeline_committers:
           description: Shows the total count of all active Git committers for Pipelines
             in the current month. A committer is active if they commit at least 3
             times in a given month.
           format: int64
+          nullable: true
           type: integer
         ci_visibility_test_committers:
           description: The total count of all active Git committers for tests in the
             current month. A committer is active if they commit at least 3 times in
             a given month.
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -15660,11 +16294,13 @@ components:
           description: "The total number of Cloud Workload Security container hours
             from the start of the given hour\u2019s month until the given hour."
           format: int64
+          nullable: true
           type: integer
         cws_host_count:
           description: "The total number of Cloud Workload Security host hours from
             the start of the given hour\u2019s month until the given hour."
           format: int64
+          nullable: true
           type: integer
         hour:
           description: The hour for the usage.
@@ -15822,11 +16458,13 @@ components:
           description: "The total number of Database Monitoring host hours from the
             start of the given hour\u2019s month until the given hour."
           format: int64
+          nullable: true
           type: integer
         dbm_queries_count:
           description: "The total number of normalized Database Monitoring queries
             from the start of the given hour\u2019s month until the given hour."
           format: int64
+          nullable: true
           type: integer
         hour:
           description: The hour for the usage.
@@ -15856,15 +16494,18 @@ components:
           description: The high-water mark of APM ECS Fargate tasks during the given
             hour.
           format: int64
+          nullable: true
           type: integer
         appsec_fargate_count:
           description: The Application Security Monitoring ECS Fargate tasks during
             the given hour.
           format: int64
+          nullable: true
           type: integer
         avg_profiled_fargate_tasks:
           description: The average profiled task count for Fargate Profiling.
           format: int64
+          nullable: true
           type: integer
         hour:
           description: The hour for the usage.
@@ -15879,6 +16520,7 @@ components:
         tasks_count:
           description: The number of Fargate tasks run.
           format: int64
+          nullable: true
           type: integer
       type: object
     UsageFargateResponse:
@@ -15900,6 +16542,7 @@ components:
 
             during a given hour that were running the Datadog Agent.'
           format: int64
+          nullable: true
           type: integer
         alibaba_host_count:
           description: 'Contains the total number of hosts that reported through Alibaba
@@ -15907,17 +16550,20 @@ components:
 
             (and were NOT running the Datadog Agent).'
           format: int64
+          nullable: true
           type: integer
         apm_azure_app_service_host_count:
           description: Contains the total number of Azure App Services hosts using
             APM.
           format: int64
+          nullable: true
           type: integer
         apm_host_count:
           description: 'Shows the total number of hosts using APM during the hour,
 
             these are counted as billable (except during trial periods).'
           format: int64
+          nullable: true
           type: integer
         aws_host_count:
           description: 'Contains the total number of hosts that reported through the
@@ -15925,6 +16571,7 @@ components:
 
             (and were NOT running the Datadog Agent).'
           format: int64
+          nullable: true
           type: integer
         azure_host_count:
           description: 'Contains the total number of hosts that reported through Azure
@@ -15932,11 +16579,13 @@ components:
 
             (and were NOT running the Datadog Agent).'
           format: int64
+          nullable: true
           type: integer
         container_count:
           description: Shows the total number of containers reported by the Docker
             integration during the hour.
           format: int64
+          nullable: true
           type: integer
         gcp_host_count:
           description: 'Contains the total number of hosts that reported through the
@@ -15944,11 +16593,13 @@ components:
 
             (and were NOT running the Datadog Agent).'
           format: int64
+          nullable: true
           type: integer
         heroku_host_count:
           description: Contains the total number of Heroku dynos reported by the Datadog
             Agent.
           format: int64
+          nullable: true
           type: integer
         host_count:
           description: 'Contains the total number of billable infrastructure hosts
@@ -15956,10 +16607,12 @@ components:
 
             This is the sum of `agent_host_count`, `aws_host_count`, and `gcp_host_count`.'
           format: int64
+          nullable: true
           type: integer
         hour:
           description: The hour for the usage.
           format: date-time
+          nullable: true
           type: string
         infra_azure_app_service:
           description: 'Contains the total number of hosts that reported through the
@@ -15967,16 +16620,19 @@ components:
 
             (and were NOT running the Datadog Agent).'
           format: int64
+          nullable: true
           type: integer
         opentelemetry_apm_host_count:
           description: Contains the total number of hosts using APM reported by Datadog
             exporter for the OpenTelemetry Collector.
           format: int64
+          nullable: true
           type: integer
         opentelemetry_host_count:
           description: Contains the total number of hosts reported by Datadog exporter
             for the OpenTelemetry Collector.
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -15990,6 +16646,7 @@ components:
 
             (and were NOT running the Datadog Agent).'
           format: int64
+          nullable: true
           type: integer
       type: object
     UsageHostsResponse:
@@ -16013,6 +16670,7 @@ components:
           description: Contains the total number monthly active users from the start
             of the given hour's month until the given hour.
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -16041,6 +16699,7 @@ components:
         indexed_events_count:
           description: Contains the number of spans indexed.
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -16070,6 +16729,7 @@ components:
           description: Contains the total number of bytes ingested for APM spans during
             a given hour.
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -16125,6 +16785,7 @@ components:
           description: Contains the number of different functions for each region
             and AWS account.
           format: int64
+          nullable: true
           type: integer
         hour:
           description: The hour for the usage.
@@ -16133,6 +16794,7 @@ components:
         invocations_sum:
           description: Contains the sum of invocations of all functions.
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -16200,11 +16862,13 @@ components:
           description: Total logs indexed with this retention period during a given
             hour.
           format: int64
+          nullable: true
           type: integer
         live_indexed_events_count:
           description: Live logs indexed with this retention period during a given
             hour.
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -16216,6 +16880,7 @@ components:
           description: Rehydrated logs indexed with this retention period during a
             given hour.
           format: int64
+          nullable: true
           type: integer
         retention:
           description: The retention period in days or "custom" for all custom retention
@@ -16238,6 +16903,7 @@ components:
         billable_ingested_bytes:
           description: Contains the number of billable log bytes ingested.
           format: int64
+          nullable: true
           type: integer
         hour:
           description: The hour for the usage.
@@ -16246,30 +16912,42 @@ components:
         indexed_events_count:
           description: Contains the number of log events indexed.
           format: int64
+          nullable: true
           type: integer
         ingested_events_bytes:
           description: Contains the number of log bytes ingested.
           format: int64
+          nullable: true
+          type: integer
+        logs_forwarding_events_bytes:
+          description: Contains the number of logs forwarded bytes (data available
+            as of April 1st 2023)
+          format: int64
+          nullable: true
           type: integer
         logs_live_indexed_count:
           description: Contains the number of live log events indexed (data available
             as of December 1, 2020).
           format: int64
+          nullable: true
           type: integer
         logs_live_ingested_bytes:
           description: Contains the number of live log bytes ingested (data available
             as of December 1, 2020).
           format: int64
+          nullable: true
           type: integer
         logs_rehydrated_indexed_count:
           description: Contains the number of rehydrated log events indexed (data
             available as of December 1, 2020).
           format: int64
+          nullable: true
           type: integer
         logs_rehydrated_ingested_bytes:
           description: Contains the number of rehydrated log bytes ingested (data
             available as of December 1, 2020).
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -16306,6 +16984,7 @@ components:
         indexed_events_count:
           description: Contains the number of netflow events indexed.
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -16362,6 +17041,7 @@ components:
         online_archive_events_count:
           description: Total count of online archived events within the hour.
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -16385,11 +17065,13 @@ components:
         avg_container_agent_count:
           description: Get average number of container agents for that hour.
           format: int64
+          nullable: true
           type: integer
         host_count:
           description: Contains the total number of profiled hosts reporting during
             a given hour.
           format: int64
+          nullable: true
           type: integer
         hour:
           description: The hour for the usage.
@@ -16486,10 +17168,12 @@ components:
         browser_rum_units:
           description: The number of browser RUM units.
           format: int64
+          nullable: true
           type: integer
         mobile_rum_units:
           description: The number of mobile RUM units.
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -16522,12 +17206,14 @@ components:
             usage types by the Sensitive Data Scanner from the start of the given
             hour\u2019s month until the given hour."
           format: int64
+          nullable: true
           type: integer
         events_scanned_bytes:
           description: "The total number of bytes scanned of Events usage across all
             usage types by the Sensitive Data Scanner from the start of the given
             hour\u2019s month until the given hour."
           format: int64
+          nullable: true
           type: integer
         hour:
           description: The hour for the usage.
@@ -16538,6 +17224,7 @@ components:
             Data Scanner from the start of the given hour\u2019s month until the given
             hour."
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -16550,12 +17237,14 @@ components:
             usage types by the Sensitive Data Scanner from the start of the given
             hour\u2019s month until the given hour."
           format: int64
+          nullable: true
           type: integer
         total_scanned_bytes:
           description: "The total number of bytes scanned across all usage types by
             the Sensitive Data Scanner from the start of the given hour\u2019s month
             until the given hour."
           format: int64
+          nullable: true
           type: integer
       type: object
     UsageSDSResponse:
@@ -16584,6 +17273,7 @@ components:
         snmp_devices:
           description: Contains the number of SNMP devices.
           format: int64
+          nullable: true
           type: integer
       type: object
     UsageSNMPResponse:
@@ -16710,6 +17400,7 @@ components:
           format: int64
           type: integer
         audit_logs_lines_indexed_sum:
+          deprecated: true
           description: Shows the sum of audit logs lines indexed over all hours in
             the current date for all organizations.
           format: int64
@@ -16877,6 +17568,11 @@ components:
             current date for all organizations.
           format: int64
           type: integer
+        forwarding_events_bytes_sum:
+          description: Shows the sum of all log bytes forwarded over all hours in
+            the current date for all organizations.
+          format: int64
+          type: integer
         gcp_host_top99p:
           description: Shows the 99th percentile of all GCP hosts over all hours in
             the current date for all organizations.
@@ -17065,11 +17761,21 @@ components:
             in the current date for all organizations.
           format: int64
           type: integer
+        universal_service_monitoring_host_top99p:
+          description: Shows the 99th percentile of all universal service management
+            hosts over all hours in the current date for the given org.
+          format: int64
+          type: integer
         vsphere_host_top99p:
           description: Shows the 99th percentile of all vSphere hosts over all hours
             in the current date for all organizations.
           format: int64
           type: integer
+        vuln_management_host_count_top99p:
+          description: Shows the 99th percentile of all Application Vulnerability
+            Management hosts over all hours in the current date for the given org.
+          format: int64
+          type: integer
       type: object
     UsageSummaryDateOrg:
       description: Global hourly report of all data billed by Datadog for a given
@@ -17101,6 +17807,7 @@ components:
           format: int64
           type: integer
         audit_logs_lines_indexed_sum:
+          deprecated: true
           description: Shows the sum of all audit logs lines indexed over all hours
             in the current date for the given org.
           format: int64
@@ -17264,6 +17971,11 @@ components:
             in the current date for the given org.
           format: int64
           type: integer
+        forwarding_events_bytes_sum:
+          description: Shows the sum of all log bytes forwarded over all hours in
+            the current date for the given org.
+          format: int64
+          type: integer
         gcp_host_top99p:
           description: Shows the 99th percentile of all GCP hosts over all hours in
             the current date for the given org.
@@ -17459,11 +18171,21 @@ components:
             in the current date for the given org.
           format: int64
           type: integer
+        universal_service_monitoring_host_top99p:
+          description: Shows the 99th percentile of all Universal Service Monitoring
+            hosts over all hours in the current date for the given org.
+          format: int64
+          type: integer
         vsphere_host_top99p:
           description: Shows the 99th percentile of all vSphere hosts over all hours
             in the current date for the given org.
           format: int64
           type: integer
+        vuln_management_host_count_top99p:
+          description: Shows the 99th percentile of all Application Vulnerability
+            Management hosts over all hours in the current date for the given org.
+          format: int64
+          type: integer
       type: object
     UsageSummaryResponse:
       description: Response summarizing all usage aggregated across the months in
@@ -17495,6 +18217,7 @@ components:
           format: int64
           type: integer
         audit_logs_lines_indexed_agg_sum:
+          deprecated: true
           description: Shows the sum of all audit logs lines indexed over all hours
             in the current months for all organizations.
           format: int64
@@ -17670,6 +18393,12 @@ components:
             over all hours in the current months for all organizations.
           format: int64
           type: integer
+        forwarding_events_bytes_agg_sum:
+          description: Shows the sum of all logs forwarding bytes over all hours in
+            the current months for all organizations (data available as of April 1,
+            2023)
+          format: int64
+          type: integer
         gcp_host_top99p_sum:
           description: Shows the 99th percentile of all GCP hosts over all hours in
             the current months for all organizations.
@@ -17894,6 +18623,11 @@ components:
             in the current months for all organizations.
           format: int64
           type: integer
+        universal_service_monitoring_host_top99p_sum:
+          description: Shows the 99th percentile of all Universal Service Monitoring
+            hosts over all hours in the current months for all organizations.
+          format: int64
+          type: integer
         usage:
           description: An array of objects regarding hourly usage.
           items:
@@ -17904,6 +18638,11 @@ components:
             in the current months for all organizations.
           format: int64
           type: integer
+        vuln_management_host_count_top99p_sum:
+          description: Shows the 99th percentile of all Application Vulnerability
+            Management hosts over all hours in the current months for all organizations.
+          format: int64
+          type: integer
       type: object
     UsageSyntheticsAPIHour:
       description: Number of Synthetics API tests run for each hour for a given organization.
@@ -17911,6 +18650,7 @@ components:
         check_calls_count:
           description: Contains the number of Synthetics API tests run.
           format: int64
+          nullable: true
           type: integer
         hour:
           description: The hour for the usage.
@@ -17940,6 +18680,7 @@ components:
         browser_check_calls_count:
           description: Contains the number of Synthetics Browser tests run.
           format: int64
+          nullable: true
           type: integer
         hour:
           description: The hour for the usage.
@@ -18077,6 +18818,7 @@ components:
         total_number_of_records:
           description: Total number of records.
           format: int64
+          nullable: true
           type: integer
       type: object
     UsageTopAvgMetricsResponse:
@@ -19173,6 +19915,7 @@ paths:
             - datadoghq.com
             - us3.datadoghq.com
             - us5.datadoghq.com
+            - ap1.datadoghq.com
             - datadoghq.eu
             - ddog-gov.com
           subdomain:
@@ -20126,53 +20869,69 @@ paths:
       tags:
       - Dashboard Lists
       x-codegen-request-body-name: body
-  /api/v1/dashboard/{dashboard_id}:
-    delete:
-      description: Delete a dashboard using the specified ID.
-      operationId: DeleteDashboard
-      parameters:
-      - description: The ID of the dashboard.
-        in: path
-        name: dashboard_id
+  /api/v1/dashboard/public:
+    post:
+      description: Share a specified private dashboard, generating a URL at which
+        it can be publicly viewed.
+      operationId: CreatePublicDashboard
+      requestBody:
+        content:
+          application/json:
+            examples:
+              json-request-body:
+                value:
+                  dashboard_id: 123-abc-456
+                  dashboard_type: custom_timeboard
+                  share_type: open
+            schema:
+              $ref: '#/components/schemas/SharedDashboard'
+        description: Create a shared dashboard request body.
         required: true
-        schema:
-          type: string
       responses:
         '200':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/DashboardDeleteResponse'
+                $ref: '#/components/schemas/SharedDashboard'
           description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
         '403':
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: Authentication Error
+          description: Forbidden
         '404':
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: Dashboards Not Found
+          description: Dashboard Not Found
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
       security:
       - apiKeyAuth: []
         appKeyAuth: []
       - AuthZ:
-        - dashboards_write
-      summary: Delete a dashboard
+        - dashboards_public_share
+      summary: Create a shared dashboard
       tags:
       - Dashboards
-    get:
-      description: Get a dashboard using the specified ID.
-      operationId: GetDashboard
+      x-codegen-request-body-name: body
+  /api/v1/dashboard/public/{token}:
+    delete:
+      description: Revoke the public URL for a dashboard (rendering it private) associated
+        with the specified token.
+      operationId: DeletePublicDashboard
       parameters:
-      - description: The ID of the dashboard.
+      - description: The token of the shared dashboard.
         in: path
-        name: dashboard_id
+        name: token
         required: true
         schema:
           type: string
@@ -20181,43 +20940,400 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/Dashboard'
+                $ref: '#/components/schemas/DeleteSharedDashboardResponse'
           description: OK
         '403':
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: Authentication Error
+          description: Forbidden
         '404':
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: Item Not Found
+          description: Shared Dashboard Not Found
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
       security:
       - apiKeyAuth: []
         appKeyAuth: []
       - AuthZ:
-        - dashboards_read
-      summary: Get a dashboard
+        - dashboards_public_share
+      summary: Revoke a shared dashboard URL
       tags:
       - Dashboards
-    put:
-      description: Update a dashboard using the specified ID.
-      operationId: UpdateDashboard
+    get:
+      description: Fetch an existing shared dashboard's sharing metadata associated
+        with the specified token.
+      operationId: GetPublicDashboard
       parameters:
-      - description: The ID of the dashboard.
+      - description: The token of the shared dashboard. Generated when a dashboard
+          is shared.
         in: path
-        name: dashboard_id
+        name: token
         required: true
         schema:
           type: string
-      requestBody:
-        content:
-          application/json:
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SharedDashboard'
+          description: OK
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Shared Dashboard Not Found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - dashboards_read
+      summary: Get a shared dashboard
+      tags:
+      - Dashboards
+    put:
+      description: Update a shared dashboard associated with the specified token.
+      operationId: UpdatePublicDashboard
+      parameters:
+      - description: The token of the shared dashboard.
+        in: path
+        name: token
+        required: true
+        schema:
+          type: string
+      requestBody:
+        content:
+          application/json:
+            examples:
+              json-request-body:
+                value:
+                  global_time:
+                    live_span: 1h
+                  selectable_template_vars:
+                  - default_value: '*'
+                    name: exampleVar
+                    prefix: test
+                    visible_tags:
+                    - selectableValue1
+                    - selectableValue2
+                  share_list:
+                  - test@datadoghq.com
+                  - test2@datadoghq.com
+                  share_type: invite
+            schema:
+              $ref: '#/components/schemas/SharedDashboardUpdateRequest'
+        description: Update Dashboard request body.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SharedDashboard'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Authentication Error
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Item Not Found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - dashboards_public_share
+      summary: Update a shared dashboard
+      tags:
+      - Dashboards
+      x-codegen-request-body-name: body
+  /api/v1/dashboard/public/{token}/invitation:
+    delete:
+      description: Revoke previously sent invitation emails and active sessions used
+        to access a given shared dashboard for specific email addresses.
+      operationId: DeletePublicDashboardInvitation
+      parameters:
+      - description: The token of the shared dashboard.
+        in: path
+        name: token
+        required: true
+        schema:
+          type: string
+      requestBody:
+        content:
+          application/json:
+            examples:
+              json-request-body:
+                value:
+                  data:
+                    attributes:
+                      email: test@datadoghq.com
+                    type: public_dashboard_invitation
+            schema:
+              $ref: '#/components/schemas/SharedDashboardInvites'
+        description: Shared Dashboard Invitation deletion request body.
+        required: true
+      responses:
+        '204':
+          description: OK
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not Found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - dashboards_public_share
+      summary: Revoke shared dashboard invitations
+      tags:
+      - Dashboards
+      x-codegen-request-body-name: body
+    get:
+      description: Describe the invitations that exist for the given shared dashboard
+        (paginated).
+      operationId: GetPublicDashboardInvitations
+      parameters:
+      - description: Token of the shared dashboard for which to fetch invitations.
+        in: path
+        name: token
+        required: true
+        schema:
+          type: string
+      - description: The number of records to return in a single request.
+        in: query
+        name: page_size
+        required: false
+        schema:
+          format: int64
+          type: integer
+      - description: The page to access (base 0).
+        in: query
+        name: page_number
+        required: false
+        schema:
+          format: int64
+          type: integer
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SharedDashboardInvites'
+          description: OK
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not Found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - dashboards_public_share
+      summary: Get all invitations for a shared dashboard
+      tags:
+      - Dashboards
+    post:
+      description: Send emails to specified email addresses containing links to access
+        a given authenticated shared dashboard. Email addresses must already belong
+        to the authenticated shared dashboard's share_list.
+      operationId: SendPublicDashboardInvitation
+      parameters:
+      - description: The token of the shared dashboard.
+        in: path
+        name: token
+        required: true
+        schema:
+          type: string
+      requestBody:
+        content:
+          application/json:
+            examples:
+              json-request-body:
+                value:
+                  data:
+                  - attributes:
+                      email: test@datadoghq.com
+                    type: public_dashboard_invitation
+            schema:
+              $ref: '#/components/schemas/SharedDashboardInvites'
+        description: Shared Dashboard Invitation request body.
+        required: true
+      responses:
+        '201':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SharedDashboardInvites'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not Found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - dashboards_public_share
+      summary: Send shared dashboard invitation email
+      tags:
+      - Dashboards
+      x-codegen-request-body-name: body
+  /api/v1/dashboard/{dashboard_id}:
+    delete:
+      description: Delete a dashboard using the specified ID.
+      operationId: DeleteDashboard
+      parameters:
+      - description: The ID of the dashboard.
+        in: path
+        name: dashboard_id
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DashboardDeleteResponse'
+          description: OK
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Authentication Error
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Dashboards Not Found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - dashboards_write
+      summary: Delete a dashboard
+      tags:
+      - Dashboards
+    get:
+      description: Get a dashboard using the specified ID.
+      operationId: GetDashboard
+      parameters:
+      - description: The ID of the dashboard.
+        in: path
+        name: dashboard_id
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Dashboard'
+          description: OK
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Authentication Error
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Item Not Found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - dashboards_read
+      summary: Get a dashboard
+      tags:
+      - Dashboards
+    put:
+      description: Update a dashboard using the specified ID.
+      operationId: UpdateDashboard
+      parameters:
+      - description: The ID of the dashboard.
+        in: path
+        name: dashboard_id
+        required: true
+        schema:
+          type: string
+      requestBody:
+        content:
+          application/json:
             schema:
               $ref: '#/components/schemas/Dashboard'
         description: Update Dashboard request body.
@@ -20334,6 +21450,12 @@ paths:
         required: false
         schema:
           type: boolean
+      - description: Return creator information.
+        in: query
+        name: with_creator
+        required: false
+        schema:
+          type: boolean
       responses:
         '200':
           content:
@@ -23578,7 +24700,7 @@ paths:
         #### Query Types
 
 
-        **Metric Alert Query**
+        ##### Metric Alert Query
 
 
         Example: `time_aggr(time_window):space_aggr:metric{tags} [by {key}] operator
@@ -23626,7 +24748,7 @@ paths:
         ''dbscan'', 7) > 0`
 
 
-        **Service Check Query**
+        ##### Service Check Query
 
 
         Example: `"check".over(tags).last(count).by(group).count_by_status()`
@@ -23652,7 +24774,7 @@ paths:
         for more information.
 
 
-        **Event Alert Query**
+        ##### Event Alert Query
 
 
         Example: `events(''sources:nagios status:error,warning priority:normal tags:
@@ -23688,7 +24810,7 @@ paths:
         V2 Alert Query. For more information, see the [Event Migration guide](https://docs.datadoghq.com/events/guides/migrating_to_new_events_features/).
 
 
-        **Event V2 Alert Query**
+        ##### Event V2 Alert Query
 
 
         Example: `events(query).rollup(rollup_method[, measure]).last(time_window)
@@ -23709,7 +24831,7 @@ paths:
         - `#` an integer or decimal number used to set the threshold.
 
 
-        **Process Alert Query**
+        ##### Process Alert Query
 
 
         Example: `processes(search).over(tags).rollup(''count'').last(timeframe) operator
@@ -23731,7 +24853,7 @@ paths:
         - `#` an integer or decimal number used to set the threshold
 
 
-        **Logs Alert Query**
+        ##### Logs Alert Query
 
 
         Example: `logs(query).index(index_name).rollup(rollup_method[, measure]).last(time_window)
@@ -23755,7 +24877,7 @@ paths:
         - `#` an integer or decimal number used to set the threshold.
 
 
-        **Composite Query**
+        ##### Composite Query
 
 
         Example: `12345 && 67890`, where `12345` and `67890` are the IDs of non-composite
@@ -23781,7 +24903,7 @@ paths:
         UI.
 
 
-        **SLO Alert Query**
+        ##### SLO Alert Query
 
 
         Example: `error_budget("slo_id").over("time_window") operator #`
@@ -23796,7 +24918,7 @@ paths:
         - `operator`: `>=` or `>`
 
 
-        **Audit Alert Query**
+        ##### Audit Alert Query
 
 
         Example: `audits(query).rollup(rollup_method[, measure]).last(time_window)
@@ -23817,11 +24939,11 @@ paths:
         - `#` an integer or decimal number used to set the threshold.
 
 
-        **NOTE** Only available on US1-FED and in closed beta on US1, EU, US3, and
-        US5.
+        **NOTE** Only available on US1-FED and in closed beta on US1, EU, AP1, US3,
+        and US5.
 
 
-        **CI Pipelines Alert Query**
+        ##### CI Pipelines Alert Query
 
 
         Example: `ci-pipelines(query).rollup(rollup_method[, measure]).last(time_window)
@@ -23843,10 +24965,10 @@ paths:
         - `#` an integer or decimal number used to set the threshold.
 
 
-        **NOTE** CI Pipeline monitors are in alpha on US1, EU, US3 and US5.
+        **NOTE** CI Pipeline monitors are in alpha on US1, EU, AP1, US3, and US5.
 
 
-        **CI Tests Alert Query**
+        ##### CI Tests Alert Query
 
 
         Example: `ci-tests(query).rollup(rollup_method[, measure]).last(time_window)
@@ -23868,11 +24990,11 @@ paths:
         - `#` an integer or decimal number used to set the threshold.
 
 
-        **NOTE** CI Test monitors are available only in closed beta on US1, EU, US3
-        and US5.
+        **NOTE** CI Test monitors are available only in closed beta on US1, EU, AP1,
+        US3, and US5.
 
 
-        **Error Tracking Alert Query**
+        ##### Error Tracking Alert Query
 
 
         Example(RUM): `error-tracking-rum(query).rollup(rollup_method[, measure]).last(time_window)
@@ -24293,6 +25415,13 @@ paths:
         required: false
         schema:
           type: string
+      - description: If this argument is set to true, then the returned data includes
+          all current active downtimes for the monitor.
+        in: query
+        name: with_downtimes
+        required: false
+        schema:
+          type: boolean
       responses:
         '200':
           content:
@@ -25982,6 +27111,7 @@ paths:
             - datadoghq.eu
             - us3.datadoghq.com
             - us5.datadoghq.com
+            - ap1.datadoghq.com
             - ddog-gov.com
           subdomain:
             default: api
@@ -26328,7 +27458,7 @@ paths:
       - Synthetics
   /api/v1/synthetics/private-locations:
     post:
-      description: Create a new Synthetics private location.
+      description: Create a new Synthetic private location.
       operationId: CreatePrivateLocation
       requestBody:
         content:
@@ -26369,7 +27499,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/synthetics/private-locations/{location_id}:
     delete:
-      description: Delete a Synthetics private location.
+      description: Delete a Synthetic private location.
       operationId: DeletePrivateLocation
       parameters:
       - description: The ID of the private location.
@@ -26400,7 +27530,7 @@ paths:
       tags:
       - Synthetics
     get:
-      description: Get a Synthetics private location.
+      description: Get a Synthetic private location.
       operationId: GetPrivateLocation
       parameters:
       - description: The ID of the private location.
@@ -26435,7 +27565,7 @@ paths:
       tags:
       - Synthetics
     put:
-      description: Edit a Synthetics private location.
+      description: Edit a Synthetic private location.
       operationId: UpdatePrivateLocation
       parameters:
       - description: The ID of the private location.
@@ -26511,7 +27641,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: Synthetics is not activated for the user.
+          description: Synthetic Monitoring is not activated for the user.
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
       security:
@@ -26873,7 +28003,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: '- Synthetic is not activated for the user
+          description: '- Synthetic Monitoring is not activated for the user
 
             - Test is not owned by the user'
         '429':
@@ -26947,7 +28077,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/synthetics/tests/browser/{public_id}/results:
     get:
-      description: Get the last 50 test results summaries for a given Synthetics Browser
+      description: Get the last 150 test results summaries for a given Synthetic browser
         test.
       operationId: GetBrowserTestLatestResults
       parameters:
@@ -26999,7 +28129,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: '- Synthetic is not activated for the user
+          description: '- Synthetic Monitoring is not activated for the user
 
             - Test is not owned by the user'
         '429':
@@ -27015,7 +28145,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/synthetics/tests/browser/{public_id}/results/{result_id}:
     get:
-      description: Get a specific full result from a given (browser) Synthetic test.
+      description: Get a specific full result from a given Synthetic browser test.
       operationId: GetBrowserTestResult
       parameters:
       - description: 'The public ID of the browser test to which the target result
@@ -27050,7 +28180,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: '- Synthetic is not activated for the user
+          description: '- Synthetic Monitoring is not activated for the user
 
             - Test or result is not owned by the user'
         '429':
@@ -27105,7 +28235,7 @@ paths:
                 $ref: '#/components/schemas/APIErrorResponse'
           description: '- Tests to be deleted can''t be found
 
-            - Synthetics is not activated for the user'
+            - Synthetic is not activated for the user'
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
       security:
@@ -27119,7 +28249,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/synthetics/tests/trigger:
     post:
-      description: Trigger a set of Synthetics tests.
+      description: Trigger a set of Synthetic tests.
       operationId: TriggerTests
       requestBody:
         content:
@@ -27148,13 +28278,13 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - synthetics_write
-      summary: Trigger Synthetics tests
+      summary: Trigger Synthetic tests
       tags:
       - Synthetics
       x-codegen-request-body-name: body
   /api/v1/synthetics/tests/trigger/ci:
     post:
-      description: Trigger a set of Synthetics tests for continuous integration.
+      description: Trigger a set of Synthetic tests for continuous integration.
       operationId: TriggerCITests
       requestBody:
         content:
@@ -27189,7 +28319,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/synthetics/tests/{public_id}:
     get:
-      description: Get the detailed configuration associated with a Synthetics test.
+      description: Get the detailed configuration associated with a Synthetic test.
       operationId: GetTest
       parameters:
       - description: The public ID of the test to get details from.
@@ -27231,7 +28361,7 @@ paths:
       - Synthetics
   /api/v1/synthetics/tests/{public_id}/results:
     get:
-      description: Get the last 50 test results summaries for a given Synthetics API
+      description: Get the last 150 test results summaries for a given Synthetic API
         test.
       operationId: GetAPITestLatestResults
       parameters:
@@ -27297,7 +28427,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/synthetics/tests/{public_id}/results/{result_id}:
     get:
-      description: Get a specific full result from a given (API) Synthetic test.
+      description: Get a specific full result from a given Synthetic API test.
       operationId: GetAPITestResult
       parameters:
       - description: The public ID of the API test to which the target result belongs.
@@ -27330,7 +28460,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: '- Synthetic is not activated for the user
+          description: '- Synthetic Monitoring is not activated for the user
 
             - Test or result is not owned by the user'
         '429':
@@ -27345,7 +28475,7 @@ paths:
       - Synthetics
   /api/v1/synthetics/tests/{public_id}/status:
     put:
-      description: Pause or start a Synthetics test by changing the status.
+      description: Pause or start a Synthetic test by changing the status.
       operationId: UpdateTestPauseStatus
       parameters:
       - description: The public ID of the Synthetic test to update.
@@ -27385,7 +28515,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: '- Synthetic is not activated for the user
+          description: '- Synthetic Monitoring is not activated for the user
 
             - Test is not owned by the user'
         '429':
@@ -27401,7 +28531,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/synthetics/variables:
     get:
-      description: Get the list of all Synthetics global variables.
+      description: Get the list of all Synthetic global variables.
       operationId: ListGlobalVariables
       responses:
         '200':
@@ -27427,7 +28557,7 @@ paths:
       tags:
       - Synthetics
     post:
-      description: Create a Synthetics global variable.
+      description: Create a Synthetic global variable.
       operationId: CreateGlobalVariable
       requestBody:
         content:
@@ -27468,7 +28598,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/synthetics/variables/{variable_id}:
     delete:
-      description: Delete a Synthetics global variable.
+      description: Delete a Synthetic global variable.
       operationId: DeleteGlobalVariable
       parameters:
       - description: The ID of the global variable.
@@ -27548,7 +28678,7 @@ paths:
       tags:
       - Synthetics
     put:
-      description: Edit a Synthetics global variable.
+      description: Edit a Synthetic global variable.
       operationId: EditGlobalVariable
       parameters:
       - description: The ID of the global variable.
@@ -27981,12 +29111,10 @@ paths:
       - Usage Metering
   /api/v1/usage/audit_logs:
     get:
+      deprecated: true
       description: 'Get hourly usage for audit logs.
 
-        **Note:** hourly usage data for all products is now available in the [Get
-        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family).
-        Refer to [Migrating from the V1 Hourly Usage APIs to V2](https://docs.datadoghq.com/account_management/guide/hourly-usage-migration/)
-        for the associated migration guide.'
+        **Note:** This endpoint has been deprecated.'
       operationId: GetUsageAuditLogs
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -28509,10 +29637,11 @@ paths:
       - Usage Metering
   /api/v1/usage/hourly-attribution:
     get:
-      description: "Get hourly usage attribution.\n\nThis API endpoint is paginated.
-        To make sure you receive all records, check if the value of `next_record_id`
-        is\nset in the response. If it is, make another request and pass `next_record_id`
-        as a parameter.\nPseudo code example:\n\n```\nresponse := GetHourlyUsageAttribution(start_month)\ncursor
+      description: "Get hourly usage attribution. Multi-region data is available starting
+        March 1, 2023.\n\nThis API endpoint is paginated. To make sure you receive
+        all records, check if the value of `next_record_id` is\nset in the response.
+        If it is, make another request and pass `next_record_id` as a parameter.\nPseudo
+        code example:\n\n```\nresponse := GetHourlyUsageAttribution(start_month)\ncursor
         := response.metadata.pagination.next_record_id\nWHILE cursor != null BEGIN\n
         \ sleep(5 seconds)  # Avoid running into rate limit\n  response := GetHourlyUsageAttribution(start_month,
         next_record_id=cursor)\n  cursor := response.metadata.pagination.next_record_id\nEND\n```"
@@ -29020,10 +30149,11 @@ paths:
       - Usage Metering
   /api/v1/usage/monthly-attribution:
     get:
-      description: "Get monthly usage attribution.\n\nThis API endpoint is paginated.
-        To make sure you receive all records, check if the value of `next_record_id`
-        is\nset in the response. If it is, make another request and pass `next_record_id`
-        as a parameter.\nPseudo code example:\n\n```\nresponse := GetMonthlyUsageAttribution(start_month)\ncursor
+      description: "Get monthly usage attribution. Multi-region data is available
+        starting March 1, 2023.\n\nThis API endpoint is paginated. To make sure you
+        receive all records, check if the value of `next_record_id` is\nset in the
+        response. If it is, make another request and pass `next_record_id` as a parameter.\nPseudo
+        code example:\n\n```\nresponse := GetMonthlyUsageAttribution(start_month)\ncursor
         := response.metadata.pagination.next_record_id\nWHILE cursor != null BEGIN\n
         \ sleep(5 seconds)  # Avoid running into rate limit\n  response := GetMonthlyUsageAttribution(start_month,
         next_record_id=cursor)\n  cursor := response.metadata.pagination.next_record_id\nEND\n```"
@@ -30373,6 +31503,7 @@ paths:
             - datadoghq.com
             - us3.datadoghq.com
             - us5.datadoghq.com
+            - ap1.datadoghq.com
             - datadoghq.eu
             - ddog-gov.com
           subdomain:
@@ -30411,6 +31542,7 @@ servers:
       - datadoghq.com
       - us3.datadoghq.com
       - us5.datadoghq.com
+      - ap1.datadoghq.com
       - datadoghq.eu
       - ddog-gov.com
     subdomain:
@@ -30648,12 +31780,13 @@ tags:
   name: Slack Integration
 - description: Take graph snapshots using the API.
   name: Snapshots
-- description: "Datadog Synthetics uses simulated user requests and browser rendering
-    to help you ensure uptime,\nidentify regional issues, and track your application
-    performance. Datadog Synthetics tests come in\ntwo different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/?tab=httptest)\nand
-    [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can
-    use Datadog\u2019s API to\nmanage both test types programmatically.\n\nFor more
-    information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/)."
+- description: "Datadog Synthetic Monitoring uses simulated user requests and browser
+    rendering to help you ensure uptime,\nidentify regional issues, and track your
+    application performance. Synthetic tests come in\ntwo different flavors, [API
+    tests](https://docs.datadoghq.com/synthetics/api_tests/?tab=httptest)\nand [browser
+    tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog\u2019s
+    API to\nmanage both test types programmatically.\n\nFor more information, see
+    the [Synthetic Monitoring documentation](https://docs.datadoghq.com/synthetics/)."
   name: Synthetics
 - description: 'The tag endpoint allows you to assign tags to hosts,