recurly 3.0.0.beta.2 → 3.0.0.beta.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2eff2defc3b440056f3a6fde80b0d8a7f2ec6e514e317666fe28f9f0d7f7a10b
-  data.tar.gz: 540a0e4f98a3a366974e650471e93e4fc70e2e54f2c9004905a6633cc066c4fc
+  metadata.gz: c06a13da0a4a02efc0494087590ad6e050b7c21ee0e3539dc85184e7136f2444
+  data.tar.gz: aad797e4c85cfa7e8388755d86fc443b27b187169d65f4db225d73c26a9da6c0
 SHA512:
-  metadata.gz: 503ebf6c95d9195f90fc221d1ff125d99626c5608648a913f8480c02c57a9229141cedd86004394db94fa1fe69f2549b740934d91eca85d5da86d666cec51d1d
-  data.tar.gz: d77e6d6c319e9a16007f470300f4358be1048673c9783cf92b06347043c0db1609c2f2eb0c6d991a7f2856749be3f15407595e6d0d39796f26522c3fa4fcd2d8
+  metadata.gz: ed00a71ff9a370d9ad98fdda0c224bd6c273b69bfd543d1e5f2b40c5aee9d69b79fc1c6a8fe965d4727615d4c06a61291767961659d88567f5ee8e8153c11beb
+  data.tar.gz: 44a44276941e20c12c0998db7b73fb195eaea121be054a6b978a9f3a22cdbef04bf0e9bf5373b1db78cb75f128fec697112907ee0daff2187d7bc5db2b442ee9

data/.gitignore

@@ -2,6 +2,7 @@
 /.yardoc
 /Gemfile.lock
 /_yardoc/
+/bin/
 /coverage/
 /doc/
 /pkg/

data/README.md

@@ -15,7 +15,7 @@ This contains everything in the README as well as code-level documentation. We s
 This gem is a pre-release. In your Gemfile, add `recurly` as a dependency.
 
 ```ruby
-gem 'recurly', '3.0.0.beta.1'
+gem 'recurly', '3.0.0.beta.3'
 ```
 
 It's important that you lock on a specific version as there may be breaking changes between releases.

data/lib/recurly/client.rb

@@ -1,6 +1,7 @@
 require 'faraday'
 require 'logger'
 require_relative './schema/json_parser'
+require_relative './client/adapter'
 
 module Recurly
   class Client
@@ -42,58 +43,30 @@ module Recurly
     #   # Give a `site_id`
     #   client = Recurly::Client.new(api_key: API_KEY, site_id: SITE_ID)
     #   # Or use the subdomain
-    #   client = Recurly::Client.new(api_key: API_KEY, subdomain: 'mysite-dev') 
+    #   client = Recurly::Client.new(api_key: API_KEY, subdomain: 'mysite-dev')
     #
     #   sub = client.get_subscription(subscription_id: 'abcd123456')
     #
     #   # you should create a new client to connect to another site
-    #   client = Recurly::Client.new(api_key: API_KEY, subdomain: 'mysite-prod') 
+    #   client = Recurly::Client.new(api_key: API_KEY, subdomain: 'mysite-prod')
     #   sub = client.get_subscription(subscription_id: 'abcd7890')
     #
     # @param api_key [String] The private API key
     # @param site_id [String] The site you wish to be scoped to.
     # @param subdomain [String] Optional subdomain for the site you wish to be scoped to. Providing this makes all the `site_id` parameters optional.
     def initialize(api_key:, site_id: nil, subdomain: nil, **options)
-      if site_id
-        @site_id = site_id
-      elsif subdomain
-        @site_id = "subdomain-#{subdomain}"
-      else
-        raise ArgumentError, "You must pass a site_id or subdomain argument to initialize the Client"
-      end
-
-      @log_level = options[:log_level] || Logger::WARN
-      @logger = Logger.new(STDOUT)
-      @logger.level = @log_level
-
-      @conn = Faraday.new(url: BASE_URL) do |faraday|
-        if @log_level == Logger::INFO
-          faraday.response :logger
-        end
-        faraday.basic_auth(api_key, '')
-        faraday.adapter :net_http do |http| # yields Net::HTTP
-          # Let's not use the bundled cert in production yet
-          # but we will use these certs for any other staging or dev environment
-          unless BASE_URL.end_with?('.recurly.com')
-            http.ca_file = File.join(File.dirname(__FILE__), '../data/ca-certificates.crt')
-          end
-          http.use_ssl = true
-          http.verify_mode = OpenSSL::SSL::VERIFY_PEER
-          http.open_timeout = 50
-          http.read_timeout = 60
-          http.keep_alive_timeout = 60
-        end
-      end
-
-      # TODO this is undocumented until we finalize it
-      @extra_headers = options[:headers] || {}
+      set_site_id(site_id, subdomain)
+      set_options(options)
+      set_faraday_connection(api_key)
 
       # execute block with this client if given
       yield(self) if block_given?
     end
 
     def next_page(pager)
-      run_request(:get, pager.next, nil, headers)
+      run_request(:get, pager.next, nil, headers).tap do |response|
+        raise_api_error!(response) if response.status != 200
+      end
     end
 
     protected
@@ -133,7 +106,7 @@ module Recurly
     end
 
     def delete(path, **options)
-      response = run_request(:delete, path, options.compact, headers)
+      response = run_request(:delete, path, nil, headers)
       raise_api_error!(response) if ![200, 201].include?(response.status)
       JSONParser.parse(self, response.body)
     rescue Faraday::ClientError => ex
@@ -194,5 +167,34 @@ module Recurly
       path = path.gsub("{", "%{")
       path % options
     end
+
+    def set_site_id(site_id, subdomain)
+      if site_id
+        @site_id = site_id
+      elsif subdomain
+        @site_id = "subdomain-#{subdomain}"
+      else
+        raise ArgumentError, "You must pass a site_id or subdomain argument to initialize the Client"
+      end
+    end
+
+    def set_faraday_connection(api_key)
+      @conn = Faraday.new(url: BASE_URL) do |faraday|
+        if @log_level == Logger::INFO
+          faraday.response :logger
+        end
+        faraday.basic_auth(api_key, '')
+        configure_net_adapter(faraday)
+      end
+    end
+
+    def set_options(options)
+      @log_level = options[:log_level] || Logger::WARN
+      @logger = Logger.new(STDOUT)
+      @logger.level = @log_level
+
+      # TODO this is undocumented until we finalize it
+      @extra_headers = options[:headers] || {}
+    end
   end
 end

