kinde_sdk 1.6.4 → 1.6.6

data/kinde_api/docs/APIsApi.md

@@ -1,23 +1,173 @@
 # KindeApi::APIsApi
 
-All URIs are relative to *https://app.kinde.com*
+All URIs are relative to *https://your_kinde_subdomain.kinde.com*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
-| [**add_apis**](APIsApi.md#add_apis) | **POST** /api/v1/apis | Add APIs |
+| [**add_api_application_scope**](APIsApi.md#add_api_application_scope) | **POST** /api/v1/apis/{api_id}/applications/{application_id}/scopes/{scope_id} | Add scope to API application |
+| [**add_api_scope**](APIsApi.md#add_api_scope) | **POST** /api/v1/apis/{api_id}/scopes | Create API scope |
+| [**add_apis**](APIsApi.md#add_apis) | **POST** /api/v1/apis | Create API |
 | [**delete_api**](APIsApi.md#delete_api) | **DELETE** /api/v1/apis/{api_id} | Delete API |
-| [**get_api**](APIsApi.md#get_api) | **GET** /api/v1/apis/{api_id} | List API details |
-| [**get_apis**](APIsApi.md#get_apis) | **GET** /api/v1/apis | List APIs |
-| [**update_api_applications**](APIsApi.md#update_api_applications) | **PATCH** /api/v1/apis/{api_id}/applications | Update API Applications |
+| [**delete_api_appliation_scope**](APIsApi.md#delete_api_appliation_scope) | **DELETE** /api/v1/apis/{api_id}/applications/{application_id}/scopes/{scope_id} | Delete API application scope |
+| [**delete_api_scope**](APIsApi.md#delete_api_scope) | **DELETE** /api/v1/apis/{api_id}/scopes/{scope_id} | Delete API scope |
+| [**get_api**](APIsApi.md#get_api) | **GET** /api/v1/apis/{api_id} | Get API |
+| [**get_api_scope**](APIsApi.md#get_api_scope) | **GET** /api/v1/apis/{api_id}/scopes/{scope_id} | Get API scope |
+| [**get_api_scopes**](APIsApi.md#get_api_scopes) | **GET** /api/v1/apis/{api_id}/scopes | Get API scopes |
+| [**get_apis**](APIsApi.md#get_apis) | **GET** /api/v1/apis | Get APIs |
+| [**update_api_applications**](APIsApi.md#update_api_applications) | **PATCH** /api/v1/apis/{api_id}/applications | Authorize API applications |
+| [**update_api_scope**](APIsApi.md#update_api_scope) | **PATCH** /api/v1/apis/{api_id}/scopes/{scope_id} | Update API scope |
+
+
+## add_api_application_scope
+
+> add_api_application_scope(api_id, application_id, scope_id)
+
+Add scope to API application
+
+Add a scope to an API application.  <div>   <code>create:api_application_scopes</code> </div> 
+
+### Examples
+
+```ruby
+require 'time'
+require 'kinde_api'
+# setup authorization
+KindeApi.configure do |config|
+  # Configure Bearer authorization (JWT): kindeBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = KindeApi::APIsApi.new
+api_id = '838f208d006a482dbd8cdb79a9889f68' # String | API ID
+application_id = '7643b487c97545aab79257fd13a1085a' # String | Application ID
+scope_id = 'api_scope_019391daf58d87d8a7213419c016ac95' # String | Scope ID
+
+begin
+  # Add scope to API application
+  api_instance.add_api_application_scope(api_id, application_id, scope_id)
+rescue KindeApi::ApiError => e
+  puts "Error when calling APIsApi->add_api_application_scope: #{e}"
+end
+```
+
+#### Using the add_api_application_scope_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)> add_api_application_scope_with_http_info(api_id, application_id, scope_id)
+
+```ruby
+begin
+  # Add scope to API application
+  data, status_code, headers = api_instance.add_api_application_scope_with_http_info(api_id, application_id, scope_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue KindeApi::ApiError => e
+  puts "Error when calling APIsApi->add_api_application_scope_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **api_id** | **String** | API ID |  |
+| **application_id** | **String** | Application ID |  |
+| **scope_id** | **String** | Scope ID |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[kindeBearerAuth](../README.md#kindeBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## add_api_scope
+
+> <CreateApiScopesResponse> add_api_scope(api_id, add_api_scope_request)
+
+Create API scope
+
+Create a new API scope.  <div>   <code>create:api_scopes</code> </div> 
+
+### Examples
+
+```ruby
+require 'time'
+require 'kinde_api'
+# setup authorization
+KindeApi.configure do |config|
+  # Configure Bearer authorization (JWT): kindeBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = KindeApi::APIsApi.new
+api_id = '838f208d006a482dbd8cdb79a9889f68' # String | API ID
+add_api_scope_request = KindeApi::AddAPIScopeRequest.new({key: 'read:logs'}) # AddAPIScopeRequest | 
+
+begin
+  # Create API scope
+  result = api_instance.add_api_scope(api_id, add_api_scope_request)
+  p result
+rescue KindeApi::ApiError => e
+  puts "Error when calling APIsApi->add_api_scope: #{e}"
+end
+```
+
+#### Using the add_api_scope_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<CreateApiScopesResponse>, Integer, Hash)> add_api_scope_with_http_info(api_id, add_api_scope_request)
+
+```ruby
+begin
+  # Create API scope
+  data, status_code, headers = api_instance.add_api_scope_with_http_info(api_id, add_api_scope_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <CreateApiScopesResponse>
+rescue KindeApi::ApiError => e
+  puts "Error when calling APIsApi->add_api_scope_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **api_id** | **String** | API ID |  |
+| **add_api_scope_request** | [**AddAPIScopeRequest**](AddAPIScopeRequest.md) |  |  |
+
+### Return type
+
+[**CreateApiScopesResponse**](CreateApiScopesResponse.md)
+
+### Authorization
+
+[kindeBearerAuth](../README.md#kindeBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
 
 
 ## add_apis
 
-> <SuccessResponse> add_apis(add_apis_request)
+> <CreateApisResponse> add_apis(add_apis_request)
 
-Add APIs
+Create API
 
-Add APIs. 
+Register a new API. For more information read [Register and manage APIs](https://docs.kinde.com/developer-tools/your-apis/register-manage-apis/).  <div>   <code>create:apis</code> </div> 
 
 ### Examples
 
@@ -31,10 +181,10 @@ KindeApi.configure do |config|
 end
 
 api_instance = KindeApi::APIsApi.new
-add_apis_request = KindeApi::AddAPIsRequest.new({name: 'name_example', audience: 'audience_example'}) # AddAPIsRequest | API details.
+add_apis_request = KindeApi::AddAPIsRequest.new({name: 'Example API', audience: 'https://api.example.com'}) # AddAPIsRequest | 
 
 begin
-  # Add APIs
+  # Create API
   result = api_instance.add_apis(add_apis_request)
   p result
 rescue KindeApi::ApiError => e
@@ -46,15 +196,15 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SuccessResponse>, Integer, Hash)> add_apis_with_http_info(add_apis_request)
+> <Array(<CreateApisResponse>, Integer, Hash)> add_apis_with_http_info(add_apis_request)
 
 ```ruby
 begin
-  # Add APIs
+  # Create API
   data, status_code, headers = api_instance.add_apis_with_http_info(add_apis_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SuccessResponse>
+  p data # => <CreateApisResponse>
 rescue KindeApi::ApiError => e
   puts "Error when calling APIsApi->add_apis_with_http_info: #{e}"
 end
@@ -64,11 +214,11 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **add_apis_request** | [**AddAPIsRequest**](AddAPIsRequest.md) | API details. |  |
+| **add_apis_request** | [**AddAPIsRequest**](AddAPIsRequest.md) |  |  |
 
 ### Return type
 
-[**SuccessResponse**](SuccessResponse.md)
+[**CreateApisResponse**](CreateApisResponse.md)
 
 ### Authorization
 
@@ -77,16 +227,16 @@ end
 ### HTTP request headers
 
 - **Content-Type**: application/json
-- **Accept**: application/json; charset=utf-8, application/json
+- **Accept**: application/json
 
 
 ## delete_api
 
-> <SuccessResponse> delete_api(api_id)
+> <DeleteApiResponse> delete_api(api_id)
 
 Delete API
 
-Deletes API. 
+Delete an API you previously created.  <div>   <code>delete:apis</code> </div> 
 
 ### Examples
 
@@ -100,7 +250,7 @@ KindeApi.configure do |config|
 end
 
 api_instance = KindeApi::APIsApi.new
-api_id = 'api_id_example' # String | The API's id.
+api_id = '7ccd126599aa422a771abcb341596881' # String | The API's ID.
 
 begin
   # Delete API
@@ -115,7 +265,7 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SuccessResponse>, Integer, Hash)> delete_api_with_http_info(api_id)
+> <Array(<DeleteApiResponse>, Integer, Hash)> delete_api_with_http_info(api_id)
 
 ```ruby
 begin
@@ -123,7 +273,7 @@ begin
   data, status_code, headers = api_instance.delete_api_with_http_info(api_id)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SuccessResponse>
+  p data # => <DeleteApiResponse>
 rescue KindeApi::ApiError => e
   puts "Error when calling APIsApi->delete_api_with_http_info: #{e}"
 end
@@ -133,11 +283,153 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **api_id** | **String** | The API&#39;s id. |  |
+| **api_id** | **String** | The API&#39;s ID. |  |
+
+### Return type
+
+[**DeleteApiResponse**](DeleteApiResponse.md)
+
+### Authorization
+
+[kindeBearerAuth](../README.md#kindeBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## delete_api_appliation_scope
+
+> delete_api_appliation_scope(api_id, application_id, scope_id)
+
+Delete API application scope
+
+Delete an API application scope you previously created.  <div>   <code>delete:apis_application_scopes</code> </div> 
+
+### Examples
+
+```ruby
+require 'time'
+require 'kinde_api'
+# setup authorization
+KindeApi.configure do |config|
+  # Configure Bearer authorization (JWT): kindeBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = KindeApi::APIsApi.new
+api_id = '838f208d006a482dbd8cdb79a9889f68' # String | API ID
+application_id = '7643b487c97545aab79257fd13a1085a' # String | Application ID
+scope_id = 'api_scope_019391daf58d87d8a7213419c016ac95' # String | Scope ID
+
+begin
+  # Delete API application scope
+  api_instance.delete_api_appliation_scope(api_id, application_id, scope_id)
+rescue KindeApi::ApiError => e
+  puts "Error when calling APIsApi->delete_api_appliation_scope: #{e}"
+end
+```
+
+#### Using the delete_api_appliation_scope_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)> delete_api_appliation_scope_with_http_info(api_id, application_id, scope_id)
+
+```ruby
+begin
+  # Delete API application scope
+  data, status_code, headers = api_instance.delete_api_appliation_scope_with_http_info(api_id, application_id, scope_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue KindeApi::ApiError => e
+  puts "Error when calling APIsApi->delete_api_appliation_scope_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **api_id** | **String** | API ID |  |
+| **application_id** | **String** | Application ID |  |
+| **scope_id** | **String** | Scope ID |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[kindeBearerAuth](../README.md#kindeBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## delete_api_scope
+
+> delete_api_scope(api_id, scope_id)
+
+Delete API scope
+
+Delete an API scope you previously created.  <div>   <code>delete:apis_scopes</code> </div> 
+
+### Examples
+
+```ruby
+require 'time'
+require 'kinde_api'
+# setup authorization
+KindeApi.configure do |config|
+  # Configure Bearer authorization (JWT): kindeBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = KindeApi::APIsApi.new
+api_id = '838f208d006a482dbd8cdb79a9889f68' # String | API ID
+scope_id = 'api_scope_019391daf58d87d8a7213419c016ac95' # String | Scope ID
+
+begin
+  # Delete API scope
+  api_instance.delete_api_scope(api_id, scope_id)
+rescue KindeApi::ApiError => e
+  puts "Error when calling APIsApi->delete_api_scope: #{e}"
+end
+```
+
+#### Using the delete_api_scope_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)> delete_api_scope_with_http_info(api_id, scope_id)
+
+```ruby
+begin
+  # Delete API scope
+  data, status_code, headers = api_instance.delete_api_scope_with_http_info(api_id, scope_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue KindeApi::ApiError => e
+  puts "Error when calling APIsApi->delete_api_scope_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **api_id** | **String** | API ID |  |
+| **scope_id** | **String** | Scope ID |  |
 
 ### Return type
 
-[**SuccessResponse**](SuccessResponse.md)
+nil (empty response body)
 
 ### Authorization
 
@@ -146,16 +438,16 @@ end
 ### HTTP request headers
 
 - **Content-Type**: Not defined
-- **Accept**: application/json; charset=utf-8, application/json
+- **Accept**: application/json
 
 
 ## get_api
 
-> <Api> get_api(api_id)
+> <GetApiResponse> get_api(api_id)
 
-List API details
+Get API
 
-Returns the details of the API. 
+Retrieve API details by ID.  <div>   <code>read:apis</code> </div> 
 
 ### Examples
 
@@ -169,10 +461,10 @@ KindeApi.configure do |config|
 end
 
 api_instance = KindeApi::APIsApi.new
-api_id = 'api_id_example' # String | The API's id.
+api_id = '7ccd126599aa422a771abcb341596881' # String | The API's ID.
 
 begin
-  # List API details
+  # Get API
   result = api_instance.get_api(api_id)
   p result
 rescue KindeApi::ApiError => e
@@ -184,15 +476,15 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<Api>, Integer, Hash)> get_api_with_http_info(api_id)
+> <Array(<GetApiResponse>, Integer, Hash)> get_api_with_http_info(api_id)
 
 ```ruby
 begin
-  # List API details
+  # Get API
   data, status_code, headers = api_instance.get_api_with_http_info(api_id)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <Api>
+  p data # => <GetApiResponse>
 rescue KindeApi::ApiError => e
   puts "Error when calling APIsApi->get_api_with_http_info: #{e}"
 end
@@ -202,11 +494,82 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **api_id** | **String** | The API&#39;s id. |  |
+| **api_id** | **String** | The API&#39;s ID. |  |
+
+### Return type
+
+[**GetApiResponse**](GetApiResponse.md)
+
+### Authorization
+
+[kindeBearerAuth](../README.md#kindeBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_api_scope
+
+> <GetApiScopeResponse> get_api_scope(api_id, scope_id)
+
+Get API scope
+
+Retrieve API scope by API ID.  <div>   <code>read:api_scopes</code> </div> 
+
+### Examples
+
+```ruby
+require 'time'
+require 'kinde_api'
+# setup authorization
+KindeApi.configure do |config|
+  # Configure Bearer authorization (JWT): kindeBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = KindeApi::APIsApi.new
+api_id = '838f208d006a482dbd8cdb79a9889f68' # String | API ID
+scope_id = 'api_scope_019391daf58d87d8a7213419c016ac95' # String | Scope ID
+
+begin
+  # Get API scope
+  result = api_instance.get_api_scope(api_id, scope_id)
+  p result
+rescue KindeApi::ApiError => e
+  puts "Error when calling APIsApi->get_api_scope: #{e}"
+end
+```
+
+#### Using the get_api_scope_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetApiScopeResponse>, Integer, Hash)> get_api_scope_with_http_info(api_id, scope_id)
+
+```ruby
+begin
+  # Get API scope
+  data, status_code, headers = api_instance.get_api_scope_with_http_info(api_id, scope_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetApiScopeResponse>
+rescue KindeApi::ApiError => e
+  puts "Error when calling APIsApi->get_api_scope_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **api_id** | **String** | API ID |  |
+| **scope_id** | **String** | Scope ID |  |
 
 ### Return type
 
-[**Api**](Api.md)
+[**GetApiScopeResponse**](GetApiScopeResponse.md)
 
 ### Authorization
 
@@ -215,16 +578,85 @@ end
 ### HTTP request headers
 
 - **Content-Type**: Not defined
-- **Accept**: application/json; charset=utf-8, application/json
+- **Accept**: application/json
+
+
+## get_api_scopes
+
+> <GetApiScopesResponse> get_api_scopes(api_id)
+
+Get API scopes
+
+Retrieve API scopes by API ID.  <div>   <code>read:api_scopes</code> </div> 
+
+### Examples
+
+```ruby
+require 'time'
+require 'kinde_api'
+# setup authorization
+KindeApi.configure do |config|
+  # Configure Bearer authorization (JWT): kindeBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = KindeApi::APIsApi.new
+api_id = '838f208d006a482dbd8cdb79a9889f68' # String | API ID
+
+begin
+  # Get API scopes
+  result = api_instance.get_api_scopes(api_id)
+  p result
+rescue KindeApi::ApiError => e
+  puts "Error when calling APIsApi->get_api_scopes: #{e}"
+end
+```
+
+#### Using the get_api_scopes_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetApiScopesResponse>, Integer, Hash)> get_api_scopes_with_http_info(api_id)
+
+```ruby
+begin
+  # Get API scopes
+  data, status_code, headers = api_instance.get_api_scopes_with_http_info(api_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetApiScopesResponse>
+rescue KindeApi::ApiError => e
+  puts "Error when calling APIsApi->get_api_scopes_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **api_id** | **String** | API ID |  |
+
+### Return type
+
+[**GetApiScopesResponse**](GetApiScopesResponse.md)
+
+### Authorization
+
+[kindeBearerAuth](../README.md#kindeBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
 
 
 ## get_apis
 
-> <Apis> get_apis
+> <GetApisResponse> get_apis(opts)
 
-List APIs
+Get APIs
 
-Returns a list of APIs. 
+Returns a list of your APIs. The APIs are returned sorted by name.  <div>   <code>read:apis</code> </div> 
 
 ### Examples
 
@@ -238,10 +670,13 @@ KindeApi.configure do |config|
 end
 
 api_instance = KindeApi::APIsApi.new
+opts = {
+  expand: 'scopes' # String | Specify additional data to retrieve. Use \"scopes\".
+}
 
 begin
-  # List APIs
-  result = api_instance.get_apis
+  # Get APIs
+  result = api_instance.get_apis(opts)
   p result
 rescue KindeApi::ApiError => e
   puts "Error when calling APIsApi->get_apis: #{e}"
@@ -252,15 +687,15 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<Apis>, Integer, Hash)> get_apis_with_http_info
+> <Array(<GetApisResponse>, Integer, Hash)> get_apis_with_http_info(opts)
 
 ```ruby
 begin
-  # List APIs
-  data, status_code, headers = api_instance.get_apis_with_http_info
+  # Get APIs
+  data, status_code, headers = api_instance.get_apis_with_http_info(opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <Apis>
+  p data # => <GetApisResponse>
 rescue KindeApi::ApiError => e
   puts "Error when calling APIsApi->get_apis_with_http_info: #{e}"
 end
@@ -268,11 +703,13 @@ end
 
 ### Parameters
 
-This endpoint does not need any parameter.
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **expand** | **String** | Specify additional data to retrieve. Use \&quot;scopes\&quot;. | [optional] |
 
 ### Return type
 
-[**Apis**](Apis.md)
+[**GetApisResponse**](GetApisResponse.md)
 
 ### Authorization
 
@@ -281,16 +718,16 @@ This endpoint does not need any parameter.
 ### HTTP request headers
 
 - **Content-Type**: Not defined
-- **Accept**: application/json; charset=utf-8, application/json
+- **Accept**: application/json
 
 
 ## update_api_applications
 
-> <SuccessResponse> update_api_applications(api_id, update_api_applications_request)
+> <AuthorizeAppApiResponse> update_api_applications(api_id, update_api_applications_request)
 
-Update API Applications
+Authorize API applications
 
-Update the applications under that API. 
+Authorize applications to be allowed to request access tokens for an API  <div>   <code>update:apis</code> </div> 
 
 ### Examples
 
@@ -304,11 +741,11 @@ KindeApi.configure do |config|
 end
 
 api_instance = KindeApi::APIsApi.new
-api_id = 'api_id_example' # String | The identifier for the API.
-update_api_applications_request = KindeApi::UpdateAPIApplicationsRequest.new({applications: [KindeApi::UpdateAPIApplicationsRequestApplicationsInner.new({id: 'id_example'})]}) # UpdateAPIApplicationsRequest | The applications you want to connect or disconnect.
+api_id = '7ccd126599aa422a771abcb341596881' # String | The API's ID.
+update_api_applications_request = KindeApi::UpdateAPIApplicationsRequest.new({applications: [KindeApi::UpdateAPIApplicationsRequestApplicationsInner.new({id: 'd2db282d6214242b3b145c123f0c123'})]}) # UpdateAPIApplicationsRequest | The applications you want to authorize.
 
 begin
-  # Update API Applications
+  # Authorize API applications
   result = api_instance.update_api_applications(api_id, update_api_applications_request)
   p result
 rescue KindeApi::ApiError => e
@@ -320,15 +757,15 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SuccessResponse>, Integer, Hash)> update_api_applications_with_http_info(api_id, update_api_applications_request)
+> <Array(<AuthorizeAppApiResponse>, Integer, Hash)> update_api_applications_with_http_info(api_id, update_api_applications_request)
 
 ```ruby
 begin
-  # Update API Applications
+  # Authorize API applications
   data, status_code, headers = api_instance.update_api_applications_with_http_info(api_id, update_api_applications_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SuccessResponse>
+  p data # => <AuthorizeAppApiResponse>
 rescue KindeApi::ApiError => e
   puts "Error when calling APIsApi->update_api_applications_with_http_info: #{e}"
 end
@@ -338,12 +775,84 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **api_id** | **String** | The identifier for the API. |  |
-| **update_api_applications_request** | [**UpdateAPIApplicationsRequest**](UpdateAPIApplicationsRequest.md) | The applications you want to connect or disconnect. |  |
+| **api_id** | **String** | The API&#39;s ID. |  |
+| **update_api_applications_request** | [**UpdateAPIApplicationsRequest**](UpdateAPIApplicationsRequest.md) | The applications you want to authorize. |  |
+
+### Return type
+
+[**AuthorizeAppApiResponse**](AuthorizeAppApiResponse.md)
+
+### Authorization
+
+[kindeBearerAuth](../README.md#kindeBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## update_api_scope
+
+> update_api_scope(api_id, scope_id, update_api_scope_request)
+
+Update API scope
+
+Update an API scope.  <div>   <code>update:api_scopes</code> </div> 
+
+### Examples
+
+```ruby
+require 'time'
+require 'kinde_api'
+# setup authorization
+KindeApi.configure do |config|
+  # Configure Bearer authorization (JWT): kindeBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = KindeApi::APIsApi.new
+api_id = '838f208d006a482dbd8cdb79a9889f68' # String | API ID
+scope_id = 'api_scope_019391daf58d87d8a7213419c016ac95' # String | Scope ID
+update_api_scope_request = KindeApi::UpdateAPIScopeRequest.new # UpdateAPIScopeRequest | 
+
+begin
+  # Update API scope
+  api_instance.update_api_scope(api_id, scope_id, update_api_scope_request)
+rescue KindeApi::ApiError => e
+  puts "Error when calling APIsApi->update_api_scope: #{e}"
+end
+```
+
+#### Using the update_api_scope_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)> update_api_scope_with_http_info(api_id, scope_id, update_api_scope_request)
+
+```ruby
+begin
+  # Update API scope
+  data, status_code, headers = api_instance.update_api_scope_with_http_info(api_id, scope_id, update_api_scope_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue KindeApi::ApiError => e
+  puts "Error when calling APIsApi->update_api_scope_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **api_id** | **String** | API ID |  |
+| **scope_id** | **String** | Scope ID |  |
+| **update_api_scope_request** | [**UpdateAPIScopeRequest**](UpdateAPIScopeRequest.md) |  |  |
 
 ### Return type
 
-[**SuccessResponse**](SuccessResponse.md)
+nil (empty response body)
 
 ### Authorization
 
@@ -352,5 +861,5 @@ end
 ### HTTP request headers
 
 - **Content-Type**: application/json
-- **Accept**: application/json; charset=utf-8, application/json
+- **Accept**: application/json