onesignal 5.16.0 → 5.18.0

data/docs/EmailProviderMetricsResponse.md

@@ -0,0 +1,18 @@
+# OneSignal::EmailProviderMetricsResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **providers** | [**Array<EmailProviderMetrics>**](EmailProviderMetrics.md) | One entry per inbox provider that received email from the domain during the reporting window. Empty when the domain is not found for the app or is not currently active for sending. | [optional] |
+
+## Example
+
+```ruby
+require 'onesignal'
+
+instance = OneSignal::EmailProviderMetricsResponse.new(
+  providers: nil
+)
+```
+

data/docs/EmailProviderMetricsTimeseriesResponse.md

@@ -0,0 +1,18 @@
+# OneSignal::EmailProviderMetricsTimeseriesResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **events** | [**Array<EmailProviderMetricsEvent>**](EmailProviderMetricsEvent.md) | One entry for every time bucket in the reporting window, oldest first. Buckets with no email activity are included with all metrics set to `0`. Empty when the domain is not found for the app or is not currently active for sending. | [optional] |
+
+## Example
+
+```ruby
+require 'onesignal'
+
+instance = OneSignal::EmailProviderMetricsTimeseriesResponse.new(
+  events: nil
+)
+```
+

data/docs/JourneyNode.md

@@ -7,7 +7,7 @@
 | **id** | **String** | Server-assigned node UUID. Returned on reads. Required on update to keep an existing node. Rejected on create with a 400 validation error. | [optional] |
 | **kind** | **String** | Node kind. Selects which other fields apply. |  |
 | **client_node_id** | **String** | Optional client-assigned identifier, unique within the journey. Use it to reference this node from elsewhere in the same request. Persisted and returned on reads. | [optional] |
-| **annotation** | **String** | Optional free-text label, up to 255 characters. Stored and returned as-is with no effect on journey behavior. | [optional] |
+| **annotation** | **String** | Optional free-text label, up to 1024 characters. Stored and returned as-is with no effect on journey behavior. | [optional] |
 | **duration_seconds** | **Integer** | wait nodes: seconds to hold the user. Minimum 60, maximum 31556952 (1 year). | [optional] |
 | **relative_to** | **String** | time_window nodes: schedule_in_timezone uses the configured windows; last_active_time holds relative to the user's last active time. | [optional] |
 | **windows** | [**Array<JourneyTimeWindow>**](JourneyTimeWindow.md) | time_window nodes: one or more time windows. A window with no day_of_week applies to every day. Required when relative_to is schedule_in_timezone; omit when it is last_active_time. | [optional] |
@@ -19,7 +19,7 @@
 | **webhook_id** | **String** | send_webhook nodes: UUID of the webhook to send. | [optional] |
 | **assignments** | **Hash<String, String>** | tag nodes: tag key-value pairs to assign. An empty string value removes the tag. Keys are limited to 255 characters and values to 1024. | [optional] |
 | **randomize_on_entry** | **Boolean** | split_range nodes: when true, assigns each user to a branch at random on entry. Defaults to false. | [optional] |
-| **branches** | [**Array<JourneyBranch>**](JourneyBranch.md) | Branching nodes: nested branches. split_range requires 2-20 weighted branches that sum to 100. yes_no requires exactly 2 branches. wait_until requires 1-10 condition branches. | [optional] |
+| **branches** | [**Array<JourneyBranch>**](JourneyBranch.md) | Branching nodes: nested branches. split_range requires 2-25 weighted branches that sum to 100. yes_no requires exactly 2 branches. wait_until requires 1-25 condition branches. | [optional] |
 | **expiration** | [**JourneyWaitUntilExpiration**](JourneyWaitUntilExpiration.md) |  | [optional] |
 
 ## Example

data/docs/UpdateJourneyNodeRequest.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **client_node_id** | **String** | Optional client-assigned identifier, unique within the journey. Use it to reference this node from elsewhere in the same request. Persisted and returned on reads. | [optional] |
-| **annotation** | **String** | Optional free-text label, up to 255 characters. Stored and returned as-is with no effect on journey behavior. | [optional] |
+| **annotation** | **String** | Optional free-text label, up to 1024 characters. Stored and returned as-is with no effect on journey behavior. | [optional] |
 | **duration_seconds** | **Integer** | wait nodes: seconds to hold the user. Minimum 60, maximum 31556952 (1 year). | [optional] |
 | **relative_to** | **String** | time_window nodes: schedule_in_timezone uses the configured windows; last_active_time holds relative to the user's last active time. | [optional] |
 | **windows** | [**Array<JourneyTimeWindow>**](JourneyTimeWindow.md) | time_window nodes: one or more time windows. A window with no day_of_week applies to every day. Required when relative_to is schedule_in_timezone; omit when it is last_active_time. | [optional] |