data/lib/recurly/client/adapter.rb

@@ -0,0 +1,46 @@
+require 'openssl'
+
+module Recurly
+  class Client
+    module NetHttpPersistentAdapter
+      protected
+      def configure_net_adapter(faraday)
+        faraday.adapter :net_http_persistent do |http| # yields Net::HTTP
+          # Let's not use the bundled cert in production yet
+          # but we will use these certs for any other staging or dev environment
+          unless BASE_URL.end_with?('.recurly.com')
+            http.ca_file = File.join(File.dirname(__FILE__), '../data/ca-certificates.crt')
+          end
+          http.open_timeout = 50
+          http.read_timeout = 60
+        end
+      end
+    end
+
+    module NetHttpAdapter
+      protected
+      def configure_net_adapter(faraday)
+        faraday.adapter :net_http do |http| # yields Net::HTTP
+          # Let's not use the bundled cert in production yet
+          # but we will use these certs for any other staging or dev environment
+          unless BASE_URL.end_with?('.recurly.com')
+            http.ca_file = File.join(File.dirname(__FILE__), '../data/ca-certificates.crt')
+          end
+          http.use_ssl = true
+          http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+          http.open_timeout = 50
+          http.read_timeout = 60
+          http.keep_alive_timeout = 60
+        end
+      end
+    end
+
+    include NetHttpAdapter
+
+    begin
+      require 'net/http/persistent'
+      include NetHttpPersistentAdapter
+    rescue LoadError
+    end
+  end
+end

data/lib/recurly/client/operations.rb

@@ -1,15 +1,28 @@
 module Recurly
   class Client
     def api_version
-      "v2018-01-24"
+      "v2018-06-06"
     end
 
     # List sites
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
     # @return [Pager<Resources::Site>] A list of sites.
     def list_sites(**options)
       path = "/sites"
@@ -26,14 +39,33 @@ module Recurly
 
     # List a site's accounts
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param subscriber [String] Filter accounts accounts with or without a subscription in the `active`, `canceled`, or `future` state.
-    # @param past_due [String] Filter for accounts with an invoice in the `past_due` state.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param subscriber [String] Filter accounts accounts with or without a subscription in the +active+,
+    #   +canceled+, or +future+ state.
+    #
+    # @param past_due [String] Filter for accounts with an invoice in the +past_due+ state.
     # @return [Pager<Resources::Account>] A list of the site's accounts.
     def list_accounts(**options)
       path = interpolate_path("/sites/{site_id}/accounts", site_id: site_id)
@@ -42,16 +74,16 @@ module Recurly
 
     # Create an account
     #
-    # @param body [Requests::CreateAccount] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::CreateAccount}
+    # @param body [Requests::AccountCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::AccountCreate}
     # @return [Resources::Account] An account.
     def create_account(body:)
       path = interpolate_path("/sites/{site_id}/accounts", site_id: site_id)
-      post(path, body, Requests::CreateAccount)
+      post(path, body, Requests::AccountCreate)
     end
 
     # Fetch an account
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @return [Resources::Account] An account.
     # @example
     #   begin
@@ -73,17 +105,17 @@ module Recurly
 
     # Modify an account
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
-    # @param body [Requests::AccountUpdatable] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::AccountUpdatable}
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
+    # @param body [Requests::AccountUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::AccountUpdate}
     # @return [Resources::Account] An account.
     def update_account(account_id:, body:)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}", site_id: site_id, account_id: account_id)
-      put(path, body, Requests::AccountUpdatable)
+      put(path, body, Requests::AccountUpdate)
     end
 
     # Deactivate an account
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @return [Resources::Account] An account.
     def deactivate_account(account_id:)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}", site_id: site_id, account_id: account_id)
@@ -92,7 +124,7 @@ module Recurly
 
     # Fetch an account's acquisition data
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @return [Resources::AccountAcquisition] An account's acquisition data.
     def get_account_acquisition(account_id:)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}/acquisition", site_id: site_id, account_id: account_id)
@@ -101,7 +133,7 @@ module Recurly
 
     # Update an account's acquisition data
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @param body [Requests::AccountAcquisitionUpdatable] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::AccountAcquisitionUpdatable}
     # @return [Resources::AccountAcquisition] An account's updated acquisition data.
     def update_account_acquisition(account_id:, body:)
@@ -111,7 +143,7 @@ module Recurly
 
     # Remove an account's acquisition data
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     def remove_account_acquisition(account_id:)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}/acquisition", site_id: site_id, account_id: account_id)
       delete(path)
@@ -119,7 +151,7 @@ module Recurly
 
     # Reactivate an inactive account
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @return [Resources::Account] An account.
     def reactivate_account(account_id:)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}/reactivate", site_id: site_id, account_id: account_id)
@@ -128,7 +160,7 @@ module Recurly
 
     # Fetch an account's balance and past due status
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @return [Resources::AccountBalance] An account's balance.
     def get_account_balance(account_id:)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}/balance", site_id: site_id, account_id: account_id)
@@ -137,7 +169,7 @@ module Recurly
 
     # Fetch an account's billing information
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @return [Resources::BillingInfo] An account's billing information.
     def get_billing_info(account_id:)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}/billing_info", site_id: site_id, account_id: account_id)
@@ -146,7 +178,7 @@ module Recurly
 
     # Set an account's billing information
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @param body [Requests::BillingInfoCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::BillingInfoCreate}
     # @return [Resources::BillingInfo] Updated billing information.
     def update_billing_info(account_id:, body:)
@@ -156,7 +188,7 @@ module Recurly
 
     # Remove an account's billing information
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     def remove_billing_info(account_id:)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}/billing_info", site_id: site_id, account_id: account_id)
       delete(path)
