ory-kratos-client 0.6.0.alpha17 → 0.7.0.alpha1

data/docs/Identity.md

@@ -4,13 +4,17 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
+| **created_at** | **Time** | CreatedAt is a helper struct field for gobuffalo.pop. | [optional] |
+| **credentials** | [**Hash<String, IdentityCredentials>**](IdentityCredentials.md) | Credentials represents all credentials that can be used for authenticating this identity. | [optional] |
 | **id** | **String** |  |  |
 | **recovery_addresses** | [**Array<RecoveryAddress>**](RecoveryAddress.md) | RecoveryAddresses contains all the addresses that can be used to recover an identity. | [optional] |
 | **schema_id** | **String** | SchemaID is the ID of the JSON Schema to be used for validating the identity's traits. |  |
 | **schema_url** | **String** | SchemaURL is the URL of the endpoint where the identity's traits schema can be fetched from.  format: url |  |
-| **traits** | **Object** |  |  |
-| **test** | **String** |  | [optional] |
-| **verifiable_addresses** | [**Array<VerifiableAddress>**](VerifiableAddress.md) | VerifiableAddresses contains all the addresses that can be verified by the user. | [optional] |
+| **state** | [**AnyType**](.md) | State is the identity's state. |  |
+| **state_changed_at** | **Time** |  | [optional] |
+| **traits** | [**AnyType**](.md) | Traits represent an identity's traits. The identity is able to create, modify, and delete traits in a self-service manner. The input will always be validated against the JSON Schema defined in `schema_url`. |  |
+| **updated_at** | **Time** | UpdatedAt is a helper struct field for gobuffalo.pop. | [optional] |
+| **verifiable_addresses** | [**Array<VerifiableIdentityAddress>**](VerifiableIdentityAddress.md) | VerifiableAddresses contains all the addresses that can be verified by the user. | [optional] |
 
 ## Example
 
@@ -18,12 +22,16 @@
 require 'ory-kratos-client'
 
 instance = OryHydraClient::Identity.new(
+  created_at: null,
+  credentials: null,
   id: null,
   recovery_addresses: null,
   schema_id: null,
   schema_url: null,
+  state: null,
+  state_changed_at: null,
   traits: null,
-  test: null,
+  updated_at: null,
   verifiable_addresses: null
 )
 ```

data/docs/IdentityCredentials.md

@@ -5,8 +5,10 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **config** | **Object** |  | [optional] |
+| **created_at** | **Time** | CreatedAt is a helper struct field for gobuffalo.pop. | [optional] |
 | **identifiers** | **Array<String>** | Identifiers represents a list of unique identifiers this credential type matches. | [optional] |
 | **type** | **String** | and so on. | [optional] |
+| **updated_at** | **Time** | UpdatedAt is a helper struct field for gobuffalo.pop. | [optional] |
 
 ## Example
 
@@ -15,8 +17,10 @@ require 'ory-kratos-client'
 
 instance = OryHydraClient::IdentityCredentials.new(
   config: null,
+  created_at: null,
   identifiers: null,
-  type: null
+  type: null,
+  updated_at: null
 )
 ```
 

data/docs/JsonError.md

@@ -0,0 +1,18 @@
+# OryHydraClient::JsonError
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **error** | [**GenericError**](GenericError.md) |  |  |
+
+## Example
+
+```ruby
+require 'ory-kratos-client'
+
+instance = OryHydraClient::JsonError.new(
+  error: null
+)
+```
+

data/docs/LoginFlow.md

@@ -5,6 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **active** | **String** | and so on. | [optional] |
+| **created_at** | **Time** | CreatedAt is a helper struct field for gobuffalo.pop. | [optional] |
 | **expires_at** | **Time** | ExpiresAt is the time (UTC) when the flow expires. If the user still wishes to log in, a new flow has to be initiated. |  |
 | **forced** | **Boolean** | Forced stores whether this login flow should enforce re-authentication. | [optional] |
 | **id** | **String** |  |  |
@@ -12,6 +13,7 @@
 | **request_url** | **String** | RequestURL is the initial URL that was requested from Ory Kratos. It can be used to forward information contained in the URL's path or query for example. |  |
 | **type** | **String** | The flow type can either be `api` or `browser`. |  |
 | **ui** | [**UiContainer**](UiContainer.md) |  |  |
+| **updated_at** | **Time** | UpdatedAt is a helper struct field for gobuffalo.pop. | [optional] |
 
 ## Example
 
