sunshine-conversations-client 12.3.1 → 12.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8014a834c366dcfe53fa40bf41270cda78e5cb6f
-  data.tar.gz: 475fedee87e8df4188082c7e8fc759207696878e
+  metadata.gz: dab15fa37a1e37b7cde889379492a89de327d3f0
+  data.tar.gz: e06b626a424572401b1f569be57a645d3e6bbd8a
 SHA512:
-  metadata.gz: 074b0c0df6a42bed7fc9eb608472f7339340fab46e57d371f20415215ab2cef51bcddcf70869eaeb18b5c7c4894604d1f68e8da1e193b2671c4f98737b5a6899
-  data.tar.gz: 1da1f375bf3b8a68b2f340c4edff091d9220244fe721afc3ec9f7adf5eb320d228c52812cb3c08f0915b5c6793bd886cd069c95d9409fb7621386a98879d1231
+  metadata.gz: 8c38c5594bf76939a709198f897c63167e0d0804fc80963b275fae2f5d2a0292b8d917f291a0432acb5a046724e30b594ff904581eb46b3a1353ec1ae7bc44da
+  data.tar.gz: b835fe404b4a81a481119aa2d7764aef9a8c3b34ad6f1e25be876995efd9dd0c3db625b069be8aa63c69e0472d0d3070f41cfce2fa5557c3f7a140a1d891bcfc

data/CHANGELOG_RB.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [12.5.0] - 2024-05-01
+
+### Added
+
+- Added `Devices` endpoint to the Users API.
+
+## [12.4.0] - 2024-04-24
+
+### Changed
+
+- Changed Android integration creation and update: added properties for new Firebase credentials and deprecated legacy properties
+
 ## [12.3.1] - 2024-03-07
 
 ### Fixed

data/README.md