@@ -164,8 +196,18 @@ module Recurly
 
     # Show the coupon redemptions for an account
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @return [Pager<Resources::CouponRedemption>] A list of the the coupon redemptions on an account.
     def list_account_coupon_redemptions(account_id:, **options)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}/coupon_redemptions", site_id: site_id, account_id: account_id)
@@ -174,7 +216,7 @@ module Recurly
 
     # Show the coupon redemption that is active on an account
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @return [Resources::CouponRedemption] An active coupon redemption on an account.
     def get_active_coupon_redemption(account_id:)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}/coupon_redemptions/active", site_id: site_id, account_id: account_id)
@@ -183,17 +225,17 @@ module Recurly
 
     # Generate an active coupon redemption on an account
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
-    # @param body [Requests::CreateCouponRedemption] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::CreateCouponRedemption}
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
+    # @param body [Requests::CouponRedemptionCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::CouponRedemptionCreate}
     # @return [Resources::CouponRedemption] Returns the new coupon redemption.
     def create_coupon_redemption(account_id:, body:)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}/coupon_redemptions/active", site_id: site_id, account_id: account_id)
-      post(path, body, Requests::CreateCouponRedemption)
+      post(path, body, Requests::CouponRedemptionCreate)
     end
 
     # Delete the active coupon redemption from an account
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @return [Resources::CouponRedemption] Coupon redemption deleted.
     def remove_coupon_redemption(account_id:)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}/coupon_redemptions/active", site_id: site_id, account_id: account_id)
@@ -202,12 +244,19 @@ module Recurly
 
     # List an account's credit payments
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
     # @return [Pager<Resources::CreditPayment>] A list of the account's credit payments.
     def list_account_credit_payments(account_id:, **options)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}/credit_payments", site_id: site_id, account_id: account_id)
@@ -216,14 +265,36 @@ module Recurly
 
     # List an account's invoices
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param type [String] Filter by type when: - `type=charge`, only charge invoices will be returned. - `type=credit`, only credit invoices will be returned. - `type=non-legacy`, only charge and credit invoices will be returned. - `type=legacy`, only legacy invoices will be returned.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param type [String] Filter by type when:
+    #   - +type=charge+, only charge invoices will be returned.
+    #   - +type=credit+, only credit invoices will be returned.
+    #   - +type=non-legacy+, only charge and credit invoices will be returned.
+    #   - +type=legacy+, only legacy invoices will be returned.
+    #
     # @return [Pager<Resources::Invoice>] A list of the account's invoices.
     def list_account_invoices(account_id:, **options)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}/invoices", site_id: site_id, account_id: account_id)
@@ -232,7 +303,7 @@ module Recurly
 
     # Create an invoice for pending line items
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @param body [Requests::InvoiceCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::InvoiceCreate}
     # @return [Resources::InvoiceCollection] Returns the new invoices.
     def create_invoice(account_id:, body:)
@@ -242,7 +313,7 @@ module Recurly
 
     # Preview new invoice for pending line items
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @param body [Requests::InvoiceCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::InvoiceCreate}
     # @return [Resources::InvoiceCollection] Returns the invoice previews.
     def preview_invoice(account_id:, body:)
@@ -252,13 +323,30 @@ module Recurly
 
     # List an account's line items
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
     # @param original [String] Filter by original field.
     # @param state [String] Filter by state field.
     # @param type [String] Filter by type field.
@@ -270,7 +358,7 @@ module Recurly
 
     # Create a new line item for the account
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @param body [Requests::LineItemCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::LineItemCreate}
     # @return [Resources::LineItem] Returns the new line item.
     def create_line_item(account_id:, body:)
@@ -280,8 +368,18 @@ module Recurly
 
     # Fetch a list of an account's notes
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @return [Pager<Resources::AccountNote>] A list of an account's notes.
     def list_account_notes(account_id:, **options)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}/notes", site_id: site_id, account_id: account_id)
@@ -290,7 +388,7 @@ module Recurly
 
     # Fetch an account note
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @param account_note_id [String] Account Note ID.
     # @return [Resources::AccountNote] An account note.
     def get_account_note(account_id:, account_note_id:)
@@ -300,13 +398,30 @@ module Recurly
 
     # Fetch a list of an account's shipping addresses
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
     # @return [Pager<Resources::ShippingAddress>] A list of an account's shipping addresses.
     def list_shipping_addresses(account_id:, **options)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}/shipping_addresses", site_id: site_id, account_id: account_id)
@@ -315,7 +430,7 @@ module Recurly
 
     # Create a new shipping address for the account
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @param body [Requests::ShippingAddressCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::ShippingAddressCreate}
     # @return [Resources::ShippingAddress] Returns the new shipping address.
     def create_shipping_address(account_id:, body:)
@@ -325,7 +440,7 @@ module Recurly
 
     # Fetch an account's shipping address
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @param shipping_address_id [String] Shipping Address ID.
     # @return [Resources::ShippingAddress] A shipping address.
     def get_shipping_address(account_id:, shipping_address_id:)
@@ -335,7 +450,7 @@ module Recurly
 
     # Update an account's shipping address
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @param shipping_address_id [String] Shipping Address ID.
     # @param body [Requests::ShippingAddressUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::ShippingAddressUpdate}
     # @return [Resources::ShippingAddress] The updated shipping address.
@@ -346,7 +461,7 @@ module Recurly
 
     # Remove an account's shipping address
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
     # @param shipping_address_id [String] Shipping Address ID.
     def remove_shipping_address(account_id:, shipping_address_id:)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}/shipping_addresses/{shipping_address_id}", site_id: site_id, account_id: account_id, shipping_address_id: shipping_address_id)
@@ -355,14 +470,35 @@ module Recurly
 
     # List an account's subscriptions
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param state [String] Filter by state. - When `state=active`, `state=canceled`, `state=expired`, or `state=future`, subscriptions with states that match the query and only those subscriptions will be returned. - When `state=in_trial`, only subscriptions that have a trial_started_at date earlier than now and a trial_ends_at date later than now will be returned. - When `state=live`, only subscriptions that are in an active, canceled, or future state or are in trial will be returned.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param state [String] Filter by state.
+    #   - When +state=active+, +state=canceled+, +state=expired+, or +state=future+, subscriptions with states that match the query and only those subscriptions will be returned.
+    #   - When +state=in_trial+, only subscriptions that have a trial_started_at date earlier than now and a trial_ends_at date later than now will be returned.
+    #   - When +state=live+, only subscriptions that are in an active, canceled, or future state or are in trial will be returned.
+    #
     # @return [Pager<Resources::Subscription>] A list of the account's subscriptions.
     def list_account_subscriptions(account_id:, **options)
       path = interpolate_path("/sites/{site_id}/accounts/{account_id}/subscriptions", site_id: site_id, account_id: account_id)