@@ -20,13 +22,15 @@ require 'ory-kratos-client'
 
 instance = OryHydraClient::LoginFlow.new(
   active: null,
+  created_at: null,
   expires_at: null,
   forced: null,
   id: null,
   issued_at: null,
   request_url: null,
   type: null,
-  ui: null
+  ui: null,
+  updated_at: null
 )
 ```
 

data/docs/MetadataApi.md

@@ -0,0 +1,254 @@
+# OryHydraClient::MetadataApi
+
+All URIs are relative to *http://localhost*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**get_version**](MetadataApi.md#get_version) | **GET** /version | Return Running Software Version. |
+| [**is_alive**](MetadataApi.md#is_alive) | **GET** /health/alive | Check HTTP Server Status |
+| [**is_ready**](MetadataApi.md#is_ready) | **GET** /health/ready | Check HTTP Server and Database Status |
+| [**prometheus**](MetadataApi.md#prometheus) | **GET** /metrics/prometheus | Get snapshot metrics from the service. If you're using k8s, you can then add annotations to your deployment like so: |
+
+
+## get_version
+
+> <InlineResponse2001> get_version
+
+Return Running Software Version.
+
+This endpoint returns the version of Ory Kratos.  If the service supports TLS Edge Termination, this endpoint does not require the `X-Forwarded-Proto` header to be set.  Be aware that if you are running multiple nodes of this service, the version will never refer to the cluster state, only to a single instance.
+
+### Examples
+
+```ruby
+require 'time'
+require 'ory-kratos-client'
+
+api_instance = OryHydraClient::MetadataApi.new
+
+begin
+  # Return Running Software Version.
+  result = api_instance.get_version
+  p result
+rescue OryHydraClient::ApiError => e
+  puts "Error when calling MetadataApi->get_version: #{e}"
+end
+```
+
+#### Using the get_version_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<InlineResponse2001>, Integer, Hash)> get_version_with_http_info
+
+```ruby
+begin
+  # Return Running Software Version.
+  data, status_code, headers = api_instance.get_version_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <InlineResponse2001>
+rescue OryHydraClient::ApiError => e
+  puts "Error when calling MetadataApi->get_version_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**InlineResponse2001**](InlineResponse2001.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## is_alive
+
+> <InlineResponse200> is_alive
+
+Check HTTP Server Status
+
+This endpoint returns a HTTP 200 status code when Ory Kratos is accepting incoming HTTP requests. This status does currently not include checks whether the database connection is working.  If the service supports TLS Edge Termination, this endpoint does not require the `X-Forwarded-Proto` header to be set.  Be aware that if you are running multiple nodes of this service, the health status will never refer to the cluster state, only to a single instance.
+
+### Examples
+
+```ruby
+require 'time'
+require 'ory-kratos-client'
+
+api_instance = OryHydraClient::MetadataApi.new
+
+begin
+  # Check HTTP Server Status
+  result = api_instance.is_alive
+  p result
+rescue OryHydraClient::ApiError => e
+  puts "Error when calling MetadataApi->is_alive: #{e}"
+end
+```
+
+#### Using the is_alive_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<InlineResponse200>, Integer, Hash)> is_alive_with_http_info
+
+```ruby
+begin
+  # Check HTTP Server Status
+  data, status_code, headers = api_instance.is_alive_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <InlineResponse200>
+rescue OryHydraClient::ApiError => e
+  puts "Error when calling MetadataApi->is_alive_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**InlineResponse200**](InlineResponse200.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## is_ready
+
+> <InlineResponse200> is_ready
+
+Check HTTP Server and Database Status
+
+This endpoint returns a HTTP 200 status code when Ory Kratos is up running and the environment dependencies (e.g. the database) are responsive as well.  If the service supports TLS Edge Termination, this endpoint does not require the `X-Forwarded-Proto` header to be set.  Be aware that if you are running multiple nodes of Ory Kratos, the health status will never refer to the cluster state, only to a single instance.
+
+### Examples
+
+```ruby
+require 'time'
+require 'ory-kratos-client'
+
+api_instance = OryHydraClient::MetadataApi.new
+
+begin
+  # Check HTTP Server and Database Status
+  result = api_instance.is_ready
+  p result
+rescue OryHydraClient::ApiError => e
+  puts "Error when calling MetadataApi->is_ready: #{e}"
+end
+```
+
+#### Using the is_ready_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<InlineResponse200>, Integer, Hash)> is_ready_with_http_info
+
+```ruby
+begin
+  # Check HTTP Server and Database Status
+  data, status_code, headers = api_instance.is_ready_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <InlineResponse200>
+rescue OryHydraClient::ApiError => e
+  puts "Error when calling MetadataApi->is_ready_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**InlineResponse200**](InlineResponse200.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## prometheus
+
+> prometheus
+
+Get snapshot metrics from the service. If you're using k8s, you can then add annotations to your deployment like so:
+
+``` metadata: annotations: prometheus.io/port: \"4434\" prometheus.io/path: \"/metrics/prometheus\" ```
+
+### Examples
+
+```ruby
+require 'time'
+require 'ory-kratos-client'
+
+api_instance = OryHydraClient::MetadataApi.new
+
+begin
+  # Get snapshot metrics from the service. If you're using k8s, you can then add annotations to your deployment like so:
+  api_instance.prometheus
+rescue OryHydraClient::ApiError => e
+  puts "Error when calling MetadataApi->prometheus: #{e}"
+end
+```
+
+#### Using the prometheus_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> prometheus_with_http_info
+
+```ruby
+begin
+  # Get snapshot metrics from the service. If you're using k8s, you can then add annotations to your deployment like so:
+  data, status_code, headers = api_instance.prometheus_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue OryHydraClient::ApiError => e
+  puts "Error when calling MetadataApi->prometheus_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: Not defined
+

data/docs/PublicApi.md

@@ -1,6 +1,6 @@
 # OryHydraClient::PublicApi
 
-All URIs are relative to *https://demo.tenants.oryapis.com/api/kratos/public*
+All URIs are relative to *http://localhost*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
@@ -12,16 +12,16 @@ All URIs are relative to *https://demo.tenants.oryapis.com/api/kratos/public*
 | [**get_self_service_settings_flow**](PublicApi.md#get_self_service_settings_flow) | **GET** /self-service/settings/flows | Get Settings Flow |
 | [**get_self_service_verification_flow**](PublicApi.md#get_self_service_verification_flow) | **GET** /self-service/verification/flows | Get Verification Flow |
 | [**initialize_self_service_browser_logout_flow**](PublicApi.md#initialize_self_service_browser_logout_flow) | **GET** /self-service/browser/flows/logout | Initialize Browser-Based Logout User Flow |
-| [**initialize_self_service_login_via_api_flow**](PublicApi.md#initialize_self_service_login_via_api_flow) | **GET** /self-service/login/api | Initialize Login Flow for API clients |
-| [**initialize_self_service_login_via_browser_flow**](PublicApi.md#initialize_self_service_login_via_browser_flow) | **GET** /self-service/login/browser | Initialize Login Flow for browsers |
-| [**initialize_self_service_recovery_via_api_flow**](PublicApi.md#initialize_self_service_recovery_via_api_flow) | **GET** /self-service/recovery/api | Initialize Recovery Flow for API Clients |
-| [**initialize_self_service_recovery_via_browser_flow**](PublicApi.md#initialize_self_service_recovery_via_browser_flow) | **GET** /self-service/recovery/browser | Initialize Recovery Flow for Browser Clients |
-| [**initialize_self_service_registration_via_api_flow**](PublicApi.md#initialize_self_service_registration_via_api_flow) | **GET** /self-service/registration/api | Initialize Registration Flow for API clients |
-| [**initialize_self_service_registration_via_browser_flow**](PublicApi.md#initialize_self_service_registration_via_browser_flow) | **GET** /self-service/registration/browser | Initialize Registration Flow for browsers |
-| [**initialize_self_service_settings_via_api_flow**](PublicApi.md#initialize_self_service_settings_via_api_flow) | **GET** /self-service/settings/api | Initialize Settings Flow for API Clients |
-| [**initialize_self_service_settings_via_browser_flow**](PublicApi.md#initialize_self_service_settings_via_browser_flow) | **GET** /self-service/settings/browser | Initialize Settings Flow for Browsers |
-| [**initialize_self_service_verification_via_api_flow**](PublicApi.md#initialize_self_service_verification_via_api_flow) | **GET** /self-service/verification/api | Initialize Verification Flow for API Clients |
-| [**initialize_self_service_verification_via_browser_flow**](PublicApi.md#initialize_self_service_verification_via_browser_flow) | **GET** /self-service/verification/browser | Initialize Verification Flow for Browser Clients |
+| [**initialize_self_service_login_for_browsers**](PublicApi.md#initialize_self_service_login_for_browsers) | **GET** /self-service/login/browser | Initialize Login Flow for browsers |
+| [**initialize_self_service_login_for_native_apps**](PublicApi.md#initialize_self_service_login_for_native_apps) | **GET** /self-service/login/api | Initialize Login Flow for Native Apps and API clients |
+| [**initialize_self_service_recovery_for_browsers**](PublicApi.md#initialize_self_service_recovery_for_browsers) | **GET** /self-service/recovery/browser | Initialize Recovery Flow for Browser Clients |
+| [**initialize_self_service_recovery_for_native_apps**](PublicApi.md#initialize_self_service_recovery_for_native_apps) | **GET** /self-service/recovery/api | Initialize Recovery Flow for Native Apps and API clients |
+| [**initialize_self_service_registration_for_browsers**](PublicApi.md#initialize_self_service_registration_for_browsers) | **GET** /self-service/registration/browser | Initialize Registration Flow for browsers |
+| [**initialize_self_service_registration_for_native_apps**](PublicApi.md#initialize_self_service_registration_for_native_apps) | **GET** /self-service/registration/api | Initialize Registration Flow for Native Apps and API clients |
+| [**initialize_self_service_settings_for_browsers**](PublicApi.md#initialize_self_service_settings_for_browsers) | **GET** /self-service/settings/browser | Initialize Settings Flow for Browsers |
+| [**initialize_self_service_settings_for_native_apps**](PublicApi.md#initialize_self_service_settings_for_native_apps) | **GET** /self-service/settings/api | Initialize Settings Flow for Native Apps and API clients |
+| [**initialize_self_service_verification_for_browsers**](PublicApi.md#initialize_self_service_verification_for_browsers) | **GET** /self-service/verification/browser | Initialize Verification Flow for Browser Clients |
+| [**initialize_self_service_verification_for_native_apps**](PublicApi.md#initialize_self_service_verification_for_native_apps) | **GET** /self-service/verification/api | Initialize Verification Flow for Native Apps and API clients |
 | [**revoke_session**](PublicApi.md#revoke_session) | **DELETE** /sessions | Initialize Logout Flow for API Clients - Revoke a Session |
 | [**submit_self_service_login_flow**](PublicApi.md#submit_self_service_login_flow) | **POST** /self-service/login | Submit a Login Flow |
 | [**submit_self_service_recovery_flow**](PublicApi.md#submit_self_service_recovery_flow) | **POST** /self-service/recovery | Complete Recovery Flow |
@@ -29,7 +29,7 @@ All URIs are relative to *https://demo.tenants.oryapis.com/api/kratos/public*
 | [**submit_self_service_registration_flow**](PublicApi.md#submit_self_service_registration_flow) | **POST** /self-service/registration | Submit a Registration Flow |
 | [**submit_self_service_settings_flow**](PublicApi.md#submit_self_service_settings_flow) | **POST** /self-service/settings | Complete Settings Flow |
 | [**submit_self_service_verification_flow**](PublicApi.md#submit_self_service_verification_flow) | **POST** /self-service/verification/methods/link | Complete Verification Flow |
-| [**whoami**](PublicApi.md#whoami) | **GET** /sessions/whoami | Check Who the Current HTTP Session Belongs To |
+| [**to_session**](PublicApi.md#to_session) | **GET** /sessions/whoami | Check Who the Current HTTP Session Belongs To |
 
 
 ## get_schema
@@ -98,7 +98,7 @@ No authorization required
 
 ## get_self_service_error
 
-> <ErrorContainer> get_self_service_error(error)
+> <SelfServiceErrorContainer> get_self_service_error(error)
 
 Get User-Facing Self-Service Errors
 
@@ -126,7 +126,7 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<ErrorContainer>, Integer, Hash)> get_self_service_error_with_http_info(error)
+> <Array(<SelfServiceErrorContainer>, Integer, Hash)> get_self_service_error_with_http_info(error)
 
 ```ruby
 begin
