ory-hydra-client 1.9.0 → 1.9.1

data/docs/PluginConfigInterface.md

@@ -2,18 +2,19 @@
 
 ## Properties
 
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**socket** | **String** | socket | 
-**types** | [**Array<PluginInterfaceType>**](PluginInterfaceType.md) | types | 
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **socket** | **String** | socket |  |
+| **types** | [**Array<PluginInterfaceType>**](PluginInterfaceType.md) | types |  |
 
-## Code Sample
+## Example
 
 ```ruby
-require 'OryHydraClient'
+require 'ory-hydra-client'
 
-instance = OryHydraClient::PluginConfigInterface.new(socket: null,
-                                 types: null)
+instance = OryHydraClient::PluginConfigInterface.new(
+  socket: null,
+  types: null
+)
 ```
 
-

data/docs/PluginConfigLinux.md

@@ -2,20 +2,21 @@
 
 ## Properties
 
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**allow_all_devices** | **Boolean** | allow all devices | 
-**capabilities** | **Array<String>** | capabilities | 
-**devices** | [**Array<PluginDevice>**](PluginDevice.md) | devices | 
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **allow_all_devices** | **Boolean** | allow all devices |  |
+| **capabilities** | **Array<String>** | capabilities |  |
+| **devices** | [**Array<PluginDevice>**](PluginDevice.md) | devices |  |
 
-## Code Sample
+## Example
 
 ```ruby
-require 'OryHydraClient'
+require 'ory-hydra-client'
 
-instance = OryHydraClient::PluginConfigLinux.new(allow_all_devices: null,
-                                 capabilities: null,
-                                 devices: null)
+instance = OryHydraClient::PluginConfigLinux.new(
+  allow_all_devices: null,
+  capabilities: null,
+  devices: null
+)
 ```
 
-

data/docs/PluginConfigNetwork.md

@@ -2,16 +2,17 @@
 
 ## Properties
 
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**type** | **String** | type | 
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **type** | **String** | type |  |
 
-## Code Sample
+## Example
 
 ```ruby
-require 'OryHydraClient'
+require 'ory-hydra-client'
 
-instance = OryHydraClient::PluginConfigNetwork.new(type: null)
+instance = OryHydraClient::PluginConfigNetwork.new(
+  type: null
+)
 ```
 
-

data/docs/PluginConfigRootfs.md

@@ -2,18 +2,19 @@
 
 ## Properties
 
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**diff_ids** | **Array<String>** | diff ids | [optional] 
-**type** | **String** | type | [optional] 
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **diff_ids** | **Array<String>** | diff ids | [optional] |
+| **type** | **String** | type | [optional] |
 
-## Code Sample
+## Example
 
 ```ruby
-require 'OryHydraClient'
+require 'ory-hydra-client'
 
-instance = OryHydraClient::PluginConfigRootfs.new(diff_ids: null,
-                                 type: null)
+instance = OryHydraClient::PluginConfigRootfs.new(
+  diff_ids: null,
+  type: null
+)
 ```
 
-

data/docs/PluginConfigUser.md

@@ -2,18 +2,19 @@
 
 ## Properties
 
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**gid** | **Integer** | g ID | [optional] 
-**uid** | **Integer** | UID | [optional] 
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **gid** | **Integer** | g ID | [optional] |
+| **uid** | **Integer** | UID | [optional] |
 
-## Code Sample
+## Example
 
 ```ruby
-require 'OryHydraClient'
+require 'ory-hydra-client'
 
-instance = OryHydraClient::PluginConfigUser.new(gid: null,
-                                 uid: null)
+instance = OryHydraClient::PluginConfigUser.new(
+  gid: null,
+  uid: null
+)
 ```
 
-

data/docs/PluginDevice.md

@@ -2,22 +2,23 @@
 
 ## Properties
 
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**description** | **String** | description | 
-**name** | **String** | name | 
-**path** | **String** | path | 
-**settable** | **Array<String>** | settable | 
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **description** | **String** | description |  |
+| **name** | **String** | name |  |
+| **path** | **String** | path |  |
+| **settable** | **Array<String>** | settable |  |
 
-## Code Sample
+## Example
 
 ```ruby
-require 'OryHydraClient'
+require 'ory-hydra-client'
 
-instance = OryHydraClient::PluginDevice.new(description: null,
-                                 name: null,
-                                 path: null,
-                                 settable: null)
+instance = OryHydraClient::PluginDevice.new(
+  description: null,
+  name: null,
+  path: null,
+  settable: null
+)
 ```
 
