RubyGems - recurly - Versions diffs - 4.85.1 → 4.86.0 - Mend

recurly 4.85.1 → 4.86.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

checksums.yaml +4 -4
data/.bumpversion.cfg +1 -1
data/CHANGELOG.md +11 -0
data/GETTING_STARTED.md +1 -1
data/lib/recurly/requests/billing_info_create.rb +4 -0
data/lib/recurly/requests/payment_gateway_references.rb +1 -1
data/lib/recurly/resources/payment_gateway_references.rb +1 -1
data/lib/recurly/resources/subscription_change.rb +4 -0
data/lib/recurly/version.rb +1 -1
data/openapi/api.yaml +313 -2
metadata +3 -3

data/openapi/api.yaml CHANGED Viewed

@@ -448,6 +448,7 @@ paths:
       tags:
       - Site
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -613,6 +614,7 @@ paths:
       tags:
       - Site
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/site_id"
       responses:
         '200':
@@ -824,10 +826,13 @@ paths:
       tags:
       - Account
       operationId: list_accounts
+      x-product:
+      - recover
       summary: List a site's accounts
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -1001,6 +1006,8 @@ paths:
       - Account
       operationId: create_account
       summary: Create an account
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -1480,7 +1487,11 @@ paths:
       tags:
       - Account
       operationId: get_account
+      x-product:
+      - recover
       summary: Fetch an account
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: An account.
@@ -1685,6 +1696,8 @@ paths:
       - Account
       operationId: update_account
       summary: Update an account
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -1979,6 +1992,7 @@ paths:
         until the end of the current billing cycle before expiring). We recommend
         closing accounts only when all business is concluded with a customer.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - in: query
         name: redact
         schema:
@@ -2197,6 +2211,8 @@ paths:
       tags:
       - Account
       operationId: redact_account
+      x-product:
+      - recover
       summary: Redact an account (GDPR Right to Erasure)
       description: Permanently and irreversibly removes all personally identifiable
         information (PII) from an account to fulfill a data subject's right to erasure
@@ -2207,6 +2223,8 @@ paths:
         are cleared. The account must have no active subscriptions, uninvoiced charges,
         or partially paid invoices before it can be redacted. Redaction is processed
         asynchronously and cannot be undone.
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: Account has been accepted for redaction and will be processed
@@ -2237,6 +2255,8 @@ paths:
       - Account Acquisition Info
       operationId: get_account_acquisition
       summary: Fetch an account's acquisition data
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: An account's acquisition data.
@@ -2442,6 +2462,8 @@ paths:
       - Account Acquisition Info
       operationId: update_account_acquisition
       summary: Update an account's acquisition data
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -2748,6 +2770,8 @@ paths:
       - Account Acquisition Info
       operationId: remove_account_acquisition
       summary: Remove an account's acquisition data
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '204':
           description: Acquisition data was succesfully deleted.
@@ -2949,6 +2973,8 @@ paths:
       summary: Reactivate an inactive account
       description: Reactivating an account will restore its history but the customer
         will need to provide new billing information to continue billing.
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: An account.
@@ -3166,6 +3192,8 @@ paths:
       - Account
       operationId: get_account_balance
       summary: Fetch an account's balance and past due status
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: An account's balance.
@@ -3378,6 +3406,7 @@ paths:
       operationId: get_billing_info
       summary: Fetch an account's billing information
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       responses:
         '200':
@@ -3610,6 +3639,7 @@ paths:
         - gateway_token
         - gateway_code
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -3887,6 +3917,7 @@ paths:
       operationId: remove_billing_info
       summary: Remove an account's billing information
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       description: You may remove any stored billing information for an account. If
         the account has a subscription, the renewal will go into dunning unless the
@@ -4090,6 +4121,7 @@ paths:
       operationId: verify_billing_info
       summary: Verify an account's credit card billing information
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -4319,6 +4351,7 @@ paths:
       operationId: verify_billing_info_cvv
       summary: Verify an account's credit card billing cvv
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -4362,6 +4395,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/sort_dates"
@@ -4412,6 +4446,7 @@ paths:
         - gateway_token
         - gateway_code
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -4453,6 +4488,7 @@ paths:
       operationId: get_a_billing_info
       summary: Fetch a billing info
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/billing_info_id"
       responses:
@@ -4494,6 +4530,7 @@ paths:
         - gateway_token
         - gateway_code
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/billing_info_id"
       requestBody:
@@ -4535,6 +4572,7 @@ paths:
       operationId: remove_a_billing_info
       summary: Remove an account's billing information
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/billing_info_id"
       description: You may remove any stored billing information for an account. If
@@ -4565,6 +4603,7 @@ paths:
       operationId: verify_billing_infos
       summary: Verify a billing information's credit card
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/billing_info_id"
       requestBody:
@@ -4608,6 +4647,7 @@ paths:
       operationId: verify_billing_infos_cvv
       summary: Verify a billing information's credit card cvv
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/billing_info_id"
       requestBody:
@@ -4658,6 +4698,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/sort_dates"
@@ -4824,6 +4865,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       responses:
         '200':
@@ -4968,6 +5010,7 @@ paths:
       operationId: create_coupon_redemption
       summary: Generate an active coupon redemption on an account or subscription
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -5198,6 +5241,7 @@ paths:
       operationId: remove_coupon_redemption
       summary: Delete the active coupon redemption from an account
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       responses:
         '200':
@@ -5407,6 +5451,7 @@ paths:
       operationId: get_coupon_redemption
       summary: Show the coupon redemption
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/coupon_redemption_id"
       responses:
@@ -5436,6 +5481,7 @@ paths:
       summary: Delete the coupon redemption
       description: Deactivate the coupon redemption on an account.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/coupon_redemption_id"
       responses:
@@ -5473,6 +5519,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -5654,6 +5701,8 @@ paths:
       - External Account
       operationId: list_account_external_account
       summary: List external accounts for an account
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: A list of external accounts on an account.
@@ -5691,6 +5740,8 @@ paths:
       - External Account
       operationId: create_account_external_account
       summary: Create an external account
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -5737,6 +5788,8 @@ paths:
       - External Account
       operationId: get_account_external_account
       summary: Get an external account for an account
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: A external account on an account.
@@ -5774,6 +5827,8 @@ paths:
       - External Account
       operationId: update_account_external_account
       summary: Update an external account
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -5816,6 +5871,8 @@ paths:
       - External Account
       operationId: delete_account_external_account
       summary: Delete an external account for an account
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: Successful Delete
@@ -5859,6 +5916,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/sort_dates"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -5887,10 +5945,13 @@ paths:
       tags:
       - Invoice
       operationId: list_account_invoices
+      x-product:
+      - recover
       summary: List an account's invoices
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/invoice_state"
@@ -6063,6 +6124,7 @@ paths:
       operationId: create_invoice
       summary: Create an invoice for pending line items
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -6365,6 +6427,7 @@ paths:
       operationId: preview_invoice
       summary: Preview new invoice for pending line items
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -6668,6 +6731,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -6845,6 +6909,7 @@ paths:
       description: When using the Credit Invoices feature, utilize the purchases endpoint
         in order to immediately post credit to a credit invoice.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -7152,6 +7217,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       responses:
@@ -7301,6 +7367,7 @@ paths:
       operationId: create_account_note
       summary: Create an account note
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -7347,6 +7414,7 @@ paths:
       operationId: get_account_note
       summary: Fetch an account note
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/account_note_id"
       responses:
@@ -7568,6 +7636,7 @@ paths:
       operationId: remove_account_note
       summary: Delete an account note
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/account_note_id"
       responses:
@@ -7595,6 +7664,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -7760,6 +7830,7 @@ paths:
       operationId: create_shipping_address
       summary: Create a new shipping address for the account
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       requestBody:
         content:
@@ -8107,6 +8178,7 @@ paths:
       operationId: get_shipping_address
       summary: Fetch an account's shipping address
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/shipping_address_id"
       responses:
@@ -8326,6 +8398,7 @@ paths:
       operationId: update_shipping_address
       summary: Update an account's shipping address
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/shipping_address_id"
       requestBody:
@@ -8629,6 +8702,7 @@ paths:
       operationId: remove_shipping_address
       summary: Remove an account's shipping address
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/shipping_address_id"
       responses:
@@ -8837,6 +8911,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -9007,10 +9082,13 @@ paths:
       tags:
       - Transaction
       operationId: list_account_transactions