@@ -134,7 +134,7 @@ begin
   data, status_code, headers = api_instance.get_self_service_error_with_http_info(error)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <ErrorContainer>
+  p data # => <SelfServiceErrorContainer>
 rescue OryHydraClient::ApiError => e
   puts "Error when calling PublicApi->get_self_service_error_with_http_info: #{e}"
 end
@@ -148,7 +148,7 @@ end
 
 ### Return type
 
-[**ErrorContainer**](ErrorContainer.md)
+[**SelfServiceErrorContainer**](SelfServiceErrorContainer.md)
 
 ### Authorization
 
@@ -354,7 +354,7 @@ No authorization required
 
 ## get_self_service_settings_flow
 
-> <SettingsFlow> get_self_service_settings_flow(id)
+> <SettingsFlow> get_self_service_settings_flow(id, opts)
 
 Get Settings Flow
 
@@ -367,18 +367,19 @@ require 'time'
 require 'ory-kratos-client'
 # setup authorization
 OryHydraClient.configure do |config|
-  # Configure API key authorization: sessionToken
-  config.api_key['sessionToken'] = '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['sessionToken'] = 'Bearer'
+  # Configure Bearer authorization: sessionToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
 api_instance = OryHydraClient::PublicApi.new
 id = 'id_example' # String | ID is the Settings Flow ID  The value for this parameter comes from `flow` URL Query parameter sent to your application (e.g. `/settings?flow=abcde`).