@@ -371,13 +507,30 @@ module Recurly
 
     # List an account's transactions
     #
-    # @param account_id [String] Account ID or code (use prefix: `code-`, e.g. `code-bob`).
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param account_id [String] Account ID or code (use prefix: +code-+, e.g. +code-bob+).
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
     # @param type [String] Filter by type field.
     # @param success [String] Filter by success field.
     # @return [Pager<Resources::Transaction>] A list of the account's transactions.
@@ -388,12 +541,29 @@ module Recurly
 
     # List a site's account acquisition data
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
     # @return [Resources::AccountAcquisition] A list of the site's account acquisition data.
     def list_account_acquisition(**options)
       path = interpolate_path("/sites/{site_id}/acquisitions", site_id: site_id)
@@ -402,12 +572,29 @@ module Recurly
 
     # List a site's coupons
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
     # @return [Pager<Resources::Coupon>] A list of the site's coupons.
     def list_coupons(**options)
       path = interpolate_path("/sites/{site_id}/coupons", site_id: site_id)
@@ -416,16 +603,16 @@ module Recurly
 
     # Create a new coupon
     #
-    # @param body [Requests::CreateCoupon] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::CreateCoupon}
+    # @param body [Requests::CouponCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::CouponCreate}
     # @return [Resources::Coupon] A new coupon.
     def create_coupon(body:)
       path = interpolate_path("/sites/{site_id}/coupons", site_id: site_id)
-      post(path, body, Requests::CreateCoupon)
+      post(path, body, Requests::CouponCreate)
     end
 
     # Fetch a coupon
     #
-    # @param coupon_id [String] Coupon ID or code (use prefix: `code-`, e.g. `code-10off`).
+    # @param coupon_id [String] Coupon ID or code (use prefix: +code-+, e.g. +code-10off+).
     # @return [Resources::Coupon] A coupon.
     def get_coupon(coupon_id:)
       path = interpolate_path("/sites/{site_id}/coupons/{coupon_id}", site_id: site_id, coupon_id: coupon_id)
@@ -434,23 +621,40 @@ module Recurly
 
     # Update an active coupon
     #
-    # @param coupon_id [String] Coupon ID or code (use prefix: `code-`, e.g. `code-10off`).
-    # @param body [Requests::UpdateCoupon] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::UpdateCoupon}
+    # @param coupon_id [String] Coupon ID or code (use prefix: +code-+, e.g. +code-10off+).
+    # @param body [Requests::CouponUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::CouponUpdate}
     # @return [Resources::Coupon] The updated coupon.
     def update_coupon(coupon_id:, body:)
       path = interpolate_path("/sites/{site_id}/coupons/{coupon_id}", site_id: site_id, coupon_id: coupon_id)
-      put(path, body, Requests::UpdateCoupon)
+      put(path, body, Requests::CouponUpdate)
     end
 
     # List unique coupon codes associated with a bulk coupon
     #
-    # @param coupon_id [String] Coupon ID or code (use prefix: `code-`, e.g. `code-10off`).
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param coupon_id [String] Coupon ID or code (use prefix: +code-+, e.g. +code-10off+).
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
     # @return [Pager<Resources::UniqueCouponCode>] A list of unique coupon codes that were generated
     def list_unique_coupon_codes(coupon_id:, **options)
       path = interpolate_path("/sites/{site_id}/coupons/{coupon_id}/unique_coupon_codes", site_id: site_id, coupon_id: coupon_id)
@@ -461,9 +665,16 @@ module Recurly
     #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
     # @return [Pager<Resources::CreditPayment>] A list of the site's credit payments.
     def list_credit_payments(**options)
       path = interpolate_path("/sites/{site_id}/credit_payments", site_id: site_id)
@@ -472,22 +683,84 @@ module Recurly
 
     # Fetch a credit payment
     #
-    # @param credit_payment_id [String] Credit Payment ID or UUID (use prefix: `uuid-`, e.g. `uuid-123457890`).
+    # @param credit_payment_id [String] Credit Payment ID or UUID (use prefix: +uuid-+, e.g. +uuid-123457890+).
     # @return [Resources::CreditPayment] A credit payment.
     def get_credit_payment(credit_payment_id:)
       path = interpolate_path("/sites/{site_id}/credit_payments/{credit_payment_id}", site_id: site_id, credit_payment_id: credit_payment_id)
       get(path)
     end
 
+    # List a site's custom field definitions
+    #
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
+    # @param limit [Integer] Limit number of records 1-200.
+    # @param order [String] Sort order.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @return [Pager<Resources::CustomFieldDefinition>] A list of the site's custom field definitions.
+    def list_custom_field_definitions(**options)
+      path = interpolate_path("/sites/{site_id}/custom_field_definitions", site_id: site_id)
+      pager(path, **options)
+    end
+
+    # Fetch an custom field definition
+    #
+    # @param custom_field_definition_id [String] Custom Field Definition ID
+    # @return [Resources::CustomFieldDefinition] An custom field definition.
+    def get_custom_field_definition(custom_field_definition_id:)
+      path = interpolate_path("/sites/{site_id}/custom_field_definitions/{custom_field_definition_id}", site_id: site_id, custom_field_definition_id: custom_field_definition_id)
+      get(path)
+    end
+
     # List a site's invoices
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param type [String] Filter by type when: - `type=charge`, only charge invoices will be returned. - `type=credit`, only credit invoices will be returned. - `type=non-legacy`, only charge and credit invoices will be returned. - `type=legacy`, only legacy invoices will be returned.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param type [String] Filter by type when:
+    #   - +type=charge+, only charge invoices will be returned.
+    #   - +type=credit+, only credit invoices will be returned.
+    #   - +type=non-legacy+, only charge and credit invoices will be returned.
+    #   - +type=legacy+, only legacy invoices will be returned.
+    #
     # @return [Pager<Resources::Invoice>] A list of the site's invoices.
     def list_invoices(**options)
       path = interpolate_path("/sites/{site_id}/invoices", site_id: site_id)
