ionoscloud 6.0.0.beta.4 → 6.0.0

data/docs/api/UserManagementApi.md

@@ -4,39 +4,39 @@ All URIs are relative to *https://api.ionos.com/cloudapi/v6*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
-| [**um_groups_delete**](UserManagementApi.md#um_groups_delete) | **DELETE** /um/groups/{groupId} | Delete a Group |
-| [**um_groups_find_by_id**](UserManagementApi.md#um_groups_find_by_id) | **GET** /um/groups/{groupId} | Retrieve a Group |
-| [**um_groups_get**](UserManagementApi.md#um_groups_get) | **GET** /um/groups | List All Groups. |
-| [**um_groups_post**](UserManagementApi.md#um_groups_post) | **POST** /um/groups | Create a Group |
-| [**um_groups_put**](UserManagementApi.md#um_groups_put) | **PUT** /um/groups/{groupId} | Modify a group |
-| [**um_groups_resources_get**](UserManagementApi.md#um_groups_resources_get) | **GET** /um/groups/{groupId}/resources | Retrieve resources assigned to a group |
-| [**um_groups_shares_delete**](UserManagementApi.md#um_groups_shares_delete) | **DELETE** /um/groups/{groupId}/shares/{resourceId} | Remove a resource from a group |
-| [**um_groups_shares_find_by_resource_id**](UserManagementApi.md#um_groups_shares_find_by_resource_id) | **GET** /um/groups/{groupId}/shares/{resourceId} | Retrieve a group share |
-| [**um_groups_shares_get**](UserManagementApi.md#um_groups_shares_get) | **GET** /um/groups/{groupId}/shares | List Group Shares  |
-| [**um_groups_shares_post**](UserManagementApi.md#um_groups_shares_post) | **POST** /um/groups/{groupId}/shares/{resourceId} | Add a resource to a group |
-| [**um_groups_shares_put**](UserManagementApi.md#um_groups_shares_put) | **PUT** /um/groups/{groupId}/shares/{resourceId} | Modify resource permissions of a group |
-| [**um_groups_users_delete**](UserManagementApi.md#um_groups_users_delete) | **DELETE** /um/groups/{groupId}/users/{userId} | Remove a user from a group |
-| [**um_groups_users_get**](UserManagementApi.md#um_groups_users_get) | **GET** /um/groups/{groupId}/users | List Group Members  |
-| [**um_groups_users_post**](UserManagementApi.md#um_groups_users_post) | **POST** /um/groups/{groupId}/users | Add a user to a group |
-| [**um_resources_find_by_type**](UserManagementApi.md#um_resources_find_by_type) | **GET** /um/resources/{resourceType} | Retrieve a list of Resources by type. |
-| [**um_resources_find_by_type_and_id**](UserManagementApi.md#um_resources_find_by_type_and_id) | **GET** /um/resources/{resourceType}/{resourceId} | Retrieve a Resource by type. |
-| [**um_resources_get**](UserManagementApi.md#um_resources_get) | **GET** /um/resources | List All Resources. |
-| [**um_users_delete**](UserManagementApi.md#um_users_delete) | **DELETE** /um/users/{userId} | Delete a User |
-| [**um_users_find_by_id**](UserManagementApi.md#um_users_find_by_id) | **GET** /um/users/{userId} | Retrieve a User |
-| [**um_users_get**](UserManagementApi.md#um_users_get) | **GET** /um/users | List all Users  |
-| [**um_users_groups_get**](UserManagementApi.md#um_users_groups_get) | **GET** /um/users/{userId}/groups | Retrieve a User's group resources |
-| [**um_users_owns_get**](UserManagementApi.md#um_users_owns_get) | **GET** /um/users/{userId}/owns | Retrieve a User's own resources |
-| [**um_users_post**](UserManagementApi.md#um_users_post) | **POST** /um/users | Create a user |
-| [**um_users_put**](UserManagementApi.md#um_users_put) | **PUT** /um/users/{userId} | Modify a user |
+| [**um_groups_delete**](UserManagementApi.md#um_groups_delete) | **DELETE** /um/groups/{groupId} | Delete groups |
+| [**um_groups_find_by_id**](UserManagementApi.md#um_groups_find_by_id) | **GET** /um/groups/{groupId} | Retrieve groups |
+| [**um_groups_get**](UserManagementApi.md#um_groups_get) | **GET** /um/groups | List all groups |
+| [**um_groups_post**](UserManagementApi.md#um_groups_post) | **POST** /um/groups | Create groups |
+| [**um_groups_put**](UserManagementApi.md#um_groups_put) | **PUT** /um/groups/{groupId} | Modify groups |
+| [**um_groups_resources_get**](UserManagementApi.md#um_groups_resources_get) | **GET** /um/groups/{groupId}/resources | Retrieve group resources |
+| [**um_groups_shares_delete**](UserManagementApi.md#um_groups_shares_delete) | **DELETE** /um/groups/{groupId}/shares/{resourceId} | Remove group shares |
+| [**um_groups_shares_find_by_resource_id**](UserManagementApi.md#um_groups_shares_find_by_resource_id) | **GET** /um/groups/{groupId}/shares/{resourceId} | Retrieve group shares |
+| [**um_groups_shares_get**](UserManagementApi.md#um_groups_shares_get) | **GET** /um/groups/{groupId}/shares | List group shares  |
+| [**um_groups_shares_post**](UserManagementApi.md#um_groups_shares_post) | **POST** /um/groups/{groupId}/shares/{resourceId} | Add group shares |
+| [**um_groups_shares_put**](UserManagementApi.md#um_groups_shares_put) | **PUT** /um/groups/{groupId}/shares/{resourceId} | Modify group share privileges |
+| [**um_groups_users_delete**](UserManagementApi.md#um_groups_users_delete) | **DELETE** /um/groups/{groupId}/users/{userId} | Remove users from groups |
+| [**um_groups_users_get**](UserManagementApi.md#um_groups_users_get) | **GET** /um/groups/{groupId}/users | List group members |
+| [**um_groups_users_post**](UserManagementApi.md#um_groups_users_post) | **POST** /um/groups/{groupId}/users | Add group members |
+| [**um_resources_find_by_type**](UserManagementApi.md#um_resources_find_by_type) | **GET** /um/resources/{resourceType} | List resources by type |
+| [**um_resources_find_by_type_and_id**](UserManagementApi.md#um_resources_find_by_type_and_id) | **GET** /um/resources/{resourceType}/{resourceId} | Retrieve resources by type |
+| [**um_resources_get**](UserManagementApi.md#um_resources_get) | **GET** /um/resources | List all resources |
+| [**um_users_delete**](UserManagementApi.md#um_users_delete) | **DELETE** /um/users/{userId} | Delete users |
+| [**um_users_find_by_id**](UserManagementApi.md#um_users_find_by_id) | **GET** /um/users/{userId} | Retrieve users |
+| [**um_users_get**](UserManagementApi.md#um_users_get) | **GET** /um/users | List all users  |
+| [**um_users_groups_get**](UserManagementApi.md#um_users_groups_get) | **GET** /um/users/{userId}/groups | Retrieve group resources by user ID |
+| [**um_users_owns_get**](UserManagementApi.md#um_users_owns_get) | **GET** /um/users/{userId}/owns | Retrieve user resources by user ID |
+| [**um_users_post**](UserManagementApi.md#um_users_post) | **POST** /um/users | Create users |
+| [**um_users_put**](UserManagementApi.md#um_users_put) | **PUT** /um/users/{userId} | Modify users |
 
 
 ## um_groups_delete
 
 > um_groups_delete(group_id, opts)
 
-Delete a Group
+Delete groups
 
-Delete a group
+Remove the specified group.
 
 ### Examples
 
@@ -56,7 +56,7 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-group_id = 'group_id_example' # String | The unique ID of the group
+group_id = 'group_id_example' # String | The unique ID of the group.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -64,7 +64,7 @@ opts = {
 }
 
 begin
-  # Delete a Group
+  # Delete groups
   api_instance.um_groups_delete(group_id, opts)
 rescue Ionoscloud::ApiError => e
   puts "Error when calling UserManagementApi->um_groups_delete: #{e}"
@@ -79,7 +79,7 @@ This returns an Array which contains the response data (`nil` in this case), sta
 
 ```ruby
 begin
-  # Delete a Group
+  # Delete groups
   data, status_code, headers = api_instance.um_groups_delete_with_http_info(group_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -93,7 +93,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **group_id** | **String** | The unique ID of the group |  |
+| **group_id** | **String** | The unique ID of the group. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
@@ -116,9 +116,9 @@ Basic Authentication, Token Authentication
 
 > <Group> um_groups_find_by_id(group_id, opts)
 
-Retrieve a Group
+Retrieve groups
 
-You can retrieve a group by using the group ID. This value can be found in the response body when a group is created or when you GET a list of groups.
+Retrieve a group by the group ID. This value is in the response body when the group is created, and in the list of the groups, returned by GET.
 
 ### Examples
 
@@ -138,7 +138,7 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-group_id = 'group_id_example' # String | The unique ID of the group
+group_id = 'group_id_example' # String | The unique ID of the group.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -146,7 +146,7 @@ opts = {
 }
 
 begin
-  # Retrieve a Group
+  # Retrieve groups
   result = api_instance.um_groups_find_by_id(group_id, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -162,7 +162,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Retrieve a Group
+  # Retrieve groups
   data, status_code, headers = api_instance.um_groups_find_by_id_with_http_info(group_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -176,14 +176,14 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **group_id** | **String** | The unique ID of the group |  |
+| **group_id** | **String** | The unique ID of the group. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**Group**](Group.md)
+[**Group**](../models/Group.md)
 
 ### Authorization
 
@@ -199,9 +199,9 @@ Basic Authentication, Token Authentication
 
 > <Groups> um_groups_get(opts)
 
-List All Groups.
+List all groups
 
-You can retrieve a complete list of all groups that you have access to
+List all the available user groups.
 
 ### Examples
 
@@ -228,7 +228,7 @@ opts = {
 }
 
 begin
-  # List All Groups.
+  # List all groups
   result = api_instance.um_groups_get(opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -244,7 +244,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # List All Groups.
+  # List all groups
   data, status_code, headers = api_instance.um_groups_get_with_http_info(opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -264,7 +264,7 @@ end
 
 ### Return type
 
-[**Groups**](Groups.md)
+[**Groups**](../models/Groups.md)
 
 ### Authorization
 
@@ -280,9 +280,9 @@ Basic Authentication, Token Authentication
 
 > <Group> um_groups_post(group, opts)
 
-Create a Group
+Create groups
 
-You can use this POST method to create a group
+Create a group.
 
 ### Examples
 
@@ -302,7 +302,7 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-group = Ionoscloud::Group.new({properties: Ionoscloud::GroupProperties.new}) # Group | Group to be created
+group = Ionoscloud::Group.new({properties: Ionoscloud::GroupProperties.new}) # Group | The group to create.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -310,7 +310,7 @@ opts = {
 }
 
 begin
-  # Create a Group
+  # Create groups
   result = api_instance.um_groups_post(group, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -326,7 +326,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Create a Group
+  # Create groups
   data, status_code, headers = api_instance.um_groups_post_with_http_info(group, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -340,14 +340,14 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **group** | [**Group**](Group.md) | Group to be created |  |
+| **group** | [**Group**](Group.md) | The group to create. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**Group**](Group.md)
+[**Group**](../models/Group.md)
 
 ### Authorization
 
@@ -363,9 +363,9 @@ Basic Authentication, Token Authentication
 
 > <Group> um_groups_put(group_id, group, opts)
 
-Modify a group
+Modify groups
 
-You can use this method to update properties of the group.
+Modify the properties of the specified group.
 
 ### Examples
 
@@ -385,8 +385,8 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-group_id = 'group_id_example' # String | The unique ID of the group
-group = Ionoscloud::Group.new({properties: Ionoscloud::GroupProperties.new}) # Group | Modified properties of the Group
+group_id = 'group_id_example' # String | The unique ID of the group.
+group = Ionoscloud::Group.new({properties: Ionoscloud::GroupProperties.new}) # Group | The modified group.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -394,7 +394,7 @@ opts = {
 }
 
 begin
-  # Modify a group
+  # Modify groups
   result = api_instance.um_groups_put(group_id, group, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -410,7 +410,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Modify a group
+  # Modify groups
   data, status_code, headers = api_instance.um_groups_put_with_http_info(group_id, group, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -424,15 +424,15 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **group_id** | **String** | The unique ID of the group |  |
-| **group** | [**Group**](Group.md) | Modified properties of the Group |  |
+| **group_id** | **String** | The unique ID of the group. |  |
+| **group** | [**Group**](Group.md) | The modified group. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**Group**](Group.md)
+[**Group**](../models/Group.md)
 
 ### Authorization
 
@@ -448,7 +448,9 @@ Basic Authentication, Token Authentication
 
 > <ResourceGroups> um_groups_resources_get(group_id, opts)
 
-Retrieve resources assigned to a group
+Retrieve group resources
+
+List the resources assigned to the group, by group ID.
 
 ### Examples
 
@@ -468,7 +470,7 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-group_id = 'group_id_example' # String | The unique ID of the group
+group_id = 'group_id_example' # String | The unique ID of the group.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -476,7 +478,7 @@ opts = {
 }
 
 begin
-  # Retrieve resources assigned to a group
+  # Retrieve group resources
   result = api_instance.um_groups_resources_get(group_id, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -492,7 +494,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Retrieve resources assigned to a group
+  # Retrieve group resources
   data, status_code, headers = api_instance.um_groups_resources_get_with_http_info(group_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -506,14 +508,14 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **group_id** | **String** | The unique ID of the group |  |
+| **group_id** | **String** | The unique ID of the group. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**ResourceGroups**](ResourceGroups.md)
+[**ResourceGroups**](../models/ResourceGroups.md)
 
 ### Authorization
 
@@ -529,9 +531,9 @@ Basic Authentication, Token Authentication
 
 > um_groups_shares_delete(group_id, resource_id, opts)
 
-Remove a resource from a group
+Remove group shares
 
-This will remove a resource from a group
+Remove the specified share from the group.
 
 ### Examples
 
@@ -551,8 +553,8 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-group_id = 'group_id_example' # String | 
-resource_id = 'resource_id_example' # String | 
+group_id = 'group_id_example' # String | The unique ID of the group.
+resource_id = 'resource_id_example' # String | The unique ID of the resource.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -560,7 +562,7 @@ opts = {
 }
 
 begin
-  # Remove a resource from a group
+  # Remove group shares
   api_instance.um_groups_shares_delete(group_id, resource_id, opts)
 rescue Ionoscloud::ApiError => e
   puts "Error when calling UserManagementApi->um_groups_shares_delete: #{e}"
@@ -575,7 +577,7 @@ This returns an Array which contains the response data (`nil` in this case), sta
 
 ```ruby
 begin
-  # Remove a resource from a group
+  # Remove group shares
   data, status_code, headers = api_instance.um_groups_shares_delete_with_http_info(group_id, resource_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -589,8 +591,8 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **group_id** | **String** |  |  |
-| **resource_id** | **String** |  |  |
+| **group_id** | **String** | The unique ID of the group. |  |
+| **resource_id** | **String** | The unique ID of the resource. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
@@ -613,9 +615,9 @@ Basic Authentication, Token Authentication
 
 > <GroupShare> um_groups_shares_find_by_resource_id(group_id, resource_id, opts)
 
-Retrieve a group share
+Retrieve group shares
 
-This will retrieve the properties of a group share.
+Retrieve the properties of the specified group share.
 
 ### Examples
 
@@ -635,8 +637,8 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-group_id = 'group_id_example' # String | 
-resource_id = 'resource_id_example' # String | 
+group_id = 'group_id_example' # String | The unique ID of the group.
+resource_id = 'resource_id_example' # String | The unique ID of the resource.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -644,7 +646,7 @@ opts = {
 }
 
 begin
-  # Retrieve a group share
+  # Retrieve group shares
   result = api_instance.um_groups_shares_find_by_resource_id(group_id, resource_id, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -660,7 +662,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Retrieve a group share
+  # Retrieve group shares
   data, status_code, headers = api_instance.um_groups_shares_find_by_resource_id_with_http_info(group_id, resource_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -674,15 +676,15 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **group_id** | **String** |  |  |
-| **resource_id** | **String** |  |  |
+| **group_id** | **String** | The unique ID of the group. |  |
+| **resource_id** | **String** | The unique ID of the resource. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**GroupShare**](GroupShare.md)
+[**GroupShare**](../models/GroupShare.md)
 
 ### Authorization
 
@@ -698,9 +700,9 @@ Basic Authentication, Token Authentication
 
 > <GroupShares> um_groups_shares_get(group_id, opts)
 
-List Group Shares 
+List group shares 
 
-You can retrieve a list of all resources along with their permissions of the group
+List all shares and share privileges for the specified group.
 
 ### Examples
 
@@ -720,7 +722,7 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-group_id = 'group_id_example' # String | 
+group_id = 'group_id_example' # String | The unique ID of the group.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -728,7 +730,7 @@ opts = {
 }
 
 begin
-  # List Group Shares 
+  # List group shares 
   result = api_instance.um_groups_shares_get(group_id, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -744,7 +746,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # List Group Shares 
+  # List group shares 
   data, status_code, headers = api_instance.um_groups_shares_get_with_http_info(group_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -758,14 +760,14 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **group_id** | **String** |  |  |
+| **group_id** | **String** | The unique ID of the group. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**GroupShares**](GroupShares.md)
+[**GroupShares**](../models/GroupShares.md)
 
 ### Authorization
 
@@ -781,9 +783,9 @@ Basic Authentication, Token Authentication
 
 > <GroupShare> um_groups_shares_post(group_id, resource_id, resource, opts)
 
-Add a resource to a group
+Add group shares
 
-This will add a resource to the group. 
+Add the specified share to the group.
 
 ### Examples
 
@@ -803,9 +805,9 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-group_id = 'group_id_example' # String | 
-resource_id = 'resource_id_example' # String | 
-resource = Ionoscloud::GroupShare.new({properties: Ionoscloud::GroupShareProperties.new}) # GroupShare | Resource to be added
+group_id = 'group_id_example' # String | The unique ID of the group.
+resource_id = 'resource_id_example' # String | The unique ID of the resource.
+resource = Ionoscloud::GroupShare.new({properties: Ionoscloud::GroupShareProperties.new}) # GroupShare | The resource to add.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -813,7 +815,7 @@ opts = {
 }
 
 begin
-  # Add a resource to a group
+  # Add group shares
   result = api_instance.um_groups_shares_post(group_id, resource_id, resource, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -829,7 +831,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Add a resource to a group
+  # Add group shares
   data, status_code, headers = api_instance.um_groups_shares_post_with_http_info(group_id, resource_id, resource, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -843,16 +845,16 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **group_id** | **String** |  |  |
-| **resource_id** | **String** |  |  |
-| **resource** | [**GroupShare**](GroupShare.md) | Resource to be added |  |
+| **group_id** | **String** | The unique ID of the group. |  |
+| **resource_id** | **String** | The unique ID of the resource. |  |
+| **resource** | [**GroupShare**](GroupShare.md) | The resource to add. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**GroupShare**](GroupShare.md)
+[**GroupShare**](../models/GroupShare.md)
 
 ### Authorization
 
@@ -868,9 +870,9 @@ Basic Authentication, Token Authentication
 
 > <GroupShare> um_groups_shares_put(group_id, resource_id, resource, opts)
 
-Modify resource permissions of a group
+Modify group share privileges
 
-You can use update resource permissions of a group. If empty body will be provided, no updates will happen, instead you will be returned the current permissions of resource in a group. In this case response code will be 200
+Modify share permissions for the specified group. With an empty body, no updates are performed, and the current share permissions for the group are returned with response code 200.
 
 ### Examples
 
@@ -890,9 +892,9 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-group_id = 'group_id_example' # String | 
-resource_id = 'resource_id_example' # String | 
-resource = Ionoscloud::GroupShare.new({properties: Ionoscloud::GroupShareProperties.new}) # GroupShare | Modified Resource
+group_id = 'group_id_example' # String | The unique ID of the group.
+resource_id = 'resource_id_example' # String | The unique ID of the resource.
+resource = Ionoscloud::GroupShare.new({properties: Ionoscloud::GroupShareProperties.new}) # GroupShare | The modified resource
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -900,7 +902,7 @@ opts = {
 }
 
 begin
-  # Modify resource permissions of a group
+  # Modify group share privileges
   result = api_instance.um_groups_shares_put(group_id, resource_id, resource, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -916,7 +918,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Modify resource permissions of a group
+  # Modify group share privileges
   data, status_code, headers = api_instance.um_groups_shares_put_with_http_info(group_id, resource_id, resource, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -930,16 +932,16 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **group_id** | **String** |  |  |
-| **resource_id** | **String** |  |  |
-| **resource** | [**GroupShare**](GroupShare.md) | Modified Resource |  |
+| **group_id** | **String** | The unique ID of the group. |  |
+| **resource_id** | **String** | The unique ID of the resource. |  |
+| **resource** | [**GroupShare**](GroupShare.md) | The modified resource |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**GroupShare**](GroupShare.md)
+[**GroupShare**](../models/GroupShare.md)
 
 ### Authorization
 
@@ -955,9 +957,9 @@ Basic Authentication, Token Authentication
 
 > um_groups_users_delete(group_id, user_id, opts)
 
-Remove a user from a group
+Remove users from groups
 
-This will remove a user from a group.
+Remove the specified user from the group.
 
 ### Examples
 
@@ -977,8 +979,8 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-group_id = 'group_id_example' # String | 
-user_id = 'user_id_example' # String | 
+group_id = 'group_id_example' # String | The unique ID of the group.
+user_id = 'user_id_example' # String | The unique ID of the user.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -986,7 +988,7 @@ opts = {
 }
 
 begin
-  # Remove a user from a group
+  # Remove users from groups
   api_instance.um_groups_users_delete(group_id, user_id, opts)
 rescue Ionoscloud::ApiError => e
   puts "Error when calling UserManagementApi->um_groups_users_delete: #{e}"
@@ -1001,7 +1003,7 @@ This returns an Array which contains the response data (`nil` in this case), sta
 
 ```ruby
 begin
-  # Remove a user from a group
+  # Remove users from groups
   data, status_code, headers = api_instance.um_groups_users_delete_with_http_info(group_id, user_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1015,8 +1017,8 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **group_id** | **String** |  |  |
-| **user_id** | **String** |  |  |
+| **group_id** | **String** | The unique ID of the group. |  |
+| **user_id** | **String** | The unique ID of the user. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
@@ -1039,9 +1041,9 @@ Basic Authentication, Token Authentication
 
 > <GroupMembers> um_groups_users_get(group_id, opts)
 
-List Group Members 
+List group members
 
-You can retrieve a list of users who are members of the group
+List all members of the specified user group.
 
 ### Examples
 
@@ -1061,7 +1063,7 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-group_id = 'group_id_example' # String | 
+group_id = 'group_id_example' # String | The unique ID of the group.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -1069,7 +1071,7 @@ opts = {
 }
 
 begin
-  # List Group Members 
+  # List group members
   result = api_instance.um_groups_users_get(group_id, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -1085,7 +1087,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # List Group Members 
+  # List group members
   data, status_code, headers = api_instance.um_groups_users_get_with_http_info(group_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1099,14 +1101,14 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **group_id** | **String** |  |  |
+| **group_id** | **String** | The unique ID of the group. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**GroupMembers**](GroupMembers.md)
+[**GroupMembers**](../models/GroupMembers.md)
 
 ### Authorization
 
@@ -1122,9 +1124,9 @@ Basic Authentication, Token Authentication
 
 > <User> um_groups_users_post(group_id, user, opts)
 
-Add a user to a group
+Add group members
 
-This will attach a pre-existing user to a group. 
+Add an existing user to the specified group. 
 
 ### Examples
 
@@ -1144,8 +1146,8 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-group_id = 'group_id_example' # String | 
-user = Ionoscloud::User.new({properties: Ionoscloud::UserProperties.new}) # User | User to be added
+group_id = 'group_id_example' # String | The unique ID of the group.
+user = Ionoscloud::User.new({properties: Ionoscloud::UserProperties.new}) # User | The user to add.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -1153,7 +1155,7 @@ opts = {
 }
 
 begin
-  # Add a user to a group
+  # Add group members
   result = api_instance.um_groups_users_post(group_id, user, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -1169,7 +1171,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Add a user to a group
+  # Add group members
   data, status_code, headers = api_instance.um_groups_users_post_with_http_info(group_id, user, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1183,15 +1185,15 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **group_id** | **String** |  |  |
-| **user** | [**User**](User.md) | User to be added |  |
+| **group_id** | **String** | The unique ID of the group. |  |
+| **user** | [**User**](User.md) | The user to add. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**User**](User.md)
+[**User**](../models/User.md)
 
 ### Authorization
 
@@ -1207,9 +1209,9 @@ Basic Authentication, Token Authentication
 
 > <Resources> um_resources_find_by_type(resource_type, opts)
 
-Retrieve a list of Resources by type.
+List resources by type
 
-You can retrieve a list of resources by using the type. Allowed values are { datacenter, snapshot, image, ipblock, pcc, backupunit, k8s }. This value of resource type also be found in the response body when you GET a list of all resources.
+List all resources of the specified type.  Resource types are: {datacenter, snapshot, image, ipblock, pcc, backupunit, k8s}  Resource types are in the list of resources, returned by GET.
 
 ### Examples
 
@@ -1229,7 +1231,7 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-resource_type = 'resource_type_example' # String | The resource Type
+resource_type = 'resource_type_example' # String | The resource type
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -1237,7 +1239,7 @@ opts = {
 }
 
 begin
-  # Retrieve a list of Resources by type.
+  # List resources by type
   result = api_instance.um_resources_find_by_type(resource_type, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -1253,7 +1255,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Retrieve a list of Resources by type.
+  # List resources by type
   data, status_code, headers = api_instance.um_resources_find_by_type_with_http_info(resource_type, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1267,14 +1269,14 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **resource_type** | **String** | The resource Type |  |
+| **resource_type** | **String** | The resource type |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**Resources**](Resources.md)
+[**Resources**](../models/Resources.md)
 
 ### Authorization
 
@@ -1290,9 +1292,9 @@ Basic Authentication, Token Authentication
 
 > <Resource> um_resources_find_by_type_and_id(resource_type, resource_id, opts)
 
-Retrieve a Resource by type.
+Retrieve resources by type
 
-You can retrieve a resource by using the type and its uuid. Allowed values for types are { datacenter, snapshot, image, ipblock, pcc, backupunit, k8s }. The value of resource type can also be found in the response body when you GET a list of all resources.
+Retrieve a resource by the resource type and resource ID.  Resource types are: {datacenter, snapshot, image, ipblock, pcc, backupunit, k8s}  Resource types are in the list of resources, returned by GET.
 
 ### Examples
 
@@ -1312,8 +1314,8 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-resource_type = 'resource_type_example' # String | The resource Type
-resource_id = 'resource_id_example' # String | The resource Uuid
+resource_type = 'resource_type_example' # String | The resource type
+resource_id = 'resource_id_example' # String | The resource ID
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -1321,7 +1323,7 @@ opts = {
 }
 
 begin
-  # Retrieve a Resource by type.
+  # Retrieve resources by type
   result = api_instance.um_resources_find_by_type_and_id(resource_type, resource_id, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -1337,7 +1339,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Retrieve a Resource by type.
+  # Retrieve resources by type
   data, status_code, headers = api_instance.um_resources_find_by_type_and_id_with_http_info(resource_type, resource_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1351,15 +1353,15 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **resource_type** | **String** | The resource Type |  |
-| **resource_id** | **String** | The resource Uuid |  |
+| **resource_type** | **String** | The resource type |  |
+| **resource_id** | **String** | The resource ID |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**Resource**](Resource.md)
+[**Resource**](../models/Resource.md)
 
 ### Authorization
 
@@ -1375,9 +1377,9 @@ Basic Authentication, Token Authentication
 
 > <Resources> um_resources_get(opts)
 
-List All Resources.
+List all resources
 
-You can retrieve a complete list of all resources that you have access to.
+List all the available resources.
 
 ### Examples
 
@@ -1404,7 +1406,7 @@ opts = {
 }
 
 begin
-  # List All Resources.
+  # List all resources
   result = api_instance.um_resources_get(opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -1420,7 +1422,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # List All Resources.
+  # List all resources
   data, status_code, headers = api_instance.um_resources_get_with_http_info(opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1440,7 +1442,7 @@ end
 
 ### Return type
 
-[**Resources**](Resources.md)
+[**Resources**](../models/Resources.md)
 
 ### Authorization
 
@@ -1456,9 +1458,9 @@ Basic Authentication, Token Authentication
 
 > um_users_delete(user_id, opts)
 
-Delete a User
+Delete users
 
-Delete a user
+Delete the specified user.
 
 ### Examples
 
@@ -1478,7 +1480,7 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-user_id = 'user_id_example' # String | The unique ID of the user
+user_id = 'user_id_example' # String | The unique ID of the user.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -1486,7 +1488,7 @@ opts = {
 }
 
 begin
-  # Delete a User
+  # Delete users
   api_instance.um_users_delete(user_id, opts)
 rescue Ionoscloud::ApiError => e
   puts "Error when calling UserManagementApi->um_users_delete: #{e}"
@@ -1501,7 +1503,7 @@ This returns an Array which contains the response data (`nil` in this case), sta
 
 ```ruby
 begin
-  # Delete a User
+  # Delete users
   data, status_code, headers = api_instance.um_users_delete_with_http_info(user_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1515,7 +1517,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **user_id** | **String** | The unique ID of the user |  |
+| **user_id** | **String** | The unique ID of the user. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
@@ -1538,9 +1540,9 @@ Basic Authentication, Token Authentication
 
 > <User> um_users_find_by_id(user_id, opts)
 
-Retrieve a User
+Retrieve users
 
-You can retrieve user details by using the users ID. This value can be found in the response body when a user is created or when you GET a list of users.
+Retrieve user properties by user ID. The user ID is in the response body when the user is created, and in the list of the users, returned by GET.
 
 ### Examples
 
@@ -1560,7 +1562,7 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-user_id = 'user_id_example' # String | The unique ID of the user
+user_id = 'user_id_example' # String | The unique ID of the user.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -1568,7 +1570,7 @@ opts = {
 }
 
 begin
-  # Retrieve a User
+  # Retrieve users
   result = api_instance.um_users_find_by_id(user_id, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -1584,7 +1586,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Retrieve a User
+  # Retrieve users
   data, status_code, headers = api_instance.um_users_find_by_id_with_http_info(user_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1598,14 +1600,14 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **user_id** | **String** | The unique ID of the user |  |
+| **user_id** | **String** | The unique ID of the user. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**User**](User.md)
+[**User**](../models/User.md)
 
 ### Authorization
 
@@ -1621,9 +1623,9 @@ Basic Authentication, Token Authentication
 
 > <Users> um_users_get(opts)
 
-List all Users 
+List all users 
 
-You can retrieve a complete list of users under your account
+List all the users in your account.
 
 ### Examples
 
@@ -1648,11 +1650,11 @@ opts = {
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
   x_contract_number: 56, # Integer | Users with multiple contracts must provide the contract number, against which all API requests are to be executed.
   offset: 56, # Integer | The first element (from the complete list of the elements) to include in the response (use together with limit for pagination).
-  limit: 56 # Integer | the maximum number of elements to return (use together with <code>offset</code> for pagination)
+  limit: 56 # Integer | The maximum number of elements to return (use together with <code>offset</code> for pagination).
 }
 
 begin
-  # List all Users 
+  # List all users 
   result = api_instance.um_users_get(opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -1668,7 +1670,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # List all Users 
+  # List all users 
   data, status_code, headers = api_instance.um_users_get_with_http_info(opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1686,11 +1688,11 @@ end
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 | **offset** | **Integer** | The first element (from the complete list of the elements) to include in the response (use together with limit for pagination). | [optional][default to 0] |
-| **limit** | **Integer** | the maximum number of elements to return (use together with &lt;code&gt;offset&lt;/code&gt; for pagination) | [optional][default to 100] |
+| **limit** | **Integer** | The maximum number of elements to return (use together with &lt;code&gt;offset&lt;/code&gt; for pagination). | [optional][default to 100] |
 
 ### Return type
 
-[**Users**](Users.md)
+[**Users**](../models/Users.md)
 
 ### Authorization
 
@@ -1706,9 +1708,9 @@ Basic Authentication, Token Authentication
 
 > <ResourceGroups> um_users_groups_get(user_id, opts)
 
-Retrieve a User's group resources
+Retrieve group resources by user ID
 
-You can retrieve group resources of user by using the users ID. This value can be found in the response body when a user is created or when you GET a list of users.
+Retrieve group resources of the user by user ID. The user ID is in the response body when the user is created, and in the list of the users, returned by GET.
 
 ### Examples
 
@@ -1728,7 +1730,7 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-user_id = 'user_id_example' # String | The unique ID of the user
+user_id = 'user_id_example' # String | The unique ID of the user.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -1736,7 +1738,7 @@ opts = {
 }
 
 begin
-  # Retrieve a User's group resources
+  # Retrieve group resources by user ID
   result = api_instance.um_users_groups_get(user_id, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -1752,7 +1754,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Retrieve a User's group resources
+  # Retrieve group resources by user ID
   data, status_code, headers = api_instance.um_users_groups_get_with_http_info(user_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1766,14 +1768,14 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **user_id** | **String** | The unique ID of the user |  |
+| **user_id** | **String** | The unique ID of the user. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**ResourceGroups**](ResourceGroups.md)
+[**ResourceGroups**](../models/ResourceGroups.md)
 
 ### Authorization
 
@@ -1789,9 +1791,9 @@ Basic Authentication, Token Authentication
 
 > <ResourcesUsers> um_users_owns_get(user_id, opts)
 
-Retrieve a User's own resources
+Retrieve user resources by user ID
 
-You can retrieve resources owned by using the users ID. This value can be found in the response body when a user is created or when you GET a list of users.
+Retrieve own resources of the user by user ID. The user ID is in the response body when the user is created, and in the list of the users, returned by GET.
 
 ### Examples
 
@@ -1811,7 +1813,7 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-user_id = 'user_id_example' # String | The unique ID of the user
+user_id = 'user_id_example' # String | The unique ID of the user.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -1819,7 +1821,7 @@ opts = {
 }
 
 begin
-  # Retrieve a User's own resources
+  # Retrieve user resources by user ID
   result = api_instance.um_users_owns_get(user_id, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -1835,7 +1837,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Retrieve a User's own resources
+  # Retrieve user resources by user ID
   data, status_code, headers = api_instance.um_users_owns_get_with_http_info(user_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1849,14 +1851,14 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **user_id** | **String** | The unique ID of the user |  |
+| **user_id** | **String** | The unique ID of the user. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**ResourcesUsers**](ResourcesUsers.md)
+[**ResourcesUsers**](../models/ResourcesUsers.md)
 
 ### Authorization
 
@@ -1872,9 +1874,9 @@ Basic Authentication, Token Authentication
 
 > <User> um_users_post(user, opts)
 
-Create a user
+Create users
 
-You can use this POST method to create a user
+Create a user.
 
 ### Examples
 
@@ -1894,7 +1896,7 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-user = Ionoscloud::UserPost.new({properties: Ionoscloud::UserPropertiesPost.new}) # UserPost | User to be created
+user = Ionoscloud::UserPost.new({properties: Ionoscloud::UserPropertiesPost.new}) # UserPost | The user to create.
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -1902,7 +1904,7 @@ opts = {
 }
 
 begin
-  # Create a user
+  # Create users
   result = api_instance.um_users_post(user, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -1918,7 +1920,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Create a user
+  # Create users
   data, status_code, headers = api_instance.um_users_post_with_http_info(user, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -1932,14 +1934,14 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **user** | [**UserPost**](UserPost.md) | User to be created |  |
+| **user** | [**UserPost**](UserPost.md) | The user to create. |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**User**](User.md)
+[**User**](../models/User.md)
 
 ### Authorization
 
@@ -1955,9 +1957,9 @@ Basic Authentication, Token Authentication
 
 > <User> um_users_put(user_id, user, opts)
 
-Modify a user
+Modify users
 
-You can use update attributes of a User
+Modify the properties of the specified user.
 
 ### Examples
 
@@ -1977,8 +1979,8 @@ Ionoscloud.configure do |config|
 end
 
 api_instance = Ionoscloud::UserManagementApi.new
-user_id = 'user_id_example' # String | 
-user = Ionoscloud::UserPut.new({properties: Ionoscloud::UserPropertiesPut.new}) # UserPut | Modified user
+user_id = 'user_id_example' # String | The unique ID of the user.
+user = Ionoscloud::UserPut.new({properties: Ionoscloud::UserPropertiesPut.new}) # UserPut | The modified user
 opts = {
   pretty: true, # Boolean | Controls whether the response is pretty-printed (with indentations and new lines).
   depth: 56, # Integer | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth=0: Only direct properties are included; children (servers and other elements) are not included.  - depth=1: Direct properties and children references are included.  - depth=2: Direct properties and children properties are included.  - depth=3: Direct properties and children properties and children's children are included.  - depth=... and so on
@@ -1986,7 +1988,7 @@ opts = {
 }
 
 begin
-  # Modify a user
+  # Modify users
   result = api_instance.um_users_put(user_id, user, opts)
   p result
 rescue Ionoscloud::ApiError => e
@@ -2002,7 +2004,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Modify a user
+  # Modify users
   data, status_code, headers = api_instance.um_users_put_with_http_info(user_id, user, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -2016,15 +2018,15 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **user_id** | **String** |  |  |
-| **user** | [**UserPut**](UserPut.md) | Modified user |  |
+| **user_id** | **String** | The unique ID of the user. |  |
+| **user** | [**UserPut**](UserPut.md) | The modified user |  |
 | **pretty** | **Boolean** | Controls whether the response is pretty-printed (with indentations and new lines). | [optional][default to true] |
 | **depth** | **Integer** | Controls the detail depth of the response objects.  GET /datacenters/[ID]  - depth&#x3D;0: Only direct properties are included; children (servers and other elements) are not included.  - depth&#x3D;1: Direct properties and children references are included.  - depth&#x3D;2: Direct properties and children properties are included.  - depth&#x3D;3: Direct properties and children properties and children&#39;s children are included.  - depth&#x3D;... and so on | [optional][default to 0] |
 | **x_contract_number** | **Integer** | Users with multiple contracts must provide the contract number, against which all API requests are to be executed. | [optional] |
 
 ### Return type
 
-[**User**](User.md)
+[**User**](../models/User.md)
 
 ### Authorization