method-ruby 0.1.0 → 0.2.0

data/lib/method_ruby/resources/payments/reversals.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+module MethodRuby
+  module Resources
+    class Payments
+      # Reversals for payments
+      class Reversals
+        # Some parameter documentations has been truncated, see
+        # {MethodRuby::Models::Payments::ReversalRetrieveParams} for more details.
+        #
+        # Retrieves a specific reversal for a payment by its unique identifier.
+        #
+        # @overload retrieve(reversal_id, payment_id:, method_version:, request_options: {})
+        #
+        # @param reversal_id [String] Path param: Unique identifier for the reversal.
+        #
+        # @param payment_id [String] Path param: Unique identifier for the payment.
+        #
+        # @param method_version [Symbol, MethodRuby::Models::Payments::ReversalRetrieveParams::MethodVersion] Header param: API version to use for this request. This spec targets `2025-12-01
+        #
+        # @param request_options [MethodRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [MethodRuby::Models::Payments::ReversalRetrieveResponse]
+        #
+        # @see MethodRuby::Models::Payments::ReversalRetrieveParams
+        def retrieve(reversal_id, params)
+          parsed, options = MethodRuby::Payments::ReversalRetrieveParams.dump_request(params)
+          payment_id =
+            parsed.delete(:payment_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: ["payments/%1$s/reversals/%2$s", payment_id, reversal_id],
+            headers: parsed.transform_keys(method_version: "method-version"),
+            model: MethodRuby::Models::Payments::ReversalRetrieveResponse,
+            security: {secret_key: true},
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {MethodRuby::Models::Payments::ReversalUpdateParams} for more details.
+        #
+        # Updates a payment reversal. Currently supports updating the reversal status.
+        #
+        # @overload update(reversal_id, payment_id:, method_version:, status: nil, idempotency_key: nil, request_options: {})
+        #
+        # @param reversal_id [String] Path param: Unique identifier for the reversal.
+        #
+        # @param payment_id [String] Path param: Unique identifier for the payment.
+        #
+        # @param method_version [Symbol, MethodRuby::Models::Payments::ReversalUpdateParams::MethodVersion] Header param: API version to use for this request. This spec targets `2025-12-01
+        #
+        # @param status [String] Body param: Updated status for the reversal.
+        #
+        # @param idempotency_key [String] Header param: Idempotency key for safely retrying a write request. Reuse the sam
+        #
+        # @param request_options [MethodRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [MethodRuby::Models::Payments::ReversalUpdateResponse]
+        #
+        # @see MethodRuby::Models::Payments::ReversalUpdateParams
+        def update(reversal_id, params)
+          parsed, options = MethodRuby::Payments::ReversalUpdateParams.dump_request(params)
+          payment_id =
+            parsed.delete(:payment_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          header_params = {method_version: "method-version", idempotency_key: "idempotency-key"}
+          @client.request(
+            method: :put,
+            path: ["payments/%1$s/reversals/%2$s", payment_id, reversal_id],
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: MethodRuby::Models::Payments::ReversalUpdateResponse,
+            security: {secret_key: true},
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {MethodRuby::Models::Payments::ReversalListParams} for more details.
+        #
+        # Returns a list of all reversals associated with a specific payment.
+        #
+        # @overload list(payment_id, method_version:, request_options: {})
+        #
+        # @param payment_id [String] Unique identifier for the payment.
+        #
+        # @param method_version [Symbol, MethodRuby::Models::Payments::ReversalListParams::MethodVersion] API version to use for this request. This spec targets `2025-12-01`.
+        #
+        # @param request_options [MethodRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [MethodRuby::Models::Payments::ReversalListResponse]
+        #
+        # @see MethodRuby::Models::Payments::ReversalListParams
+        def list(payment_id, params)
+          parsed, options = MethodRuby::Payments::ReversalListParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: ["payments/%1$s/reversals", payment_id],
+            headers: parsed.transform_keys(method_version: "method-version"),
+            model: MethodRuby::Models::Payments::ReversalListResponse,
+            security: {secret_key: true},
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [MethodRuby::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/method_ruby/resources/payments.rb

@@ -0,0 +1,211 @@
+# frozen_string_literal: true
+
+module MethodRuby
+  module Resources
+    # ACH and clearing payments
+    class Payments
+      # Reversals for payments
+      # @return [MethodRuby::Resources::Payments::Reversals]
+      attr_reader :reversals
+
+      # Some parameter documentations has been truncated, see
+      # {MethodRuby::Models::PaymentCreateParams} for more details.
+      #
+      # Creates a new payment to transfer funds from a source account to a destination
+      # account.
+      #
+      # @overload create(amount:, description:, destination:, source:, method_version:, dry_run: nil, fee: nil, metadata: nil, reversal_account: nil, idempotency_key: nil, request_options: {})
+      #
+      # @param amount [Integer] Body param: Payment amount in cents.
+      #
+      # @param description [String] Body param: Human-readable description for the payment.
+      #
+      # @param destination [String] Body param: The destination account ID.
+      #
+      # @param source [String] Body param: The source account ID.
+      #
+      # @param method_version [Symbol, MethodRuby::Models::PaymentCreateParams::MethodVersion] Header param: API version to use for this request. This spec targets `2025-12-01
+      #
+      # @param dry_run [Boolean] Body param: Validate the payment request without moving funds.
+      #
+      # @param fee [MethodRuby::Models::PaymentCreateParams::Fee] Body param: Optional fee configuration for the payment.
+      #
+      # @param metadata [Hash{Symbol=>Object}, nil] Body param: Arbitrary key-value metadata attached to the resource.
+      #
+      # @param reversal_account [String] Body param: Account ID to use for the reversal leg of the payment, if applicable
+      #
+      # @param idempotency_key [String] Header param: Idempotency key for safely retrying a write request. Reuse the sam
+      #
+      # @param request_options [MethodRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [MethodRuby::Models::PaymentCreateResponse]
+      #
+      # @see MethodRuby::Models::PaymentCreateParams
+      def create(params)
+        parsed, options = MethodRuby::PaymentCreateParams.dump_request(params)
+        header_params = {method_version: "method-version", idempotency_key: "idempotency-key"}
+        @client.request(
+          method: :post,
+          path: "payments",
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
+          model: MethodRuby::Models::PaymentCreateResponse,
+          security: {secret_key: true},
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {MethodRuby::Models::PaymentRetrieveParams} for more details.
+      #
+      # Retrieves a payment by its unique identifier.
+      #
+      # @overload retrieve(payment_id, method_version:, expand: nil, request_options: {})
+      #
+      # @param payment_id [String] Path param: Unique identifier for the payment.
+      #
+      # @param method_version [Symbol, MethodRuby::Models::PaymentRetrieveParams::MethodVersion] Header param: API version to use for this request. This spec targets `2025-12-01
+      #
+      # @param expand [Array<Symbol, MethodRuby::Models::PaymentRetrieveParams::Expand>] Query param: Expand payment source or destination accounts inline. Nested accoun
+      #
+      # @param request_options [MethodRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [MethodRuby::Models::PaymentRetrieveResponse]
+      #
+      # @see MethodRuby::Models::PaymentRetrieveParams
+      def retrieve(payment_id, params)
+        query_params = [:expand]
+        parsed, options = MethodRuby::PaymentRetrieveParams.dump_request(params)
+        query = MethodRuby::Internal::Util.encode_query_params(parsed.slice(*query_params))
+        @client.request(
+          method: :get,
+          path: ["payments/%1$s", payment_id],
+          query: query,
+          headers: parsed.except(*query_params).transform_keys(method_version: "method-version"),
+          model: MethodRuby::Models::PaymentRetrieveResponse,
+          security: {secret_key: true},
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {MethodRuby::Models::PaymentListParams} for more details.
+      #
+      # Returns a paginated list of payments. Results can be filtered by status, type,
+      # accounts, holders, reversal, and date range.
+      #
+      # @overload list(method_version:, acc_id: nil, destination: nil, destination_holder_id: nil, expand: nil, from_date: nil, holder_id: nil, page: nil, page_cursor: nil, page_limit: nil, reversal_id: nil, source: nil, source_holder_id: nil, status: nil, to_date: nil, type: nil, request_options: {})
+      #
+      # @param method_version [Symbol, MethodRuby::Models::PaymentListParams::MethodVersion] Header param: API version to use for this request. This spec targets `2025-12-01
+      #
+      # @param acc_id [String] Query param: Filter payments by either the source or destination account ID.
+      #
+      # @param destination [String] Query param: Filter payments by destination account ID.
+      #
+      # @param destination_holder_id [String] Query param: Filter payments by destination entity ID.
+      #
+      # @param expand [Array<Symbol, MethodRuby::Models::PaymentListParams::Expand>] Query param: Expand payment source or destination accounts inline. Nested accoun
+      #
+      # @param from_date [Date] Query param: Filter results from this date (inclusive, YYYY-MM-DD format).
+      #
+      # @param holder_id [String] Query param: Filter payments by either the source or destination entity ID.
+      #
+      # @param page [Integer] Query param: Page number for pagination (1-indexed).
+      #
+      # @param page_cursor [String] Query param: Cursor for cursor-based pagination. Use the value from `Pagination-
+      #
+      # @param page_limit [Integer] Query param: Number of items per page.
+      #
+      # @param reversal_id [String] Query param: Filter payments by reversal ID.
+      #
+      # @param source [String] Query param: Filter payments by source account ID.
+      #
+      # @param source_holder_id [String] Query param: Filter payments by source entity ID.
+      #
+      # @param status [Symbol, MethodRuby::Models::PaymentListParams::Status] Query param: Filter payments by status.
+      #
+      # @param to_date [Date] Query param: Filter results to this date (inclusive, YYYY-MM-DD format).
+      #
+      # @param type [Symbol, MethodRuby::Models::PaymentListParams::Type] Query param: Filter payments by payment type.
+      #
+      # @param request_options [MethodRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [MethodRuby::Models::PaymentListResponse]
+      #
+      # @see MethodRuby::Models::PaymentListParams
+      def list(params)
+        query_params =
+          [
+            :acc_id,
+            :destination,
+            :destination_holder_id,
+            :expand,
+            :from_date,
+            :holder_id,
+            :page,
+            :page_cursor,
+            :page_limit,
+            :reversal_id,
+            :source,
+            :source_holder_id,
+            :status,
+            :to_date,
+            :type
+          ]
+        parsed, options = MethodRuby::PaymentListParams.dump_request(params)
+        query = MethodRuby::Internal::Util.encode_query_params(parsed.slice(*query_params))
+        @client.request(
+          method: :get,
+          path: "payments",
+          query: query,
+          headers: parsed.except(*query_params).transform_keys(method_version: "method-version"),
+          model: MethodRuby::Models::PaymentListResponse,
+          security: {secret_key: true},
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {MethodRuby::Models::PaymentDeleteParams} for more details.
+      #
+      # Cancels a pending payment. Only payments with a `pending` status can be
+      # canceled.
+      #
+      # @overload delete(payment_id, method_version:, idempotency_key: nil, request_options: {})
+      #
+      # @param payment_id [String] Unique identifier for the payment.
+      #
+      # @param method_version [Symbol, MethodRuby::Models::PaymentDeleteParams::MethodVersion] API version to use for this request. This spec targets `2025-12-01`.
+      #
+      # @param idempotency_key [String] Idempotency key for safely retrying a write request. Reuse the same value when
+      #
+      # @param request_options [MethodRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [MethodRuby::Models::PaymentDeleteResponse]
+      #
+      # @see MethodRuby::Models::PaymentDeleteParams
+      def delete(payment_id, params)
+        parsed, options = MethodRuby::PaymentDeleteParams.dump_request(params)
+        @client.request(
+          method: :delete,
+          path: ["payments/%1$s", payment_id],
+          headers: parsed.transform_keys(
+            method_version: "method-version",
+            idempotency_key: "idempotency-key"
+          ),
+          model: MethodRuby::Models::PaymentDeleteResponse,
+          security: {secret_key: true},
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [MethodRuby::Client]
+      def initialize(client:)
+        @client = client
+        @reversals = MethodRuby::Resources::Payments::Reversals.new(client: client)
+      end
+    end
+  end
+end

data/lib/method_ruby/resources/ping.rb

@@ -2,24 +2,31 @@
 
 module MethodRuby
   module Resources
-    # API health check endpoint.
+    # Health check endpoint
     class Ping
-      # Returns the API health status and version.
+      # Some parameter documentations has been truncated, see
+      # {MethodRuby::Models::PingCheckParams} for more details.
       #
-      # @overload check(request_options: {})
+      # Returns a simple health check response for authenticated API clients.
+      #
+      # @overload check(method_version:, request_options: {})
+      #
+      # @param method_version [Symbol, MethodRuby::Models::PingCheckParams::MethodVersion] API version to use for this request. This spec targets `2025-12-01`.
       #
       # @param request_options [MethodRuby::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [MethodRuby::Models::PingCheckResponse]
       #
       # @see MethodRuby::Models::PingCheckParams
-      def check(params = {})
+      def check(params)
+        parsed, options = MethodRuby::PingCheckParams.dump_request(params)
         @client.request(
           method: :get,
           path: "ping",
+          headers: parsed.transform_keys(method_version: "method-version"),
           model: MethodRuby::Models::PingCheckResponse,
-          security: {},
-          options: params[:request_options]
+          security: {secret_key: true},
+          options: options
         )
       end
 

data/lib/method_ruby/resources/reports/download.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module MethodRuby
+  module Resources
+    class Reports
+      # Downloadable reports
+      class Download
+        # Some parameter documentations has been truncated, see
+        # {MethodRuby::Models::Reports::DownloadRetrieveParams} for more details.
+        #
+        # Returns the completed report as a CSV file attachment.
+        #
+        # @overload retrieve(report_id, method_version:, request_options: {})
+        #
+        # @param report_id [String] Unique identifier for the report.
+        #
+        # @param method_version [Symbol, MethodRuby::Models::Reports::DownloadRetrieveParams::MethodVersion] API version to use for this request. This spec targets `2025-12-01`.
+        #
+        # @param request_options [MethodRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [StringIO]
+        #
+        # @see MethodRuby::Models::Reports::DownloadRetrieveParams
+        def retrieve(report_id, params)
+          parsed, options = MethodRuby::Reports::DownloadRetrieveParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: ["reports/%1$s/download", report_id],
+            headers: {"accept" => "text/csv", **parsed}.transform_keys(method_version: "method-version"),
+            model: MethodRuby::Internal::Type::FileInput,
+            security: {secret_key: true},
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [MethodRuby::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/method_ruby/resources/reports.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module MethodRuby
+  module Resources
+    # Downloadable reports
+    class Reports
+      # Downloadable reports
+      # @return [MethodRuby::Resources::Reports::Download]
+      attr_reader :download
+
+      # Some parameter documentations has been truncated, see
+      # {MethodRuby::Models::ReportCreateParams} for more details.
+      #
+      # Creates a new report of the specified type. The report will be generated
+      # asynchronously and can be downloaded once its status is `completed`.
+      #
+      # @overload create(type:, method_version:, idempotency_key: nil, request_options: {})
+      #
+      # @param type [Symbol, MethodRuby::Models::ReportCreateParams::Type] Body param: The type of report to generate.
+      #
+      # @param method_version [Symbol, MethodRuby::Models::ReportCreateParams::MethodVersion] Header param: API version to use for this request. This spec targets `2025-12-01
+      #
+      # @param idempotency_key [String] Header param: Idempotency key for safely retrying a write request. Reuse the sam
+      #
+      # @param request_options [MethodRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [MethodRuby::Models::ReportCreateResponse]
+      #
+      # @see MethodRuby::Models::ReportCreateParams
+      def create(params)
+        parsed, options = MethodRuby::ReportCreateParams.dump_request(params)
+        header_params = {method_version: "method-version", idempotency_key: "idempotency-key"}
+        @client.request(
+          method: :post,
+          path: "reports",
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
+          model: MethodRuby::Models::ReportCreateResponse,
+          security: {secret_key: true},
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {MethodRuby::Models::ReportRetrieveParams} for more details.
+      #
+      # Returns a single report by its identifier. Use this to check the status of a
+      # report before downloading.
+      #
+      # @overload retrieve(report_id, method_version:, request_options: {})
+      #
+      # @param report_id [String] Unique identifier for the report.
+      #
+      # @param method_version [Symbol, MethodRuby::Models::ReportRetrieveParams::MethodVersion] API version to use for this request. This spec targets `2025-12-01`.
+      #
+      # @param request_options [MethodRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [MethodRuby::Models::ReportRetrieveResponse]
+      #
+      # @see MethodRuby::Models::ReportRetrieveParams
+      def retrieve(report_id, params)
+        parsed, options = MethodRuby::ReportRetrieveParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: ["reports/%1$s", report_id],
+          headers: parsed.transform_keys(method_version: "method-version"),
+          model: MethodRuby::Models::ReportRetrieveResponse,
+          security: {secret_key: true},
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [MethodRuby::Client]
+      def initialize(client:)
+        @client = client
+        @download = MethodRuby::Resources::Reports::Download.new(client: client)
+      end
+    end
+  end
+end

data/lib/method_ruby/resources/secrets.rb

@@ -0,0 +1,145 @@
+# frozen_string_literal: true
+
+module MethodRuby
+  module Resources
+    # Secure secret storage
+    class Secrets
+      # Some parameter documentations has been truncated, see
+      # {MethodRuby::Models::SecretCreateParams} for more details.
+      #
+      # Stores a new secret value securely.
+      #
+      # @overload create(value:, method_version:, metadata: nil, idempotency_key: nil, request_options: {})
+      #
+      # @param value [String] Body param: The secret value to store securely.
+      #
+      # @param method_version [Symbol, MethodRuby::Models::SecretCreateParams::MethodVersion] Header param: API version to use for this request. This spec targets `2025-12-01
+      #
+      # @param metadata [Hash{Symbol=>Object}, nil] Body param: Arbitrary key-value metadata attached to the resource.
+      #
+      # @param idempotency_key [String] Header param: Idempotency key for safely retrying a write request. Reuse the sam
+      #
+      # @param request_options [MethodRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [MethodRuby::Models::SecretCreateResponse]
+      #
+      # @see MethodRuby::Models::SecretCreateParams
+      def create(params)
+        parsed, options = MethodRuby::SecretCreateParams.dump_request(params)
+        header_params = {method_version: "method-version", idempotency_key: "idempotency-key"}
+        @client.request(
+          method: :post,
+          path: "secrets",
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
+          model: MethodRuby::Models::SecretCreateResponse,
+          security: {secret_key: true},
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {MethodRuby::Models::SecretRetrieveParams} for more details.
+      #
+      # Returns a single secret by its identifier. The secret value is never returned.
+      #
+      # @overload retrieve(id, method_version:, request_options: {})
+      #
+      # @param id [String] Unique identifier for the secret.
+      #
+      # @param method_version [Symbol, MethodRuby::Models::SecretRetrieveParams::MethodVersion] API version to use for this request. This spec targets `2025-12-01`.
+      #
+      # @param request_options [MethodRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [MethodRuby::Models::SecretRetrieveResponse]
+      #
+      # @see MethodRuby::Models::SecretRetrieveParams
+      def retrieve(id, params)
+        parsed, options = MethodRuby::SecretRetrieveParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: ["secrets/%1$s", id],
+          headers: parsed.transform_keys(method_version: "method-version"),
+          model: MethodRuby::Models::SecretRetrieveResponse,
+          security: {secret_key: true},
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {MethodRuby::Models::SecretListParams} for more details.
+      #
+      # Returns a paginated list of secrets. Secret values are never returned.
+      #
+      # @overload list(method_version:, page: nil, page_cursor: nil, page_limit: nil, request_options: {})
+      #
+      # @param method_version [Symbol, MethodRuby::Models::SecretListParams::MethodVersion] Header param: API version to use for this request. This spec targets `2025-12-01
+      #
+      # @param page [Integer] Query param: Page number for pagination (1-indexed).
+      #
+      # @param page_cursor [String] Query param: Cursor for cursor-based pagination. Use the value from `Pagination-
+      #
+      # @param page_limit [Integer] Query param: Number of items per page.
+      #
+      # @param request_options [MethodRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [MethodRuby::Models::SecretListResponse]
+      #
+      # @see MethodRuby::Models::SecretListParams
+      def list(params)
+        query_params = [:page, :page_cursor, :page_limit]
+        parsed, options = MethodRuby::SecretListParams.dump_request(params)
+        query = MethodRuby::Internal::Util.encode_query_params(parsed.slice(*query_params))
+        @client.request(
+          method: :get,
+          path: "secrets",
+          query: query,
+          headers: parsed.except(*query_params).transform_keys(method_version: "method-version"),
+          model: MethodRuby::Models::SecretListResponse,
+          security: {secret_key: true},
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {MethodRuby::Models::SecretDeleteParams} for more details.
+      #
+      # Deletes a secret.
+      #
+      # @overload delete(id, method_version:, idempotency_key: nil, request_options: {})
+      #
+      # @param id [String] Unique identifier for the secret.
+      #
+      # @param method_version [Symbol, MethodRuby::Models::SecretDeleteParams::MethodVersion] API version to use for this request. This spec targets `2025-12-01`.
+      #
+      # @param idempotency_key [String] Idempotency key for safely retrying a write request. Reuse the same value when
+      #
+      # @param request_options [MethodRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [MethodRuby::Models::SecretDeleteResponse]
+      #
+      # @see MethodRuby::Models::SecretDeleteParams
+      def delete(id, params)
+        parsed, options = MethodRuby::SecretDeleteParams.dump_request(params)
+        @client.request(
+          method: :delete,
+          path: ["secrets/%1$s", id],
+          headers: parsed.transform_keys(
+            method_version: "method-version",
+            idempotency_key: "idempotency-key"
+          ),
+          model: MethodRuby::Models::SecretDeleteResponse,
+          security: {secret_key: true},
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [MethodRuby::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end