@@ -496,7 +769,7 @@ module Recurly
 
     # Fetch an invoice
     #
-    # @param invoice_id [String] Invoice ID or number (use prefix: `number-`, e.g. `number-1000`).
+    # @param invoice_id [String] Invoice ID or number (use prefix: +number-+, e.g. +number-1000+).
     # @return [Resources::Invoice] An invoice.
     def get_invoice(invoice_id:)
       path = interpolate_path("/sites/{site_id}/invoices/{invoice_id}", site_id: site_id, invoice_id: invoice_id)
@@ -505,7 +778,7 @@ module Recurly
 
     # Collect a pending or past due, automatic invoice
     #
-    # @param invoice_id [String] Invoice ID or number (use prefix: `number-`, e.g. `number-1000`).
+    # @param invoice_id [String] Invoice ID or number (use prefix: +number-+, e.g. +number-1000+).
     # @return [Resources::Invoice] The updated invoice.
     def collect_invoice(invoice_id:)
       path = interpolate_path("/sites/{site_id}/invoices/{invoice_id}/collect", site_id: site_id, invoice_id: invoice_id)
@@ -514,7 +787,7 @@ module Recurly
 
     # Mark an open invoice as failed
     #
-    # @param invoice_id [String] Invoice ID or number (use prefix: `number-`, e.g. `number-1000`).
+    # @param invoice_id [String] Invoice ID or number (use prefix: +number-+, e.g. +number-1000+).
     # @return [Resources::Invoice] The updated invoice.
     def fail_invoice(invoice_id:)
       path = interpolate_path("/sites/{site_id}/invoices/{invoice_id}/mark_failed", site_id: site_id, invoice_id: invoice_id)
@@ -523,7 +796,7 @@ module Recurly
 
     # Mark an open invoice as successful
     #
-    # @param invoice_id [String] Invoice ID or number (use prefix: `number-`, e.g. `number-1000`).
+    # @param invoice_id [String] Invoice ID or number (use prefix: +number-+, e.g. +number-1000+).
     # @return [Resources::Invoice] The updated invoice.
     def mark_invoice_successful(invoice_id:)
       path = interpolate_path("/sites/{site_id}/invoices/{invoice_id}/mark_successful", site_id: site_id, invoice_id: invoice_id)
@@ -532,7 +805,7 @@ module Recurly
 
     # Reopen a closed, manual invoice
     #
-    # @param invoice_id [String] Invoice ID or number (use prefix: `number-`, e.g. `number-1000`).
+    # @param invoice_id [String] Invoice ID or number (use prefix: +number-+, e.g. +number-1000+).
     # @return [Resources::Invoice] The updated invoice.
     def reopen_invoice(invoice_id:)
       path = interpolate_path("/sites/{site_id}/invoices/{invoice_id}/reopen", site_id: site_id, invoice_id: invoice_id)
@@ -541,13 +814,30 @@ module Recurly
 
     # List a invoice's line items
     #
-    # @param invoice_id [String] Invoice ID or number (use prefix: `number-`, e.g. `number-1000`).
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param invoice_id [String] Invoice ID or number (use prefix: +number-+, e.g. +number-1000+).
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
     # @param original [String] Filter by original field.
     # @param state [String] Filter by state field.
     # @param type [String] Filter by type field.
@@ -559,8 +849,18 @@ module Recurly
 
     # Show the coupon redemptions applied to an invoice
     #
-    # @param invoice_id [String] Invoice ID or number (use prefix: `number-`, e.g. `number-1000`).
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param invoice_id [String] Invoice ID or number (use prefix: +number-+, e.g. +number-1000+).
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @return [Pager<Resources::CouponRedemption>] A list of the the coupon redemptions associated with the invoice.
     def list_invoice_coupon_redemptions(invoice_id:, **options)
       path = interpolate_path("/sites/{site_id}/invoices/{invoice_id}/coupon_redemptions", site_id: site_id, invoice_id: invoice_id)
@@ -569,7 +869,7 @@ module Recurly
 
     # List an invoice's related credit or charge invoices
     #
-    # @param invoice_id [String] Invoice ID or number (use prefix: `number-`, e.g. `number-1000`).
+    # @param invoice_id [String] Invoice ID or number (use prefix: +number-+, e.g. +number-1000+).
     # @return [Pager<Resources::Invoice>] A list of the credit or charge invoices associated with the invoice.
     def list_related_invoices(invoice_id:)
       path = interpolate_path("/sites/{site_id}/invoices/{invoice_id}/related_invoices", site_id: site_id, invoice_id: invoice_id)
@@ -578,7 +878,7 @@ module Recurly
 
     # Refund an invoice
     #
-    # @param invoice_id [String] Invoice ID or number (use prefix: `number-`, e.g. `number-1000`).
+    # @param invoice_id [String] Invoice ID or number (use prefix: +number-+, e.g. +number-1000+).
     # @param body [Requests::InvoiceRefund] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::InvoiceRefund}
     # @return [Resources::Invoice] Returns the new credit invoice.
     def refund_invoice(invoice_id:, body:)
@@ -588,12 +888,29 @@ module Recurly
 
     # List a site's line items
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
     # @param original [String] Filter by original field.
     # @param state [String] Filter by state field.
     # @param type [String] Filter by type field.
@@ -622,12 +939,29 @@ module Recurly
 
     # List a site's plans
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
     # @param state [String] Filter by state.
     # @return [Pager<Resources::Plan>] A list of plans.
     def list_plans(**options)
@@ -646,7 +980,7 @@ module Recurly
 
     # Fetch a plan
     #