+opts = {
+  x_session_token: 'x_session_token_example' # String | The Session Token of the Identity performing the settings flow.
+}
 
 begin
   # Get Settings Flow
-  result = api_instance.get_self_service_settings_flow(id)
+  result = api_instance.get_self_service_settings_flow(id, opts)
   p result
 rescue OryHydraClient::ApiError => e
   puts "Error when calling PublicApi->get_self_service_settings_flow: #{e}"
@@ -389,12 +390,12 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SettingsFlow>, Integer, Hash)> get_self_service_settings_flow_with_http_info(id)
+> <Array(<SettingsFlow>, Integer, Hash)> get_self_service_settings_flow_with_http_info(id, opts)
 
 ```ruby
 begin
   # Get Settings Flow
-  data, status_code, headers = api_instance.get_self_service_settings_flow_with_http_info(id)
+  data, status_code, headers = api_instance.get_self_service_settings_flow_with_http_info(id, opts)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <SettingsFlow>
@@ -408,6 +409,7 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **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;). |  |
+| **x_session_token** | **String** | The Session Token of the Identity performing the settings flow. | [optional] |
 
 ### Return type
 
@@ -547,13 +549,13 @@ No authorization required
 - **Accept**: application/json
 
 
-## initialize_self_service_login_via_api_flow
+## initialize_self_service_login_for_browsers
 
-> <LoginFlow> initialize_self_service_login_via_api_flow(opts)
+> initialize_self_service_login_for_browsers(opts)
 
-Initialize Login Flow for API clients
+Initialize Login Flow for browsers
 
-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).
+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).
 
 ### Examples
 
@@ -567,29 +569,28 @@ opts = {
 }
 
 begin
-  # Initialize Login Flow for API clients
-  result = api_instance.initialize_self_service_login_via_api_flow(opts)
-  p result
+  # Initialize Login Flow for browsers
+  api_instance.initialize_self_service_login_for_browsers(opts)
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_login_via_api_flow: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_login_for_browsers: #{e}"
 end
 ```
 
-#### Using the initialize_self_service_login_via_api_flow_with_http_info variant
+#### Using the initialize_self_service_login_for_browsers_with_http_info variant
 
-This returns an Array which contains the response data, status code and headers.
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
 
-> <Array(<LoginFlow>, Integer, Hash)> initialize_self_service_login_via_api_flow_with_http_info(opts)
+> <Array(nil, Integer, Hash)> initialize_self_service_login_for_browsers_with_http_info(opts)
 
 ```ruby
 begin
-  # Initialize Login Flow for API clients
-  data, status_code, headers = api_instance.initialize_self_service_login_via_api_flow_with_http_info(opts)
+  # Initialize Login Flow for browsers
+  data, status_code, headers = api_instance.initialize_self_service_login_for_browsers_with_http_info(opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <LoginFlow>
+  p data # => nil
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_login_via_api_flow_with_http_info: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_login_for_browsers_with_http_info: #{e}"
 end
 ```
 
@@ -601,7 +602,7 @@ end
 
 ### Return type
 
-[**LoginFlow**](LoginFlow.md)
+nil (empty response body)
 
 ### Authorization
 
@@ -613,13 +614,13 @@ No authorization required
 - **Accept**: application/json
 
 
-## initialize_self_service_login_via_browser_flow
+## initialize_self_service_login_for_native_apps
 
-> initialize_self_service_login_via_browser_flow
+> <LoginFlow> initialize_self_service_login_for_native_apps(opts)
 
-Initialize Login Flow for browsers
+Initialize Login Flow for Native Apps and API clients
 
-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).
+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).
 
 ### Examples
 
@@ -628,40 +629,46 @@ require 'time'
 require 'ory-kratos-client'
 
 api_instance = OryHydraClient::PublicApi.new
+opts = {
+  refresh: true # Boolean | 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.
+}
 
 begin
-  # Initialize Login Flow for browsers
-  api_instance.initialize_self_service_login_via_browser_flow
+  # Initialize Login Flow for Native Apps and API clients
+  result = api_instance.initialize_self_service_login_for_native_apps(opts)
+  p result
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_login_via_browser_flow: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_login_for_native_apps: #{e}"
 end
 ```
 
-#### Using the initialize_self_service_login_via_browser_flow_with_http_info variant
+#### Using the initialize_self_service_login_for_native_apps_with_http_info variant
 
-This returns an Array which contains the response data (`nil` in this case), status code and headers.
+This returns an Array which contains the response data, status code and headers.
 
-> <Array(nil, Integer, Hash)> initialize_self_service_login_via_browser_flow_with_http_info
+> <Array(<LoginFlow>, Integer, Hash)> initialize_self_service_login_for_native_apps_with_http_info(opts)
 
 ```ruby
 begin
