zyphr 0.1.50 → 0.1.52

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a4fd52fa232b4a334d6ea406412fa92ee9d076583b6038b8e9d0231b5c77c016
-  data.tar.gz: 2f2e95c64d51dc3f4c48309a580d7e21960fc5a3665359b5986431e1f833c6b5
+  metadata.gz: f75ed6cc534f48323ebfd87603494f864ccaa1a04c92fe195f57259314cb8f37
+  data.tar.gz: 718da4c96ac21ee903d062e2571cf277ba0f79cfc60c6afd73ffe9b92eb57277
 SHA512:
-  metadata.gz: 48bdb019fd49d35023234cc46edb30ed3aa0716a267aefa6fbfb8c3147be8e3cde1bf60bd01f0c12e1e443111fd5bb58f49a853d2c09e1c28b91040103c1f0fe
-  data.tar.gz: fc7da20a4d8529d1a12e120bf0ffcf30588f26cc4abbfe8c0ea386c21d3435eac9aca82229a96f416d8d5826542881ec71c62f47c453b75179bdd9fd9f94e734
+  metadata.gz: d502a6ef3e460bbbf38adda6c8c0a9752860e07e1fbf50fdd51191e6964ee494a9ab6fa3142ba4bb6ad5046e2a0436dce6edbde6458c5d843c3eefb09eb5e326
+  data.tar.gz: 92a8acd011029ec21a5b872189a875ae4529a387cf669f560b36a63b20ad89b3dc1eb5bee28a167b0aac65f663e8f0b7146e766264873178e2344fcbf8cc1c34

data/README.md