-    # @param plan_id [String] Plan ID or code (use prefix: `code-`, e.g. `code-gold`).
+    # @param plan_id [String] Plan ID or code (use prefix: +code-+, e.g. +code-gold+).
     # @return [Resources::Plan] A plan.
     def get_plan(plan_id:)
       path = interpolate_path("/sites/{site_id}/plans/{plan_id}", site_id: site_id, plan_id: plan_id)
@@ -655,7 +989,7 @@ module Recurly
 
     # Update a plan
     #
-    # @param plan_id [String] Plan ID or code (use prefix: `code-`, e.g. `code-gold`).
+    # @param plan_id [String] Plan ID or code (use prefix: +code-+, e.g. +code-gold+).
     # @param body [Requests::PlanUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::PlanUpdate}
     # @return [Resources::Plan] A plan.
     def update_plan(plan_id:, body:)
@@ -665,7 +999,7 @@ module Recurly
 
     # Remove a plan
     #
-    # @param plan_id [String] Plan ID or code (use prefix: `code-`, e.g. `code-gold`).
+    # @param plan_id [String] Plan ID or code (use prefix: +code-+, e.g. +code-gold+).
     # @return [Resources::Plan] Plan deleted
     def remove_plan(plan_id:)
       path = interpolate_path("/sites/{site_id}/plans/{plan_id}", site_id: site_id, plan_id: plan_id)
@@ -674,13 +1008,30 @@ module Recurly
 
     # List a plan's add-ons
     #
-    # @param plan_id [String] Plan ID or code (use prefix: `code-`, e.g. `code-gold`).
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param plan_id [String] Plan ID or code (use prefix: +code-+, e.g. +code-gold+).
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
     # @param state [String] Filter by state.
     # @return [Pager<Resources::AddOn>] A list of add-ons.
     def list_plan_add_ons(plan_id:, **options)
@@ -690,7 +1041,7 @@ module Recurly
 
     # Create an add-on
     #
-    # @param plan_id [String] Plan ID or code (use prefix: `code-`, e.g. `code-gold`).
+    # @param plan_id [String] Plan ID or code (use prefix: +code-+, e.g. +code-gold+).
     # @param body [Requests::AddOnCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::AddOnCreate}
     # @return [Resources::AddOn] An add-on.
     def create_plan_add_on(plan_id:, body:)
@@ -700,8 +1051,8 @@ module Recurly
 
     # Fetch a plan's add-on
     #
-    # @param add_on_id [String] Add-on ID or code (use prefix: `code-`, e.g. `code-gold`).
-    # @param plan_id [String] Plan ID or code (use prefix: `code-`, e.g. `code-gold`).
+    # @param add_on_id [String] Add-on ID or code (use prefix: +code-+, e.g. +code-gold+).
+    # @param plan_id [String] Plan ID or code (use prefix: +code-+, e.g. +code-gold+).
     # @return [Resources::AddOn] An add-on.
     def get_plan_add_on(add_on_id:, plan_id:)
       path = interpolate_path("/sites/{site_id}/plans/{plan_id}/add_ons/{add_on_id}", site_id: site_id, add_on_id: add_on_id, plan_id: plan_id)
@@ -710,8 +1061,8 @@ module Recurly
 
     # Update an add-on
     #
-    # @param add_on_id [String] Add-on ID or code (use prefix: `code-`, e.g. `code-gold`).
-    # @param plan_id [String] Plan ID or code (use prefix: `code-`, e.g. `code-gold`).
+    # @param add_on_id [String] Add-on ID or code (use prefix: +code-+, e.g. +code-gold+).
+    # @param plan_id [String] Plan ID or code (use prefix: +code-+, e.g. +code-gold+).
     # @param body [Requests::AddOnUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::AddOnUpdate}
     # @return [Resources::AddOn] An add-on.
     def update_plan_add_on(add_on_id:, plan_id:, body:)
@@ -721,8 +1072,8 @@ module Recurly
 
     # Remove an add-on
     #
-    # @param add_on_id [String] Add-on ID or code (use prefix: `code-`, e.g. `code-gold`).
-    # @param plan_id [String] Plan ID or code (use prefix: `code-`, e.g. `code-gold`).
+    # @param add_on_id [String] Add-on ID or code (use prefix: +code-+, e.g. +code-gold+).
+    # @param plan_id [String] Plan ID or code (use prefix: +code-+, e.g. +code-gold+).
     # @return [Resources::AddOn] Add-on deleted
     def remove_plan_add_on(add_on_id:, plan_id:)
       path = interpolate_path("/sites/{site_id}/plans/{plan_id}/add_ons/{add_on_id}", site_id: site_id, add_on_id: add_on_id, plan_id: plan_id)
@@ -731,12 +1082,29 @@ module Recurly
 
     # List a site's add-ons
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
     # @param state [String] Filter by state.
     # @return [Pager<Resources::AddOn>] A list of add-ons.
     def list_add_ons(**options)
@@ -746,7 +1114,7 @@ module Recurly
 
     # Fetch an add-on
     #
-    # @param add_on_id [String] Add-on ID or code (use prefix: `code-`, e.g. `code-gold`).
+    # @param add_on_id [String] Add-on ID or code (use prefix: +code-+, e.g. +code-gold+).
     # @return [Resources::AddOn] An add-on.
     def get_add_on(add_on_id:)
       path = interpolate_path("/sites/{site_id}/add_ons/{add_on_id}", site_id: site_id, add_on_id: add_on_id)
@@ -755,13 +1123,34 @@ module Recurly
 
     # List a site's subscriptions
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param state [String] Filter by state. - When `state=active`, `state=canceled`, `state=expired`, or `state=future`, subscriptions with states that match the query and only those subscriptions will be returned. - When `state=in_trial`, only subscriptions that have a trial_started_at date earlier than now and a trial_ends_at date later than now will be returned. - When `state=live`, only subscriptions that are in an active, canceled, or future state or are in trial will be returned.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param state [String] Filter by state.
+    #   - When +state=active+, +state=canceled+, +state=expired+, or +state=future+, subscriptions with states that match the query and only those subscriptions will be returned.
+    #   - When +state=in_trial+, only subscriptions that have a trial_started_at date earlier than now and a trial_ends_at date later than now will be returned.
+    #   - When +state=live+, only subscriptions that are in an active, canceled, or future state or are in trial will be returned.
+    #
     # @return [Pager<Resources::Subscription>] A list of the site's subscriptions.
     def list_subscriptions(**options)
       path = interpolate_path("/sites/{site_id}/subscriptions", site_id: site_id)