-  # Initialize Login Flow for browsers
-  data, status_code, headers = api_instance.initialize_self_service_login_via_browser_flow_with_http_info
+  # Initialize Login Flow for Native Apps and API clients
+  data, status_code, headers = api_instance.initialize_self_service_login_for_native_apps_with_http_info(opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => nil
+  p data # => <LoginFlow>
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_login_via_browser_flow_with_http_info: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_login_for_native_apps_with_http_info: #{e}"
 end
 ```
 
 ### Parameters
 
-This endpoint does not need any parameter.
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **refresh** | **Boolean** | 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. | [optional] |
 
 ### Return type
 
-nil (empty response body)
+[**LoginFlow**](LoginFlow.md)
 
 ### Authorization
 
@@ -673,13 +680,13 @@ No authorization required
 - **Accept**: application/json
 
 
-## initialize_self_service_recovery_via_api_flow
+## initialize_self_service_recovery_for_browsers
 
-> <RecoveryFlow> initialize_self_service_recovery_via_api_flow
+> initialize_self_service_recovery_for_browsers
 
-Initialize Recovery Flow for API Clients
+Initialize Recovery Flow for Browser 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).
+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).
 
 ### Examples
 
@@ -690,29 +697,28 @@ require 'ory-kratos-client'
 api_instance = OryHydraClient::PublicApi.new
 
 begin
-  # Initialize Recovery Flow for API Clients
-  result = api_instance.initialize_self_service_recovery_via_api_flow
-  p result
+  # Initialize Recovery Flow for Browser Clients
+  api_instance.initialize_self_service_recovery_for_browsers
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_recovery_via_api_flow: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_recovery_for_browsers: #{e}"
 end
 ```
 
-#### Using the initialize_self_service_recovery_via_api_flow_with_http_info variant
+#### Using the initialize_self_service_recovery_for_browsers_with_http_info variant
 
-This returns an Array which contains the response data, status code and headers.
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
 
-> <Array(<RecoveryFlow>, Integer, Hash)> initialize_self_service_recovery_via_api_flow_with_http_info
+> <Array(nil, Integer, Hash)> initialize_self_service_recovery_for_browsers_with_http_info
 
 ```ruby
 begin
-  # Initialize Recovery Flow for API Clients
-  data, status_code, headers = api_instance.initialize_self_service_recovery_via_api_flow_with_http_info
+  # Initialize Recovery Flow for Browser Clients
+  data, status_code, headers = api_instance.initialize_self_service_recovery_for_browsers_with_http_info
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <RecoveryFlow>
+  p data # => nil
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_recovery_via_api_flow_with_http_info: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_recovery_for_browsers_with_http_info: #{e}"
 end
 ```
 
@@ -722,7 +728,7 @@ This endpoint does not need any parameter.
 
 ### Return type
 
-[**RecoveryFlow**](RecoveryFlow.md)
+nil (empty response body)
 
 ### Authorization
 
@@ -734,13 +740,13 @@ No authorization required
 - **Accept**: application/json
 
 
-## initialize_self_service_recovery_via_browser_flow
+## initialize_self_service_recovery_for_native_apps
 
-> initialize_self_service_recovery_via_browser_flow
+> <RecoveryFlow> initialize_self_service_recovery_for_native_apps
 
-Initialize Recovery Flow for Browser Clients
+Initialize Recovery Flow for Native Apps and API 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).
+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).
 
 ### Examples
 
@@ -751,28 +757,29 @@ require 'ory-kratos-client'
 api_instance = OryHydraClient::PublicApi.new
 
 begin
-  # Initialize Recovery Flow for Browser Clients
-  api_instance.initialize_self_service_recovery_via_browser_flow
+  # Initialize Recovery Flow for Native Apps and API clients
+  result = api_instance.initialize_self_service_recovery_for_native_apps
+  p result
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_recovery_via_browser_flow: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_recovery_for_native_apps: #{e}"
 end
 ```
 
-#### Using the initialize_self_service_recovery_via_browser_flow_with_http_info variant
+#### Using the initialize_self_service_recovery_for_native_apps_with_http_info variant
 
-This returns an Array which contains the response data (`nil` in this case), status code and headers.
+This returns an Array which contains the response data, status code and headers.
 
-> <Array(nil, Integer, Hash)> initialize_self_service_recovery_via_browser_flow_with_http_info
+> <Array(<RecoveryFlow>, Integer, Hash)> initialize_self_service_recovery_for_native_apps_with_http_info
 
 ```ruby
 begin
-  # Initialize Recovery Flow for Browser Clients
-  data, status_code, headers = api_instance.initialize_self_service_recovery_via_browser_flow_with_http_info
+  # Initialize Recovery Flow for Native Apps and API clients
+  data, status_code, headers = api_instance.initialize_self_service_recovery_for_native_apps_with_http_info
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => nil
+  p data # => <RecoveryFlow>
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_recovery_via_browser_flow_with_http_info: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_recovery_for_native_apps_with_http_info: #{e}"
 end
 ```
 
@@ -782,7 +789,7 @@ This endpoint does not need any parameter.
 
 ### Return type
 
-nil (empty response body)
+[**RecoveryFlow**](RecoveryFlow.md)
 
 ### Authorization
 
@@ -794,13 +801,13 @@ No authorization required
 - **Accept**: application/json
 
 
-## initialize_self_service_registration_via_api_flow
+## initialize_self_service_registration_for_browsers
 
-> <RegistrationFlow> initialize_self_service_registration_via_api_flow
+> initialize_self_service_registration_for_browsers
 
-Initialize Registration Flow for API clients
+Initialize Registration Flow for browsers
 
-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).
+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).
 
 ### Examples
 
@@ -811,29 +818,28 @@ require 'ory-kratos-client'
 api_instance = OryHydraClient::PublicApi.new
 
 begin
-  # Initialize Registration Flow for API clients
-  result = api_instance.initialize_self_service_registration_via_api_flow
-  p result
+  # Initialize Registration Flow for browsers
+  api_instance.initialize_self_service_registration_for_browsers
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_registration_via_api_flow: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_registration_for_browsers: #{e}"
 end
 ```
 