-

data/docs/PluginEnv.md

@@ -2,22 +2,23 @@
 
 ## Properties
 
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**description** | **String** | description | 
-**name** | **String** | name | 
-**settable** | **Array<String>** | settable | 
-**value** | **String** | value | 
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **description** | **String** | description |  |
+| **name** | **String** | name |  |
+| **settable** | **Array<String>** | settable |  |
+| **value** | **String** | value |  |
 
-## Code Sample
+## Example
 
 ```ruby
-require 'OryHydraClient'
+require 'ory-hydra-client'
 
-instance = OryHydraClient::PluginEnv.new(description: null,
-                                 name: null,
-                                 settable: null,
-                                 value: null)
+instance = OryHydraClient::PluginEnv.new(
+  description: null,
+  name: null,
+  settable: null,
+  value: null
+)
 ```
 
-

data/docs/PluginInterfaceType.md

@@ -2,20 +2,21 @@
 
 ## Properties
 
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**capability** | **String** | capability | 
-**prefix** | **String** | prefix | 
-**version** | **String** | version | 
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **capability** | **String** | capability |  |
+| **prefix** | **String** | prefix |  |
+| **version** | **String** | version |  |
 
-## Code Sample
+## Example
 
 ```ruby
-require 'OryHydraClient'
+require 'ory-hydra-client'
 
-instance = OryHydraClient::PluginInterfaceType.new(capability: null,
-                                 prefix: null,
-                                 version: null)
+instance = OryHydraClient::PluginInterfaceType.new(
+  capability: null,
+  prefix: null,
+  version: null
+)
 ```
 
-

data/docs/PluginMount.md

@@ -2,28 +2,29 @@
 
 ## Properties
 
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**description** | **String** | description | 
-**destination** | **String** | destination | 
-**name** | **String** | name | 
-**options** | **Array<String>** | options | 
-**settable** | **Array<String>** | settable | 
-**source** | **String** | source | 
-**type** | **String** | type | 
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **description** | **String** | description |  |
+| **destination** | **String** | destination |  |
+| **name** | **String** | name |  |
+| **options** | **Array<String>** | options |  |
+| **settable** | **Array<String>** | settable |  |
+| **source** | **String** | source |  |
+| **type** | **String** | type |  |
 
-## Code Sample
+## Example
 
 ```ruby
-require 'OryHydraClient'
+require 'ory-hydra-client'
 
-instance = OryHydraClient::PluginMount.new(description: null,
-                                 destination: null,
-                                 name: null,
-                                 options: null,
-                                 settable: null,
-                                 source: null,
-                                 type: null)
+instance = OryHydraClient::PluginMount.new(
+  description: null,
+  destination: null,
+  name: null,
+  options: null,
+  settable: null,
+  source: null,
+  type: null
+)
 ```
 
-

data/docs/PluginSettings.md

@@ -2,22 +2,23 @@
 
 ## Properties
 
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**args** | **Array<String>** | args | 
-**devices** | [**Array<PluginDevice>**](PluginDevice.md) | devices | 
-**env** | **Array<String>** | env | 
-**mounts** | [**Array<PluginMount>**](PluginMount.md) | mounts | 
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **args** | **Array<String>** | args |  |
+| **devices** | [**Array<PluginDevice>**](PluginDevice.md) | devices |  |
+| **env** | **Array<String>** | env |  |
+| **mounts** | [**Array<PluginMount>**](PluginMount.md) | mounts |  |
 
-## Code Sample
+## Example
 
 ```ruby
-require 'OryHydraClient'
+require 'ory-hydra-client'
 
-instance = OryHydraClient::PluginSettings.new(args: null,
-                                 devices: null,
-                                 env: null,
-                                 mounts: null)
+instance = OryHydraClient::PluginSettings.new(
+  args: null,
+  devices: null,
+  env: null,
+  mounts: null
+)
 ```
 
-

data/docs/PreviousConsentSession.md