+      x-product:
+      - recover
       summary: List an account's transactions
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -9188,6 +9266,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/account_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -9315,6 +9394,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -9482,6 +9562,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -9652,6 +9733,8 @@ paths:
       - Coupon
       operationId: create_coupon
       summary: Create a new coupon
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -10015,6 +10098,7 @@ paths:
       operationId: get_coupon
       summary: Fetch a coupon
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/coupon_id"
       responses:
         '200':
@@ -10227,6 +10311,7 @@ paths:
       operationId: update_coupon
       summary: Update an active coupon
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/coupon_id"
       requestBody:
         content:
@@ -10498,6 +10583,7 @@ paths:
       operationId: deactivate_coupon
       summary: Expire a coupon
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/coupon_id"
       description: Mark an existing Coupon as expired
       responses:
@@ -10693,6 +10779,7 @@ paths:
       operationId: generate_unique_coupon_codes
       summary: Generate unique coupon codes
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/coupon_id"
       requestBody:
         content:
@@ -10738,6 +10825,7 @@ paths:
         them directly in the response. For larger batches, use the asynchronous generate
         endpoint instead.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/coupon_id"
       requestBody:
         content:
@@ -10786,6 +10874,7 @@ paths:
       description: Make an expired coupon redeemable again. You can change editable
         fields in this call.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/coupon_id"
       requestBody:
         content:
@@ -10834,6 +10923,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/coupon_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -10871,6 +10961,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
       - "$ref": "#/components/parameters/sort_dates"
@@ -11043,6 +11134,7 @@ paths:
       operationId: get_credit_payment
       summary: Fetch a credit payment
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/credit_payment_id"
       responses:
         '200':
@@ -11073,6 +11165,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -11252,6 +11345,7 @@ paths:
       operationId: get_custom_field_definition
       summary: Fetch an custom field definition
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/custom_field_definition_id"
       responses:
         '200':
@@ -11464,6 +11558,8 @@ paths:
       - General Ledger Account
       operationId: create_general_ledger_account
       summary: Create a new general ledger account
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -11492,6 +11588,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -11518,6 +11615,7 @@ paths:
       operationId: get_general_ledger_account
       summary: Fetch a general ledger account
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/general_ledger_account_id"
       responses:
         '200':
@@ -11539,6 +11637,7 @@ paths:
       operationId: update_general_ledger_account
       summary: Update a general ledger account
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/general_ledger_account_id"
       requestBody:
         content:
@@ -11567,6 +11666,7 @@ paths:
       operationId: get_performance_obligation
       summary: Get a single Performance Obligation.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/performance_obligation_id"
       responses:
         '200':
@@ -11588,6 +11688,8 @@ paths:
       - Performance Obligations
       operationId: get_performance_obligations
       summary: Get a site's Performance Obligations
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: A list of Performance Obligations.
@@ -11611,6 +11713,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/invoice_template_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -11656,6 +11759,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -11827,6 +11931,8 @@ paths:
       - Item
       operationId: create_item
       summary: Create a new item
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -12215,6 +12321,7 @@ paths:
       operationId: get_item
       summary: Fetch an item
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/item_id"
       responses:
         '200':
@@ -12427,6 +12534,7 @@ paths:
       operationId: update_item
       summary: Update an active item
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/item_id"
       requestBody:
         content:
@@ -12723,6 +12831,7 @@ paths:
       operationId: deactivate_item
       summary: Deactivate an item
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/item_id"
       description: Deactivating an item makes it unavailable for new purchases. It
         will not affect existing line items.
@@ -12939,6 +13048,8 @@ paths:
       summary: Reactivate an inactive item
       description: Reactivating an item makes it available for new purchases. It will
         not affect existing line items.
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: An item.
@@ -13157,6 +13268,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -13189,6 +13301,8 @@ paths:
       - Measured Unit
       operationId: create_measured_unit
       summary: Create a new measured unit
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -13234,6 +13348,7 @@ paths:
       operationId: get_measured_unit
       summary: Fetch a measured unit
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/measured_unit_id"
       responses:
         '200':
@@ -13261,6 +13376,7 @@ paths:
       operationId: update_measured_unit
       summary: Update a measured unit
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/measured_unit_id"
       requestBody:
         content:
@@ -13307,6 +13423,7 @@ paths:
       summary: Remove a measured unit
       description: A mesured unit cannot be deleted if it is used by an active plan.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/measured_unit_id"
       responses:
         '200':
@@ -13337,6 +13454,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/sort_dates"
       responses:
         '200':