-#### Using the initialize_self_service_registration_via_api_flow_with_http_info variant
+#### Using the initialize_self_service_registration_for_browsers_with_http_info variant
 
-This returns an Array which contains the response data, status code and headers.
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
 
-> <Array(<RegistrationFlow>, Integer, Hash)> initialize_self_service_registration_via_api_flow_with_http_info
+> <Array(nil, Integer, Hash)> initialize_self_service_registration_for_browsers_with_http_info
 
 ```ruby
 begin
-  # Initialize Registration Flow for API clients
-  data, status_code, headers = api_instance.initialize_self_service_registration_via_api_flow_with_http_info
+  # Initialize Registration Flow for browsers
+  data, status_code, headers = api_instance.initialize_self_service_registration_for_browsers_with_http_info
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <RegistrationFlow>
+  p data # => nil
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_registration_via_api_flow_with_http_info: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_registration_for_browsers_with_http_info: #{e}"
 end
 ```
 
@@ -843,7 +849,7 @@ This endpoint does not need any parameter.
 
 ### Return type
 
-[**RegistrationFlow**](RegistrationFlow.md)
+nil (empty response body)
 
 ### Authorization
 
@@ -855,13 +861,13 @@ No authorization required
 - **Accept**: application/json
 
 
-## initialize_self_service_registration_via_browser_flow
+## initialize_self_service_registration_for_native_apps
 
-> initialize_self_service_registration_via_browser_flow
+> <RegistrationFlow> initialize_self_service_registration_for_native_apps
 
-Initialize Registration Flow for browsers
+Initialize Registration Flow for Native Apps and API clients
 
-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).
+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).
 
 ### Examples
 
@@ -872,28 +878,29 @@ require 'ory-kratos-client'
 api_instance = OryHydraClient::PublicApi.new
 
 begin
-  # Initialize Registration Flow for browsers
-  api_instance.initialize_self_service_registration_via_browser_flow
+  # Initialize Registration Flow for Native Apps and API clients
+  result = api_instance.initialize_self_service_registration_for_native_apps
+  p result
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_registration_via_browser_flow: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_registration_for_native_apps: #{e}"
 end
 ```
 
-#### Using the initialize_self_service_registration_via_browser_flow_with_http_info variant
+#### Using the initialize_self_service_registration_for_native_apps_with_http_info variant
 
-This returns an Array which contains the response data (`nil` in this case), status code and headers.
+This returns an Array which contains the response data, status code and headers.
 
-> <Array(nil, Integer, Hash)> initialize_self_service_registration_via_browser_flow_with_http_info
+> <Array(<RegistrationFlow>, Integer, Hash)> initialize_self_service_registration_for_native_apps_with_http_info
 
 ```ruby
 begin
-  # Initialize Registration Flow for browsers
-  data, status_code, headers = api_instance.initialize_self_service_registration_via_browser_flow_with_http_info
+  # Initialize Registration Flow for Native Apps and API clients
+  data, status_code, headers = api_instance.initialize_self_service_registration_for_native_apps_with_http_info
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => nil
+  p data # => <RegistrationFlow>
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_registration_via_browser_flow_with_http_info: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_registration_for_native_apps_with_http_info: #{e}"
 end
 ```
 
@@ -903,7 +910,7 @@ This endpoint does not need any parameter.
 
 ### Return type
 
-nil (empty response body)
+[**RegistrationFlow**](RegistrationFlow.md)
 
 ### Authorization
 
@@ -915,13 +922,13 @@ No authorization required
 - **Accept**: application/json
 
 
-## initialize_self_service_settings_via_api_flow
+## initialize_self_service_settings_for_browsers
 
-> <SettingsFlow> initialize_self_service_settings_via_api_flow
+> initialize_self_service_settings_for_browsers
 
-Initialize Settings Flow for API Clients
+Initialize Settings Flow for Browsers
 
-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).
+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).
 
 ### Examples
 
@@ -930,38 +937,35 @@ require 'time'
 require 'ory-kratos-client'
 # setup authorization
 OryHydraClient.configure do |config|
-  # Configure API key authorization: sessionToken
-  config.api_key['sessionToken'] = '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['sessionToken'] = 'Bearer'
+  # Configure Bearer authorization: sessionToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
 api_instance = OryHydraClient::PublicApi.new
 
 begin
-  # Initialize Settings Flow for API Clients
-  result = api_instance.initialize_self_service_settings_via_api_flow
-  p result
+  # Initialize Settings Flow for Browsers
+  api_instance.initialize_self_service_settings_for_browsers
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_settings_via_api_flow: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_settings_for_browsers: #{e}"
 end
 ```
 
-#### Using the initialize_self_service_settings_via_api_flow_with_http_info variant
+#### Using the initialize_self_service_settings_for_browsers_with_http_info variant
 
-This returns an Array which contains the response data, status code and headers.
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
 