@@ -167,6 +167,7 @@ Class | Method | HTTP request | Description
 *Zyphr::AuthMFAApi* | [**verify_mfa_enrollment**](docs/AuthMFAApi.md#verify_mfa_enrollment) | **POST** /auth/mfa/verify-enrollment | Verify MFA enrollment
 *Zyphr::AuthMagicLinksApi* | [**send_magic_link**](docs/AuthMagicLinksApi.md#send_magic_link) | **POST** /auth/magic-link/send | Send a magic link
 *Zyphr::AuthMagicLinksApi* | [**verify_magic_link**](docs/AuthMagicLinksApi.md#verify_magic_link) | **POST** /auth/magic-link/verify | Verify a magic link
+*Zyphr::AuthOAuthApi* | [**complete_o_auth_link**](docs/AuthOAuthApi.md#complete_o_auth_link) | **POST** /auth/oauth/{provider}/link/callback | Complete linking an OAuth provider to the current account
 *Zyphr::AuthOAuthApi* | [**disconnect_o_auth_provider**](docs/AuthOAuthApi.md#disconnect_o_auth_provider) | **DELETE** /auth/oauth/{provider} | Disconnect OAuth provider
 *Zyphr::AuthOAuthApi* | [**get_o_auth_authorization_url**](docs/AuthOAuthApi.md#get_o_auth_authorization_url) | **GET** /auth/oauth/{provider}/authorize | Get OAuth authorization URL
 *Zyphr::AuthOAuthApi* | [**get_o_auth_connection_info**](docs/AuthOAuthApi.md#get_o_auth_connection_info) | **GET** /auth/oauth/connections/{provider} | Get OAuth connection info
@@ -175,6 +176,7 @@ Class | Method | HTTP request | Description
 *Zyphr::AuthOAuthApi* | [**list_o_auth_connections**](docs/AuthOAuthApi.md#list_o_auth_connections) | **GET** /auth/oauth/connections | List OAuth connections
 *Zyphr::AuthOAuthApi* | [**list_o_auth_providers**](docs/AuthOAuthApi.md#list_o_auth_providers) | **GET** /auth/oauth/providers | List OAuth providers
 *Zyphr::AuthOAuthApi* | [**refresh_o_auth_tokens**](docs/AuthOAuthApi.md#refresh_o_auth_tokens) | **POST** /auth/oauth/tokens/{provider}/refresh | Refresh OAuth provider tokens
+*Zyphr::AuthOAuthApi* | [**start_o_auth_link**](docs/AuthOAuthApi.md#start_o_auth_link) | **GET** /auth/oauth/{provider}/link | Start linking an OAuth provider to the current account
 *Zyphr::AuthOrganizationsApi* | [**add_organization_member**](docs/AuthOrganizationsApi.md#add_organization_member) | **POST** /auth/organizations/{id}/members | Add a member to an organization
 *Zyphr::AuthOrganizationsApi* | [**create_organization**](docs/AuthOrganizationsApi.md#create_organization) | **POST** /auth/organizations | Create an organization
 *Zyphr::AuthOrganizationsApi* | [**delete_organization**](docs/AuthOrganizationsApi.md#delete_organization) | **DELETE** /auth/organizations/{id} | Delete an organization
@@ -598,6 +600,8 @@ Class | Method | HTTP request | Description
  - [Zyphr::MfaVerifyRequest](docs/MfaVerifyRequest.md)
  - [Zyphr::OAuthAuthorizationUrlResponse](docs/OAuthAuthorizationUrlResponse.md)
  - [Zyphr::OAuthAuthorizationUrlResponseData](docs/OAuthAuthorizationUrlResponseData.md)
+ - [Zyphr::OAuthAuthorizeResponse](docs/OAuthAuthorizeResponse.md)
+ - [Zyphr::OAuthAuthorizeResponseData](docs/OAuthAuthorizeResponseData.md)
  - [Zyphr::OAuthCallbackRequest](docs/OAuthCallbackRequest.md)
  - [Zyphr::OAuthCallbackResponse](docs/OAuthCallbackResponse.md)
  - [Zyphr::OAuthCallbackResponseData](docs/OAuthCallbackResponseData.md)
@@ -606,6 +610,8 @@ Class | Method | HTTP request | Description
  - [Zyphr::OAuthConnectionInfoResponseData](docs/OAuthConnectionInfoResponseData.md)
  - [Zyphr::OAuthConnectionsResponse](docs/OAuthConnectionsResponse.md)
  - [Zyphr::OAuthConnectionsResponseData](docs/OAuthConnectionsResponseData.md)
+ - [Zyphr::OAuthLinkResponse](docs/OAuthLinkResponse.md)
+ - [Zyphr::OAuthLinkResponseData](docs/OAuthLinkResponseData.md)
  - [Zyphr::OAuthProvider](docs/OAuthProvider.md)
  - [Zyphr::OAuthProviderInfo](docs/OAuthProviderInfo.md)
  - [Zyphr::OAuthProviderName](docs/OAuthProviderName.md)

data/docs/AuthOAuthApi.md

@@ -4,6 +4,7 @@ All URIs are relative to *https://api.zyphr.dev/v1*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
+| [**complete_o_auth_link**](AuthOAuthApi.md#complete_o_auth_link) | **POST** /auth/oauth/{provider}/link/callback | Complete linking an OAuth provider to the current account |
 | [**disconnect_o_auth_provider**](AuthOAuthApi.md#disconnect_o_auth_provider) | **DELETE** /auth/oauth/{provider} | Disconnect OAuth provider |
 | [**get_o_auth_authorization_url**](AuthOAuthApi.md#get_o_auth_authorization_url) | **GET** /auth/oauth/{provider}/authorize | Get OAuth authorization URL |
 | [**get_o_auth_connection_info**](AuthOAuthApi.md#get_o_auth_connection_info) | **GET** /auth/oauth/connections/{provider} | Get OAuth connection info |
@@ -12,6 +13,83 @@ All URIs are relative to *https://api.zyphr.dev/v1*
 | [**list_o_auth_connections**](AuthOAuthApi.md#list_o_auth_connections) | **GET** /auth/oauth/connections | List OAuth connections |
 | [**list_o_auth_providers**](AuthOAuthApi.md#list_o_auth_providers) | **GET** /auth/oauth/providers | List OAuth providers |
 | [**refresh_o_auth_tokens**](AuthOAuthApi.md#refresh_o_auth_tokens) | **POST** /auth/oauth/tokens/{provider}/refresh | Refresh OAuth provider tokens |
+| [**start_o_auth_link**](AuthOAuthApi.md#start_o_auth_link) | **GET** /auth/oauth/{provider}/link | Start linking an OAuth provider to the current account |
+
+
+## complete_o_auth_link
+
+> <OAuthLinkResponse> complete_o_auth_link(provider, o_auth_callback_request)
+
+Complete linking an OAuth provider to the current account
+
+Complete an authenticated account-linking flow started via the link authorize endpoint. Attaches the resolved provider identity to the current end user. Rejects if the provider identity is already linked to a different account, if the provider did not verify the email, or if the linking session does not belong to the authenticated user. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'zyphr'
+# setup authorization
+Zyphr.configure do |config|
+  # Configure Bearer authorization (JWT): EndUserToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure API key authorization: ApplicationPublicKey
+  config.api_key['X-Application-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Key'] = 'Bearer'
+end
+
+api_instance = Zyphr::AuthOAuthApi.new
+provider = Zyphr::OAuthProviderName::GOOGLE # OAuthProviderName | OAuth provider name
+o_auth_callback_request = Zyphr::OAuthCallbackRequest.new({code: 'code_example', state: 'state_example'}) # OAuthCallbackRequest | 
+
+begin
+  # Complete linking an OAuth provider to the current account
+  result = api_instance.complete_o_auth_link(provider, o_auth_callback_request)
+  p result
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOAuthApi->complete_o_auth_link: #{e}"
+end
+```
+
+#### Using the complete_o_auth_link_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<OAuthLinkResponse>, Integer, Hash)> complete_o_auth_link_with_http_info(provider, o_auth_callback_request)
+
+```ruby
+begin
+  # Complete linking an OAuth provider to the current account
+  data, status_code, headers = api_instance.complete_o_auth_link_with_http_info(provider, o_auth_callback_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <OAuthLinkResponse>
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOAuthApi->complete_o_auth_link_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **provider** | [**OAuthProviderName**](.md) | OAuth provider name |  |
+| **o_auth_callback_request** | [**OAuthCallbackRequest**](OAuthCallbackRequest.md) |  |  |
+
+### Return type
+
+[**OAuthLinkResponse**](OAuthLinkResponse.md)
+
+### Authorization
+
+[EndUserToken](../README.md#EndUserToken), [ApplicationPublicKey](../README.md#ApplicationPublicKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
 
 
 ## disconnect_o_auth_provider
@@ -595,3 +673,79 @@ end
 - **Content-Type**: application/json
 - **Accept**: application/json
 
+
+## start_o_auth_link
+
+> <OAuthAuthorizeResponse> start_o_auth_link(provider, redirect_uri)
+
+Start linking an OAuth provider to the current account
+
+Begin an authenticated account-linking flow. Unlike the sign-in authorize endpoint, this binds the current end user into the OAuth state so the matching link callback attaches the returned provider identity to THIS account instead of finding-or-creating a user. Requires an end-user token. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'zyphr'
+# setup authorization
+Zyphr.configure do |config|
+  # Configure Bearer authorization (JWT): EndUserToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure API key authorization: ApplicationPublicKey
+  config.api_key['X-Application-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Key'] = 'Bearer'
+end
+
+api_instance = Zyphr::AuthOAuthApi.new
+provider = Zyphr::OAuthProviderName::GOOGLE # OAuthProviderName | OAuth provider name
+redirect_uri = 'redirect_uri_example' # String | Redirect URI registered for the application
+
+begin
+  # Start linking an OAuth provider to the current account
+  result = api_instance.start_o_auth_link(provider, redirect_uri)
+  p result
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOAuthApi->start_o_auth_link: #{e}"
+end
+```
+
+#### Using the start_o_auth_link_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<OAuthAuthorizeResponse>, Integer, Hash)> start_o_auth_link_with_http_info(provider, redirect_uri)
+
+```ruby
+begin
+  # Start linking an OAuth provider to the current account
+  data, status_code, headers = api_instance.start_o_auth_link_with_http_info(provider, redirect_uri)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <OAuthAuthorizeResponse>
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOAuthApi->start_o_auth_link_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **provider** | [**OAuthProviderName**](.md) | OAuth provider name |  |
+| **redirect_uri** | **String** | Redirect URI registered for the application |  |
+
+### Return type
+
+[**OAuthAuthorizeResponse**](OAuthAuthorizeResponse.md)
+
+### Authorization
+
+[EndUserToken](../README.md#EndUserToken), [ApplicationPublicKey](../README.md#ApplicationPublicKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+

data/docs/OAuthAuthorizeResponse.md

@@ -0,0 +1,20 @@
+# Zyphr::OAuthAuthorizeResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**OAuthAuthorizeResponseData**](OAuthAuthorizeResponseData.md) |  | [optional] |
+| **meta** | [**RequestMeta**](RequestMeta.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zyphr'
+
+instance = Zyphr::OAuthAuthorizeResponse.new(
+  data: null,
+  meta: null
+)
+```
+

data/docs/OAuthAuthorizeResponseData.md

@@ -0,0 +1,20 @@
+# Zyphr::OAuthAuthorizeResponseData
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **authorization_url** | **String** | Provider authorization URL to redirect the user to | [optional] |
+| **state** | **String** | Opaque one-time state token for the callback | [optional] |
+
+## Example
+
+```ruby
+require 'zyphr'
+
+instance = Zyphr::OAuthAuthorizeResponseData.new(
+  authorization_url: null,
+  state: null
+)
+```
+

data/docs/OAuthLinkResponse.md

@@ -0,0 +1,20 @@
+# Zyphr::OAuthLinkResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**OAuthLinkResponseData**](OAuthLinkResponseData.md) |  | [optional] |
+| **meta** | [**RequestMeta**](RequestMeta.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zyphr'
+
+instance = Zyphr::OAuthLinkResponse.new(
+  data: null,
+  meta: null
+)
+```
+

data/docs/OAuthLinkResponseData.md

@@ -0,0 +1,20 @@
+# Zyphr::OAuthLinkResponseData
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **success** | **Boolean** |  | [optional] |
+| **provider_info** | [**OAuthProviderInfo**](OAuthProviderInfo.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zyphr'
+
+instance = Zyphr::OAuthLinkResponseData.new(
+  success: null,
+  provider_info: null
+)
+```
+

data/docs/PasswordPolicy.md

@@ -11,6 +11,7 @@
 | **require_numbers** | **Boolean** | Whether at least one number (0-9) is required. |  |
 | **require_special** | **Boolean** | Whether at least one special character is required. |  |
 | **disallow_common** | **Boolean** | Whether commonly used passwords are rejected. |  |
+| **disallow_breached** | **Boolean** | Whether passwords found in the HaveIBeenPwned breach corpus are rejected at registration/reset. Checked via k-anonymity (only a 5-char SHA-1 prefix leaves our infrastructure) and fail-open: if the breach source is unavailable the password is allowed. Default false (advisory only — the breach signal is returned but does not gate acceptance unless enabled). |  |
 
 ## Example
 
@@ -24,7 +25,8 @@ instance = Zyphr::PasswordPolicy.new(
   require_lowercase: null,
   require_numbers: null,
   require_special: null,
-  disallow_common: null
+  disallow_common: null,
+  disallow_breached: null
 )
 ```
 

data/docs/PasswordStrength.md

@@ -4,8 +4,10 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **valid** | **Boolean** | Whether the password would be accepted by the server's enforcement path. A password that is valid here is accepted by registration. |  |
-| **score** | **Integer** | Strength score, 0-100. |  |
+| **valid** | **Boolean** | Whether the password would be accepted by the server's enforcement path. A password that is valid here is accepted by registration. When the application enables `disallow_breached`, a breached password is `valid: false` here AND rejected by register/reset (no drift). |  |
+| **breached** | **Boolean** | Whether the password appears in the HaveIBeenPwned breach corpus. This is a distinct signal from `valid` and is always returned regardless of the app's `disallow_breached` setting. Fail-open: if the breach source is unavailable this is `false`. |  |
+| **breach_count** | **Integer** | HIBP occurrence count for the password (0 if not breached or if the breach lookup failed/was unavailable). |  |
+| **score** | **Integer** | Strength score, 0-100. A pure composition measure — independent of the breach signal. |  |
 | **label** | **String** | Strength label derived from the score. |  |
 | **feedback** | **Array<String>** | Actionable feedback — policy errors plus strength-improvement suggestions. |  |
 
@@ -16,6 +18,8 @@ require 'zyphr'
 
 instance = Zyphr::PasswordStrength.new(
   valid: null,
+  breached: null,
+  breach_count: null,
   score: null,
   label: null,
   feedback: null

data/lib/zyphr/api/auth_o_auth_api.rb

@@ -19,6 +19,80 @@ module Zyphr
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
+    # Complete linking an OAuth provider to the current account
+    # Complete an authenticated account-linking flow started via the link authorize endpoint. Attaches the resolved provider identity to the current end user. Rejects if the provider identity is already linked to a different account, if the provider did not verify the email, or if the linking session does not belong to the authenticated user. 
+    # @param provider [OAuthProviderName] OAuth provider name
+    # @param o_auth_callback_request [OAuthCallbackRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [OAuthLinkResponse]
+    def complete_o_auth_link(provider, o_auth_callback_request, opts = {})
+      data, _status_code, _headers = complete_o_auth_link_with_http_info(provider, o_auth_callback_request, opts)
+      data
+    end
+
+    # Complete linking an OAuth provider to the current account
+    # Complete an authenticated account-linking flow started via the link authorize endpoint. Attaches the resolved provider identity to the current end user. Rejects if the provider identity is already linked to a different account, if the provider did not verify the email, or if the linking session does not belong to the authenticated user. 
+    # @param provider [OAuthProviderName] OAuth provider name
+    # @param o_auth_callback_request [OAuthCallbackRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(OAuthLinkResponse, Integer, Hash)>] OAuthLinkResponse data, response status code and response headers
+    def complete_o_auth_link_with_http_info(provider, o_auth_callback_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AuthOAuthApi.complete_o_auth_link ...'
+      end
+      # verify the required parameter 'provider' is set
+      if @api_client.config.client_side_validation && provider.nil?
+        fail ArgumentError, "Missing the required parameter 'provider' when calling AuthOAuthApi.complete_o_auth_link"
+      end
+      # verify the required parameter 'o_auth_callback_request' is set
+      if @api_client.config.client_side_validation && o_auth_callback_request.nil?
+        fail ArgumentError, "Missing the required parameter 'o_auth_callback_request' when calling AuthOAuthApi.complete_o_auth_link"
+      end
+      # resource path
+      local_var_path = '/auth/oauth/{provider}/link/callback'.sub('{' + 'provider' + '}', CGI.escape(provider.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']) unless header_params['Accept']
+      # 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(o_auth_callback_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'OAuthLinkResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['EndUserToken', 'ApplicationPublicKey']
+
+      new_options = opts.merge(
+        :operation => :"AuthOAuthApi.complete_o_auth_link",
+        :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: AuthOAuthApi#complete_o_auth_link\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Disconnect OAuth provider
     # Disconnect an OAuth provider from the current user.
     # @param provider [OAuthProviderName] OAuth provider name
@@ -546,5 +620,75 @@ module Zyphr
       end
       return data, status_code, headers
     end
+
+    # Start linking an OAuth provider to the current account
+    # Begin an authenticated account-linking flow. Unlike the sign-in authorize endpoint, this binds the current end user into the OAuth state so the matching link callback attaches the returned provider identity to THIS account instead of finding-or-creating a user. Requires an end-user token. 
+    # @param provider [OAuthProviderName] OAuth provider name
+    # @param redirect_uri [String] Redirect URI registered for the application
+    # @param [Hash] opts the optional parameters
+    # @return [OAuthAuthorizeResponse]
+    def start_o_auth_link(provider, redirect_uri, opts = {})
+      data, _status_code, _headers = start_o_auth_link_with_http_info(provider, redirect_uri, opts)
+      data
+    end
+
+    # Start linking an OAuth provider to the current account
+    # Begin an authenticated account-linking flow. Unlike the sign-in authorize endpoint, this binds the current end user into the OAuth state so the matching link callback attaches the returned provider identity to THIS account instead of finding-or-creating a user. Requires an end-user token. 
+    # @param provider [OAuthProviderName] OAuth provider name
+    # @param redirect_uri [String] Redirect URI registered for the application
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(OAuthAuthorizeResponse, Integer, Hash)>] OAuthAuthorizeResponse data, response status code and response headers
+    def start_o_auth_link_with_http_info(provider, redirect_uri, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AuthOAuthApi.start_o_auth_link ...'
+      end
+      # verify the required parameter 'provider' is set
+      if @api_client.config.client_side_validation && provider.nil?
+        fail ArgumentError, "Missing the required parameter 'provider' when calling AuthOAuthApi.start_o_auth_link"
+      end
+      # verify the required parameter 'redirect_uri' is set
+      if @api_client.config.client_side_validation && redirect_uri.nil?
+        fail ArgumentError, "Missing the required parameter 'redirect_uri' when calling AuthOAuthApi.start_o_auth_link"
+      end
+      # resource path
+      local_var_path = '/auth/oauth/{provider}/link'.sub('{' + 'provider' + '}', CGI.escape(provider.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'redirect_uri'] = redirect_uri
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'OAuthAuthorizeResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['EndUserToken', 'ApplicationPublicKey']
+
+      new_options = opts.merge(
+        :operation => :"AuthOAuthApi.start_o_auth_link",
+        :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: AuthOAuthApi#start_o_auth_link\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
   end
 end