@@ -2,28 +2,29 @@
 
 ## Properties
 
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**consent_request** | [**ConsentRequest**](ConsentRequest.md) |  | [optional] 
-**grant_access_token_audience** | **Array<String>** |  | [optional] 
-**grant_scope** | **Array<String>** |  | [optional] 
-**handled_at** | **DateTime** |  | [optional] 
-**remember** | **Boolean** | Remember, if set to true, tells ORY Hydra to remember this consent authorization and reuse it if the same client asks the same user for the same, or a subset of, scope. | [optional] 
-**remember_for** | **Integer** | RememberFor sets how long the consent authorization should be remembered for in seconds. If set to `0`, the authorization will be remembered indefinitely. | [optional] 
-**session** | [**ConsentRequestSession**](ConsentRequestSession.md) |  | [optional] 
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **consent_request** | [**ConsentRequest**](ConsentRequest.md) |  | [optional] |
+| **grant_access_token_audience** | **Array<String>** |  | [optional] |
+| **grant_scope** | **Array<String>** |  | [optional] |
+| **handled_at** | **Time** |  | [optional] |
+| **remember** | **Boolean** | Remember, if set to true, tells ORY Hydra to remember this consent authorization and reuse it if the same client asks the same user for the same, or a subset of, scope. | [optional] |
+| **remember_for** | **Integer** | RememberFor sets how long the consent authorization should be remembered for in seconds. If set to `0`, the authorization will be remembered indefinitely. | [optional] |
+| **session** | [**ConsentRequestSession**](ConsentRequestSession.md) |  | [optional] |
 
-## Code Sample
+## Example
 
 ```ruby
-require 'OryHydraClient'
+require 'ory-hydra-client'
 
-instance = OryHydraClient::PreviousConsentSession.new(consent_request: null,
-                                 grant_access_token_audience: null,
-                                 grant_scope: null,
-                                 handled_at: null,
-                                 remember: null,
-                                 remember_for: null,
-                                 session: null)
+instance = OryHydraClient::PreviousConsentSession.new(
+  consent_request: null,
+  grant_access_token_audience: null,
+  grant_scope: null,
+  handled_at: null,
+  remember: null,
+  remember_for: null,
+  session: null
+)
 ```
 
-

data/docs/PublicApi.md

@@ -2,17 +2,16 @@
 
 All URIs are relative to *http://localhost*
 