-> <Array(<SettingsFlow>, Integer, Hash)> initialize_self_service_settings_via_api_flow_with_http_info
+> <Array(nil, Integer, Hash)> initialize_self_service_settings_for_browsers_with_http_info
 
 ```ruby
 begin
-  # Initialize Settings Flow for API Clients
-  data, status_code, headers = api_instance.initialize_self_service_settings_via_api_flow_with_http_info
+  # Initialize Settings Flow for Browsers
+  data, status_code, headers = api_instance.initialize_self_service_settings_for_browsers_with_http_info
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SettingsFlow>
+  p data # => nil
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_settings_via_api_flow_with_http_info: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_settings_for_browsers_with_http_info: #{e}"
 end
 ```
 
@@ -971,7 +975,7 @@ This endpoint does not need any parameter.
 
 ### Return type
 
-[**SettingsFlow**](SettingsFlow.md)
+nil (empty response body)
 
 ### Authorization
 
@@ -983,13 +987,13 @@ This endpoint does not need any parameter.
 - **Accept**: application/json
 
 
-## initialize_self_service_settings_via_browser_flow
+## initialize_self_service_settings_for_native_apps
 
-> initialize_self_service_settings_via_browser_flow
+> <SettingsFlow> initialize_self_service_settings_for_native_apps(opts)
 
-Initialize Settings Flow for Browsers
+Initialize Settings Flow for Native Apps and API clients
 
-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).
+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).
 
 ### Examples
 
@@ -998,47 +1002,51 @@ require 'time'
 require 'ory-kratos-client'
 # setup authorization
 OryHydraClient.configure do |config|
-  # Configure API key authorization: sessionToken
-  config.api_key['sessionToken'] = '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['sessionToken'] = 'Bearer'
+  # Configure Bearer authorization: sessionToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
 api_instance = OryHydraClient::PublicApi.new
+opts = {
+  x_session_token: 'x_session_token_example' # String | The Session Token of the Identity performing the settings flow.
+}
 
 begin
-  # Initialize Settings Flow for Browsers
-  api_instance.initialize_self_service_settings_via_browser_flow
+  # Initialize Settings Flow for Native Apps and API clients
+  result = api_instance.initialize_self_service_settings_for_native_apps(opts)
+  p result
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_settings_via_browser_flow: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_settings_for_native_apps: #{e}"
 end
 ```
 
-#### Using the initialize_self_service_settings_via_browser_flow_with_http_info variant
+#### Using the initialize_self_service_settings_for_native_apps_with_http_info variant
 
-This returns an Array which contains the response data (`nil` in this case), status code and headers.
+This returns an Array which contains the response data, status code and headers.
 
-> <Array(nil, Integer, Hash)> initialize_self_service_settings_via_browser_flow_with_http_info
+> <Array(<SettingsFlow>, Integer, Hash)> initialize_self_service_settings_for_native_apps_with_http_info(opts)
 
 ```ruby
 begin
-  # Initialize Settings Flow for Browsers
-  data, status_code, headers = api_instance.initialize_self_service_settings_via_browser_flow_with_http_info
+  # Initialize Settings Flow for Native Apps and API clients
+  data, status_code, headers = api_instance.initialize_self_service_settings_for_native_apps_with_http_info(opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => nil
+  p data # => <SettingsFlow>
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_settings_via_browser_flow_with_http_info: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_settings_for_native_apps_with_http_info: #{e}"
 end
 ```
 
 ### Parameters
 
-This endpoint does not need any parameter.
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **x_session_token** | **String** | The Session Token of the Identity performing the settings flow. | [optional] |
 
 ### Return type
 
-nil (empty response body)
+[**SettingsFlow**](SettingsFlow.md)
 
 ### Authorization
 
@@ -1050,13 +1058,13 @@ nil (empty response body)
 - **Accept**: application/json
 
 
-## initialize_self_service_verification_via_api_flow
+## initialize_self_service_verification_for_browsers
 
-> <VerificationFlow> initialize_self_service_verification_via_api_flow
+> initialize_self_service_verification_for_browsers
 
-Initialize Verification Flow for API Clients
+Initialize Verification Flow for Browser 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).
+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).
 
 ### Examples
 
@@ -1067,29 +1075,28 @@ require 'ory-kratos-client'
 api_instance = OryHydraClient::PublicApi.new
 
 begin
-  # Initialize Verification Flow for API Clients
-  result = api_instance.initialize_self_service_verification_via_api_flow
-  p result
+  # Initialize Verification Flow for Browser Clients
+  api_instance.initialize_self_service_verification_for_browsers
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_verification_via_api_flow: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_verification_for_browsers: #{e}"
 end
 ```
 
-#### Using the initialize_self_service_verification_via_api_flow_with_http_info variant
+#### Using the initialize_self_service_verification_for_browsers_with_http_info variant
 
-This returns an Array which contains the response data, status code and headers.
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
 
-> <Array(<VerificationFlow>, Integer, Hash)> initialize_self_service_verification_via_api_flow_with_http_info
+> <Array(nil, Integer, Hash)> initialize_self_service_verification_for_browsers_with_http_info
 
 ```ruby
 begin
-  # Initialize Verification Flow for API Clients
-  data, status_code, headers = api_instance.initialize_self_service_verification_via_api_flow_with_http_info
+  # Initialize Verification Flow for Browser Clients
+  data, status_code, headers = api_instance.initialize_self_service_verification_for_browsers_with_http_info
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <VerificationFlow>
+  p data # => nil
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_verification_via_api_flow_with_http_info: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_verification_for_browsers_with_http_info: #{e}"
 end
 ```
 
@@ -1099,7 +1106,7 @@ This endpoint does not need any parameter.
 
 ### Return type
 
-[**VerificationFlow**](VerificationFlow.md)
+nil (empty response body)
 
 ### Authorization
 
@@ -1111,13 +1118,13 @@ No authorization required
 - **Accept**: application/json
 
 
-## initialize_self_service_verification_via_browser_flow
+## initialize_self_service_verification_for_native_apps
 
-> initialize_self_service_verification_via_browser_flow
+> <VerificationFlow> initialize_self_service_verification_for_native_apps
 
-Initialize Verification Flow for Browser Clients
+Initialize Verification Flow for Native Apps and API 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).
+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).
 
 ### Examples
 