@@ -779,7 +1168,7 @@ module Recurly
 
     # Fetch a subscription
     #
-    # @param subscription_id [String] Subscription ID or UUID (use prefix: `uuid-`, e.g. `uuid-123457890`).
+    # @param subscription_id [String] Subscription ID or UUID (use prefix: +uuid-+, e.g. +uuid-123457890+).
     # @return [Resources::Subscription] A subscription.
     # @example
     #   begin
@@ -801,7 +1190,7 @@ module Recurly
 
     # Modify a subscription
     #
-    # @param subscription_id [String] Subscription ID or UUID (use prefix: `uuid-`, e.g. `uuid-123457890`).
+    # @param subscription_id [String] Subscription ID or UUID (use prefix: +uuid-+, e.g. +uuid-123457890+).
     # @param body [Requests::SubscriptionUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::SubscriptionUpdate}
     # @return [Resources::Subscription] A subscription.
     def modify_subscription(subscription_id:, body:)
@@ -811,8 +1200,17 @@ module Recurly
 
     # Terminate a subscription
     #
-    # @param subscription_id [String] Subscription ID or UUID (use prefix: `uuid-`, e.g. `uuid-123457890`).
-    # @param refund [String] The type of refund to perform:  * `full` - Performs a full refund of the last invoice for the current subscription term. * `partial` - Prorates a refund based on the amount of time remaining in the current bill cycle. * `none` - Terminates the subscription without a refund.  In the event that the most recent invoice is a $0 invoice paid entirely by credit, Recurly will apply the credit back to the customer’s account.  You may also terminate a subscription with no refund and then manually refund specific invoices.
+    # @param subscription_id [String] Subscription ID or UUID (use prefix: +uuid-+, e.g. +uuid-123457890+).
+    # @param refund [String] The type of refund to perform:
+    #
+    #   * +full+ - Performs a full refund of the last invoice for the current subscription term.
+    #   * +partial+ - Prorates a refund based on the amount of time remaining in the current bill cycle.
+    #   * +none+ - Terminates the subscription without a refund.
+    #
+    #   In the event that the most recent invoice is a $0 invoice paid entirely by credit, Recurly will apply the credit back to the customer’s account.
+    #
+    #   You may also terminate a subscription with no refund and then manually refund specific invoices.
+    #
     # @return [Resources::Subscription] An expired subscription.
     def terminate_subscription(subscription_id:, **options)
       path = interpolate_path("/sites/{site_id}/subscriptions/{subscription_id}", site_id: site_id, subscription_id: subscription_id)
@@ -821,7 +1219,7 @@ module Recurly
 
     # Cancel a subscription
     #
-    # @param subscription_id [String] Subscription ID or UUID (use prefix: `uuid-`, e.g. `uuid-123457890`).
+    # @param subscription_id [String] Subscription ID or UUID (use prefix: +uuid-+, e.g. +uuid-123457890+).
     # @return [Resources::Subscription] A canceled or failed subscription.
     def cancel_subscription(subscription_id:)
       path = interpolate_path("/sites/{site_id}/subscriptions/{subscription_id}/cancel", site_id: site_id, subscription_id: subscription_id)
@@ -830,16 +1228,35 @@ module Recurly
 
     # Reactivate a canceled subscription
     #
-    # @param subscription_id [String] Subscription ID or UUID (use prefix: `uuid-`, e.g. `uuid-123457890`).
+    # @param subscription_id [String] Subscription ID or UUID (use prefix: +uuid-+, e.g. +uuid-123457890+).
     # @return [Resources::Subscription] An active subscription.
     def reactivate_subscription(subscription_id:)
       path = interpolate_path("/sites/{site_id}/subscriptions/{subscription_id}/reactivate", site_id: site_id, subscription_id: subscription_id)
       put(path)
     end
 
+    # Pause subscription
+    #
+    # @param subscription_id [String] Subscription ID or UUID (use prefix: +uuid-+, e.g. +uuid-123457890+).
+    # @param body [Requests::SubscriptionPause] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::SubscriptionPause}
+    # @return [Resources::Subscription] A subscription.
+    def pause_subscription(subscription_id:, body:)
+      path = interpolate_path("/sites/{site_id}/subscriptions/{subscription_id}/pause", site_id: site_id, subscription_id: subscription_id)
+      put(path, body, Requests::SubscriptionPause)
+    end
+
+    # Resume subscription
+    #
+    # @param subscription_id [String] Subscription ID or UUID (use prefix: +uuid-+, e.g. +uuid-123457890+).
+    # @return [Resources::Subscription] A subscription.
+    def resume_subscription(subscription_id:)
+      path = interpolate_path("/sites/{site_id}/subscriptions/{subscription_id}/resume", site_id: site_id, subscription_id: subscription_id)
+      put(path)
+    end
+
     # Fetch a subscription's pending change
     #
-    # @param subscription_id [String] Subscription ID or UUID (use prefix: `uuid-`, e.g. `uuid-123457890`).
+    # @param subscription_id [String] Subscription ID or UUID (use prefix: +uuid-+, e.g. +uuid-123457890+).
     # @return [Resources::SubscriptionChange] A subscription's pending change.
     def get_subscription_change(subscription_id:)
       path = interpolate_path("/sites/{site_id}/subscriptions/{subscription_id}/change", site_id: site_id, subscription_id: subscription_id)
@@ -848,7 +1265,7 @@ module Recurly
 
     # Create a new subscription change
     #
-    # @param subscription_id [String] Subscription ID or UUID (use prefix: `uuid-`, e.g. `uuid-123457890`).
+    # @param subscription_id [String] Subscription ID or UUID (use prefix: +uuid-+, e.g. +uuid-123457890+).
     # @param body [Requests::SubscriptionChangeCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::SubscriptionChangeCreate}
     # @return [Resources::SubscriptionChange] A subscription change.
     def create_subscription_change(subscription_id:, body:)