@@ -17,7 +17,7 @@
 | **webhook_id** | **String** | send_webhook nodes: UUID of the webhook to send. | [optional] |
 | **assignments** | **Hash<String, String>** | tag nodes: tag key-value pairs to assign. An empty string value removes the tag. Keys are limited to 255 characters and values to 1024. | [optional] |
 | **randomize_on_entry** | **Boolean** | split_range nodes: when true, assigns each user to a branch at random on entry. Defaults to false. | [optional] |
-| **branches** | [**Array<JourneyBranch>**](JourneyBranch.md) | Branching nodes: nested branches. split_range requires 2-20 weighted branches that sum to 100. yes_no requires exactly 2 branches. wait_until requires 1-10 condition branches. | [optional] |
+| **branches** | [**Array<JourneyBranch>**](JourneyBranch.md) | Branching nodes: nested branches. split_range requires 2-25 weighted branches that sum to 100. yes_no requires exactly 2 branches. wait_until requires 1-25 condition branches. | [optional] |
 | **expiration** | [**JourneyWaitUntilExpiration**](JourneyWaitUntilExpiration.md) |  | [optional] |
 | **concurrency_key** | **String** | Optional optimistic-concurrency token. Pass the concurrency_key from a prior fetch to reject the update with 409 if the journey changed. Omit to skip the check. It is not merged onto the node. | [optional] |
 

data/lib/onesignal/api/default_api.rb

@@ -1203,7 +1203,7 @@ module OneSignal
     # Delete Segment
     # Delete a segment (not user devices) - Required: OneSignal Paid Plan You can delete a segment under your app by calling this API. You must provide an API key in the Authorization header that has admin access on the app. The segment_id can be found in the URL of the segment when viewing it in the dashboard. 
     # @param app_id [String] The OneSignal App ID for your app.  Available in Keys & IDs.
-    # @param segment_id [String] The segment_id can be found in the URL of the segment when viewing it in the dashboard.
+    # @param segment_id [String] The segment's unique identifier. In the dashboard, go to Audience > Segments, open the segment's options menu, and select Copy segment ID. You can also get it from the View Segments API or the segment's URL in the dashboard.
     # @param [Hash] opts the optional parameters
     # @return [GenericSuccessBoolResponse]
     def delete_segment(app_id, segment_id, opts = {})
@@ -1214,7 +1214,7 @@ module OneSignal
     # Delete Segment
     # Delete a segment (not user devices) - Required: OneSignal Paid Plan You can delete a segment under your app by calling this API. You must provide an API key in the Authorization header that has admin access on the app. The segment_id can be found in the URL of the segment when viewing it in the dashboard. 
     # @param app_id [String] The OneSignal App ID for your app.  Available in Keys & IDs.
-    # @param segment_id [String] The segment_id can be found in the URL of the segment when viewing it in the dashboard.
+    # @param segment_id [String] The segment's unique identifier. In the dashboard, go to Audience > Segments, open the segment's options menu, and select Copy segment ID. You can also get it from the View Segments API or the segment's URL in the dashboard.
     # @param [Hash] opts the optional parameters
     # @return [Array<(GenericSuccessBoolResponse, Integer, Hash)>] GenericSuccessBoolResponse data, response status code and response headers
     def delete_segment_with_http_info(app_id, segment_id, opts = {})
@@ -1479,6 +1479,82 @@ module OneSignal
       return data, status_code, headers
     end
 