@@ -13363,6 +13481,8 @@ paths:
       - External Product
       operationId: create_external_product
       summary: Create an external product
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -13403,6 +13523,8 @@ paths:
       - External Product
       operationId: get_external_product
       summary: Fetch an external product
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: Settings for an external product.
@@ -13428,6 +13550,8 @@ paths:
       - External Product
       operationId: update_external_product
       summary: Update an external product
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -13460,6 +13584,8 @@ paths:
       operationId: deactivate_external_products
       summary: Deactivate an external product
       description: Deactivate an external product.
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: Deactivated external product.
@@ -13491,6 +13617,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/sort_dates"
       responses:
         '200':
@@ -13518,6 +13645,8 @@ paths:
       - External Product Reference
       operationId: create_external_product_external_product_reference
       summary: Create an external product reference on an external product
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -13553,6 +13682,8 @@ paths:
       - External Product Reference
       operationId: get_external_product_external_product_reference
       summary: Fetch an external product reference
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: Details for an external product reference.
@@ -13578,6 +13709,8 @@ paths:
       - External Product Reference
       operationId: deactivate_external_product_external_product_reference
       summary: Deactivate an external product reference
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: Details for an external product reference.
@@ -13604,6 +13737,8 @@ paths:
       - External Subscription
       operationId: create_external_subscription
       summary: Create an external subscription
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -13645,6 +13780,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/sort_dates"
       responses:
         '200':
@@ -13669,6 +13805,7 @@ paths:
   "/external_subscriptions/{external_subscription_id}":
     get:
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/external_subscription_id_fetch"
       tags:
       - External Subscription
@@ -13703,6 +13840,7 @@ paths:
       x-code-samples: []
     put:
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/external_subscription_id"
       tags:
       - External Subscription
@@ -13758,6 +13896,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/sort_dates"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -13786,6 +13925,8 @@ paths:
       - External Invoice
       operationId: create_external_invoice
       summary: Create an external invoice
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -13824,10 +13965,13 @@ paths:
       tags:
       - Invoice
       operationId: list_invoices
+      x-product:
+      - recover
       summary: List a site's invoices
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/invoice_state"
       - "$ref": "#/components/parameters/limit"
@@ -14000,8 +14144,11 @@ paths:
       tags:
       - Invoice
       operationId: get_invoice
+      x-product:
+      - recover
       summary: Fetch an invoice
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/invoice_id"
       responses:
         '200':
@@ -14214,6 +14361,7 @@ paths:
       operationId: update_invoice
       summary: Update an invoice
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/invoice_id"
       requestBody:
         content:
@@ -14491,6 +14639,7 @@ paths:
       operationId: get_invoice_pdf
       summary: Fetch an invoice as a PDF
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/invoice_id"
       responses:
         '200':
@@ -14747,6 +14896,7 @@ paths:
       description: Apply credit payment to the outstanding balance on an existing
         charge invoice from an account’s available balance from existing credit invoices.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/invoice_id"
       responses:
         '200':
@@ -14970,6 +15120,7 @@ paths:
       description: Force a collection attempt using the stored billing information.
         This will trigger a transaction outside of Recurly's normal retry logic.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/invoice_id"
       requestBody:
         content:
@@ -15193,12 +15344,15 @@ paths:
       tags:
       - Invoice
       operationId: mark_invoice_failed
+      x-product:
+      - recover
       summary: Mark an open invoice as failed
       description: |
         Indicates that the invoice was not successfully paid for and that collection attempts should stop. This functionality is mostly used to halt the dunning procedures for an invoice.
         Only invoices with the `pending`, `processing` or `past_due` states can be marked as failed.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/invoice_id"
       responses:
         '200':
@@ -15416,12 +15570,15 @@ paths:
       tags:
       - Invoice
       operationId: mark_invoice_successful
+      x-product:
+      - recover
       summary: Mark an open invoice as successful
       description: |
         Indicates that the invoice was successfully paid for and that automated collection attempts should stop - this functionality is typically used to indicate that payment was received via another method and that revenue should be recognized.
         Only invoices with the `pending`, `processing`, `past_due` or `failed` states can be marked as paid.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/invoice_id"
       responses:
         '200':
@@ -15647,6 +15804,7 @@ paths:
       operationId: reopen_invoice
       summary: Reopen a closed, manual invoice
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/invoice_id"
       responses:
         '200':
