ory-kratos-client 0.6.0.alpha15 → 0.6.3.alpha1

data/docs/RecoveryAddress.md

@@ -4,7 +4,9 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
+| **created_at** | **Time** | CreatedAt is a helper struct field for gobuffalo.pop. | [optional] |
 | **id** | **String** |  |  |
+| **updated_at** | **Time** | UpdatedAt is a helper struct field for gobuffalo.pop. | [optional] |
 | **value** | **String** |  |  |
 | **via** | **String** |  |  |
 
@@ -14,7 +16,9 @@
 require 'ory-kratos-client'
 
 instance = OryHydraClient::RecoveryAddress.new(
+  created_at: null,
   id: null,
+  updated_at: null,
   value: null,
   via: null
 )

data/docs/SelfServiceErrorContainer.md

@@ -0,0 +1,24 @@
+# OryHydraClient::SelfServiceErrorContainer
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **created_at** | **Time** | CreatedAt is a helper struct field for gobuffalo.pop. | [optional] |
+| **errors** | **Array<Object>** | Errors in the container |  |
+| **id** | **String** |  |  |
+| **updated_at** | **Time** | UpdatedAt is a helper struct field for gobuffalo.pop. | [optional] |
+
+## Example
+
+```ruby
+require 'ory-kratos-client'
+
+instance = OryHydraClient::SelfServiceErrorContainer.new(
+  created_at: null,
+  errors: null,
+  id: null,
+  updated_at: null
+)
+```
+

data/docs/VerifiableIdentityAddress.md

@@ -0,0 +1,32 @@
+# OryHydraClient::VerifiableIdentityAddress
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **created_at** | **Time** | When this entry was created | [optional] |
+| **id** | **String** |  |  |
+| **status** | **String** | VerifiableAddressStatus must not exceed 16 characters as that is the limitation in the SQL Schema |  |
+| **updated_at** | **Time** | When this entry was last updated | [optional] |
+| **value** | **String** | The address value  example foo@user.com |  |
+| **verified** | **Boolean** | Indicates if the address has already been verified |  |
+| **verified_at** | **Time** |  | [optional] |
+| **via** | **String** | VerifiableAddressType must not exceed 16 characters as that is the limitation in the SQL Schema |  |
+
+## Example
+
+```ruby
+require 'ory-kratos-client'
+
+instance = OryHydraClient::VerifiableIdentityAddress.new(
+  created_at: 2014-01-01T23:28:56.782Z,
+  id: null,
+  status: null,
+  updated_at: 2014-01-01T23:28:56.782Z,
+  value: null,
+  verified: true,
+  verified_at: null,
+  via: null
+)
+```
+

data/lib/ory-kratos-client.rb

@@ -3,7 +3,7 @@
 
 #Documentation for all public and administrative Ory Kratos APIs. Public and administrative APIs are exposed on different ports. Public APIs can face the public internet without any protection while administrative APIs should never be exposed without prior authorization. To protect the administative API port you should use something like Nginx, Ory Oathkeeper, or any other technology capable of authorizing incoming requests. 
 
-The version of the OpenAPI document: v0.6.0-alpha.15
+The version of the OpenAPI document: v0.6.3-alpha.1
 Contact: hi@ory.sh
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 5.1.1
@@ -26,10 +26,8 @@ require 'ory-kratos-client/models/container_wait_ok_body'
 require 'ory-kratos-client/models/container_wait_ok_body_error'
 require 'ory-kratos-client/models/create_identity'
 require 'ory-kratos-client/models/create_recovery_link'
-require 'ory-kratos-client/models/error_container'
 require 'ory-kratos-client/models/error_response'
 require 'ory-kratos-client/models/generic_error'
-require 'ory-kratos-client/models/generic_error_payload'
 require 'ory-kratos-client/models/graph_driver_data'
 require 'ory-kratos-client/models/health_not_ready_status'
 require 'ory-kratos-client/models/health_status'
@@ -41,6 +39,7 @@ require 'ory-kratos-client/models/image_summary'
 require 'ory-kratos-client/models/inline_response200'
 require 'ory-kratos-client/models/inline_response2001'
 require 'ory-kratos-client/models/inline_response503'
+require 'ory-kratos-client/models/json_error'
 require 'ory-kratos-client/models/login_flow'
 require 'ory-kratos-client/models/login_via_api_response'
 require 'ory-kratos-client/models/meta'
@@ -64,6 +63,7 @@ require 'ory-kratos-client/models/recovery_link'
 require 'ory-kratos-client/models/registration_flow'
 require 'ory-kratos-client/models/registration_via_api_response'
 require 'ory-kratos-client/models/revoke_session'
+require 'ory-kratos-client/models/self_service_error_container'
 require 'ory-kratos-client/models/service_update_response'
 require 'ory-kratos-client/models/session'
 require 'ory-kratos-client/models/settings_flow'
@@ -89,7 +89,7 @@ require 'ory-kratos-client/models/ui_node_input_attributes_value'
 require 'ory-kratos-client/models/ui_node_text_attributes'
 require 'ory-kratos-client/models/ui_text'
 require 'ory-kratos-client/models/update_identity'
-require 'ory-kratos-client/models/verifiable_address'
+require 'ory-kratos-client/models/verifiable_identity_address'
 require 'ory-kratos-client/models/verification_flow'
 require 'ory-kratos-client/models/version'
 require 'ory-kratos-client/models/volume'

data/lib/ory-kratos-client/api/admin_api.rb

@@ -3,7 +3,7 @@
 
 #Documentation for all public and administrative Ory Kratos APIs. Public and administrative APIs are exposed on different ports. Public APIs can face the public internet without any protection while administrative APIs should never be exposed without prior authorization. To protect the administative API port you should use something like Nginx, Ory Oathkeeper, or any other technology capable of authorizing incoming requests. 
 
-The version of the OpenAPI document: v0.6.0-alpha.15
+The version of the OpenAPI document: v0.6.3-alpha.1
 Contact: hi@ory.sh
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 5.1.1
@@ -332,7 +332,7 @@ module OryHydraClient
     # This endpoint returns the error associated with a user-facing self service errors.  This endpoint supports stub values to help you implement the error UI:  `?error=stub:500` - returns a stub 500 (Internal Server Error) error.  More information can be found at [Ory Kratos User User Facing Error Documentation](https://www.ory.sh/docs/kratos/self-service/flows/user-facing-errors).
     # @param error [String] Error is the container's ID
     # @param [Hash] opts the optional parameters
-    # @return [ErrorContainer]
+    # @return [SelfServiceErrorContainer]
     def get_self_service_error(error, opts = {})
       data, _status_code, _headers = get_self_service_error_with_http_info(error, opts)
       data