@@ -1128,28 +1135,29 @@ require 'ory-kratos-client'
 api_instance = OryHydraClient::PublicApi.new
 
 begin
-  # Initialize Verification Flow for Browser Clients
-  api_instance.initialize_self_service_verification_via_browser_flow
+  # Initialize Verification Flow for Native Apps and API clients
+  result = api_instance.initialize_self_service_verification_for_native_apps
+  p result
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_verification_via_browser_flow: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_verification_for_native_apps: #{e}"
 end
 ```
 
-#### Using the initialize_self_service_verification_via_browser_flow_with_http_info variant
+#### Using the initialize_self_service_verification_for_native_apps_with_http_info variant
 
-This returns an Array which contains the response data (`nil` in this case), status code and headers.
+This returns an Array which contains the response data, status code and headers.
 
-> <Array(nil, Integer, Hash)> initialize_self_service_verification_via_browser_flow_with_http_info
+> <Array(<VerificationFlow>, Integer, Hash)> initialize_self_service_verification_for_native_apps_with_http_info
 
 ```ruby
 begin
-  # Initialize Verification Flow for Browser Clients
-  data, status_code, headers = api_instance.initialize_self_service_verification_via_browser_flow_with_http_info
+  # Initialize Verification Flow for Native Apps and API clients
+  data, status_code, headers = api_instance.initialize_self_service_verification_for_native_apps_with_http_info
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => nil
+  p data # => <VerificationFlow>
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->initialize_self_service_verification_via_browser_flow_with_http_info: #{e}"
+  puts "Error when calling PublicApi->initialize_self_service_verification_for_native_apps_with_http_info: #{e}"
 end
 ```
 
@@ -1159,7 +1167,7 @@ This endpoint does not need any parameter.
 
 ### Return type
 
-nil (empty response body)
+[**VerificationFlow**](VerificationFlow.md)
 
 ### Authorization
 
@@ -1521,15 +1529,14 @@ require 'time'
 require 'ory-kratos-client'
 # setup authorization
 OryHydraClient.configure do |config|
-  # Configure API key authorization: sessionToken
-  config.api_key['sessionToken'] = '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['sessionToken'] = 'Bearer'
+  # Configure Bearer authorization: sessionToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
 api_instance = OryHydraClient::PublicApi.new
 flow = 'flow_example' # String | The Settings Flow ID  The value for this parameter comes from `flow` URL Query parameter sent to your application (e.g. `/settings?flow=abcde`).
 opts = {
+  x_session_token: 'x_session_token_example', # String | The Session Token of the Identity performing the settings flow.
   submit_self_service_settings_flow: OryHydraClient::SubmitSelfServiceSettingsFlowWithPasswordMethod.new({password: 'password_example'}) # SubmitSelfServiceSettingsFlow | 
 }
 
@@ -1565,6 +1572,7 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **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;). |  |
+| **x_session_token** | **String** | The Session Token of the Identity performing the settings flow. | [optional] |
 | **submit_self_service_settings_flow** | [**SubmitSelfServiceSettingsFlow**](SubmitSelfServiceSettingsFlow.md) |  | [optional] |
 
 ### Return type
@@ -1648,13 +1656,13 @@ No authorization required
 - **Accept**: application/json
 
 
-## whoami
+## to_session
 
-> <Session> whoami(opts)
+> <Session> to_session(opts)
 
 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!
 
 ### Examples
 
@@ -1663,42 +1671,41 @@ require 'time'
 require 'ory-kratos-client'
 # setup authorization
 OryHydraClient.configure do |config|
-  # Configure API key authorization: sessionToken
-  config.api_key['sessionToken'] = 'YOUR API KEY'
+  # Configure API key authorization: sessionCookie
+  config.api_key['sessionCookie'] = '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['sessionToken'] = 'Bearer'
+  # config.api_key_prefix['sessionCookie'] = 'Bearer'
 end
 
 api_instance = OryHydraClient::PublicApi.new
 opts = {
-  cookie: 'cookie_example', # String | 
-  authorization: 'authorization_example' # String | 
+  x_session_token: 'x_session_token_example' # String | 
 }
 
 begin
   # Check Who the Current HTTP Session Belongs To
-  result = api_instance.whoami(opts)
+  result = api_instance.to_session(opts)
   p result
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->whoami: #{e}"
+  puts "Error when calling PublicApi->to_session: #{e}"
 end
 ```
 
-#### Using the whoami_with_http_info variant
+#### Using the to_session_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<Session>, Integer, Hash)> whoami_with_http_info(opts)
+> <Array(<Session>, Integer, Hash)> to_session_with_http_info(opts)
 
 ```ruby
 begin
   # Check Who the Current HTTP Session Belongs To
-  data, status_code, headers = api_instance.whoami_with_http_info(opts)
+  data, status_code, headers = api_instance.to_session_with_http_info(opts)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <Session>
 rescue OryHydraClient::ApiError => e
-  puts "Error when calling PublicApi->whoami_with_http_info: #{e}"
+  puts "Error when calling PublicApi->to_session_with_http_info: #{e}"
 end
 ```
 
@@ -1706,8 +1713,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **cookie** | **String** |  | [optional] |
-| **authorization** | **String** |  | [optional] |
+| **x_session_token** | **String** |  | [optional] |
 
 ### Return type
 
@@ -1715,7 +1721,7 @@ end
 
 ### Authorization
 
-[sessionToken](../README.md#sessionToken)
+[sessionCookie](../README.md#sessionCookie)
 
 ### HTTP request headers