+    # Duplicate journey
+    # The Journeys API is in beta. Endpoints and response fields can still change. Copy an existing journey into a new draft. The source does not change. The copy is always a draft, and started_at and archived_at are null. If you omit the body, or omit overrides, the copy keeps the source description, audience, nodes, early_exit, and reentry_rules. The copy takes the source name plus \" (Copy)\". The copy does not keep schedule. Send schedule under overrides to set it. Server-controlled fields are rejected with 400. The authenticated App API key must have permission to create journeys.
+    # @param app_id [String] Your OneSignal App ID in UUID v4 format.
+    # @param journey_id [String] UUID of the journey to copy.
+    # @param [Hash] opts the optional parameters
+    # @option opts [DuplicateJourneyRequest] :duplicate_journey_request 
+    # @return [Journey]
+    def duplicate_journey(app_id, journey_id, opts = {})
+      data, _status_code, _headers = duplicate_journey_with_http_info(app_id, journey_id, opts)
+      data
+    end
+
+    # Duplicate journey
+    # The Journeys API is in beta. Endpoints and response fields can still change. Copy an existing journey into a new draft. The source does not change. The copy is always a draft, and started_at and archived_at are null. If you omit the body, or omit overrides, the copy keeps the source description, audience, nodes, early_exit, and reentry_rules. The copy takes the source name plus \&quot; (Copy)\&quot;. The copy does not keep schedule. Send schedule under overrides to set it. Server-controlled fields are rejected with 400. The authenticated App API key must have permission to create journeys.
+    # @param app_id [String] Your OneSignal App ID in UUID v4 format.
+    # @param journey_id [String] UUID of the journey to copy.
+    # @param [Hash] opts the optional parameters
+    # @option opts [DuplicateJourneyRequest] :duplicate_journey_request 
+    # @return [Array<(Journey, Integer, Hash)>] Journey data, response status code and response headers
+    def duplicate_journey_with_http_info(app_id, journey_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DefaultApi.duplicate_journey ...'
+      end
+      # verify the required parameter 'app_id' is set
+      if @api_client.config.client_side_validation && app_id.nil?
+        fail ArgumentError, "Missing the required parameter 'app_id' when calling DefaultApi.duplicate_journey"
+      end
+      # verify the required parameter 'journey_id' is set
+      if @api_client.config.client_side_validation && journey_id.nil?
+        fail ArgumentError, "Missing the required parameter 'journey_id' when calling DefaultApi.duplicate_journey"
+      end
+      # resource path
+      local_var_path = '/apps/{app_id}/journeys/{journey_id}/duplicate'.sub('{' + 'app_id' + '}', CGI.escape(app_id.to_s)).sub('{' + 'journey_id' + '}', CGI.escape(journey_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'duplicate_journey_request'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Journey'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['rest_api_key']
+
+      new_options = opts.merge(
+        :operation => :"DefaultApi.duplicate_journey",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DefaultApi#duplicate_journey\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Estimate notification recipients
     # Returns the estimated number of recipients for a notification's targeting, without creating or sending anything. The returned `count` reflects the same audience-size estimate you would see under \"Choose your target audience\" when composing a message. It is based on the user targeting method you've set and the specific platforms the message is targeted to send to. This endpoint only supports a subset of targeting parameters: `included_segments` is required (its `\"All\"` shorthand targets every subscriber), and `excluded_segments`, `filters`, `include_aliases`, and `target_channel` narrow that audience further. Use `target_channel` to select platforms. `include_subscription_ids` and the other raw subscription id/token fields, and the individual `isIos` / `isAndroid` / etc. platform flags, are not supported. All other notification fields (content, delivery options, and so on) are accepted, but ignored. 
     # @param estimate_notification_recipients_request [EstimateNotificationRecipientsRequest] 
@@ -1947,6 +2023,189 @@ module OneSignal
       return data, status_code, headers
     end
 
+    # Get email inbox provider metrics
+    # Email delivery, opens, clicks, bounces, failures, and spam complaints broken down by inbox provider (Gmail, Outlook, Yahoo, Apple, and more) to pinpoint where deliverability problems are coming from. Metrics are reported for a single sending domain over the requested time range. `start` must be before `end` and no more than 365 days ago. `providers` is empty when the domain is not found for the app or is not currently active for sending. 
+    # @param app_id [String] Your OneSignal App ID in UUID v4 format.
+    # @param domain [String] The sending domain to report on. Must be an email domain configured for this app.
+    # @param start [Time] Start of the reporting window, as an ISO 8601 timestamp (for example, &#x60;2026-08-01T00:00:00Z&#x60;).
+    # @param _end [Time] End of the reporting window, as an ISO 8601 timestamp (for example, &#x60;2026-08-08T00:00:00Z&#x60;).
+    # @param [Hash] opts the optional parameters
+    # @return [EmailProviderMetricsResponse]
+    def get_email_provider_metrics(app_id, domain, start, _end, opts = {})
+      data, _status_code, _headers = get_email_provider_metrics_with_http_info(app_id, domain, start, _end, opts)
+      data
+    end
+
+    # Get email inbox provider metrics
+    # Email delivery, opens, clicks, bounces, failures, and spam complaints broken down by inbox provider (Gmail, Outlook, Yahoo, Apple, and more) to pinpoint where deliverability problems are coming from. Metrics are reported for a single sending domain over the requested time range. &#x60;start&#x60; must be before &#x60;end&#x60; and no more than 365 days ago. &#x60;providers&#x60; is empty when the domain is not found for the app or is not currently active for sending. 
+    # @param app_id [String] Your OneSignal App ID in UUID v4 format.
+    # @param domain [String] The sending domain to report on. Must be an email domain configured for this app.
+    # @param start [Time] Start of the reporting window, as an ISO 8601 timestamp (for example, &#x60;2026-08-01T00:00:00Z&#x60;).
+    # @param _end [Time] End of the reporting window, as an ISO 8601 timestamp (for example, &#x60;2026-08-08T00:00:00Z&#x60;).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(EmailProviderMetricsResponse, Integer, Hash)>] EmailProviderMetricsResponse data, response status code and response headers
+    def get_email_provider_metrics_with_http_info(app_id, domain, start, _end, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DefaultApi.get_email_provider_metrics ...'
+      end
+      # verify the required parameter 'app_id' is set
+      if @api_client.config.client_side_validation && app_id.nil?
+        fail ArgumentError, "Missing the required parameter 'app_id' when calling DefaultApi.get_email_provider_metrics"
+      end
+      # verify the required parameter 'domain' is set
+      if @api_client.config.client_side_validation && domain.nil?
+        fail ArgumentError, "Missing the required parameter 'domain' when calling DefaultApi.get_email_provider_metrics"
+      end
+      # verify the required parameter 'start' is set
+      if @api_client.config.client_side_validation && start.nil?
+        fail ArgumentError, "Missing the required parameter 'start' when calling DefaultApi.get_email_provider_metrics"
+      end
+      # verify the required parameter '_end' is set
+      if @api_client.config.client_side_validation && _end.nil?
+        fail ArgumentError, "Missing the required parameter '_end' when calling DefaultApi.get_email_provider_metrics"
+      end
+      # resource path
+      local_var_path = '/apps/{app_id}/email_analytics/provider_metrics'.sub('{' + 'app_id' + '}', CGI.escape(app_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'domain'] = domain
+      query_params[:'start'] = start
+      query_params[:'end'] = _end
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EmailProviderMetricsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['rest_api_key']
+
+      new_options = opts.merge(
+        :operation => :"DefaultApi.get_email_provider_metrics",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DefaultApi#get_email_provider_metrics\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get email inbox provider metrics over time
+    # Email delivery, opens, clicks, bounces, failures, and spam complaints for a sending domain over time, bucketed by hour, day, or month. Use `providers[]` to narrow the totals to specific inbox providers (Gmail, Outlook, Yahoo, Apple, and more) and track how deliverability to them changes. Each event's metrics are totaled across the requested providers, or across all providers when none are given. `start` must be before `end` and no more than 365 days ago, or 60 days ago for `hourly` granularity. `events` is empty when the domain is not found for the app or is not currently active for sending. 
+    # @param app_id [String] Your OneSignal App ID in UUID v4 format.
+    # @param domain [String] The sending domain to report on. Must be an email domain configured for this app.
+    # @param start [Time] Start of the reporting window, as an ISO 8601 timestamp (for example, &#x60;2026-08-01T00:00:00Z&#x60;).
+    # @param _end [Time] End of the reporting window, as an ISO 8601 timestamp (for example, &#x60;2026-08-08T00:00:00Z&#x60;).
+    # @param granularity [String] The size of each time bucket. Hourly data is only available for the last 60 days.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :providers Inbox providers to include in the totals. Omit to include all providers. Accepted values: &#x60;apple&#x60;, &#x60;att&#x60;, &#x60;canadian&#x60;, &#x60;chinese&#x60;, &#x60;comcast&#x60;, &#x60;free_fr&#x60;, &#x60;french&#x60;, &#x60;german&#x60;, &#x60;gmail&#x60;, &#x60;google_workspace&#x60;, &#x60;googlers&#x60;, &#x60;inbox_lv&#x60;, &#x60;italian&#x60;, &#x60;japanese&#x60;, &#x60;outlook_365&#x60;, &#x60;outlook_eu&#x60;, &#x60;outlook_us&#x60;, &#x60;proton&#x60;, &#x60;rackspace&#x60;, &#x60;russian&#x60;, &#x60;uk&#x60;, &#x60;united_online&#x60;, &#x60;yahoo_eu&#x60;, &#x60;yahoo_us&#x60;, &#x60;other_eu&#x60;, &#x60;other_us&#x60;, and &#x60;other&#x60;. Example: providers[]&#x3D;gmail&amp;providers[]&#x3D;yahoo_us 
+    # @return [EmailProviderMetricsTimeseriesResponse]
+    def get_email_provider_metrics_timeseries(app_id, domain, start, _end, granularity, opts = {})
+      data, _status_code, _headers = get_email_provider_metrics_timeseries_with_http_info(app_id, domain, start, _end, granularity, opts)
+      data
+    end
+
+    # Get email inbox provider metrics over time
+    # Email delivery, opens, clicks, bounces, failures, and spam complaints for a sending domain over time, bucketed by hour, day, or month. Use &#x60;providers[]&#x60; to narrow the totals to specific inbox providers (Gmail, Outlook, Yahoo, Apple, and more) and track how deliverability to them changes. Each event&#39;s metrics are totaled across the requested providers, or across all providers when none are given. &#x60;start&#x60; must be before &#x60;end&#x60; and no more than 365 days ago, or 60 days ago for &#x60;hourly&#x60; granularity. &#x60;events&#x60; is empty when the domain is not found for the app or is not currently active for sending. 
+    # @param app_id [String] Your OneSignal App ID in UUID v4 format.
+    # @param domain [String] The sending domain to report on. Must be an email domain configured for this app.
+    # @param start [Time] Start of the reporting window, as an ISO 8601 timestamp (for example, &#x60;2026-08-01T00:00:00Z&#x60;).
+    # @param _end [Time] End of the reporting window, as an ISO 8601 timestamp (for example, &#x60;2026-08-08T00:00:00Z&#x60;).
+    # @param granularity [String] The size of each time bucket. Hourly data is only available for the last 60 days.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :providers Inbox providers to include in the totals. Omit to include all providers. Accepted values: &#x60;apple&#x60;, &#x60;att&#x60;, &#x60;canadian&#x60;, &#x60;chinese&#x60;, &#x60;comcast&#x60;, &#x60;free_fr&#x60;, &#x60;french&#x60;, &#x60;german&#x60;, &#x60;gmail&#x60;, &#x60;google_workspace&#x60;, &#x60;googlers&#x60;, &#x60;inbox_lv&#x60;, &#x60;italian&#x60;, &#x60;japanese&#x60;, &#x60;outlook_365&#x60;, &#x60;outlook_eu&#x60;, &#x60;outlook_us&#x60;, &#x60;proton&#x60;, &#x60;rackspace&#x60;, &#x60;russian&#x60;, &#x60;uk&#x60;, &#x60;united_online&#x60;, &#x60;yahoo_eu&#x60;, &#x60;yahoo_us&#x60;, &#x60;other_eu&#x60;, &#x60;other_us&#x60;, and &#x60;other&#x60;. Example: providers[]&#x3D;gmail&amp;providers[]&#x3D;yahoo_us 
+    # @return [Array<(EmailProviderMetricsTimeseriesResponse, Integer, Hash)>] EmailProviderMetricsTimeseriesResponse data, response status code and response headers
+    def get_email_provider_metrics_timeseries_with_http_info(app_id, domain, start, _end, granularity, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DefaultApi.get_email_provider_metrics_timeseries ...'
+      end
+      # verify the required parameter 'app_id' is set
+      if @api_client.config.client_side_validation && app_id.nil?
+        fail ArgumentError, "Missing the required parameter 'app_id' when calling DefaultApi.get_email_provider_metrics_timeseries"
+      end
+      # verify the required parameter 'domain' is set
+      if @api_client.config.client_side_validation && domain.nil?
+        fail ArgumentError, "Missing the required parameter 'domain' when calling DefaultApi.get_email_provider_metrics_timeseries"
+      end
+      # verify the required parameter 'start' is set
+      if @api_client.config.client_side_validation && start.nil?
+        fail ArgumentError, "Missing the required parameter 'start' when calling DefaultApi.get_email_provider_metrics_timeseries"
+      end
+      # verify the required parameter '_end' is set
+      if @api_client.config.client_side_validation && _end.nil?
+        fail ArgumentError, "Missing the required parameter '_end' when calling DefaultApi.get_email_provider_metrics_timeseries"
+      end
+      # verify the required parameter 'granularity' is set
+      if @api_client.config.client_side_validation && granularity.nil?
+        fail ArgumentError, "Missing the required parameter 'granularity' when calling DefaultApi.get_email_provider_metrics_timeseries"
+      end
+      # verify enum value
+      allowable_values = ["hourly", "daily", "monthly"]
+      if @api_client.config.client_side_validation && !allowable_values.include?(granularity)
+        fail ArgumentError, "invalid value for \"granularity\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/apps/{app_id}/email_analytics/provider_metrics_timeseries'.sub('{' + 'app_id' + '}', CGI.escape(app_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'domain'] = domain
+      query_params[:'start'] = start
+      query_params[:'end'] = _end
+      query_params[:'granularity'] = granularity
+      query_params[:'providers[]'] = @api_client.build_collection_param(opts[:'providers'], :multi) if !opts[:'providers'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EmailProviderMetricsTimeseriesResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['rest_api_key']
+
+      new_options = opts.merge(
+        :operation => :"DefaultApi.get_email_provider_metrics_timeseries",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DefaultApi#get_email_provider_metrics_timeseries\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get email reputation statistics
     # The email bounce and spam complaint rates received for the app over the last 24 hours, 7 days, and 30 days. Rates are expressed as fractions of successfully delivered emails (for example, `0.02` means 2%). A window reports `0` for both rates when the app has not successfully delivered any email in that period. 
     # @param app_id [String] Your OneSignal App ID in UUID v4 format.
@@ -2319,7 +2578,7 @@ module OneSignal
     # View Segment
     # Retrieve details for a single segment by its ID, including subscriber count and optionally segment metadata and filters.
     # @param app_id [String] The OneSignal App ID for your app.  Available in Keys &amp; IDs.
-    # @param segment_id [String] The segment&#39;s unique identifier. Can be found using the View Segments API or in the URL of the segment when viewing it in the dashboard.
+    # @param segment_id [String] The segment&#39;s unique identifier. In the dashboard, go to Audience &gt; Segments, open the segment&#39;s options menu, and select Copy segment ID. You can also get it from the View Segments API or the segment&#39;s URL in the dashboard.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :include_segment_detail Set to true to include segment metadata and filters in the response.
     # @return [GetSegmentSuccessResponse]
@@ -2331,7 +2590,7 @@ module OneSignal
     # View Segment
     # Retrieve details for a single segment by its ID, including subscriber count and optionally segment metadata and filters.
     # @param app_id [String] The OneSignal App ID for your app.  Available in Keys &amp; IDs.
-    # @param segment_id [String] The segment&#39;s unique identifier. Can be found using the View Segments API or in the URL of the segment when viewing it in the dashboard.
+    # @param segment_id [String] The segment&#39;s unique identifier. In the dashboard, go to Audience &gt; Segments, open the segment&#39;s options menu, and select Copy segment ID. You can also get it from the View Segments API or the segment&#39;s URL in the dashboard.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :include_segment_detail Set to true to include segment metadata and filters in the response.
     # @return [Array<(GetSegmentSuccessResponse, Integer, Hash)>] GetSegmentSuccessResponse data, response status code and response headers
@@ -3360,7 +3619,7 @@ module OneSignal
     # Update Segment
     # Update an existing segment's name and/or filters. The name parameter is always required. When filters are provided, all existing filters are replaced with the new ones.
     # @param app_id [String] The OneSignal App ID for your app.  Available in Keys &amp; IDs.
-    # @param segment_id [String] The segment&#39;s unique identifier. Can be found using the View Segments API or in the URL of the segment when viewing it in the dashboard.
+    # @param segment_id [String] The segment&#39;s unique identifier. In the dashboard, go to Audience &gt; Segments, open the segment&#39;s options menu, and select Copy segment ID. You can also get it from the View Segments API or the segment&#39;s URL in the dashboard.
     # @param [Hash] opts the optional parameters
     # @option opts [UpdateSegmentRequest] :update_segment_request 
     # @return [UpdateSegmentSuccessResponse]
@@ -3372,7 +3631,7 @@ module OneSignal
     # Update Segment
     # Update an existing segment&#39;s name and/or filters. The name parameter is always required. When filters are provided, all existing filters are replaced with the new ones.
     # @param app_id [String] The OneSignal App ID for your app.  Available in Keys &amp; IDs.
-    # @param segment_id [String] The segment&#39;s unique identifier. Can be found using the View Segments API or in the URL of the segment when viewing it in the dashboard.
+    # @param segment_id [String] The segment&#39;s unique identifier. In the dashboard, go to Audience &gt; Segments, open the segment&#39;s options menu, and select Copy segment ID. You can also get it from the View Segments API or the segment&#39;s URL in the dashboard.
     # @param [Hash] opts the optional parameters
     # @option opts [UpdateSegmentRequest] :update_segment_request 
     # @return [Array<(UpdateSegmentSuccessResponse, Integer, Hash)>] UpdateSegmentSuccessResponse data, response status code and response headers

data/lib/onesignal/api_client.rb

@@ -89,13 +89,14 @@ module OneSignal
       url = build_request_url(path, opts)
       http_method = http_method.to_sym.downcase
 
-      opts[:header_params]['OS-Usage-Data'] = 'kind=sdk, sdk-name=onesignal-ruby, version=5.16.0'
+      opts[:header_params]['OS-Usage-Data'] = 'kind=sdk, sdk-name=onesignal-ruby, version=5.18.0'
       header_params = @default_headers.merge(opts[:header_params] || {})
       query_params = opts[:query_params] || {}
       form_params = opts[:form_params] || {}
       follow_location = opts[:follow_location] || true
 
       update_params_for_auth! header_params, query_params, opts[:auth_names]
+      query_params = serialize_query_params(query_params)
 
       # set ssl_verifyhosts option based on @config.verify_ssl_host (true/false)
       _verify_ssl_host = @config.verify_ssl_host ? 2 : 0
@@ -388,5 +389,27 @@ module OneSignal
         fail "unknown collection format: #{collection_format.inspect}"
       end
     end
+
+    # Serialize query parameter values for the wire.
+    # Time, DateTime and Date values are sent as ISO 8601 (Time#to_s is not),
+    # including inside arrays; other values are passed through unchanged.
+    # @param [Hash] query_params Query parameters
+    # @return [Hash] Query parameters with serialized values
+    def serialize_query_params(query_params)
+      query_params.transform_values { |value| serialize_query_value(value) }
+    end
+
+    # @param [Object] value Query parameter value
+    # @return [Object] ISO 8601 string for Time/Date values, the value otherwise
+    def serialize_query_value(value)
+      case value
+      when Array
+        value.map { |item| serialize_query_value(item) }
+      when Time, Date
+        value.iso8601
+      else
+        value
+      end
+    end
   end
 end

data/lib/onesignal/configuration.rb

@@ -102,7 +102,9 @@ module OneSignal
     attr_accessor :key_file
 
     # Set this to customize parameters encoding of array parameter with multi collectionFormat.
-    # Default to nil.
+    # Defaults to :multi, which sends arrays as repeated keys (ids=a&ids=b), matching
+    # OpenAPI `style: form, explode: true`. nil falls back to Ethon's default
+    # (ids[0]=a&ids[1]=b).
     #
     # @see The params_encoding option of Ethon. Related source code:
     # https://github.com/typhoeus/ethon/blob/master/lib/ethon/easy/queryable.rb#L96
@@ -128,7 +130,7 @@ module OneSignal
       @cert_file = nil
       @key_file = nil
       @timeout = 0
-      @params_encoding = nil
+      @params_encoding = :multi
       @debugging = false
       @inject_format = false
       @force_ending_format = false