@@ -342,7 +342,7 @@ module OryHydraClient
     # This endpoint returns the error associated with a user-facing self service errors.  This endpoint supports stub values to help you implement the error UI:  `?error=stub:500` - returns a stub 500 (Internal Server Error) error.  More information can be found at [Ory Kratos User User Facing Error Documentation](https://www.ory.sh/docs/kratos/self-service/flows/user-facing-errors).
     # @param error [String] Error is the container's ID
     # @param [Hash] opts the optional parameters
-    # @return [Array<(ErrorContainer, Integer, Hash)>] ErrorContainer data, response status code and response headers
+    # @return [Array<(SelfServiceErrorContainer, Integer, Hash)>] SelfServiceErrorContainer data, response status code and response headers
     def get_self_service_error_with_http_info(error, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AdminApi.get_self_service_error ...'
@@ -370,7 +370,7 @@ module OryHydraClient
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'ErrorContainer'
+      return_type = opts[:debug_return_type] || 'SelfServiceErrorContainer'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || []
@@ -588,6 +588,7 @@ module OryHydraClient
     # When accessing this endpoint through Ory Kratos' Public API you must ensure that either the Ory Kratos Session Cookie or the Ory Kratos Session Token are set. The public endpoint does not return 404 status codes but instead 403 or 500 to improve data privacy.  You can access this endpoint without credentials when using Ory Kratos' Admin API.  More information can be found at [Ory Kratos User Settings & Profile Management Documentation](../self-service/flows/user-settings).
     # @param id [String] ID is the Settings Flow ID  The value for this parameter comes from &#x60;flow&#x60; URL Query parameter sent to your application (e.g. &#x60;/settings?flow&#x3D;abcde&#x60;).
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_session_token The Session Token of the Identity performing the settings flow.
     # @return [SettingsFlow]
     def get_self_service_settings_flow(id, opts = {})
       data, _status_code, _headers = get_self_service_settings_flow_with_http_info(id, opts)
@@ -598,6 +599,7 @@ module OryHydraClient
     # When accessing this endpoint through Ory Kratos&#39; Public API you must ensure that either the Ory Kratos Session Cookie or the Ory Kratos Session Token are set. The public endpoint does not return 404 status codes but instead 403 or 500 to improve data privacy.  You can access this endpoint without credentials when using Ory Kratos&#39; Admin API.  More information can be found at [Ory Kratos User Settings &amp; Profile Management Documentation](../self-service/flows/user-settings).
     # @param id [String] ID is the Settings Flow ID  The value for this parameter comes from &#x60;flow&#x60; URL Query parameter sent to your application (e.g. &#x60;/settings?flow&#x3D;abcde&#x60;).
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_session_token The Session Token of the Identity performing the settings flow.
     # @return [Array<(SettingsFlow, Integer, Hash)>] SettingsFlow data, response status code and response headers
     def get_self_service_settings_flow_with_http_info(id, opts = {})
       if @api_client.config.debugging
@@ -618,6 +620,7 @@ module OryHydraClient
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params[:'X-Session-Token'] = opts[:'x_session_token'] if !opts[:'x_session_token'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}

data/lib/ory-kratos-client/api/public_api.rb

@@ -3,7 +3,7 @@
 
 #Documentation for all public and administrative Ory Kratos APIs. Public and administrative APIs are exposed on different ports. Public APIs can face the public internet without any protection while administrative APIs should never be exposed without prior authorization. To protect the administative API port you should use something like Nginx, Ory Oathkeeper, or any other technology capable of authorizing incoming requests. 
 
-The version of the OpenAPI document: v0.6.0-alpha.15
+The version of the OpenAPI document: v0.6.3-alpha.1
 Contact: hi@ory.sh
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 5.1.1
@@ -84,7 +84,7 @@ module OryHydraClient
     # This endpoint returns the error associated with a user-facing self service errors.  This endpoint supports stub values to help you implement the error UI:  `?error=stub:500` - returns a stub 500 (Internal Server Error) error.  More information can be found at [Ory Kratos User User Facing Error Documentation](https://www.ory.sh/docs/kratos/self-service/flows/user-facing-errors).
     # @param error [String] Error is the container's ID
     # @param [Hash] opts the optional parameters
-    # @return [ErrorContainer]
+    # @return [SelfServiceErrorContainer]
     def get_self_service_error(error, opts = {})
       data, _status_code, _headers = get_self_service_error_with_http_info(error, opts)
       data
@@ -94,7 +94,7 @@ module OryHydraClient
     # This endpoint returns the error associated with a user-facing self service errors.  This endpoint supports stub values to help you implement the error UI:  `?error=stub:500` - returns a stub 500 (Internal Server Error) error.  More information can be found at [Ory Kratos User User Facing Error Documentation](https://www.ory.sh/docs/kratos/self-service/flows/user-facing-errors).
     # @param error [String] Error is the container's ID
     # @param [Hash] opts the optional parameters
-    # @return [Array<(ErrorContainer, Integer, Hash)>] ErrorContainer data, response status code and response headers
+    # @return [Array<(SelfServiceErrorContainer, Integer, Hash)>] SelfServiceErrorContainer data, response status code and response headers
     def get_self_service_error_with_http_info(error, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: PublicApi.get_self_service_error ...'
@@ -122,7 +122,7 @@ module OryHydraClient
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'ErrorContainer'
+      return_type = opts[:debug_return_type] || 'SelfServiceErrorContainer'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || []
@@ -340,6 +340,7 @@ module OryHydraClient
     # When accessing this endpoint through Ory Kratos' Public API you must ensure that either the Ory Kratos Session Cookie or the Ory Kratos Session Token are set. The public endpoint does not return 404 status codes but instead 403 or 500 to improve data privacy.  You can access this endpoint without credentials when using Ory Kratos' Admin API.  More information can be found at [Ory Kratos User Settings & Profile Management Documentation](../self-service/flows/user-settings).
     # @param id [String] ID is the Settings Flow ID  The value for this parameter comes from &#x60;flow&#x60; URL Query parameter sent to your application (e.g. &#x60;/settings?flow&#x3D;abcde&#x60;).
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_session_token The Session Token of the Identity performing the settings flow.
     # @return [SettingsFlow]
     def get_self_service_settings_flow(id, opts = {})
       data, _status_code, _headers = get_self_service_settings_flow_with_http_info(id, opts)
@@ -350,6 +351,7 @@ module OryHydraClient
     # When accessing this endpoint through Ory Kratos&#39; Public API you must ensure that either the Ory Kratos Session Cookie or the Ory Kratos Session Token are set. The public endpoint does not return 404 status codes but instead 403 or 500 to improve data privacy.  You can access this endpoint without credentials when using Ory Kratos&#39; Admin API.  More information can be found at [Ory Kratos User Settings &amp; Profile Management Documentation](../self-service/flows/user-settings).
     # @param id [String] ID is the Settings Flow ID  The value for this parameter comes from &#x60;flow&#x60; URL Query parameter sent to your application (e.g. &#x60;/settings?flow&#x3D;abcde&#x60;).
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_session_token The Session Token of the Identity performing the settings flow.
     # @return [Array<(SettingsFlow, Integer, Hash)>] SettingsFlow data, response status code and response headers
     def get_self_service_settings_flow_with_http_info(id, opts = {})
       if @api_client.config.debugging
@@ -370,6 +372,7 @@ module OryHydraClient
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params[:'X-Session-Token'] = opts[:'x_session_token'] if !opts[:'x_session_token'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -521,24 +524,84 @@ module OryHydraClient
       return data, status_code, headers
     end
 
-    # Initialize Login Flow for API clients
+    # Initialize Login Flow for browsers
+    # This endpoint initializes a browser-based user login flow. Once initialized, the browser will be redirected to `selfservice.flows.login.ui_url` with the flow ID set as the query parameter `?flow=`. If a valid user session exists already, the browser will be redirected to `urls.default_redirect_url` unless the query parameter `?refresh=true` was set.  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  More information can be found at [Ory Kratos User Login and User Registration Documentation](https://www.ory.sh/docs/next/kratos/self-service/flows/user-login-user-registration).
+    # @param [Hash] opts the optional parameters
+    # @option opts [Boolean] :refresh Refresh a login session  If set to true, this will refresh an existing login session by asking the user to sign in again. This will reset the authenticated_at time of the session.
+    # @return [nil]
+    def initialize_self_service_login_for_browsers(opts = {})
+      initialize_self_service_login_for_browsers_with_http_info(opts)
+      nil
+    end
+
+    # Initialize Login Flow for browsers
+    # This endpoint initializes a browser-based user login flow. Once initialized, the browser will be redirected to &#x60;selfservice.flows.login.ui_url&#x60; with the flow ID set as the query parameter &#x60;?flow&#x3D;&#x60;. If a valid user session exists already, the browser will be redirected to &#x60;urls.default_redirect_url&#x60; unless the query parameter &#x60;?refresh&#x3D;true&#x60; was set.  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  More information can be found at [Ory Kratos User Login and User Registration Documentation](https://www.ory.sh/docs/next/kratos/self-service/flows/user-login-user-registration).
+    # @param [Hash] opts the optional parameters
+    # @option opts [Boolean] :refresh Refresh a login session  If set to true, this will refresh an existing login session by asking the user to sign in again. This will reset the authenticated_at time of the session.
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def initialize_self_service_login_for_browsers_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_login_for_browsers ...'
+      end
+      # resource path
+      local_var_path = '/self-service/login/browser'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'refresh'] = opts[:'refresh'] if !opts[:'refresh'].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]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"PublicApi.initialize_self_service_login_for_browsers",
+        :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: PublicApi#initialize_self_service_login_for_browsers\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Initialize Login Flow for Native Apps and API clients
     # This endpoint initiates a login flow for API clients such as mobile devices, smart TVs, and so on.  If a valid provided session cookie or session token is provided, a 400 Bad Request error will be returned unless the URL query parameter `?refresh=true` is set.  To fetch an existing login flow call `/self-service/login/flows?flow=<flow_id>`.  :::warning  You MUST NOT use this endpoint in client-side (Single Page Apps, ReactJS, AngularJS) nor server-side (Java Server Pages, NodeJS, PHP, Golang, ...) browser applications. Using this endpoint in these applications will make you vulnerable to a variety of CSRF attacks, including CSRF login attacks.  This endpoint MUST ONLY be used in scenarios such as native mobile apps (React Native, Objective C, Swift, Java, ...).  :::  More information can be found at [Ory Kratos User Login and User Registration Documentation](https://www.ory.sh/docs/next/kratos/self-service/flows/user-login-user-registration).
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :refresh Refresh a login session  If set to true, this will refresh an existing login session by asking the user to sign in again. This will reset the authenticated_at time of the session.
     # @return [LoginFlow]
-    def initialize_self_service_login_via_api_flow(opts = {})
-      data, _status_code, _headers = initialize_self_service_login_via_api_flow_with_http_info(opts)
+    def initialize_self_service_login_for_native_apps(opts = {})
+      data, _status_code, _headers = initialize_self_service_login_for_native_apps_with_http_info(opts)
       data
     end
 
-    # Initialize Login Flow for API clients
+    # Initialize Login Flow for Native Apps and API clients
     # This endpoint initiates a login flow for API clients such as mobile devices, smart TVs, and so on.  If a valid provided session cookie or session token is provided, a 400 Bad Request error will be returned unless the URL query parameter &#x60;?refresh&#x3D;true&#x60; is set.  To fetch an existing login flow call &#x60;/self-service/login/flows?flow&#x3D;&lt;flow_id&gt;&#x60;.  :::warning  You MUST NOT use this endpoint in client-side (Single Page Apps, ReactJS, AngularJS) nor server-side (Java Server Pages, NodeJS, PHP, Golang, ...) browser applications. Using this endpoint in these applications will make you vulnerable to a variety of CSRF attacks, including CSRF login attacks.  This endpoint MUST ONLY be used in scenarios such as native mobile apps (React Native, Objective C, Swift, Java, ...).  :::  More information can be found at [Ory Kratos User Login and User Registration Documentation](https://www.ory.sh/docs/next/kratos/self-service/flows/user-login-user-registration).
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :refresh Refresh a login session  If set to true, this will refresh an existing login session by asking the user to sign in again. This will reset the authenticated_at time of the session.
     # @return [Array<(LoginFlow, Integer, Hash)>] LoginFlow data, response status code and response headers
-    def initialize_self_service_login_via_api_flow_with_http_info(opts = {})
+    def initialize_self_service_login_for_native_apps_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_login_via_api_flow ...'
+        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_login_for_native_apps ...'
       end
       # resource path
       local_var_path = '/self-service/login/api'
@@ -565,7 +628,7 @@ module OryHydraClient
       auth_names = opts[:debug_auth_names] || []
 
       new_options = opts.merge(
-        :operation => :"PublicApi.initialize_self_service_login_via_api_flow",
+        :operation => :"PublicApi.initialize_self_service_login_for_native_apps",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -576,30 +639,30 @@ module OryHydraClient
 
       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: PublicApi#initialize_self_service_login_via_api_flow\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: PublicApi#initialize_self_service_login_for_native_apps\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Initialize Login Flow for browsers
-    # This endpoint initializes a browser-based user login flow. Once initialized, the browser will be redirected to `selfservice.flows.login.ui_url` with the flow ID set as the query parameter `?flow=`. If a valid user session exists already, the browser will be redirected to `urls.default_redirect_url` unless the query parameter `?refresh=true` was set.  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  More information can be found at [Ory Kratos User Login and User Registration Documentation](https://www.ory.sh/docs/next/kratos/self-service/flows/user-login-user-registration).
+    # Initialize Recovery Flow for Browser Clients
+    # This endpoint initializes a browser-based account recovery flow. Once initialized, the browser will be redirected to `selfservice.flows.recovery.ui_url` with the flow ID set as the query parameter `?flow=`. If a valid user session exists, the browser is returned to the configured return URL.  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  More information can be found at [Ory Kratos Account Recovery Documentation](../self-service/flows/account-recovery.mdx).
     # @param [Hash] opts the optional parameters
     # @return [nil]
-    def initialize_self_service_login_via_browser_flow(opts = {})
-      initialize_self_service_login_via_browser_flow_with_http_info(opts)
+    def initialize_self_service_recovery_for_browsers(opts = {})
+      initialize_self_service_recovery_for_browsers_with_http_info(opts)
       nil
     end
 
-    # Initialize Login Flow for browsers
-    # This endpoint initializes a browser-based user login flow. Once initialized, the browser will be redirected to &#x60;selfservice.flows.login.ui_url&#x60; with the flow ID set as the query parameter &#x60;?flow&#x3D;&#x60;. If a valid user session exists already, the browser will be redirected to &#x60;urls.default_redirect_url&#x60; unless the query parameter &#x60;?refresh&#x3D;true&#x60; was set.  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  More information can be found at [Ory Kratos User Login and User Registration Documentation](https://www.ory.sh/docs/next/kratos/self-service/flows/user-login-user-registration).
+    # Initialize Recovery Flow for Browser Clients
+    # This endpoint initializes a browser-based account recovery flow. Once initialized, the browser will be redirected to &#x60;selfservice.flows.recovery.ui_url&#x60; with the flow ID set as the query parameter &#x60;?flow&#x3D;&#x60;. If a valid user session exists, the browser is returned to the configured return URL.  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  More information can be found at [Ory Kratos Account Recovery Documentation](../self-service/flows/account-recovery.mdx).
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
-    def initialize_self_service_login_via_browser_flow_with_http_info(opts = {})
+    def initialize_self_service_recovery_for_browsers_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_login_via_browser_flow ...'
+        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_recovery_for_browsers ...'
       end
       # resource path
-      local_var_path = '/self-service/login/browser'
+      local_var_path = '/self-service/recovery/browser'
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -622,7 +685,7 @@ module OryHydraClient
       auth_names = opts[:debug_auth_names] || []
 
       new_options = opts.merge(
-        :operation => :"PublicApi.initialize_self_service_login_via_browser_flow",
+        :operation => :"PublicApi.initialize_self_service_recovery_for_browsers",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -633,27 +696,27 @@ module OryHydraClient
 
       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: PublicApi#initialize_self_service_login_via_browser_flow\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: PublicApi#initialize_self_service_recovery_for_browsers\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Initialize Recovery Flow for API Clients
+    # Initialize Recovery Flow for Native Apps and API clients
     # This endpoint initiates a recovery flow for API clients such as mobile devices, smart TVs, and so on.  If a valid provided session cookie or session token is provided, a 400 Bad Request error.  To fetch an existing recovery flow call `/self-service/recovery/flows?flow=<flow_id>`.  :::warning  You MUST NOT use this endpoint in client-side (Single Page Apps, ReactJS, AngularJS) nor server-side (Java Server Pages, NodeJS, PHP, Golang, ...) browser applications. Using this endpoint in these applications will make you vulnerable to a variety of CSRF attacks.  This endpoint MUST ONLY be used in scenarios such as native mobile apps (React Native, Objective C, Swift, Java, ...).  :::  More information can be found at [Ory Kratos Account Recovery Documentation](../self-service/flows/account-recovery.mdx).
     # @param [Hash] opts the optional parameters
     # @return [RecoveryFlow]
-    def initialize_self_service_recovery_via_api_flow(opts = {})
-      data, _status_code, _headers = initialize_self_service_recovery_via_api_flow_with_http_info(opts)
+    def initialize_self_service_recovery_for_native_apps(opts = {})
+      data, _status_code, _headers = initialize_self_service_recovery_for_native_apps_with_http_info(opts)
       data
     end
 
-    # Initialize Recovery Flow for API Clients
+    # Initialize Recovery Flow for Native Apps and API clients
     # This endpoint initiates a recovery flow for API clients such as mobile devices, smart TVs, and so on.  If a valid provided session cookie or session token is provided, a 400 Bad Request error.  To fetch an existing recovery flow call &#x60;/self-service/recovery/flows?flow&#x3D;&lt;flow_id&gt;&#x60;.  :::warning  You MUST NOT use this endpoint in client-side (Single Page Apps, ReactJS, AngularJS) nor server-side (Java Server Pages, NodeJS, PHP, Golang, ...) browser applications. Using this endpoint in these applications will make you vulnerable to a variety of CSRF attacks.  This endpoint MUST ONLY be used in scenarios such as native mobile apps (React Native, Objective C, Swift, Java, ...).  :::  More information can be found at [Ory Kratos Account Recovery Documentation](../self-service/flows/account-recovery.mdx).
     # @param [Hash] opts the optional parameters
     # @return [Array<(RecoveryFlow, Integer, Hash)>] RecoveryFlow data, response status code and response headers
-    def initialize_self_service_recovery_via_api_flow_with_http_info(opts = {})
+    def initialize_self_service_recovery_for_native_apps_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_recovery_via_api_flow ...'
+        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_recovery_for_native_apps ...'
       end
       # resource path
       local_var_path = '/self-service/recovery/api'
@@ -679,7 +742,7 @@ module OryHydraClient
       auth_names = opts[:debug_auth_names] || []
 
       new_options = opts.merge(
-        :operation => :"PublicApi.initialize_self_service_recovery_via_api_flow",
+        :operation => :"PublicApi.initialize_self_service_recovery_for_native_apps",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -690,30 +753,30 @@ module OryHydraClient
 
       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: PublicApi#initialize_self_service_recovery_via_api_flow\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: PublicApi#initialize_self_service_recovery_for_native_apps\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Initialize Recovery Flow for Browser Clients
-    # This endpoint initializes a browser-based account recovery flow. Once initialized, the browser will be redirected to `selfservice.flows.recovery.ui_url` with the flow ID set as the query parameter `?flow=`. If a valid user session exists, the browser is returned to the configured return URL.  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  More information can be found at [Ory Kratos Account Recovery Documentation](../self-service/flows/account-recovery.mdx).
+    # Initialize Registration Flow for browsers
+    # This endpoint initializes a browser-based user registration flow. Once initialized, the browser will be redirected to `selfservice.flows.registration.ui_url` with the flow ID set as the query parameter `?flow=`. If a valid user session exists already, the browser will be redirected to `urls.default_redirect_url` unless the query parameter `?refresh=true` was set.  :::note  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  :::  More information can be found at [Ory Kratos User Login and User Registration Documentation](https://www.ory.sh/docs/next/kratos/self-service/flows/user-login-user-registration).
     # @param [Hash] opts the optional parameters
     # @return [nil]
-    def initialize_self_service_recovery_via_browser_flow(opts = {})
-      initialize_self_service_recovery_via_browser_flow_with_http_info(opts)
+    def initialize_self_service_registration_for_browsers(opts = {})
+      initialize_self_service_registration_for_browsers_with_http_info(opts)
       nil
     end
 
-    # Initialize Recovery Flow for Browser Clients
-    # This endpoint initializes a browser-based account recovery flow. Once initialized, the browser will be redirected to &#x60;selfservice.flows.recovery.ui_url&#x60; with the flow ID set as the query parameter &#x60;?flow&#x3D;&#x60;. If a valid user session exists, the browser is returned to the configured return URL.  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  More information can be found at [Ory Kratos Account Recovery Documentation](../self-service/flows/account-recovery.mdx).
+    # Initialize Registration Flow for browsers
+    # This endpoint initializes a browser-based user registration flow. Once initialized, the browser will be redirected to &#x60;selfservice.flows.registration.ui_url&#x60; with the flow ID set as the query parameter &#x60;?flow&#x3D;&#x60;. If a valid user session exists already, the browser will be redirected to &#x60;urls.default_redirect_url&#x60; unless the query parameter &#x60;?refresh&#x3D;true&#x60; was set.  :::note  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  :::  More information can be found at [Ory Kratos User Login and User Registration Documentation](https://www.ory.sh/docs/next/kratos/self-service/flows/user-login-user-registration).
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
-    def initialize_self_service_recovery_via_browser_flow_with_http_info(opts = {})
+    def initialize_self_service_registration_for_browsers_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_recovery_via_browser_flow ...'
+        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_registration_for_browsers ...'
       end
       # resource path
-      local_var_path = '/self-service/recovery/browser'
+      local_var_path = '/self-service/registration/browser'
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -736,7 +799,7 @@ module OryHydraClient
       auth_names = opts[:debug_auth_names] || []
 
       new_options = opts.merge(
-        :operation => :"PublicApi.initialize_self_service_recovery_via_browser_flow",
+        :operation => :"PublicApi.initialize_self_service_registration_for_browsers",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -747,27 +810,27 @@ module OryHydraClient
 
       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: PublicApi#initialize_self_service_recovery_via_browser_flow\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: PublicApi#initialize_self_service_registration_for_browsers\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Initialize Registration Flow for API clients
+    # Initialize Registration Flow for Native Apps and API clients
     # This endpoint initiates a registration flow for API clients such as mobile devices, smart TVs, and so on.  If a valid provided session cookie or session token is provided, a 400 Bad Request error will be returned unless the URL query parameter `?refresh=true` is set.  To fetch an existing registration flow call `/self-service/registration/flows?flow=<flow_id>`.  :::warning  You MUST NOT use this endpoint in client-side (Single Page Apps, ReactJS, AngularJS) nor server-side (Java Server Pages, NodeJS, PHP, Golang, ...) browser applications. Using this endpoint in these applications will make you vulnerable to a variety of CSRF attacks.  This endpoint MUST ONLY be used in scenarios such as native mobile apps (React Native, Objective C, Swift, Java, ...).  :::  More information can be found at [Ory Kratos User Login and User Registration Documentation](https://www.ory.sh/docs/next/kratos/self-service/flows/user-login-user-registration).
     # @param [Hash] opts the optional parameters
     # @return [RegistrationFlow]
-    def initialize_self_service_registration_via_api_flow(opts = {})
-      data, _status_code, _headers = initialize_self_service_registration_via_api_flow_with_http_info(opts)
+    def initialize_self_service_registration_for_native_apps(opts = {})
+      data, _status_code, _headers = initialize_self_service_registration_for_native_apps_with_http_info(opts)
       data
     end
 
-    # Initialize Registration Flow for API clients
+    # Initialize Registration Flow for Native Apps and API clients
     # This endpoint initiates a registration flow for API clients such as mobile devices, smart TVs, and so on.  If a valid provided session cookie or session token is provided, a 400 Bad Request error will be returned unless the URL query parameter &#x60;?refresh&#x3D;true&#x60; is set.  To fetch an existing registration flow call &#x60;/self-service/registration/flows?flow&#x3D;&lt;flow_id&gt;&#x60;.  :::warning  You MUST NOT use this endpoint in client-side (Single Page Apps, ReactJS, AngularJS) nor server-side (Java Server Pages, NodeJS, PHP, Golang, ...) browser applications. Using this endpoint in these applications will make you vulnerable to a variety of CSRF attacks.  This endpoint MUST ONLY be used in scenarios such as native mobile apps (React Native, Objective C, Swift, Java, ...).  :::  More information can be found at [Ory Kratos User Login and User Registration Documentation](https://www.ory.sh/docs/next/kratos/self-service/flows/user-login-user-registration).
     # @param [Hash] opts the optional parameters
     # @return [Array<(RegistrationFlow, Integer, Hash)>] RegistrationFlow data, response status code and response headers
-    def initialize_self_service_registration_via_api_flow_with_http_info(opts = {})
+    def initialize_self_service_registration_for_native_apps_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_registration_via_api_flow ...'
+        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_registration_for_native_apps ...'
       end
       # resource path
       local_var_path = '/self-service/registration/api'
@@ -793,7 +856,7 @@ module OryHydraClient
       auth_names = opts[:debug_auth_names] || []
 
       new_options = opts.merge(
-        :operation => :"PublicApi.initialize_self_service_registration_via_api_flow",
+        :operation => :"PublicApi.initialize_self_service_registration_for_native_apps",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -804,30 +867,30 @@ module OryHydraClient
 
       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: PublicApi#initialize_self_service_registration_via_api_flow\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: PublicApi#initialize_self_service_registration_for_native_apps\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Initialize Registration Flow for browsers
-    # This endpoint initializes a browser-based user registration flow. Once initialized, the browser will be redirected to `selfservice.flows.registration.ui_url` with the flow ID set as the query parameter `?flow=`. If a valid user session exists already, the browser will be redirected to `urls.default_redirect_url` unless the query parameter `?refresh=true` was set.  :::note  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  :::  More information can be found at [Ory Kratos User Login and User Registration Documentation](https://www.ory.sh/docs/next/kratos/self-service/flows/user-login-user-registration).
+    # Initialize Settings Flow for Browsers
+    # This endpoint initializes a browser-based user settings flow. Once initialized, the browser will be redirected to `selfservice.flows.settings.ui_url` with the flow ID set as the query parameter `?flow=`. If no valid Ory Kratos Session Cookie is included in the request, a login flow will be initialized.  :::note  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  :::  More information can be found at [Ory Kratos User Settings & Profile Management Documentation](../self-service/flows/user-settings).
     # @param [Hash] opts the optional parameters
     # @return [nil]
-    def initialize_self_service_registration_via_browser_flow(opts = {})
-      initialize_self_service_registration_via_browser_flow_with_http_info(opts)
+    def initialize_self_service_settings_for_browsers(opts = {})
+      initialize_self_service_settings_for_browsers_with_http_info(opts)
       nil
     end
 
-    # Initialize Registration Flow for browsers
-    # This endpoint initializes a browser-based user registration flow. Once initialized, the browser will be redirected to &#x60;selfservice.flows.registration.ui_url&#x60; with the flow ID set as the query parameter &#x60;?flow&#x3D;&#x60;. If a valid user session exists already, the browser will be redirected to &#x60;urls.default_redirect_url&#x60; unless the query parameter &#x60;?refresh&#x3D;true&#x60; was set.  :::note  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  :::  More information can be found at [Ory Kratos User Login and User Registration Documentation](https://www.ory.sh/docs/next/kratos/self-service/flows/user-login-user-registration).
+    # Initialize Settings Flow for Browsers
+    # This endpoint initializes a browser-based user settings flow. Once initialized, the browser will be redirected to &#x60;selfservice.flows.settings.ui_url&#x60; with the flow ID set as the query parameter &#x60;?flow&#x3D;&#x60;. If no valid Ory Kratos Session Cookie is included in the request, a login flow will be initialized.  :::note  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  :::  More information can be found at [Ory Kratos User Settings &amp; Profile Management Documentation](../self-service/flows/user-settings).
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
-    def initialize_self_service_registration_via_browser_flow_with_http_info(opts = {})
+    def initialize_self_service_settings_for_browsers_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_registration_via_browser_flow ...'
+        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_settings_for_browsers ...'
       end
       # resource path
-      local_var_path = '/self-service/registration/browser'
+      local_var_path = '/self-service/settings/browser'
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -847,10 +910,10 @@ module OryHydraClient
       return_type = opts[:debug_return_type]
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || []
+      auth_names = opts[:debug_auth_names] || ['sessionToken']
 
       new_options = opts.merge(
-        :operation => :"PublicApi.initialize_self_service_registration_via_browser_flow",
+        :operation => :"PublicApi.initialize_self_service_settings_for_browsers",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -861,27 +924,29 @@ module OryHydraClient
 
       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: PublicApi#initialize_self_service_registration_via_browser_flow\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: PublicApi#initialize_self_service_settings_for_browsers\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Initialize Settings Flow for API Clients
+    # Initialize Settings Flow for Native Apps and API clients
     # This endpoint initiates a settings flow for API clients such as mobile devices, smart TVs, and so on. You must provide a valid Ory Kratos Session Token for this endpoint to respond with HTTP 200 OK.  To fetch an existing settings flow call `/self-service/settings/flows?flow=<flow_id>`.  :::warning  You MUST NOT use this endpoint in client-side (Single Page Apps, ReactJS, AngularJS) nor server-side (Java Server Pages, NodeJS, PHP, Golang, ...) browser applications. Using this endpoint in these applications will make you vulnerable to a variety of CSRF attacks.  This endpoint MUST ONLY be used in scenarios such as native mobile apps (React Native, Objective C, Swift, Java, ...).  :::  More information can be found at [Ory Kratos User Settings & Profile Management Documentation](../self-service/flows/user-settings).
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_session_token The Session Token of the Identity performing the settings flow.
     # @return [SettingsFlow]
-    def initialize_self_service_settings_via_api_flow(opts = {})
-      data, _status_code, _headers = initialize_self_service_settings_via_api_flow_with_http_info(opts)
+    def initialize_self_service_settings_for_native_apps(opts = {})
+      data, _status_code, _headers = initialize_self_service_settings_for_native_apps_with_http_info(opts)
       data
     end
 
-    # Initialize Settings Flow for API Clients
+    # Initialize Settings Flow for Native Apps and API clients
     # This endpoint initiates a settings flow for API clients such as mobile devices, smart TVs, and so on. You must provide a valid Ory Kratos Session Token for this endpoint to respond with HTTP 200 OK.  To fetch an existing settings flow call &#x60;/self-service/settings/flows?flow&#x3D;&lt;flow_id&gt;&#x60;.  :::warning  You MUST NOT use this endpoint in client-side (Single Page Apps, ReactJS, AngularJS) nor server-side (Java Server Pages, NodeJS, PHP, Golang, ...) browser applications. Using this endpoint in these applications will make you vulnerable to a variety of CSRF attacks.  This endpoint MUST ONLY be used in scenarios such as native mobile apps (React Native, Objective C, Swift, Java, ...).  :::  More information can be found at [Ory Kratos User Settings &amp; Profile Management Documentation](../self-service/flows/user-settings).
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_session_token The Session Token of the Identity performing the settings flow.
     # @return [Array<(SettingsFlow, Integer, Hash)>] SettingsFlow data, response status code and response headers
-    def initialize_self_service_settings_via_api_flow_with_http_info(opts = {})
+    def initialize_self_service_settings_for_native_apps_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_settings_via_api_flow ...'
+        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_settings_for_native_apps ...'
       end
       # resource path
       local_var_path = '/self-service/settings/api'
@@ -893,6 +958,7 @@ module OryHydraClient
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params[:'X-Session-Token'] = opts[:'x_session_token'] if !opts[:'x_session_token'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -907,7 +973,7 @@ module OryHydraClient
       auth_names = opts[:debug_auth_names] || ['sessionToken']
 
       new_options = opts.merge(
-        :operation => :"PublicApi.initialize_self_service_settings_via_api_flow",
+        :operation => :"PublicApi.initialize_self_service_settings_for_native_apps",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -918,30 +984,30 @@ module OryHydraClient
 
       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: PublicApi#initialize_self_service_settings_via_api_flow\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: PublicApi#initialize_self_service_settings_for_native_apps\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Initialize Settings Flow for Browsers
-    # This endpoint initializes a browser-based user settings flow. Once initialized, the browser will be redirected to `selfservice.flows.settings.ui_url` with the flow ID set as the query parameter `?flow=`. If no valid Ory Kratos Session Cookie is included in the request, a login flow will be initialized.  :::note  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  :::  More information can be found at [Ory Kratos User Settings & Profile Management Documentation](../self-service/flows/user-settings).
+    # Initialize Verification Flow for Browser Clients
+    # This endpoint initializes a browser-based account verification flow. Once initialized, the browser will be redirected to `selfservice.flows.verification.ui_url` with the flow ID set as the query parameter `?flow=`.  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  More information can be found at [Ory Kratos Email and Phone Verification Documentation](https://www.ory.sh/docs/kratos/selfservice/flows/verify-email-account-activation).
     # @param [Hash] opts the optional parameters
     # @return [nil]
-    def initialize_self_service_settings_via_browser_flow(opts = {})
-      initialize_self_service_settings_via_browser_flow_with_http_info(opts)
+    def initialize_self_service_verification_for_browsers(opts = {})
+      initialize_self_service_verification_for_browsers_with_http_info(opts)
       nil
     end
 
-    # Initialize Settings Flow for Browsers
-    # This endpoint initializes a browser-based user settings flow. Once initialized, the browser will be redirected to &#x60;selfservice.flows.settings.ui_url&#x60; with the flow ID set as the query parameter &#x60;?flow&#x3D;&#x60;. If no valid Ory Kratos Session Cookie is included in the request, a login flow will be initialized.  :::note  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  :::  More information can be found at [Ory Kratos User Settings &amp; Profile Management Documentation](../self-service/flows/user-settings).
+    # Initialize Verification Flow for Browser Clients
+    # This endpoint initializes a browser-based account verification flow. Once initialized, the browser will be redirected to &#x60;selfservice.flows.verification.ui_url&#x60; with the flow ID set as the query parameter &#x60;?flow&#x3D;&#x60;.  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  More information can be found at [Ory Kratos Email and Phone Verification Documentation](https://www.ory.sh/docs/kratos/selfservice/flows/verify-email-account-activation).
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
-    def initialize_self_service_settings_via_browser_flow_with_http_info(opts = {})
+    def initialize_self_service_verification_for_browsers_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_settings_via_browser_flow ...'
+        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_verification_for_browsers ...'
       end
       # resource path
-      local_var_path = '/self-service/settings/browser'
+      local_var_path = '/self-service/verification/browser'
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -961,10 +1027,10 @@ module OryHydraClient
       return_type = opts[:debug_return_type]
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['sessionToken']
+      auth_names = opts[:debug_auth_names] || []
 
       new_options = opts.merge(
-        :operation => :"PublicApi.initialize_self_service_settings_via_browser_flow",
+        :operation => :"PublicApi.initialize_self_service_verification_for_browsers",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -975,27 +1041,27 @@ module OryHydraClient
 
       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: PublicApi#initialize_self_service_settings_via_browser_flow\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: PublicApi#initialize_self_service_verification_for_browsers\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Initialize Verification Flow for API Clients
+    # Initialize Verification Flow for Native Apps and API clients
     # This endpoint initiates a verification flow for API clients such as mobile devices, smart TVs, and so on.  To fetch an existing verification flow call `/self-service/verification/flows?flow=<flow_id>`.  :::warning  You MUST NOT use this endpoint in client-side (Single Page Apps, ReactJS, AngularJS) nor server-side (Java Server Pages, NodeJS, PHP, Golang, ...) browser applications. Using this endpoint in these applications will make you vulnerable to a variety of CSRF attacks.  This endpoint MUST ONLY be used in scenarios such as native mobile apps (React Native, Objective C, Swift, Java, ...).  :::  More information can be found at [Ory Kratos Email and Phone Verification Documentation](https://www.ory.sh/docs/kratos/selfservice/flows/verify-email-account-activation).
     # @param [Hash] opts the optional parameters
     # @return [VerificationFlow]
-    def initialize_self_service_verification_via_api_flow(opts = {})
-      data, _status_code, _headers = initialize_self_service_verification_via_api_flow_with_http_info(opts)
+    def initialize_self_service_verification_for_native_apps(opts = {})
+      data, _status_code, _headers = initialize_self_service_verification_for_native_apps_with_http_info(opts)
       data
     end
 
-    # Initialize Verification Flow for API Clients
+    # Initialize Verification Flow for Native Apps and API clients
     # This endpoint initiates a verification flow for API clients such as mobile devices, smart TVs, and so on.  To fetch an existing verification flow call &#x60;/self-service/verification/flows?flow&#x3D;&lt;flow_id&gt;&#x60;.  :::warning  You MUST NOT use this endpoint in client-side (Single Page Apps, ReactJS, AngularJS) nor server-side (Java Server Pages, NodeJS, PHP, Golang, ...) browser applications. Using this endpoint in these applications will make you vulnerable to a variety of CSRF attacks.  This endpoint MUST ONLY be used in scenarios such as native mobile apps (React Native, Objective C, Swift, Java, ...).  :::  More information can be found at [Ory Kratos Email and Phone Verification Documentation](https://www.ory.sh/docs/kratos/selfservice/flows/verify-email-account-activation).
     # @param [Hash] opts the optional parameters
     # @return [Array<(VerificationFlow, Integer, Hash)>] VerificationFlow data, response status code and response headers
-    def initialize_self_service_verification_via_api_flow_with_http_info(opts = {})
+    def initialize_self_service_verification_for_native_apps_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_verification_via_api_flow ...'
+        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_verification_for_native_apps ...'
       end
       # resource path
       local_var_path = '/self-service/verification/api'
@@ -1021,7 +1087,7 @@ module OryHydraClient
       auth_names = opts[:debug_auth_names] || []
 
       new_options = opts.merge(
-        :operation => :"PublicApi.initialize_self_service_verification_via_api_flow",
+        :operation => :"PublicApi.initialize_self_service_verification_for_native_apps",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -1032,64 +1098,7 @@ module OryHydraClient
 
       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: PublicApi#initialize_self_service_verification_via_api_flow\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
-    # Initialize Verification Flow for Browser Clients
-    # This endpoint initializes a browser-based account verification flow. Once initialized, the browser will be redirected to `selfservice.flows.verification.ui_url` with the flow ID set as the query parameter `?flow=`.  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  More information can be found at [Ory Kratos Email and Phone Verification Documentation](https://www.ory.sh/docs/kratos/selfservice/flows/verify-email-account-activation).
-    # @param [Hash] opts the optional parameters
-    # @return [nil]
-    def initialize_self_service_verification_via_browser_flow(opts = {})
-      initialize_self_service_verification_via_browser_flow_with_http_info(opts)
-      nil
-    end
-
-    # Initialize Verification Flow for Browser Clients
-    # This endpoint initializes a browser-based account verification flow. Once initialized, the browser will be redirected to &#x60;selfservice.flows.verification.ui_url&#x60; with the flow ID set as the query parameter &#x60;?flow&#x3D;&#x60;.  This endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).  More information can be found at [Ory Kratos Email and Phone Verification Documentation](https://www.ory.sh/docs/kratos/selfservice/flows/verify-email-account-activation).
-    # @param [Hash] opts the optional parameters
-    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
-    def initialize_self_service_verification_via_browser_flow_with_http_info(opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: PublicApi.initialize_self_service_verification_via_browser_flow ...'
-      end
-      # resource path
-      local_var_path = '/self-service/verification/browser'
-
-      # 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[:debug_body]
-
-      # return_type
-      return_type = opts[:debug_return_type]
-
-      # auth_names
-      auth_names = opts[:debug_auth_names] || []
-
-      new_options = opts.merge(
-        :operation => :"PublicApi.initialize_self_service_verification_via_browser_flow",
-        :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: PublicApi#initialize_self_service_verification_via_browser_flow\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: PublicApi#initialize_self_service_verification_for_native_apps\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
@@ -1434,6 +1443,7 @@ module OryHydraClient
     # Use this endpoint to complete a settings flow by sending an identity's updated password. This endpoint behaves differently for API and browser flows.  API-initiated flows expect `application/json` to be sent in the body and respond with HTTP 200 and an application/json body with the session token on success; HTTP 302 redirect to a fresh settings flow if the original flow expired with the appropriate error messages set; HTTP 400 on form validation errors. HTTP 401 when the endpoint is called without a valid session token. HTTP 403 when `selfservice.flows.settings.privileged_session_max_age` was reached. Implies that the user needs to re-authenticate.  Browser flows expect `application/x-www-form-urlencoded` to be sent in the body and responds with a HTTP 302 redirect to the post/after settings URL or the `return_to` value if it was set and if the flow succeeded; a HTTP 302 redirect to the Settings UI URL with the flow ID containing the validation errors otherwise. a HTTP 302 redirect to the login endpoint when `selfservice.flows.settings.privileged_session_max_age` was reached.  More information can be found at [Ory Kratos User Settings & Profile Management Documentation](../self-service/flows/user-settings).
     # @param flow [String] The Settings Flow ID  The value for this parameter comes from &#x60;flow&#x60; URL Query parameter sent to your application (e.g. &#x60;/settings?flow&#x3D;abcde&#x60;).
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_session_token The Session Token of the Identity performing the settings flow.
     # @option opts [SubmitSelfServiceSettingsFlow] :submit_self_service_settings_flow 
     # @return [SettingsViaApiResponse]
     def submit_self_service_settings_flow(flow, opts = {})
@@ -1445,6 +1455,7 @@ module OryHydraClient
     # Use this endpoint to complete a settings flow by sending an identity&#39;s updated password. This endpoint behaves differently for API and browser flows.  API-initiated flows expect &#x60;application/json&#x60; to be sent in the body and respond with HTTP 200 and an application/json body with the session token on success; HTTP 302 redirect to a fresh settings flow if the original flow expired with the appropriate error messages set; HTTP 400 on form validation errors. HTTP 401 when the endpoint is called without a valid session token. HTTP 403 when &#x60;selfservice.flows.settings.privileged_session_max_age&#x60; was reached. Implies that the user needs to re-authenticate.  Browser flows expect &#x60;application/x-www-form-urlencoded&#x60; to be sent in the body and responds with a HTTP 302 redirect to the post/after settings URL or the &#x60;return_to&#x60; value if it was set and if the flow succeeded; a HTTP 302 redirect to the Settings UI URL with the flow ID containing the validation errors otherwise. a HTTP 302 redirect to the login endpoint when &#x60;selfservice.flows.settings.privileged_session_max_age&#x60; was reached.  More information can be found at [Ory Kratos User Settings &amp; Profile Management Documentation](../self-service/flows/user-settings).
     # @param flow [String] The Settings Flow ID  The value for this parameter comes from &#x60;flow&#x60; URL Query parameter sent to your application (e.g. &#x60;/settings?flow&#x3D;abcde&#x60;).
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_session_token The Session Token of the Identity performing the settings flow.
     # @option opts [SubmitSelfServiceSettingsFlow] :submit_self_service_settings_flow 
     # @return [Array<(SettingsViaApiResponse, Integer, Hash)>] SettingsViaApiResponse data, response status code and response headers
     def submit_self_service_settings_flow_with_http_info(flow, opts = {})
@@ -1468,6 +1479,7 @@ module OryHydraClient
       header_params['Accept'] = @api_client.select_header_accept(['application/json'])
       # HTTP header 'Content-Type'
       header_params['Content-Type'] = @api_client.select_header_content_type(['application/json', 'application/x-www-form-urlencoded'])
+      header_params[:'X-Session-Token'] = opts[:'x_session_token'] if !opts[:'x_session_token'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1567,25 +1579,23 @@ module OryHydraClient
     end
 
     # Check Who the Current HTTP Session Belongs To
-    # Uses the HTTP Headers in the GET request to determine (e.g. by using checking the cookies) who is authenticated. Returns a session object in the body or 401 if the credentials are invalid or no credentials were sent. Additionally when the request it successful it adds the user ID to the 'X-Kratos-Authenticated-Identity-Id' header in the response.  This endpoint is useful for reverse proxies and API Gateways.
+    # Uses the HTTP Headers in the GET request to determine (e.g. by using checking the cookies) who is authenticated. Returns a session object in the body or 401 if the credentials are invalid or no credentials were sent. Additionally when the request it successful it adds the user ID to the 'X-Kratos-Authenticated-Identity-Id' header in the response.  This endpoint is useful for:  AJAX calls. Remember to send credentials and set up CORS correctly! Reverse proxies and API Gateways Server-side calls - use the `X-Session-Token` header!
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :cookie 
-    # @option opts [String] :authorization 
+    # @option opts [String] :x_session_token 
     # @return [Session]
-    def whoami(opts = {})
-      data, _status_code, _headers = whoami_with_http_info(opts)
+    def to_session(opts = {})
+      data, _status_code, _headers = to_session_with_http_info(opts)
       data
     end
 
     # Check Who the Current HTTP Session Belongs To
-    # Uses the HTTP Headers in the GET request to determine (e.g. by using checking the cookies) who is authenticated. Returns a session object in the body or 401 if the credentials are invalid or no credentials were sent. Additionally when the request it successful it adds the user ID to the &#39;X-Kratos-Authenticated-Identity-Id&#39; header in the response.  This endpoint is useful for reverse proxies and API Gateways.
+    # Uses the HTTP Headers in the GET request to determine (e.g. by using checking the cookies) who is authenticated. Returns a session object in the body or 401 if the credentials are invalid or no credentials were sent. Additionally when the request it successful it adds the user ID to the &#39;X-Kratos-Authenticated-Identity-Id&#39; header in the response.  This endpoint is useful for:  AJAX calls. Remember to send credentials and set up CORS correctly! Reverse proxies and API Gateways Server-side calls - use the &#x60;X-Session-Token&#x60; header!
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :cookie 
-    # @option opts [String] :authorization 
+    # @option opts [String] :x_session_token 
     # @return [Array<(Session, Integer, Hash)>] Session data, response status code and response headers
-    def whoami_with_http_info(opts = {})
+    def to_session_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: PublicApi.whoami ...'
+        @api_client.config.logger.debug 'Calling API: PublicApi.to_session ...'
       end
       # resource path
       local_var_path = '/sessions/whoami'
@@ -1597,8 +1607,7 @@ module OryHydraClient
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/json'])
-      header_params[:'Cookie'] = opts[:'cookie'] if !opts[:'cookie'].nil?
-      header_params[:'Authorization'] = opts[:'authorization'] if !opts[:'authorization'].nil?
+      header_params[:'X-Session-Token'] = opts[:'x_session_token'] if !opts[:'x_session_token'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1610,10 +1619,10 @@ module OryHydraClient
       return_type = opts[:debug_return_type] || 'Session'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['sessionToken']
+      auth_names = opts[:debug_auth_names] || ['sessionCookie']
 
       new_options = opts.merge(
-        :operation => :"PublicApi.whoami",
+        :operation => :"PublicApi.to_session",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -1624,7 +1633,7 @@ module OryHydraClient
 
       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: PublicApi#whoami\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: PublicApi#to_session\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end