@@ -15869,6 +16027,7 @@ paths:
       description: Invoice must be a credit invoice (`type=credit`) and cannot be
         closed (`state=closed`), processing (`state=processing`), or already voided.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/invoice_id"
       responses:
         '200':
@@ -16054,6 +16213,7 @@ paths:
         not captured through your gateway. It will throw an error for an auto-collecting
         invoice.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/invoice_id"
       requestBody:
         content:
@@ -16141,6 +16301,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/invoice_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -16326,6 +16487,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/invoice_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/sort_dates"
@@ -16493,6 +16655,7 @@ paths:
         See the [Pagination Guide](/developers/guides/pagination.html) to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/invoice_id"
       responses:
         '200':
@@ -16654,6 +16817,7 @@ paths:
         * Apply a refund to one or more individual line items on an invoice. A line item can be refunded by a quantity amount, a specific dollar/cent amount, or a percentage amount and will only apply to the specific line item you are aiming to refund.
           * Note: You must have the Credit Memos feature flag enabled on your site to utilize specific dollar/cent amount and percentage amount refunds on line items.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/invoice_id"
       requestBody:
         content:
@@ -16941,7 +17105,11 @@ paths:
       tags:
       - Revenue Recovery
       operationId: create_invoice_retry
+      x-product:
+      - recover
       summary: Create an invoice for revenue recovery
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -16990,6 +17158,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -17169,6 +17338,7 @@ paths:
       operationId: get_line_item
       summary: Fetch a line item
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/line_item_id"
       responses:
         '200':
@@ -17381,6 +17551,7 @@ paths:
       operationId: remove_line_item
       summary: Delete an uninvoiced line item
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/line_item_id"
       responses:
         '204':
@@ -17598,6 +17769,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -17769,6 +17941,8 @@ paths:
       - Plan
       operationId: create_plan
       summary: Create a plan
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -18135,6 +18309,7 @@ paths:
       operationId: get_plan
       summary: Fetch a plan
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/plan_id"
       responses:
         '200':
@@ -18347,6 +18522,7 @@ paths:
       operationId: update_plan
       summary: Update a plan
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/plan_id"
       requestBody:
         content:
@@ -18609,6 +18785,7 @@ paths:
       operationId: remove_plan
       summary: Remove a plan
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/plan_id"
       responses:
         '200':
@@ -18814,6 +18991,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/plan_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -18985,6 +19163,7 @@ paths:
       operationId: create_plan_add_on
       summary: Create an add-on
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/plan_id"
       requestBody:
         content:
@@ -19348,6 +19527,7 @@ paths:
       operationId: get_plan_add_on
       summary: Fetch a plan's add-on
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/plan_id"
       - "$ref": "#/components/parameters/add_on_id"
       responses:
@@ -19565,6 +19745,7 @@ paths:
       operationId: update_plan_add_on
       summary: Update an add-on
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/plan_id"
       - "$ref": "#/components/parameters/add_on_id"
       requestBody:
@@ -19818,6 +19999,7 @@ paths:
       operationId: remove_plan_add_on
       summary: Remove an add-on
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/plan_id"
       - "$ref": "#/components/parameters/add_on_id"
       responses:
@@ -20019,6 +20201,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -20055,6 +20238,7 @@ paths:
       operationId: get_price_segment
       summary: Fetch a price segment
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/price_segment_id"
       responses:
         '200':
@@ -20085,6 +20269,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -20254,6 +20439,7 @@ paths:
       operationId: get_add_on
       summary: Fetch an add-on
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/add_on_id"
       responses:
         '200':
@@ -20469,6 +20655,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -20635,6 +20822,8 @@ paths:
       - Shipping Method
       operationId: create_shipping_method
       summary: Create a new shipping method
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -20680,6 +20869,7 @@ paths:
       operationId: get_shipping_method
       summary: Fetch a shipping method
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/shipping_method_id"
       responses:
         '200':
@@ -20707,6 +20897,7 @@ paths:
       operationId: update_shipping_method
       summary: Update an active Shipping Method
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/shipping_method_id"
       requestBody:
         content:
@@ -20752,6 +20943,7 @@ paths:
       operationId: deactivate_shipping_method
       summary: Deactivate a shipping method
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/shipping_method_id"
       description: Deactivating a shipping method makes it unavailable for new subscriptions
         or purchases. It will not affect existing subscriptions.