@@ -858,7 +1275,7 @@ module Recurly
 
     # Delete the pending subscription change
     #
-    # @param subscription_id [String] Subscription ID or UUID (use prefix: `uuid-`, e.g. `uuid-123457890`).
+    # @param subscription_id [String] Subscription ID or UUID (use prefix: +uuid-+, e.g. +uuid-123457890+).
     def remove_subscription_change(subscription_id:)
       path = interpolate_path("/sites/{site_id}/subscriptions/{subscription_id}/change", site_id: site_id, subscription_id: subscription_id)
       delete(path)
@@ -866,14 +1283,36 @@ module Recurly
 
     # List a subscription's invoices
     #
-    # @param subscription_id [String] Subscription ID or UUID (use prefix: `uuid-`, e.g. `uuid-123457890`).
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param subscription_id [String] Subscription ID or UUID (use prefix: +uuid-+, e.g. +uuid-123457890+).
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param type [String] Filter by type when: - `type=charge`, only charge invoices will be returned. - `type=credit`, only credit invoices will be returned. - `type=non-legacy`, only charge and credit invoices will be returned. - `type=legacy`, only legacy invoices will be returned.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param type [String] Filter by type when:
+    #   - +type=charge+, only charge invoices will be returned.
+    #   - +type=credit+, only credit invoices will be returned.
+    #   - +type=non-legacy+, only charge and credit invoices will be returned.
+    #   - +type=legacy+, only legacy invoices will be returned.
+    #
     # @return [Pager<Resources::Invoice>] A list of the subscription's invoices.
     def list_subscription_invoices(subscription_id:, **options)
       path = interpolate_path("/sites/{site_id}/subscriptions/{subscription_id}/invoices", site_id: site_id, subscription_id: subscription_id)
@@ -882,12 +1321,29 @@ module Recurly
 
     # List a site's transactions
     #
-    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1`.  **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering   parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the   results correspond to your request. * Records are returned in an arbitrary order. Since results are all   returned at once you can sort the records yourself.
+    # @param ids [String] Filter results by their IDs. Up to 200 IDs can be passed at once using
+    #   commas as separators, e.g. +ids=h1at4d57xlmy,gyqgg0d3v9n1+.
+    #
+    #   *Important notes:*
+    #   * The +ids+ parameter cannot be used with any other ordering or filtering
+    #     parameters (+limit+, +order+, +sort+, +begin_time+, +end_time+, etc)
+    #   * Invalid or unknown IDs will be ignored, so you should check that the
+    #     results correspond to your request.
+    #   * Records are returned in an arbitrary order. Since results are all
+    #     returned at once you can sort the records yourself.
+    #
     # @param limit [Integer] Limit number of records 1-200.
     # @param order [String] Sort order.
-    # @param sort [String] Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.
-    # @param begin_time [DateTime] Filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
-    # @param end_time [DateTime] Filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    # @param sort [String] Sort field. You *really* only want to sort by +updated_at+ in ascending
+    #   order. In descending order updated records will move behind the cursor and could
+    #   prevent some records from being returned.
+    #
+    # @param begin_time [DateTime] Filter by begin_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
+    # @param end_time [DateTime] Filter by end_time when +sort=created_at+ or +sort=updated_at+.
+    #   *Note:* this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.
+    #
     # @param type [String] Filter by type field.
     # @param success [String] Filter by success field.
     # @return [Pager<Resources::Transaction>] A list of the site's transactions.
@@ -898,7 +1354,7 @@ module Recurly
 
     # Fetch a transaction
     #
-    # @param transaction_id [String] Transaction ID or UUID (use prefix: `uuid-`, e.g. `uuid-123457890`).
+    # @param transaction_id [String] Transaction ID or UUID (use prefix: +uuid-+, e.g. +uuid-123457890+).
     # @return [Resources::Transaction] A transaction.
     def get_transaction(transaction_id:)
       path = interpolate_path("/sites/{site_id}/transactions/{transaction_id}", site_id: site_id, transaction_id: transaction_id)
@@ -907,7 +1363,7 @@ module Recurly
 
     # Fetch a unique coupon code
     #
-    # @param unique_coupon_code_id [String] Unique Coupon Code ID or code (use prefix: `code-`, e.g. `code-abc-8dh2-def`).
+    # @param unique_coupon_code_id [String] Unique Coupon Code ID or code (use prefix: +code-+, e.g. +code-abc-8dh2-def+).
     # @return [Resources::UniqueCouponCode] A unique coupon code.
     def get_unique_coupon_code(unique_coupon_code_id:)
       path = interpolate_path("/sites/{site_id}/unique_coupon_codes/{unique_coupon_code_id}", site_id: site_id, unique_coupon_code_id: unique_coupon_code_id)
@@ -916,7 +1372,7 @@ module Recurly
 
     # Deactivate a unique coupon code
     #
-    # @param unique_coupon_code_id [String] Unique Coupon Code ID or code (use prefix: `code-`, e.g. `code-abc-8dh2-def`).
+    # @param unique_coupon_code_id [String] Unique Coupon Code ID or code (use prefix: +code-+, e.g. +code-abc-8dh2-def+).
     # @return [Resources::UniqueCouponCode] A unique coupon code.
     def deactivate_unique_coupon_code(unique_coupon_code_id:)
       path = interpolate_path("/sites/{site_id}/unique_coupon_codes/{unique_coupon_code_id}", site_id: site_id, unique_coupon_code_id: unique_coupon_code_id)
@@ -925,7 +1381,7 @@ module Recurly
 
     # Restore a unique coupon code
     #
-    # @param unique_coupon_code_id [String] Unique Coupon Code ID or code (use prefix: `code-`, e.g. `code-abc-8dh2-def`).
+    # @param unique_coupon_code_id [String] Unique Coupon Code ID or code (use prefix: +code-+, e.g. +code-abc-8dh2-def+).
     # @return [Resources::UniqueCouponCode] A unique coupon code.
     def reactivate_unique_coupon_code(unique_coupon_code_id:)
       path = interpolate_path("/sites/{site_id}/unique_coupon_codes/{unique_coupon_code_id}/restore", site_id: site_id, unique_coupon_code_id: unique_coupon_code_id)