datadog_api_client 1.0.0 → 1.4.0

data/docs/v2/UsersAPI.md

@@ -4,6 +4,7 @@ All URIs are relative to *https://api.datadoghq.com*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
+| [**create_service_account**](UsersAPI.md#create_service_account) | **POST** /api/v2/service_accounts | Create a service account |
 | [**create_user**](UsersAPI.md#create_user) | **POST** /api/v2/users | Create a user |
 | [**disable_user**](UsersAPI.md#disable_user) | **DELETE** /api/v2/users/{user_id} | Disable a user |
 | [**get_invitation**](UsersAPI.md#get_invitation) | **GET** /api/v2/user_invitations/{user_invitation_uuid} | Get a user invitation |
@@ -15,12 +16,70 @@ All URIs are relative to *https://api.datadoghq.com*
 | [**update_user**](UsersAPI.md#update_user) | **PATCH** /api/v2/users/{user_id} | Update a user |
 
 
+## create_service_account
+
+> <UserResponse> create_service_account(body)
+
+Create a service account for your organization.
+
+### Examples
+
+```ruby
+require 'datadog_api_client'
+api_instance = DatadogAPIClient::V2::UsersAPI.new
+body = DatadogAPIClient::V2::ServiceAccountCreateRequest.new({data: DatadogAPIClient::V2::ServiceAccountCreateData.new({attributes: DatadogAPIClient::V2::ServiceAccountCreateAttributes.new({email: 'jane.doe@example.com', service_account: true}), type: DatadogAPIClient::V2::UsersType::USERS})}) # ServiceAccountCreateRequest | 
+
+begin
+  # Create a service account
+  result = api_instance.create_service_account(body)
+  p result
+rescue DatadogAPIClient::V2::APIError => e
+  puts "Error when calling UsersAPI->create_service_account: #{e}"
+end
+```
+
+#### Using the create_service_account_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<UserResponse>, Integer, Hash)> create_service_account_with_http_info(body)
+
+```ruby
+begin
+  # Create a service account
+  data, status_code, headers = api_instance.create_service_account_with_http_info(body)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <UserResponse>
+rescue DatadogAPIClient::V2::APIError => e
+  puts "Error when calling UsersAPI->create_service_account_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **body** | [**ServiceAccountCreateRequest**](ServiceAccountCreateRequest.md) |  |  |
+
+### Return type
+
+[**UserResponse**](UserResponse.md)
+
+### Authorization
+
+[apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## create_user
 
 > <UserResponse> create_user(body)
 
-Create a user
-
 Create a user for your organization.
 
 ### Examples
@@ -69,7 +128,7 @@ end
 
 ### Authorization
 
-[apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
+[AuthZ](README.md#AuthZ), [apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
 
 ### HTTP request headers
 
@@ -81,16 +140,15 @@ end
 
 > disable_user(user_id)
 
-Disable a user
-
-Disable a user. Can only be used with an application key belonging to an administrator user.
+Disable a user. Can only be used with an application key belonging
+to an administrator user.
 
 ### Examples
 
 ```ruby
 require 'datadog_api_client'
 api_instance = DatadogAPIClient::V2::UsersAPI.new
-user_id = 'user_id_example' # String | The ID of the user.
+user_id = '00000000-0000-0000-0000-000000000000' # String | The ID of the user.
 
 begin
   # Disable a user
@@ -130,7 +188,7 @@ nil (empty response body)
 
 ### Authorization
 
-[apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
+[AuthZ](README.md#AuthZ), [apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
 
 ### HTTP request headers
 
@@ -142,8 +200,6 @@ nil (empty response body)
 
 > <UserInvitationResponse> get_invitation(user_invitation_uuid)
 
-Get a user invitation
-
 Returns a single user invitation by its UUID.
 
 ### Examples
@@ -151,7 +207,7 @@ Returns a single user invitation by its UUID.
 ```ruby
 require 'datadog_api_client'
 api_instance = DatadogAPIClient::V2::UsersAPI.new
-user_invitation_uuid = 'user_invitation_uuid_example' # String | The UUID of the user invitation.
+user_invitation_uuid = '00000000-0000-0000-0000-000000000000' # String | The UUID of the user invitation.
 
 begin
   # Get a user invitation
@@ -192,7 +248,7 @@ end
 
 ### Authorization
 
-[apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
+[AuthZ](README.md#AuthZ), [apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
 
 ### HTTP request headers
 
@@ -204,8 +260,6 @@ end
 
 > <UserResponse> get_user(user_id)
 
-Get user details
-
 Get a user in the organization specified by the user’s `user_id`.
 
 ### Examples
@@ -213,7 +267,7 @@ Get a user in the organization specified by the user’s `user_id`.
 ```ruby
 require 'datadog_api_client'
 api_instance = DatadogAPIClient::V2::UsersAPI.new
-user_id = 'user_id_example' # String | The ID of the user.
+user_id = '00000000-0000-0000-0000-000000000000' # String | The ID of the user.
 
 begin
   # Get user details
@@ -254,7 +308,7 @@ end
 
 ### Authorization
 
-[apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
+[AuthZ](README.md#AuthZ), [apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
 
 ### HTTP request headers
 
@@ -266,16 +320,15 @@ end
 
 > <UserResponse> list_user_organizations(user_id)
 
-Get a user organization
-
-Get a user organization. Returns the user information and all organizations joined by this user.
+Get a user organization. Returns the user information and all organizations
+joined by this user.
 
 ### Examples
 
 ```ruby
 require 'datadog_api_client'
 api_instance = DatadogAPIClient::V2::UsersAPI.new
-user_id = 'user_id_example' # String | The ID of the user.
+user_id = '00000000-0000-0000-0000-000000000000' # String | The ID of the user.
 
 begin
   # Get a user organization
@@ -316,7 +369,7 @@ end
 
 ### Authorization
 
-[apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
+[AuthZ](README.md#AuthZ), [apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
 
 ### HTTP request headers
 
@@ -328,16 +381,15 @@ end
 
 > <PermissionsResponse> list_user_permissions(user_id)
 
-Get a user permissions
-
-Get a user permission set. Returns a list of the user’s permissions granted by the associated user's roles.
+Get a user permission set. Returns a list of the user’s permissions
+granted by the associated user's roles.
 
 ### Examples
 
 ```ruby
 require 'datadog_api_client'
 api_instance = DatadogAPIClient::V2::UsersAPI.new
-user_id = 'user_id_example' # String | The ID of the user.
+user_id = '00000000-0000-0000-0000-000000000000' # String | The ID of the user.
 
 begin
   # Get a user permissions
@@ -378,7 +430,7 @@ end
 
 ### Authorization
 
-[apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
+[AuthZ](README.md#AuthZ), [apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
 
 ### HTTP request headers
 
@@ -390,9 +442,8 @@ end
 
 > <UsersResponse> list_users(opts)
 
-List all users
-
-Get the list of all users in the organization. This list includes all users even if they are deactivated or unverified.
+Get the list of all users in the organization. This list includes
+all users even if they are deactivated or unverified.
 
 ### Examples
 
@@ -400,12 +451,12 @@ Get the list of all users in the organization. This list includes all users even
 require 'datadog_api_client'
 api_instance = DatadogAPIClient::V2::UsersAPI.new
 opts = {
-  page_size: 789, # Integer | Size for a given page.
-  page_number: 789, # Integer | Specific page number to return.
-  sort: 'sort_example', # String | User attribute to order results by. Sort order is ascending by default. Sort order is descending if the field is prefixed by a negative sign, for example `sort=-name`. Options: `name`, `modified_at`, `user_count`.
+  page_size: 10, # Integer | Size for a given page.
+  page_number: 0, # Integer | Specific page number to return.
+  sort: 'name', # String | User attribute to order results by. Sort order is ascending by default. Sort order is descending if the field is prefixed by a negative sign, for example `sort=-name`. Options: `name`, `modified_at`, `user_count`.
   sort_dir: DatadogAPIClient::V2::QuerySortOrder::ASC, # QuerySortOrder | Direction of sort. Options: `asc`, `desc`.
   filter: 'filter_example', # String | Filter all users by the given string. Defaults to no filtering.
-  filter_status: 'filter_status_example' # String | Filter on status attribute. Comma separated list, with possible values `Active`, `Pending`, and `Disabled`. Defaults to no filtering.
+  filter_status: 'Active' # String | Filter on status attribute. Comma separated list, with possible values `Active`, `Pending`, and `Disabled`. Defaults to no filtering.
 }
 
 begin
@@ -452,7 +503,7 @@ end
 
 ### Authorization
 
-[apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
+[AuthZ](README.md#AuthZ), [apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
 
 ### HTTP request headers
 
@@ -464,8 +515,6 @@ end
 
 > <UserInvitationsResponse> send_invitations(body)
 
-Send invitation emails
-
 Sends emails to one or more users inviting them to join the organization.
 
 ### Examples
@@ -514,7 +563,7 @@ end
 
 ### Authorization
 
-[apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
+[AuthZ](README.md#AuthZ), [apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
 
 ### HTTP request headers
 
@@ -526,16 +575,15 @@ end
 
 > <UserResponse> update_user(user_id, body)
 
-Update a user
-
-Edit a user. Can only be used with an application key belonging to an administrator user.
+Edit a user. Can only be used with an application key belonging
+to an administrator user.
 
 ### Examples
 
 ```ruby
 require 'datadog_api_client'
 api_instance = DatadogAPIClient::V2::UsersAPI.new
-user_id = 'user_id_example' # String | The ID of the user.
+user_id = '00000000-0000-0000-0000-000000000000' # String | The ID of the user.
 body = DatadogAPIClient::V2::UserUpdateRequest.new({data: DatadogAPIClient::V2::UserUpdateData.new({attributes: DatadogAPIClient::V2::UserUpdateAttributes.new, id: '00000000-0000-0000-0000-000000000000', type: DatadogAPIClient::V2::UsersType::USERS})}) # UserUpdateRequest | 
 
 begin
@@ -578,7 +626,7 @@ end
 
 ### Authorization
 
-[apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
+[AuthZ](README.md#AuthZ), [apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
 
 ### HTTP request headers
 

data/examples/v1/metrics/SubmitMetrics.rbbeta

@@ -0,0 +1,14 @@
+require 'datadog_api_client'
+api_instance = DatadogAPIClient::V1::MetricsAPI.new
+body = DatadogAPIClient::V1::MetricsPayload.new({series: [DatadogAPIClient::V1::Series.new({metric: 'system.load.1', points: [[Time.now.to_f, 3.56]]})]}) # MetricsPayload |
+opts = {
+  content_encoding: DatadogAPIClient::V1::MetricContentEncoding::DEFLATE
+}
+
+begin
+  # Submit metrics
+  result = api_instance.submit_metrics(body, opts)
+  p result
+rescue DatadogAPIClient::V1::APIError => e
+  puts "Error when calling MetricsAPI->submit_metrics: #{e}"
+end

data/extract-code-blocks.awk

@@ -53,6 +53,10 @@ function camel(value) {
         }
         system("mkdir -p " output "/" tag);
         out_file=output "/" tag "/" operation_id ".rbbeta";
+        if (system("[ -f " out_file " ]") == 0) {
+            printf "skipped: "
+            in_code_block = 0;
+        }
         print out_file;
     } else {
         print "Can't parse " FILENAME > "/dev/stderr"

data/lib/datadog_api_client/v1/api/authentication_api.rb

@@ -70,7 +70,7 @@ module DatadogAPIClient::V1
       return_type = opts[:debug_return_type] || 'AuthenticationValidationResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || [:apiKeyAuth]
+      auth_names = opts[:debug_auth_names] || [:AuthZ, :apiKeyAuth]
 
       new_options = opts.merge(
         :operation => :validate,

data/lib/datadog_api_client/v1/api/aws_integration_api.rb

@@ -174,7 +174,7 @@ module DatadogAPIClient::V1
 
     # Generate a new external ID
     # Generate a new AWS external ID for a given AWS account ID and role name pair.
-    # @param body [AWSAccount] Your Datadog role delegation name. For more information about your AWS account Role name, see the [Datadog AWS integration configuration info](https://github.com/DataDog/documentation/blob/master/integrations/amazon_web_services/#installation).
+    # @param body [AWSAccount] Your Datadog role delegation name. For more information about your AWS account Role name, see the [Datadog AWS integration configuration info](https://docs.datadoghq.com/integrations/amazon_web_services/#setup).
     # @param [Hash] opts the optional parameters
     # @return [AWSAccountCreateResponse]
     def create_new_aws_external_id(body, opts = {})
@@ -184,7 +184,7 @@ module DatadogAPIClient::V1
 
     # Generate a new external ID
     # Generate a new AWS external ID for a given AWS account ID and role name pair.
-    # @param body [AWSAccount] Your Datadog role delegation name. For more information about your AWS account Role name, see the [Datadog AWS integration configuration info](https://github.com/DataDog/documentation/blob/master/integrations/amazon_web_services/#installation).
+    # @param body [AWSAccount] Your Datadog role delegation name. For more information about your AWS account Role name, see the [Datadog AWS integration configuration info](https://docs.datadoghq.com/integrations/amazon_web_services/#setup).
     # @param [Hash] opts the optional parameters
     # @return [Array<(AWSAccountCreateResponse, Integer, Hash)>] AWSAccountCreateResponse data, response status code and response headers
     def create_new_aws_external_id_with_http_info(body, opts = {})
@@ -249,7 +249,7 @@ module DatadogAPIClient::V1
 
     # Delete an AWS integration
     # Delete a Datadog-AWS integration matching the specified `account_id` and `role_name parameters`.
-    # @param body [AWSAccount] AWS request object
+    # @param body [AWSAccountDeleteRequest] AWS request object
     # @param [Hash] opts the optional parameters
     # @return [Object]
     def delete_aws_account(body, opts = {})
@@ -259,7 +259,7 @@ module DatadogAPIClient::V1
 
     # Delete an AWS integration
     # Delete a Datadog-AWS integration matching the specified &#x60;account_id&#x60; and &#x60;role_name parameters&#x60;.
-    # @param body [AWSAccount] AWS request object
+    # @param body [AWSAccountDeleteRequest] AWS request object
     # @param [Hash] opts the optional parameters
     # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
     def delete_aws_account_with_http_info(body, opts = {})

data/lib/datadog_api_client/v1/api/aws_logs_integration_api.rb

@@ -78,7 +78,7 @@ module DatadogAPIClient::V1
       return_type = opts[:debug_return_type] || 'AWSLogsAsyncResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+      auth_names = opts[:debug_auth_names] || [:AuthZ, :apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
         :operation => :check_aws_logs_lambda_async,

data/lib/datadog_api_client/v1/api/dashboard_lists_api.rb

@@ -78,7 +78,7 @@ module DatadogAPIClient::V1
       return_type = opts[:debug_return_type] || 'DashboardList'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+      auth_names = opts[:debug_auth_names] || [:AuthZ, :apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
         :operation => :create_dashboard_list,
@@ -151,7 +151,7 @@ module DatadogAPIClient::V1
       return_type = opts[:debug_return_type] || 'DashboardListDeleteResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+      auth_names = opts[:debug_auth_names] || [:AuthZ, :apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
         :operation => :delete_dashboard_list,
@@ -224,7 +224,7 @@ module DatadogAPIClient::V1
       return_type = opts[:debug_return_type] || 'DashboardList'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+      auth_names = opts[:debug_auth_names] || [:AuthZ, :apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
         :operation => :get_dashboard_list,
@@ -291,7 +291,7 @@ module DatadogAPIClient::V1
       return_type = opts[:debug_return_type] || 'DashboardListListResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+      auth_names = opts[:debug_auth_names] || [:AuthZ, :apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
         :operation => :list_dashboard_lists,
@@ -372,7 +372,7 @@ module DatadogAPIClient::V1
       return_type = opts[:debug_return_type] || 'DashboardList'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+      auth_names = opts[:debug_auth_names] || [:AuthZ, :apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
         :operation => :update_dashboard_list,

data/lib/datadog_api_client/v1/api/dashboards_api.rb

@@ -78,7 +78,7 @@ module DatadogAPIClient::V1
       return_type = opts[:debug_return_type] || 'Dashboard'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+      auth_names = opts[:debug_auth_names] || [:AuthZ, :apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
         :operation => :create_dashboard,
@@ -151,7 +151,7 @@ module DatadogAPIClient::V1
       return_type = opts[:debug_return_type] || 'DashboardDeleteResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+      auth_names = opts[:debug_auth_names] || [:AuthZ, :apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
         :operation => :delete_dashboard,
@@ -170,6 +170,81 @@ module DatadogAPIClient::V1
       return data, status_code, headers
     end
 
+    # Delete dashboards
+    # Delete dashboards using the specified IDs. If there are any failures, no dashboards will be deleted (partial success is not allowed).
+    # @param body [DashboardBulkDeleteRequest] Delete dashboards request body.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def delete_dashboards(body, opts = {})
+      delete_dashboards_with_http_info(body, opts)
+      nil
+    end
+
+    # Delete dashboards
+    # Delete dashboards using the specified IDs. If there are any failures, no dashboards will be deleted (partial success is not allowed).
+    # @param body [DashboardBulkDeleteRequest] Delete dashboards request body.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_dashboards_with_http_info(body, opts = {})
+
+      if @api_client.config.unstable_operations.has_key?(:delete_dashboards)
+        unstable_enabled = @api_client.config.unstable_operations[:delete_dashboards]
+        if unstable_enabled
+          @api_client.config.logger.warn format("Using unstable operation '%s'", "delete_dashboards")
+        else
+          raise APIError.new(message: format("Unstable operation '%s' is disabled", "delete_dashboards"))
+        end
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DashboardsAPI.delete_dashboards ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling DashboardsAPI.delete_dashboards"
+      end
+      # resource path
+      local_var_path = '/api/v1/dashboard'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:AuthZ, :apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :delete_dashboards,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DashboardsAPI#delete_dashboards\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get a dashboard
     # Get a dashboard using the specified ID.
     # @param dashboard_id [String] The ID of the dashboard.
@@ -224,7 +299,7 @@ module DatadogAPIClient::V1
       return_type = opts[:debug_return_type] || 'Dashboard'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+      auth_names = opts[:debug_auth_names] || [:AuthZ, :apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
         :operation => :get_dashboard,
@@ -294,7 +369,7 @@ module DatadogAPIClient::V1
       return_type = opts[:debug_return_type] || 'DashboardSummary'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+      auth_names = opts[:debug_auth_names] || [:AuthZ, :apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
         :operation => :list_dashboards,
@@ -313,6 +388,81 @@ module DatadogAPIClient::V1
       return data, status_code, headers
     end
 
+    # Restore deleted dashboards
+    # Restore dashboards using the specified IDs. If there are any failures, no dashboards will be restored (partial success is not allowed).
+    # @param body [DashboardRestoreRequest] Restore dashboards request body.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def restore_dashboards(body, opts = {})
+      restore_dashboards_with_http_info(body, opts)
+      nil
+    end
+
+    # Restore deleted dashboards
+    # Restore dashboards using the specified IDs. If there are any failures, no dashboards will be restored (partial success is not allowed).
+    # @param body [DashboardRestoreRequest] Restore dashboards request body.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def restore_dashboards_with_http_info(body, opts = {})
+
+      if @api_client.config.unstable_operations.has_key?(:restore_dashboards)
+        unstable_enabled = @api_client.config.unstable_operations[:restore_dashboards]
+        if unstable_enabled
+          @api_client.config.logger.warn format("Using unstable operation '%s'", "restore_dashboards")
+        else
+          raise APIError.new(message: format("Unstable operation '%s' is disabled", "restore_dashboards"))
+        end
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DashboardsAPI.restore_dashboards ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling DashboardsAPI.restore_dashboards"
+      end
+      # resource path
+      local_var_path = '/api/v1/dashboard'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:AuthZ, :apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :restore_dashboards,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DashboardsAPI#restore_dashboards\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Update a dashboard
     # Update a dashboard using the specified ID.
     # @param dashboard_id [String] The ID of the dashboard.
@@ -375,7 +525,7 @@ module DatadogAPIClient::V1
       return_type = opts[:debug_return_type] || 'Dashboard'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+      auth_names = opts[:debug_auth_names] || [:AuthZ, :apiKeyAuth, :appKeyAuth]
 
       new_options = opts.merge(
         :operation => :update_dashboard,