-Method | HTTP request | Description
-------------- | ------------- | -------------
-[**disconnect_user**](PublicApi.md#disconnect_user) | **GET** /oauth2/sessions/logout | OpenID Connect Front-Backchannel Enabled Logout
-[**discover_open_id_configuration**](PublicApi.md#discover_open_id_configuration) | **GET** /.well-known/openid-configuration | OpenID Connect Discovery
-[**is_instance_ready**](PublicApi.md#is_instance_ready) | **GET** /health/ready | Check Readiness Status
-[**oauth2_token**](PublicApi.md#oauth2_token) | **POST** /oauth2/token | The OAuth 2.0 Token Endpoint
-[**oauth_auth**](PublicApi.md#oauth_auth) | **GET** /oauth2/auth | The OAuth 2.0 Authorize Endpoint
-[**revoke_o_auth2_token**](PublicApi.md#revoke_o_auth2_token) | **POST** /oauth2/revoke | Revoke OAuth2 Tokens
-[**userinfo**](PublicApi.md#userinfo) | **GET** /userinfo | OpenID Connect Userinfo
-[**well_known**](PublicApi.md#well_known) | **GET** /.well-known/jwks.json | JSON Web Keys Discovery
-
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**disconnect_user**](PublicApi.md#disconnect_user) | **GET** /oauth2/sessions/logout | OpenID Connect Front-Backchannel Enabled Logout |
+| [**discover_open_id_configuration**](PublicApi.md#discover_open_id_configuration) | **GET** /.well-known/openid-configuration | OpenID Connect Discovery |
+| [**is_instance_ready**](PublicApi.md#is_instance_ready) | **GET** /health/ready | Check Readiness Status |
+| [**oauth2_token**](PublicApi.md#oauth2_token) | **POST** /oauth2/token | The OAuth 2.0 Token Endpoint |
+| [**oauth_auth**](PublicApi.md#oauth_auth) | **GET** /oauth2/auth | The OAuth 2.0 Authorize Endpoint |
+| [**revoke_o_auth2_token**](PublicApi.md#revoke_o_auth2_token) | **POST** /oauth2/revoke | Revoke OAuth2 Tokens |
+| [**userinfo**](PublicApi.md#userinfo) | **GET** /userinfo | OpenID Connect Userinfo |
+| [**well_known**](PublicApi.md#well_known) | **GET** /.well-known/jwks.json | JSON Web Keys Discovery |
 
 
 ## disconnect_user
@@ -23,19 +22,37 @@ OpenID Connect Front-Backchannel Enabled Logout
 
 This endpoint initiates and completes user logout at ORY Hydra and initiates OpenID Connect Front-/Back-channel logout:  https://openid.net/specs/openid-connect-frontchannel-1_0.html https://openid.net/specs/openid-connect-backchannel-1_0.html
 
-### Example
+### Examples
 
 ```ruby
-# load the gem
+require 'time'
 require 'ory-hydra-client'
 
 api_instance = OryHydraClient::PublicApi.new
 
 begin
-  #OpenID Connect Front-Backchannel Enabled Logout
+  # OpenID Connect Front-Backchannel Enabled Logout
   api_instance.disconnect_user
 rescue OryHydraClient::ApiError => e
-  puts "Exception when calling PublicApi->disconnect_user: #{e}"
+  puts "Error when calling PublicApi->disconnect_user: #{e}"
+end
+```
+
+#### Using the disconnect_user_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)> disconnect_user_with_http_info
+
+```ruby
+begin
+  # OpenID Connect Front-Backchannel Enabled Logout
+  data, status_code, headers = api_instance.disconnect_user_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue OryHydraClient::ApiError => e
+  puts "Error when calling PublicApi->disconnect_user_with_http_info: #{e}"
 end
 ```
 
@@ -59,26 +76,44 @@ No authorization required
 
 ## discover_open_id_configuration
 
-> WellKnown discover_open_id_configuration
+> <WellKnown> discover_open_id_configuration
 
 OpenID Connect Discovery
 
 The well known endpoint an be used to retrieve information for OpenID Connect clients. We encourage you to not roll your own OpenID Connect client but to use an OpenID Connect client library instead. You can learn more on this flow at https://openid.net/specs/openid-connect-discovery-1_0.html .  Popular libraries for OpenID Connect clients include oidc-client-js (JavaScript), go-oidc (Golang), and others. For a full list of clients go here: https://openid.net/developers/certified/
 
-### Example
+### Examples
 
 ```ruby
-# load the gem
+require 'time'
 require 'ory-hydra-client'
 
 api_instance = OryHydraClient::PublicApi.new
 
 begin
-  #OpenID Connect Discovery
+  # OpenID Connect Discovery
   result = api_instance.discover_open_id_configuration
   p result
 rescue OryHydraClient::ApiError => e
-  puts "Exception when calling PublicApi->discover_open_id_configuration: #{e}"
+  puts "Error when calling PublicApi->discover_open_id_configuration: #{e}"
+end
+```
+
+#### Using the discover_open_id_configuration_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<WellKnown>, Integer, Hash)> discover_open_id_configuration_with_http_info
+
+```ruby
+begin
+  # OpenID Connect Discovery
+  data, status_code, headers = api_instance.discover_open_id_configuration_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <WellKnown>
+rescue OryHydraClient::ApiError => e
+  puts "Error when calling PublicApi->discover_open_id_configuration_with_http_info: #{e}"
 end
 ```
 
@@ -102,26 +137,44 @@ No authorization required
 
 ## is_instance_ready
 
-> HealthStatus is_instance_ready
+> <HealthStatus> is_instance_ready
 
 Check Readiness Status
 
 This endpoint returns a 200 status code when the HTTP server 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 this service, the health status will never refer to the cluster state, only to a single instance.
 
-### Example
+### Examples
 
 ```ruby
-# load the gem
+require 'time'
 require 'ory-hydra-client'
 
 api_instance = OryHydraClient::PublicApi.new
 
 begin
-  #Check Readiness Status
+  # Check Readiness Status
   result = api_instance.is_instance_ready
   p result
 rescue OryHydraClient::ApiError => e
-  puts "Exception when calling PublicApi->is_instance_ready: #{e}"
+  puts "Error when calling PublicApi->is_instance_ready: #{e}"
+end
+```
+
+#### Using the is_instance_ready_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<HealthStatus>, Integer, Hash)> is_instance_ready_with_http_info
+
+```ruby
+begin
+  # Check Readiness Status
+  data, status_code, headers = api_instance.is_instance_ready_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <HealthStatus>
+rescue OryHydraClient::ApiError => e
+  puts "Error when calling PublicApi->is_instance_ready_with_http_info: #{e}"
 end
 ```
 
@@ -145,16 +198,16 @@ No authorization required
 
 ## oauth2_token
 
-> Oauth2TokenResponse oauth2_token(grant_type, opts)
+> <Oauth2TokenResponse> oauth2_token(grant_type, opts)
 
 The OAuth 2.0 Token Endpoint
 
 The client makes a request to the token endpoint by sending the following parameters using the \"application/x-www-form-urlencoded\" HTTP request entity-body.  > Do not implement a client for this endpoint yourself. Use a library. There are many libraries > available for any programming language. You can find a list of libraries here: https://oauth.net/code/ > > Do note that Hydra SDK does not implement this endpoint properly. Use one of the libraries listed above!
 
-### Example
+### Examples
 
 ```ruby
-# load the gem
+require 'time'
 require 'ory-hydra-client'
 # setup authorization
 OryHydraClient.configure do |config|
@@ -176,24 +229,41 @@ opts = {
 }
 
 begin
-  #The OAuth 2.0 Token Endpoint
+  # The OAuth 2.0 Token Endpoint
   result = api_instance.oauth2_token(grant_type, opts)
   p result
 rescue OryHydraClient::ApiError => e
-  puts "Exception when calling PublicApi->oauth2_token: #{e}"
+  puts "Error when calling PublicApi->oauth2_token: #{e}"
 end
 ```
 
-### Parameters
+#### Using the oauth2_token_with_http_info variant
 
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<Oauth2TokenResponse>, Integer, Hash)> oauth2_token_with_http_info(grant_type, opts)
+
+```ruby
+begin
+  # The OAuth 2.0 Token Endpoint
+  data, status_code, headers = api_instance.oauth2_token_with_http_info(grant_type, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <Oauth2TokenResponse>
+rescue OryHydraClient::ApiError => e
+  puts "Error when calling PublicApi->oauth2_token_with_http_info: #{e}"
+end
+```
+
+### Parameters
 
-Name | Type | Description  | Notes
-------------- | ------------- | ------------- | -------------
- **grant_type** | **String**|  | 
- **code** | **String**|  | [optional] 
- **refresh_token** | **String**|  | [optional] 
- **redirect_uri** | **String**|  | [optional] 
- **client_id** | **String**|  | [optional] 
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **grant_type** | **String** |  |  |
+| **code** | **String** |  | [optional] |
+| **refresh_token** | **String** |  | [optional] |
+| **redirect_uri** | **String** |  | [optional] |
+| **client_id** | **String** |  | [optional] |
 
 ### Return type
 
@@ -217,19 +287,37 @@ The OAuth 2.0 Authorize Endpoint
 
 This endpoint is not documented here because you should never use your own implementation to perform OAuth2 flows. OAuth2 is a very popular protocol and a library for your programming language will exists.  To learn more about this flow please refer to the specification: https://tools.ietf.org/html/rfc6749
 
-### Example
+### Examples
 
 ```ruby
-# load the gem
+require 'time'
 require 'ory-hydra-client'
 
 api_instance = OryHydraClient::PublicApi.new
 
 begin
-  #The OAuth 2.0 Authorize Endpoint
+  # The OAuth 2.0 Authorize Endpoint
   api_instance.oauth_auth
 rescue OryHydraClient::ApiError => e
-  puts "Exception when calling PublicApi->oauth_auth: #{e}"
+  puts "Error when calling PublicApi->oauth_auth: #{e}"
+end
+```
+
+#### Using the oauth_auth_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)> oauth_auth_with_http_info
+
+```ruby
+begin
+  # The OAuth 2.0 Authorize Endpoint
+  data, status_code, headers = api_instance.oauth_auth_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue OryHydraClient::ApiError => e
+  puts "Error when calling PublicApi->oauth_auth_with_http_info: #{e}"
 end
 ```
 
@@ -259,10 +347,10 @@ Revoke OAuth2 Tokens
 
 Revoking a token (both access and refresh) means that the tokens will be invalid. A revoked access token can no longer be used to make access requests, and a revoked refresh token can no longer be used to refresh an access token. Revoking a refresh token also invalidates the access token that was created with it. A token may only be revoked by the client the token was generated for.
 
-### Example
+### Examples
 
 ```ruby
-# load the gem
+require 'time'
 require 'ory-hydra-client'
 # setup authorization
 OryHydraClient.configure do |config|
@@ -278,19 +366,36 @@ api_instance = OryHydraClient::PublicApi.new
 token = 'token_example' # String | 
 
 begin
-  #Revoke OAuth2 Tokens
+  # Revoke OAuth2 Tokens
   api_instance.revoke_o_auth2_token(token)
 rescue OryHydraClient::ApiError => e
-  puts "Exception when calling PublicApi->revoke_o_auth2_token: #{e}"
+  puts "Error when calling PublicApi->revoke_o_auth2_token: #{e}"
 end
 ```
 
-### Parameters
+#### Using the revoke_o_auth2_token_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)> revoke_o_auth2_token_with_http_info(token)
+
+```ruby
+begin
+  # Revoke OAuth2 Tokens
+  data, status_code, headers = api_instance.revoke_o_auth2_token_with_http_info(token)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue OryHydraClient::ApiError => e
+  puts "Error when calling PublicApi->revoke_o_auth2_token_with_http_info: #{e}"
+end
+```
+
+### Parameters
 
-Name | Type | Description  | Notes
-------------- | ------------- | ------------- | -------------
- **token** | **String**|  | 
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **token** | **String** |  |  |
 
 ### Return type
 
@@ -308,16 +413,16 @@ nil (empty response body)
 
 ## userinfo
 
-> UserinfoResponse userinfo
+> <UserinfoResponse> userinfo
 
 OpenID Connect Userinfo
 
 This endpoint returns the payload of the ID Token, including the idTokenExtra values, of the provided OAuth 2.0 Access Token.  For more information please [refer to the spec](http://openid.net/specs/openid-connect-core-1_0.html#UserInfo).
 
-### Example
+### Examples
 
 ```ruby
-# load the gem
+require 'time'
 require 'ory-hydra-client'
 # setup authorization
 OryHydraClient.configure do |config|
@@ -328,11 +433,29 @@ end
 api_instance = OryHydraClient::PublicApi.new
 
 begin
-  #OpenID Connect Userinfo
+  # OpenID Connect Userinfo
   result = api_instance.userinfo
   p result
 rescue OryHydraClient::ApiError => e
-  puts "Exception when calling PublicApi->userinfo: #{e}"
+  puts "Error when calling PublicApi->userinfo: #{e}"
+end
+```
+
+#### Using the userinfo_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<UserinfoResponse>, Integer, Hash)> userinfo_with_http_info
+
+```ruby
+begin
+  # OpenID Connect Userinfo
+  data, status_code, headers = api_instance.userinfo_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <UserinfoResponse>
+rescue OryHydraClient::ApiError => e
+  puts "Error when calling PublicApi->userinfo_with_http_info: #{e}"
 end
 ```
 
@@ -356,26 +479,44 @@ This endpoint does not need any parameter.
 
 ## well_known
 
-> JSONWebKeySet well_known
+> <JSONWebKeySet> well_known
 
 JSON Web Keys Discovery
 
 This endpoint returns JSON Web Keys to be used as public keys for verifying OpenID Connect ID Tokens and, if enabled, OAuth 2.0 JWT Access Tokens. This endpoint can be used with client libraries like [node-jwks-rsa](https://github.com/auth0/node-jwks-rsa) among others.
 
-### Example
+### Examples
 
 ```ruby
-# load the gem
+require 'time'
 require 'ory-hydra-client'
 
 api_instance = OryHydraClient::PublicApi.new
 
 begin
-  #JSON Web Keys Discovery
+  # JSON Web Keys Discovery
   result = api_instance.well_known
   p result
 rescue OryHydraClient::ApiError => e
-  puts "Exception when calling PublicApi->well_known: #{e}"
+  puts "Error when calling PublicApi->well_known: #{e}"
+end
+```
+
+#### Using the well_known_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<JSONWebKeySet>, Integer, Hash)> well_known_with_http_info
+
+```ruby
+begin
+  # JSON Web Keys Discovery
+  data, status_code, headers = api_instance.well_known_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <JSONWebKeySet>
+rescue OryHydraClient::ApiError => e
+  puts "Error when calling PublicApi->well_known_with_http_info: #{e}"
 end
 ```