@@ -20784,6 +20976,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -20955,6 +21148,8 @@ paths:
       - Subscription
       operationId: create_subscription
       summary: Create a new subscription
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -21280,6 +21475,7 @@ paths:
       operationId: get_subscription
       summary: Fetch a subscription
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       responses:
         '200':
@@ -21499,6 +21695,7 @@ paths:
         impact on the billed amount. Use the [Create Subscription Change](#operation/create_subscription_change)
         endpoint to make those changes.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       requestBody:
         content:
@@ -21773,6 +21970,7 @@ paths:
         If the subscription has a paid invoice you may choose to refund all, part or none of last invoice's amount.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       - name: refund
         in: query
@@ -22041,6 +22239,7 @@ paths:
         until the end of the billing cycle. When a future subscription (`state=future`)
         is canceled it becomes failed `state=failed` and cannot be reactivated.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       requestBody:
         content:
@@ -22278,6 +22477,7 @@ paths:
         Expired or failed subscriptions cannot be reactivated; instead a new subscription plan will need to be applied to the account.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       responses:
         '200':
@@ -22511,6 +22711,7 @@ paths:
         Expired, cancelled, or failed subscriptions cannot be paused.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       requestBody:
         content:
@@ -22780,6 +22981,7 @@ paths:
         The subscription must be in the paused state. Active, expired, cancelled,
         or failed subscriptions cannot be resumed.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       responses:
         '200':
@@ -23010,6 +23212,7 @@ paths:
         in trial. The subscription must be in a trial. Active, paused, expired, cancelled,
         or failed subscriptions cannot be converted.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       responses:
         '200':
@@ -23048,6 +23251,7 @@ paths:
         exist; if they don't (for example, if the subscription is not set to renew),
         it will return an result with no invoices.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       responses:
         '200':
@@ -23271,6 +23475,7 @@ paths:
       operationId: get_subscription_change
       summary: Fetch a subscription's pending change
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       responses:
         '200':
@@ -23510,6 +23715,7 @@ paths:
         change, and a change is submitted which matches the subscription as it currently
         exists, a 422 Unprocessable Entity validation error will be returned.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       requestBody:
         content:
@@ -23795,6 +24001,7 @@ paths:
       operationId: remove_subscription_change
       summary: Delete the pending subscription change
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       description: Deleting the pending subscription change will cause the current
         subscription settings to be used on the next renewal.
@@ -24008,6 +24215,7 @@ paths:
       description: Calling this will not save the subscription change or overwrite
         an existing change.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       requestBody:
         content:
@@ -24051,6 +24259,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/invoice_state"
@@ -24227,6 +24436,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
@@ -24405,6 +24615,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/sort_dates"
@@ -24570,6 +24781,7 @@ paths:
       operationId: get_subscription_coupon_redemption
       summary: Show the coupon redemption for a subscription
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       - "$ref": "#/components/parameters/coupon_redemption_id"
       responses:
@@ -24599,6 +24811,7 @@ paths:
       summary: Delete the coupon redemption from a subscription
       description: Deactivate the coupon redemption on a subscription.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       - "$ref": "#/components/parameters/coupon_redemption_id"
       responses:
@@ -24634,6 +24847,7 @@ paths:
       operationId: list_usage
       summary: List a subscription add-on's usage records
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       - "$ref": "#/components/parameters/add_on_id"
       - "$ref": "#/components/parameters/ids"
@@ -24675,6 +24889,7 @@ paths:
       operationId: create_usage
       summary: Log a usage record on this subscription add-on
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/subscription_id"
       - "$ref": "#/components/parameters/add_on_id"
       requestBody:
@@ -24722,6 +24937,7 @@ paths:
       operationId: get_usage
       summary: Get a usage record
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/usage_id"
       responses:
         '200':
@@ -24755,6 +24971,7 @@ paths:
       operationId: update_usage
       summary: Update a usage record
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/usage_id"
       requestBody:
         content:
@@ -24800,6 +25017,7 @@ paths:
       operationId: remove_usage
       summary: Delete a usage record.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/usage_id"
       responses:
         '204':
@@ -24834,10 +25052,13 @@ paths:
       tags:
       - Transaction
       operationId: list_transactions
+      x-product:
+      - recover
       summary: List a site's transactions
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -25010,8 +25231,11 @@ paths:
       tags:
       - Transaction
       operationId: get_transaction
+      x-product:
+      - recover
       summary: Fetch a transaction
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/transaction_id"
       responses:
         '200':
@@ -25226,6 +25450,8 @@ paths:
       - Unique Coupon Code
       operationId: get_unique_coupon_code
       summary: Fetch a unique coupon code
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: A unique coupon code.
@@ -25253,6 +25479,8 @@ paths:
       summary: Deactivate a unique coupon code
       description: Expire a unique code, making that specific code no longer redeemable.
         The parent bulk coupon will not be affected.
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: A unique coupon code.
@@ -25287,6 +25515,8 @@ paths:
       - Unique Coupon Code
       operationId: reactivate_unique_coupon_code
       summary: Restore a unique coupon code
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: A unique coupon code.
@@ -25322,6 +25552,8 @@ paths:
       description: A purchase is a checkout containing at least one or more subscriptions
         or one-time charges (line items) and supports both coupon and gift card redemptions.
         All items purchased will be on one invoice and paid for with one transaction.
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -25768,6 +26000,8 @@ paths:
       description: A purchase is a checkout containing at least one or more subscriptions
         or one-time charges (line items) and supports both coupon and gift card redemptions.
         All items purchased will be on one invoice and paid for with one transaction.
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -26211,6 +26445,8 @@ paths:
         For additional information regarding shipping fees, please see https://docs.recurly.com/docs/shipping
         Note: an email address is required on the account for a Pending Purchase.
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -26712,6 +26948,8 @@ paths:
         The authorize endpoint will create a pending purchase that can be activated at a later time once payment has been completed on an external source.
         For additional information regarding shipping fees, please see https://docs.recurly.com/docs/shipping
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -26749,6 +26987,7 @@ paths:
       tags:
       - Purchase
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/transaction_id"
       operationId: create_capture_purchase
       summary: Capture a purchase
@@ -26800,6 +27039,8 @@ paths:
       tags:
       - Purchase
       operationId: cancelPurchase
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: Returns the cancelled invoice
@@ -26834,6 +27075,8 @@ paths:
       summary: List the dates that have an available export to download.
       description: Returns a list of dates for which export files are available for
         download.
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: Returns a list of dates.
@@ -27031,6 +27274,8 @@ paths:
       summary: List of the export files that are available to download.
       description: Returns a list of presigned URLs to download export files for the
         given date, with their MD5 sums.
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: Returns a list of export files to download.
@@ -27223,10 +27468,13 @@ paths:
       tags:
       - Dunning Campaigns
       operationId: list_dunning_campaigns
+      x-product:
+      - recover
       summary: List the dunning campaigns for a site
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/sort_dates"
       responses:
         '200':
@@ -27253,6 +27501,8 @@ paths:
       - Dunning Campaigns
       operationId: create_dunning_campaign
       summary: Create a new dunning campaign
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -27311,7 +27561,11 @@ paths:
       tags:
       - Dunning Campaigns
       operationId: get_dunning_campaign
+      x-product:
+      - recover
       summary: Fetch a dunning campaign
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: Settings for a dunning campaign.
@@ -27345,6 +27599,8 @@ paths:
       summary: Update a dunning campaign
       description: Each cycle write is a full replacement of that cycle's settings;
         omitted scalars fall back to the model default rather than the prior version.
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -27402,6 +27658,8 @@ paths:
       operationId: deactivate_dunning_campaign
       summary: Deactivate a dunning campaign
       description: The default dunning campaign cannot be deactivated.
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: The deactivated dunning campaign.
@@ -27440,6 +27698,8 @@ paths:
       - Dunning Campaigns
       operationId: list_dunning_campaign_email_templates
       summary: List the custom email templates assignable to a dunning campaign interval
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: A list of the site's assignable custom email templates.
@@ -27475,6 +27735,8 @@ paths:
       - Dunning Campaigns
       operationId: put_dunning_campaign_bulk_update
       summary: Assign a dunning campaign to multiple plans
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -27515,6 +27777,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/sort_dates"
       responses:
         '200':
@@ -27544,6 +27807,8 @@ paths:
       - Invoice Templates
       operationId: get_invoice_template
       summary: Fetch an invoice template
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: Settings for an invoice template.
@@ -27579,6 +27844,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/sort_dates"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -27610,6 +27876,8 @@ paths:
       - External Invoice
       operationId: show_external_invoice
       summary: Fetch an external invoice
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '201':
           description: Returns the external invoice
@@ -27647,6 +27915,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/sort_dates"
       - "$ref": "#/components/parameters/limit"
       - "$ref": "#/components/parameters/order"
@@ -27679,6 +27948,8 @@ paths:
       - External Payment Phase
       operationId: get_external_subscription_external_payment_phase
       summary: Fetch an external payment phase
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: Details for an external payment phase.
@@ -27708,6 +27979,8 @@ paths:
       - Account
       operationId: list_entitlements
       summary: List entitlements granted to an account
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: A list of the entitlements granted to an account.
@@ -27739,6 +28012,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/sort_dates"
       responses:
         '200':
@@ -27768,6 +28042,8 @@ paths:
       - Business Entities
       operationId: get_business_entity
       summary: Fetch a business entity
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: Business entity details
@@ -27794,6 +28070,8 @@ paths:
       - Business Entities
       operationId: list_business_entities
       summary: List business entities
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: List of all business entities on your site.
@@ -27820,6 +28098,8 @@ paths:
       - Gift Cards
       operationId: list_gift_cards
       summary: List gift cards
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: List of all created gift cards on your site.
@@ -27845,6 +28125,8 @@ paths:
       - Gift Cards
       operationId: create_gift_card
       summary: Create gift card
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -27885,6 +28167,8 @@ paths:
       - Gift Cards
       operationId: get_gift_card
       summary: Fetch a gift card
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       responses:
         '200':
           description: Gift card details
@@ -27911,6 +28195,8 @@ paths:
       - Gift Cards
       operationId: preview_gift_card
       summary: Preview gift card
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -27951,6 +28237,8 @@ paths:
       - Gift Cards
       operationId: redeem_gift_card
       summary: Redeem gift card
+      parameters:
+      - "$ref": "#/components/parameters/accept_header"
       requestBody:
         content:
           application/json:
@@ -27992,6 +28280,7 @@ paths:
       description: See the [Pagination Guide](/developers/guides/pagination.html)
         to learn how to use pagination in the API and Client Libraries.
       parameters:
+      - "$ref": "#/components/parameters/accept_header"
       - "$ref": "#/components/parameters/business_entity_id"
       - "$ref": "#/components/parameters/ids"
       - "$ref": "#/components/parameters/invoice_state"
@@ -28032,6 +28321,15 @@ servers:
 - url: https://v3.eu.recurly.com
 components:
   parameters:
+    accept_header:
+      name: Accept
+      in: header
+      description: The API version to use for this request, e.g. `application/vnd.recurly.v2021-02-25`.
+        Requests without a versioned `Accept` header return a 406 response.
+      required: true
+      schema:
+        default: application/vnd.recurly.v2021-02-25
+        "$ref": "#/components/schemas/AcceptHeaderEnum"
     site_id:
       name: site_id
       in: path
@@ -28536,6 +28834,11 @@ components:
         page.
       scheme: basic
   schemas:
+    AcceptHeaderEnum:
+      type: string
+      enum:
+      - application/vnd.recurly.v2021-02-25
+      - application/vnd.recurly.v2021-02-25+json
     Empty:
       type: object
       properties: {}
@@ -30559,6 +30862,12 @@ components:
           type: string
           title: An identifier for a specific payment gateway.
           maxLength: 12
+        backup_gateway_code:
+          type: string
+          title: Identifies a backup gateway. Applies only when `gateway_code` is
+            provided and that gateway is in failover. Providing this code overrides
+            gateway exclusion configurations and restricts the backup to this gateway.
+          maxLength: 12
         payment_gateway_references:
           type: array
           description: Array of Payment Gateway References, each a reference to a
@@ -35118,6 +35427,8 @@ components:
           type: boolean
           title: Activated?
           description: Returns `true` if the subscription change is activated.
+        price_segment_id:
+          "$ref": "#/components/schemas/PriceSegmentId"
         revenue_schedule_type:
           title: Revenue schedule type
           "$ref": "#/components/schemas/RevenueScheduleTypeEnum"
@@ -38713,8 +39024,8 @@ components:
       - post
     PaymentGatewayReferencesEnum:
       type: string
-      description: The type of reference token. Required if token is passed in for
-        Stripe Gateway or Ebanx UPI.
+      description: The type of reference token. The value can be omitted for gateways
+        that only support one type of token.
       enum:
       - stripe_confirmation_token
       - upi_vpa