@@ -4,8 +4,8 @@ SunshineConversationsClient - the Ruby gem for the Sunshine Conversations API
 
 This SDK is automatically generated by the [OpenAPI Generator Codegen](https://github.com/OpenAPITools/openapi-generator) project using the [Sunshine Conversations API spec](https://github.com/zendesk/sunshine-conversations-api-spec).
 
-- API version: 12.3.1
-- Package version: 12.3.1
+- API version: 12.5.0
+- Package version: 12.5.0
 - Build package: org.openapitools.codegen.languages.RubyClientCodegen
 
 ## Sunshine Conversations API Version
@@ -32,16 +32,16 @@ gem build sunshine-conversations-client.gemspec
 Then either install the gem locally:
 
 ```shell
-gem install ./sunshine-conversations-client-12.3.1.gem
+gem install ./sunshine-conversations-client-12.5.0.gem
 ```
 
-(for development, run `gem install --dev ./sunshine-conversations-client-12.3.1.gem` to install the development dependencies)
+(for development, run `gem install --dev ./sunshine-conversations-client-12.5.0.gem` to install the development dependencies)
 
 or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
 
 Finally add this to the Gemfile:
 
-    gem 'sunshine-conversations-client', '~> 12.3.1'
+    gem 'sunshine-conversations-client', '~> 12.5.0'
 
 ### Install from Git
 
@@ -157,6 +157,8 @@ Class | Method | HTTP request | Description
 *SunshineConversationsClient::CustomIntegrationApiKeysApi* | [**delete_custom_integration_key**](docs/CustomIntegrationApiKeysApi.md#delete_custom_integration_key) | **DELETE** /v2/apps/{appId}/integrations/{integrationId}/keys/{keyId} | Delete Integration Key
 *SunshineConversationsClient::CustomIntegrationApiKeysApi* | [**get_custom_integration_key**](docs/CustomIntegrationApiKeysApi.md#get_custom_integration_key) | **GET** /v2/apps/{appId}/integrations/{integrationId}/keys/{keyId} | Get Integration Key
 *SunshineConversationsClient::CustomIntegrationApiKeysApi* | [**list_custom_integration_keys**](docs/CustomIntegrationApiKeysApi.md#list_custom_integration_keys) | **GET** /v2/apps/{appId}/integrations/{integrationId}/keys | List Integration Keys
+*SunshineConversationsClient::DevicesApi* | [**get_device**](docs/DevicesApi.md#get_device) | **GET** /v2/apps/{appId}/users/{userIdOrExternalId}/devices/{deviceId} | Get Device
+*SunshineConversationsClient::DevicesApi* | [**list_devices**](docs/DevicesApi.md#list_devices) | **GET** /v2/apps/{appId}/users/{userIdOrExternalId}/devices | List Devices
 *SunshineConversationsClient::IntegrationsApi* | [**create_integration**](docs/IntegrationsApi.md#create_integration) | **POST** /v2/apps/{appId}/integrations | Create Integration
 *SunshineConversationsClient::IntegrationsApi* | [**delete_integration**](docs/IntegrationsApi.md#delete_integration) | **DELETE** /v2/apps/{appId}/integrations/{integrationId} | Delete Integration
 *SunshineConversationsClient::IntegrationsApi* | [**get_integration**](docs/IntegrationsApi.md#get_integration) | **GET** /v2/apps/{appId}/integrations/{integrationId} | Get Integration
@@ -305,6 +307,7 @@ Class | Method | HTTP request | Description
  - [SunshineConversationsClient::CustomUpdate](docs/CustomUpdate.md)
  - [SunshineConversationsClient::Destination](docs/Destination.md)
  - [SunshineConversationsClient::Device](docs/Device.md)
+ - [SunshineConversationsClient::DeviceResponse](docs/DeviceResponse.md)
  - [SunshineConversationsClient::EventSubSchema](docs/EventSubSchema.md)
  - [SunshineConversationsClient::ExtraChannelOptions](docs/ExtraChannelOptions.md)
  - [SunshineConversationsClient::ExtraChannelOptionsMessenger](docs/ExtraChannelOptionsMessenger.md)

data/docs/Android.md

@@ -4,7 +4,10 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**type** | **String** | To configure an android integration, first visit the [Firebase Console](https://console.firebase.google.com/). Copy the `serverKey` and `senderId` from the Cloud Messaging tab in the settings of your project and call the create integrations endpoint with this data. If you would like to continue using your legacy GCM `serverKey` you can also obtain it from the [Google Developer Console](https://console.developers.google.com/).  | [optional] [default to 'android']
+**type** | **String** | <aside class=\"notice\">Firebase Cloud Messaging has deprecated its legacy APIs for HTTP and XMPP. Legacy credentials <code>serverKey</code> and <code>senderId</code> will stop working as of June 2024 and must be replaced with OAuth 2.0 access token based credentials.</aside>  To configure an android integration, first visit the [Firebase Console](https://console.firebase.google.com/).  Generate a private key from the Service accounts tab in the settings.  Copy the `project_id`, `client_email` and `private_key` from the generated JSON file and call the create integrations endpoint with this data.  | [optional] [default to 'android']
+**project_id** | **String** | Your project ID from your generated private key file. | [optional] 
+**client_email** | **String** | Your client email from your generated private key file. | [optional] 
+**private_key** | **String** | Your private key from your generated private key file. | [optional] 
 **server_key** | **String** | Your server key from the fcm console. | [optional] 
 **sender_id** | **String** | Your sender id from the fcm console. | [optional] 
 **can_user_create_more_conversations** | **Boolean** | Allows users to create more than one conversation on the android integration. | [optional] 
@@ -16,6 +19,9 @@ Name | Type | Description | Notes
 require 'SunshineConversationsClient'
 
 instance = SunshineConversationsClient::Android.new(type: null,
+                                 project_id: <project-id>,
+                                 client_email: <client-email>,
+                                 private_key: <private-key>,
                                  server_key: <server-key>,
                                  sender_id: <sender-id>,
                                  can_user_create_more_conversations: null,

data/docs/AndroidAllOf.md

@@ -4,7 +4,10 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**type** | **String** | To configure an android integration, first visit the [Firebase Console](https://console.firebase.google.com/). Copy the `serverKey` and `senderId` from the Cloud Messaging tab in the settings of your project and call the create integrations endpoint with this data. If you would like to continue using your legacy GCM `serverKey` you can also obtain it from the [Google Developer Console](https://console.developers.google.com/).  | [optional] [default to 'android']
+**type** | **String** | <aside class=\"notice\">Firebase Cloud Messaging has deprecated its legacy APIs for HTTP and XMPP. Legacy credentials <code>serverKey</code> and <code>senderId</code> will stop working as of June 2024 and must be replaced with OAuth 2.0 access token based credentials.</aside>  To configure an android integration, first visit the [Firebase Console](https://console.firebase.google.com/).  Generate a private key from the Service accounts tab in the settings.  Copy the `project_id`, `client_email` and `private_key` from the generated JSON file and call the create integrations endpoint with this data.  | [optional] [default to 'android']
+**project_id** | **String** | Your project ID from your generated private key file. | [optional] 
+**client_email** | **String** | Your client email from your generated private key file. | [optional] 
+**private_key** | **String** | Your private key from your generated private key file. | [optional] 
 **server_key** | **String** | Your server key from the fcm console. | [optional] 
 **sender_id** | **String** | Your sender id from the fcm console. | [optional] 
 **can_user_create_more_conversations** | **Boolean** | Allows users to create more than one conversation on the android integration. | [optional] 
@@ -16,6 +19,9 @@ Name | Type | Description | Notes
 require 'SunshineConversationsClient'
 
 instance = SunshineConversationsClient::AndroidAllOf.new(type: null,
+                                 project_id: <project-id>,
+                                 client_email: <client-email>,
+                                 private_key: <private-key>,
                                  server_key: <server-key>,
                                  sender_id: <sender-id>,
                                  can_user_create_more_conversations: null,

data/docs/AndroidUpdate.md

@@ -5,6 +5,9 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **display_name** | **String** | A human-friendly name used to identify the integration. `displayName` can be unset by changing it to `null`. | [optional] 
+**project_id** | **String** | Your project ID from your generated private key file. | [optional] 
+**client_email** | **String** | Your client email from your generated private key file. | [optional] 
+**private_key** | **String** | Your private key from your generated private key file. | [optional] 
 **server_key** | **String** | Your server key from the fcm console. | [optional] 
 **sender_id** | **String** | Your sender id from the fcm console. | [optional] 
 **can_user_create_more_conversations** | **Boolean** | Allows users to create more than one conversation on the android integration. | [optional] 
@@ -15,6 +18,9 @@ Name | Type | Description | Notes
 require 'SunshineConversationsClient'
 
 instance = SunshineConversationsClient::AndroidUpdate.new(display_name: My awesome integration,
+                                 project_id: <project-id>,
+                                 client_email: <client-email>,
+                                 private_key: <private-key>,
                                  server_key: <server-key>,
                                  sender_id: <sender-id>,
                                  can_user_create_more_conversations: null)

data/docs/AndroidUpdateAllOf.md

@@ -4,6 +4,9 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
+**project_id** | **String** | Your project ID from your generated private key file. | [optional] 
+**client_email** | **String** | Your client email from your generated private key file. | [optional] 
+**private_key** | **String** | Your private key from your generated private key file. | [optional] 
 **server_key** | **String** | Your server key from the fcm console. | [optional] 
 **sender_id** | **String** | Your sender id from the fcm console. | [optional] 
 **can_user_create_more_conversations** | **Boolean** | Allows users to create more than one conversation on the android integration. | [optional] 
@@ -13,7 +16,10 @@ Name | Type | Description | Notes
 ```ruby
 require 'SunshineConversationsClient'
 
-instance = SunshineConversationsClient::AndroidUpdateAllOf.new(server_key: <server-key>,
+instance = SunshineConversationsClient::AndroidUpdateAllOf.new(project_id: <project-id>,
+                                 client_email: <client-email>,
+                                 private_key: <private-key>,
+                                 server_key: <server-key>,
                                  sender_id: <sender-id>,
                                  can_user_create_more_conversations: null)
 ```

data/docs/DeviceResponse.md

@@ -0,0 +1,17 @@
+# SunshineConversationsClient::DeviceResponse
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**device** | [**Device**](Device.md) | The device. | [optional] 
+
+## Code Sample
+
+```ruby
+require 'SunshineConversationsClient'
+
+instance = SunshineConversationsClient::DeviceResponse.new(device: null)
+```
+
+

data/docs/DevicesApi.md

@@ -0,0 +1,132 @@
+# SunshineConversationsClient::DevicesApi
+
+All URIs are relative to *https://api.smooch.io*
+
+Method | HTTP request | Description
+------------- | ------------- | -------------
+[**get_device**](DevicesApi.md#get_device) | **GET** /v2/apps/{appId}/users/{userIdOrExternalId}/devices/{deviceId} | Get Device
+[**list_devices**](DevicesApi.md#list_devices) | **GET** /v2/apps/{appId}/users/{userIdOrExternalId}/devices | List Devices
+
+
+
+## get_device
+
+> DeviceResponse get_device(app_id, user_id_or_external_id, device_id)
+
+Get Device
+
+Fetches a specific Device.  ```shell /v2/apps/:appId/users/:userId ``` 
+
+### Example
+
+```ruby
+# load the gem
+require 'sunshine-conversations-client'
+# setup authorization
+SunshineConversationsClient.configure do |config|
+  # Configure HTTP basic authorization: basicAuth
+  config.username = 'YOUR_USERNAME'
+  config.password = 'YOUR_PASSWORD'
+
+  # Configure Bearer authorization (JWT): bearerAuth
+  # Uncomment this line to use JWTs
+  # config.access_token = 'YOUR_JWT'
+end
+
+api_instance = SunshineConversationsClient::DevicesApi.new
+app_id = '5d8cff3cd55b040010928b5b' # String | Identifies the app.
+user_id_or_external_id = '42589ad070d43be9b00ff7e5' # String | The user's id or externalId.
+device_id = '5d8cff3cd55b040010928b5b' # String | The device's id.
+# Be sure to add the required body parameters
+
+begin
+  #Get Device
+  result = api_instance.get_device(app_id, user_id_or_external_id, device_id)
+  p result
+rescue SunshineConversationsClient::ApiError => e
+  puts "Exception when calling DevicesApi->get_device: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **app_id** | **String**| Identifies the app. | 
+ **user_id_or_external_id** | **String**| The user's id or externalId. | 
+ **device_id** | **String**| The device's id. | 
+
+### Return type
+
+[**DeviceResponse**](DeviceResponse.md)
+
+### Authorization
+
+[basicAuth](../README.md#basicAuth), [bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_devices
+
+> ClientListResponse list_devices(app_id, user_id_or_external_id)
+
+List Devices
+
+Get all the devices for a particular user. The Devices are sorted based on last seen time.  ```shell /v2/apps/:appId/users/:userId/devices ``` 
+
+### Example
+
+```ruby
+# load the gem
+require 'sunshine-conversations-client'
+# setup authorization
+SunshineConversationsClient.configure do |config|
+  # Configure HTTP basic authorization: basicAuth
+  config.username = 'YOUR_USERNAME'
+  config.password = 'YOUR_PASSWORD'
+
+  # Configure Bearer authorization (JWT): bearerAuth
+  # Uncomment this line to use JWTs
+  # config.access_token = 'YOUR_JWT'
+end
+
+api_instance = SunshineConversationsClient::DevicesApi.new
+app_id = '5d8cff3cd55b040010928b5b' # String | Identifies the app.
+user_id_or_external_id = '42589ad070d43be9b00ff7e5' # String | The user's id or externalId.
+# Be sure to add the required body parameters
+
+begin
+  #List Devices
+  result = api_instance.list_devices(app_id, user_id_or_external_id)
+  p result
+rescue SunshineConversationsClient::ApiError => e
+  puts "Exception when calling DevicesApi->list_devices: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **app_id** | **String**| Identifies the app. | 
+ **user_id_or_external_id** | **String**| The user's id or externalId. | 
+
+### Return type
+
+[**ClientListResponse**](ClientListResponse.md)
+
+### Authorization
+
+[basicAuth](../README.md#basicAuth), [bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+

data/docs/IntegrationUpdate.md

@@ -5,6 +5,9 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **display_name** | **String** | A human-friendly name used to identify the integration. `displayName` can be unset by changing it to `null`. | [optional] 
+**project_id** | **String** | Your project ID from your generated private key file. | [optional] 
+**client_email** | **String** | Your client email from your generated private key file. | [optional] 
+**private_key** | **String** | Your private key from your generated private key file. | [optional] 
 **server_key** | **String** | Your server key from the fcm console. | [optional] 
 **sender_id** | **String** | Your sender id from the fcm console. | [optional] 
 **can_user_create_more_conversations** | **Boolean** | Allows users to create more than one conversation on the web messenger integration. | [optional] 
@@ -39,6 +42,9 @@ Name | Type | Description | Notes
 require 'SunshineConversationsClient'
 
 instance = SunshineConversationsClient::IntegrationUpdate.new(display_name: My awesome integration,
+                                 project_id: <project-id>,
+                                 client_email: <client-email>,
+                                 private_key: <private-key>,
                                  server_key: <server-key>,
                                  sender_id: <sender-id>,
                                  can_user_create_more_conversations: null,

data/lib/sunshine-conversations-client/api/activities_api.rb

@@ -1,7 +1,7 @@
 =begin
 #Sunshine Conversations API
 
-The version of the OpenAPI document: 12.3.1
+The version of the OpenAPI document: 12.5.0
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1

data/lib/sunshine-conversations-client/api/app_keys_api.rb

@@ -1,7 +1,7 @@
 =begin
 #Sunshine Conversations API
 
-The version of the OpenAPI document: 12.3.1
+The version of the OpenAPI document: 12.5.0
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1

data/lib/sunshine-conversations-client/api/apps_api.rb

@@ -1,7 +1,7 @@
 =begin
 #Sunshine Conversations API
 
-The version of the OpenAPI document: 12.3.1
+The version of the OpenAPI document: 12.5.0
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1

data/lib/sunshine-conversations-client/api/attachments_api.rb

@@ -1,7 +1,7 @@
 =begin
 #Sunshine Conversations API
 
-The version of the OpenAPI document: 12.3.1
+The version of the OpenAPI document: 12.5.0
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1

data/lib/sunshine-conversations-client/api/clients_api.rb

@@ -1,7 +1,7 @@
 =begin
 #Sunshine Conversations API
 
-The version of the OpenAPI document: 12.3.1
+The version of the OpenAPI document: 12.5.0
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1

data/lib/sunshine-conversations-client/api/conversations_api.rb

@@ -1,7 +1,7 @@
 =begin
 #Sunshine Conversations API
 
-The version of the OpenAPI document: 12.3.1
+The version of the OpenAPI document: 12.5.0
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1

data/lib/sunshine-conversations-client/api/custom_integration_api_keys_api.rb

@@ -1,7 +1,7 @@
 =begin
 #Sunshine Conversations API
 
-The version of the OpenAPI document: 12.3.1
+The version of the OpenAPI document: 12.5.0
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1

data/lib/sunshine-conversations-client/api/devices_api.rb

@@ -0,0 +1,161 @@
+=begin
+#Sunshine Conversations API
+
+The version of the OpenAPI document: 12.5.0
+
+Generated by: https://openapi-generator.tech
+OpenAPI Generator version: 4.3.1
+=end
+
+require 'cgi'
+
+module SunshineConversationsClient
+  class DevicesApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get Device
+    # Fetches a specific Device.  ```shell /v2/apps/:appId/users/:userId ``` 
+    # @param app_id [String] Identifies the app.
+    # @param user_id_or_external_id [String] The user's id or externalId.
+    # @param device_id [String] The device's id.
+    # @param [Hash] opts the optional parameters
+    # @return [DeviceResponse]
+    def get_device(app_id, user_id_or_external_id, device_id, opts = {})
+      data, _status_code, _headers = get_device_with_http_info(app_id, user_id_or_external_id, device_id, opts)
+      data
+    end
+
+    # Get Device
+    # Fetches a specific Device.  ```shell /v2/apps/:appId/users/:userId ``` 
+    # @param app_id [String] Identifies the app.
+    # @param user_id_or_external_id [String] The user's id or externalId.
+    # @param device_id [String] The device's id.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DeviceResponse, Integer, Hash)>] DeviceResponse data, response status code and response headers
+    def get_device_with_http_info(app_id, user_id_or_external_id, device_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DevicesApi.get_device ...'
+      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 DevicesApi.get_device"
+      end
+      # verify the required parameter 'user_id_or_external_id' is set
+      if @api_client.config.client_side_validation && user_id_or_external_id.nil?
+        fail ArgumentError, "Missing the required parameter 'user_id_or_external_id' when calling DevicesApi.get_device"
+      end
+      # verify the required parameter 'device_id' is set
+      if @api_client.config.client_side_validation && device_id.nil?
+        fail ArgumentError, "Missing the required parameter 'device_id' when calling DevicesApi.get_device"
+      end
+      # resource path
+      local_var_path = '/v2/apps/{appId}/users/{userIdOrExternalId}/devices/{deviceId}'.sub('{' + 'appId' + '}', CGI.escape(app_id.to_s)).sub('{' + 'userIdOrExternalId' + '}', CGI.escape(user_id_or_external_id.to_s)).sub('{' + 'deviceId' + '}', CGI.escape(device_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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:body] 
+
+      # return_type
+      return_type = opts[:return_type] || 'DeviceResponse' 
+
+      # auth_names
+      auth_names = opts[:auth_names] || ['basicAuth', 'bearerAuth']
+
+      new_options = opts.merge(
+        :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: DevicesApi#get_device\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List Devices
+    # Get all the devices for a particular user. The Devices are sorted based on last seen time.  ```shell /v2/apps/:appId/users/:userId/devices ``` 
+    # @param app_id [String] Identifies the app.
+    # @param user_id_or_external_id [String] The user&#39;s id or externalId.
+    # @param [Hash] opts the optional parameters
+    # @return [ClientListResponse]
+    def list_devices(app_id, user_id_or_external_id, opts = {})
+      data, _status_code, _headers = list_devices_with_http_info(app_id, user_id_or_external_id, opts)
+      data
+    end
+
+    # List Devices
+    # Get all the devices for a particular user. The Devices are sorted based on last seen time.  &#x60;&#x60;&#x60;shell /v2/apps/:appId/users/:userId/devices &#x60;&#x60;&#x60; 
+    # @param app_id [String] Identifies the app.
+    # @param user_id_or_external_id [String] The user&#39;s id or externalId.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ClientListResponse, Integer, Hash)>] ClientListResponse data, response status code and response headers
+    def list_devices_with_http_info(app_id, user_id_or_external_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DevicesApi.list_devices ...'
+      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 DevicesApi.list_devices"
+      end
+      # verify the required parameter 'user_id_or_external_id' is set
+      if @api_client.config.client_side_validation && user_id_or_external_id.nil?
+        fail ArgumentError, "Missing the required parameter 'user_id_or_external_id' when calling DevicesApi.list_devices"
+      end
+      # resource path
+      local_var_path = '/v2/apps/{appId}/users/{userIdOrExternalId}/devices'.sub('{' + 'appId' + '}', CGI.escape(app_id.to_s)).sub('{' + 'userIdOrExternalId' + '}', CGI.escape(user_id_or_external_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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:body] 
+
+      # return_type
+      return_type = opts[:return_type] || 'ClientListResponse' 
+
+      # auth_names
+      auth_names = opts[:auth_names] || ['basicAuth', 'bearerAuth']
+
+      new_options = opts.merge(
+        :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: DevicesApi#list_devices\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/sunshine-conversations-client/api/integrations_api.rb

@@ -1,7 +1,7 @@
 =begin
 #Sunshine Conversations API
 
-The version of the OpenAPI document: 12.3.1
+The version of the OpenAPI document: 12.5.0
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1

data/lib/sunshine-conversations-client/api/messages_api.rb

@@ -1,7 +1,7 @@
 =begin
 #Sunshine Conversations API
 
-The version of the OpenAPI document: 12.3.1
+The version of the OpenAPI document: 12.5.0
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1

data/lib/sunshine-conversations-client/api/o_auth_endpoints_api.rb

@@ -1,7 +1,7 @@
 =begin
 #Sunshine Conversations API
 
-The version of the OpenAPI document: 12.3.1
+The version of the OpenAPI document: 12.5.0
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1

data/lib/sunshine-conversations-client/api/participants_api.rb

@@ -1,7 +1,7 @@
 =begin
 #Sunshine Conversations API
 
-The version of the OpenAPI document: 12.3.1
+The version of the OpenAPI document: 12.5.0
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1

data/lib/sunshine-conversations-client/api/switchboard_actions_api.rb

@@ -1,7 +1,7 @@
 =begin
 #Sunshine Conversations API
 
-The version of the OpenAPI document: 12.3.1
+The version of the OpenAPI document: 12.5.0
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1

data/lib/sunshine-conversations-client/api/switchboard_integrations_api.rb

@@ -1,7 +1,7 @@
 =begin
 #Sunshine Conversations API
 
-The version of the OpenAPI document: 12.3.1
+The version of the OpenAPI document: 12.5.0
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1

data/lib/sunshine-conversations-client/api/switchboards_api.rb

@@ -1,7 +1,7 @@
 =begin
 #Sunshine Conversations API
 
-The version of the OpenAPI document: 12.3.1
+The version of the OpenAPI document: 12.5.0
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1

data/lib/sunshine-conversations-client/api/users_api.rb

@@ -1,7 +1,7 @@
 =begin
 #Sunshine Conversations API
 
-The version of the OpenAPI document: 12.3.1
+The version of the OpenAPI document: 12.5.0
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1