sellapp 0.1.1 → 0.2.1

data/docs/resources/subscriptions.md

@@ -65,22 +65,28 @@ Documented HTTP responses: 200, 400, 401, 403, 404, 422, 429, 500. See the API r
 
 [Response access, transport controls, pagination, and typed errors](../usage.md)
 
-## get_capabilities
+## list_subscriptions
 
-View subscription capabilities
+List subscriptions
 
-[API reference](https://sell.app/docs/api/subscriptions/view-subscription-capabilities) · Effect: **read**
+[API reference](https://sell.app/docs/api/subscriptions/read-subscriptions) · Effect: **read**
 
 ```ruby
-def get_capabilities(
-      product_subscription:,
+def list_subscriptions(
+      limit: 15,
+      page: 1,
+      pagination: true,
+      status: nil,
       request_options: {}
     )
 ```
 
 | Argument | Native type | Required |
 | --- | --- | --- |
-| product_subscription | `Object` | Yes |
+| limit | `Object` | No |
+| page | `Object` | No |
+| pagination | `Object` | No |
+| status | `Object` | No |
 | request_options | `Object` | No |
 
 Returns: `Object`.
@@ -90,7 +96,7 @@ require "sellapp"
 
 client = SellApp::Client.new(base_url: ENV.fetch("SELLAPP_API_BASE_URL"), api_key: ENV.fetch("SELLAPP_API_KEY"), store: ENV.fetch("SELLAPP_STORE"))
 
-result = client.subscriptions.get_capabilities(product_subscription: 1)
+result = client.subscriptions.list_subscriptions
 puts result.inspect
 ```
 
@@ -112,21 +118,85 @@ Supported credential alternatives (each object is one alternative):
 ]
 ```
 
-Documented HTTP responses: 200, 400, 401, 403, 404, 422, 429, 500. See the API reference for field-level validation and consequences.
+Documented HTTP responses: 200, 400, 401, 403, 422, 429, 500. See the API reference for field-level validation and consequences.
 
 [Response access, transport controls, pagination, and typed errors](../usage.md)
 
-## cancel_at_period_end
+## search_subscriptions
 
-Cancel a subscription at period end
+Search subscriptions
 
-[API reference](https://sell.app/docs/api/subscriptions/cancel-at-period-end) · Effect: **consequential**
+[API reference](https://sell.app/docs/api/subscriptions/read-subscriptions) · Effect: **read**
 
 ```ruby
-def cancel_at_period_end(
+def search_subscriptions(
+      filters: nil,
+      sort: nil,
+      search: nil,
+      includes: nil,
+      limit: 15,
+      page: 1,
+      pagination: true,
+      request_options: {}
+    )
+```
+
+| Argument | Native type | Required |
+| --- | --- | --- |
+| filters | `Object` | No |
+| sort | `Object` | No |
+| search | `Object` | No |
+| includes | `Object` | No |
+| limit | `Object` | No |
+| page | `Object` | No |
+| pagination | `Object` | No |
+| request_options | `Object` | No |
+
+Returns: `Object`.
+
+```rb
+require "sellapp"
+
+client = SellApp::Client.new(base_url: ENV.fetch("SELLAPP_API_BASE_URL"), api_key: ENV.fetch("SELLAPP_API_KEY"), store: ENV.fetch("SELLAPP_STORE"))
+
+result = client.subscriptions.search_subscriptions(
+  filters: [{ field: "status", operator: "=", value: "ACTIVE" }],
+  search: { value: "maya.chen@example.com" }
+)
+puts result.inspect
+```
+
+### Authentication and errors
+
+Supported credential alternatives (each object is one alternative):
+
+```json
+[
+  {
+    "bearerAuth": []
+  },
+  {
+    "oauthAccessToken": [
+      "admin"
+    ],
+    "storeAuth": []
+  }
+]
+```
+
+Documented HTTP responses: 200, 400, 401, 403, 422, 429, 500. See the API reference for field-level validation and consequences.
+
+[Response access, transport controls, pagination, and typed errors](../usage.md)
+
+## get_subscription
+
+Retrieve a subscription
+
+[API reference](https://sell.app/docs/api/subscriptions/read-subscriptions) · Effect: **read**
+
+```ruby
+def get_subscription(
       product_subscription:,
-      idempotency_key: SellApp::OMIT,
-      reason: SellApp::OMIT,
       request_options: {}
     )
 ```
@@ -134,8 +204,6 @@ def cancel_at_period_end(
 | Argument | Native type | Required |
 | --- | --- | --- |
 | product_subscription | `Object` | Yes |
-| idempotency_key | `Object` | No |
-| reason | `Object` | No |
 | request_options | `Object` | No |
 
 Returns: `Object`.
@@ -145,10 +213,7 @@ require "sellapp"
 
 client = SellApp::Client.new(base_url: ENV.fetch("SELLAPP_API_BASE_URL"), api_key: ENV.fetch("SELLAPP_API_KEY"), store: ENV.fetch("SELLAPP_STORE"))
 
-result = client.subscriptions.cancel_at_period_end(
-  product_subscription: 55,
-  reason: "Customer request"
-)
+result = client.subscriptions.get_subscription(product_subscription: 123)
 puts result.inspect
 ```
 
@@ -174,19 +239,15 @@ Documented HTTP responses: 200, 400, 401, 403, 404, 422, 429, 500. See the API r
 
 [Response access, transport controls, pagination, and typed errors](../usage.md)
 
-## cancel_immediately
+## get_capabilities
 
-Cancel a subscription immediately
+View subscription capabilities
 
-[API reference](https://sell.app/docs/api/subscriptions/cancel-immediately) · Effect: **consequential**
+[API reference](https://sell.app/docs/api/subscriptions/view-subscription-capabilities) · Effect: **read**
 
 ```ruby
-def cancel_immediately(
+def get_capabilities(
       product_subscription:,
-      idempotency_key: SellApp::OMIT,
-      reason: SellApp::OMIT,
-      refund_last_payment: nil,
-      pro_rated_refund: nil,
       request_options: {}
     )
 ```
@@ -194,10 +255,6 @@ def cancel_immediately(
 | Argument | Native type | Required |
 | --- | --- | --- |
 | product_subscription | `Object` | Yes |
-| idempotency_key | `Object` | No |
-| reason | `Object` | No |
-| refund_last_payment | `Object` | No |
-| pro_rated_refund | `Object` | No |
 | request_options | `Object` | No |
 
 Returns: `Object`.
@@ -207,10 +264,7 @@ require "sellapp"
 
 client = SellApp::Client.new(base_url: ENV.fetch("SELLAPP_API_BASE_URL"), api_key: ENV.fetch("SELLAPP_API_KEY"), store: ENV.fetch("SELLAPP_STORE"))
 
-result = client.subscriptions.cancel_immediately(
-  product_subscription: 55,
-  reason: "Customer request"
-)
+result = client.subscriptions.get_capabilities(product_subscription: 1)
 puts result.inspect
 ```
 
@@ -236,17 +290,16 @@ Documented HTTP responses: 200, 400, 401, 403, 404, 422, 429, 500. See the API r
 
 [Response access, transport controls, pagination, and typed errors](../usage.md)
 
-## pause
+## cancel_at_period_end
 
-Pause a subscription
+Cancel a subscription at period end
 
-[API reference](https://sell.app/docs/api/subscriptions/pause-a-subscription) · Effect: **consequential**
+[API reference](https://sell.app/docs/api/subscriptions/cancel-at-period-end) · Effect: **consequential**
 
 ```ruby
-def pause(
+def cancel_at_period_end(
       product_subscription:,
       idempotency_key: SellApp::OMIT,
-      resume_at: SellApp::OMIT,
       reason: SellApp::OMIT,
       request_options: {}
     )
@@ -256,7 +309,6 @@ def pause(
 | --- | --- | --- |
 | product_subscription | `Object` | Yes |
 | idempotency_key | `Object` | No |
-| resume_at | `Object` | No |
 | reason | `Object` | No |
 | request_options | `Object` | No |
 
@@ -267,9 +319,8 @@ require "sellapp"
 
 client = SellApp::Client.new(base_url: ENV.fetch("SELLAPP_API_BASE_URL"), api_key: ENV.fetch("SELLAPP_API_KEY"), store: ENV.fetch("SELLAPP_STORE"))
 
-result = client.subscriptions.pause(
+result = client.subscriptions.cancel_at_period_end(
   product_subscription: 55,
-  resume_at: "2026-10-10T12:00:00Z",
   reason: "Customer request"
 )
 puts result.inspect
@@ -297,16 +348,19 @@ Documented HTTP responses: 200, 400, 401, 403, 404, 422, 429, 500. See the API r
 
 [Response access, transport controls, pagination, and typed errors](../usage.md)
 
-## resume
+## cancel_immediately
 
-Resume a subscription
+Cancel a subscription immediately
 
-[API reference](https://sell.app/docs/api/subscriptions/resume-a-subscription) · Effect: **consequential**
+[API reference](https://sell.app/docs/api/subscriptions/cancel-immediately) · Effect: **consequential**
 
 ```ruby
-def resume(
+def cancel_immediately(
       product_subscription:,
       idempotency_key: SellApp::OMIT,
+      reason: SellApp::OMIT,
+      refund_last_payment: nil,
+      pro_rated_refund: nil,
       request_options: {}
     )
 ```
@@ -315,6 +369,9 @@ def resume(
 | --- | --- | --- |
 | product_subscription | `Object` | Yes |
 | idempotency_key | `Object` | No |
+| reason | `Object` | No |
+| refund_last_payment | `Object` | No |
+| pro_rated_refund | `Object` | No |
 | request_options | `Object` | No |
 
 Returns: `Object`.
@@ -324,7 +381,10 @@ require "sellapp"
 
 client = SellApp::Client.new(base_url: ENV.fetch("SELLAPP_API_BASE_URL"), api_key: ENV.fetch("SELLAPP_API_KEY"), store: ENV.fetch("SELLAPP_STORE"))
 
-result = client.subscriptions.resume(product_subscription: 55)
+result = client.subscriptions.cancel_immediately(
+  product_subscription: 55,
+  reason: "Customer request"
+)
 puts result.inspect
 ```
 
@@ -350,14 +410,14 @@ Documented HTTP responses: 200, 400, 401, 403, 404, 422, 429, 500. See the API r
 
 [Response access, transport controls, pagination, and typed errors](../usage.md)
 
-## update_payment_method
+## keep
 
-Update a subscription payment method
+Keep a subscription
 
-[API reference](https://sell.app/docs/api/subscriptions/update-payment-method) · Effect: **consequential**
+[API reference](https://sell.app/docs/api/subscriptions/keep-a-subscription) · Effect: **consequential**
 
 ```ruby
-def update_payment_method(
+def keep(
       product_subscription:,
       idempotency_key: SellApp::OMIT,
       request_options: {}
@@ -377,7 +437,7 @@ require "sellapp"
 
 client = SellApp::Client.new(base_url: ENV.fetch("SELLAPP_API_BASE_URL"), api_key: ENV.fetch("SELLAPP_API_KEY"), store: ENV.fetch("SELLAPP_STORE"))
 
-result = client.subscriptions.update_payment_method(product_subscription: 1)
+result = client.subscriptions.keep(product_subscription: 55)
 puts result.inspect
 ```
 
@@ -399,24 +459,22 @@ Supported credential alternatives (each object is one alternative):
 ]
 ```
 
-Documented HTTP responses: 400, 401, 403, 404, 422, 429, 500. See the API reference for field-level validation and consequences.
+Documented HTTP responses: 200, 400, 401, 403, 404, 422, 429, 500. See the API reference for field-level validation and consequences.
 
 [Response access, transport controls, pagination, and typed errors](../usage.md)
 
-## preview_plan_change
+## pause
 
-Preview a subscription plan change
+Pause a subscription
 
-[API reference](https://sell.app/docs/api/subscriptions/preview-plan-change) · Effect: **consequential**
+[API reference](https://sell.app/docs/api/subscriptions/pause-a-subscription) · Effect: **consequential**
 
 ```ruby
-def preview_plan_change(
+def pause(
       product_subscription:,
-      target_variant_id:,
       idempotency_key: SellApp::OMIT,
-      effective_timing: nil,
-      proration_behavior: nil,
-      metadata: nil,
+      resume_at: SellApp::OMIT,
+      reason: SellApp::OMIT,
       request_options: {}
     )
 ```
@@ -424,11 +482,9 @@ def preview_plan_change(
 | Argument | Native type | Required |
 | --- | --- | --- |
 | product_subscription | `Object` | Yes |
-| target_variant_id | `Object` | Yes |
 | idempotency_key | `Object` | No |
-| effective_timing | `Object` | No |
-| proration_behavior | `Object` | No |
-| metadata | `Object` | No |
+| resume_at | `Object` | No |
+| reason | `Object` | No |
 | request_options | `Object` | No |
 
 Returns: `Object`.
@@ -438,11 +494,10 @@ require "sellapp"
 
 client = SellApp::Client.new(base_url: ENV.fetch("SELLAPP_API_BASE_URL"), api_key: ENV.fetch("SELLAPP_API_KEY"), store: ENV.fetch("SELLAPP_STORE"))
 
-result = client.subscriptions.preview_plan_change(
-  product_subscription: 1,
-  target_variant_id: 4321,
-  effective_timing: "immediate",
-  proration_behavior: "provider_default"
+result = client.subscriptions.pause(
+  product_subscription: 55,
+  resume_at: "2026-10-10T12:00:00Z",
+  reason: "Customer request"
 )
 puts result.inspect
 ```
@@ -465,25 +520,20 @@ Supported credential alternatives (each object is one alternative):
 ]
 ```
 
-Documented HTTP responses: 400, 401, 403, 404, 422, 429, 500. See the API reference for field-level validation and consequences.
+Documented HTTP responses: 200, 400, 401, 403, 404, 422, 429, 500. See the API reference for field-level validation and consequences.
 
 [Response access, transport controls, pagination, and typed errors](../usage.md)
 
-## confirm_plan_change
+## resume
 
-Confirm a subscription plan change
+Resume a subscription
 
-[API reference](https://sell.app/docs/api/subscriptions/confirm-plan-change) · Effect: **consequential**
+[API reference](https://sell.app/docs/api/subscriptions/resume-a-subscription) · Effect: **consequential**
 
 ```ruby
-def confirm_plan_change(
+def resume(
       product_subscription:,
-      target_variant_id:,
-      preview_token:,
       idempotency_key: SellApp::OMIT,
-      effective_timing: nil,
-      proration_behavior: nil,
-      metadata: nil,
       request_options: {}
     )
 ```
@@ -491,12 +541,7 @@ def confirm_plan_change(
 | Argument | Native type | Required |
 | --- | --- | --- |
 | product_subscription | `Object` | Yes |
-| target_variant_id | `Object` | Yes |
-| preview_token | `Object` | Yes |
 | idempotency_key | `Object` | No |
-| effective_timing | `Object` | No |
-| proration_behavior | `Object` | No |
-| metadata | `Object` | No |
 | request_options | `Object` | No |
 
 Returns: `Object`.
@@ -506,11 +551,7 @@ require "sellapp"
 
 client = SellApp::Client.new(base_url: ENV.fetch("SELLAPP_API_BASE_URL"), api_key: ENV.fetch("SELLAPP_API_KEY"), store: ENV.fetch("SELLAPP_STORE"))
 
-result = client.subscriptions.confirm_plan_change(
-  product_subscription: 1,
-  target_variant_id: 4321,
-  preview_token: "subprev_9c4b2f"
-)
+result = client.subscriptions.resume(product_subscription: 55)
 puts result.inspect
 ```
 
@@ -532,23 +573,21 @@ Supported credential alternatives (each object is one alternative):
 ]
 ```
 
-Documented HTTP responses: 400, 401, 403, 404, 422, 429, 500. See the API reference for field-level validation and consequences.
+Documented HTTP responses: 200, 400, 401, 403, 404, 422, 429, 500. See the API reference for field-level validation and consequences.
 
 [Response access, transport controls, pagination, and typed errors](../usage.md)
 
-## preview_renewal_date
+## update_payment_method
 
-Preview a subscription renewal date change
+Update a subscription payment method
 
-[API reference](https://sell.app/docs/api/subscriptions/preview-renewal-date-change) · Effect: **consequential**
+[API reference](https://sell.app/docs/api/subscriptions/update-payment-method) · Effect: **consequential**
 
 ```ruby
-def preview_renewal_date(
+def update_payment_method(
       product_subscription:,
-      renewal_date:,
       idempotency_key: SellApp::OMIT,
-      reason: SellApp::OMIT,
-      metadata: nil,
+      return_url: SellApp::OMIT,
       request_options: {}
     )
 ```
@@ -556,10 +595,8 @@ def preview_renewal_date(
 | Argument | Native type | Required |
 | --- | --- | --- |
 | product_subscription | `Object` | Yes |
-| renewal_date | `Object` | Yes |
 | idempotency_key | `Object` | No |
-| reason | `Object` | No |
-| metadata | `Object` | No |
+| return_url | `Object` | No |
 | request_options | `Object` | No |
 
 Returns: `Object`.
@@ -569,10 +606,9 @@ require "sellapp"
 
 client = SellApp::Client.new(base_url: ENV.fetch("SELLAPP_API_BASE_URL"), api_key: ENV.fetch("SELLAPP_API_KEY"), store: ENV.fetch("SELLAPP_STORE"))
 
-result = client.subscriptions.preview_renewal_date(
-  product_subscription: 1,
-  renewal_date: "2026-10-01T12:00:00Z",
-  reason: "Align Maya's membership with the monthly reading circle."
+result = client.subscriptions.update_payment_method(
+  product_subscription: 55,
+  return_url: "https://store.example.com/billing/updated"
 )
 puts result.inspect
 ```
@@ -599,19 +635,19 @@ Documented HTTP responses: 200, 400, 401, 403, 404, 422, 429, 500. See the API r
 
 [Response access, transport controls, pagination, and typed errors](../usage.md)
 
-## confirm_renewal_date
+## preview_plan_change
 
-Confirm a subscription renewal date change
+Preview a subscription plan change
 
-[API reference](https://sell.app/docs/api/subscriptions/confirm-renewal-date-change) · Effect: **consequential**
+[API reference](https://sell.app/docs/api/subscriptions/preview-plan-change) · Effect: **consequential**
 
 ```ruby
-def confirm_renewal_date(
+def preview_plan_change(
       product_subscription:,
-      renewal_date:,
+      target_variant_id:,
       idempotency_key: SellApp::OMIT,
-      preview_token: SellApp::OMIT,
-      reason: SellApp::OMIT,
+      effective_timing: nil,
+      proration_behavior: nil,
       metadata: nil,
       request_options: {}
     )
@@ -620,10 +656,10 @@ def confirm_renewal_date(
 | Argument | Native type | Required |
 | --- | --- | --- |
 | product_subscription | `Object` | Yes |
-| renewal_date | `Object` | Yes |
+| target_variant_id | `Object` | Yes |
 | idempotency_key | `Object` | No |
-| preview_token | `Object` | No |
-| reason | `Object` | No |
+| effective_timing | `Object` | No |
+| proration_behavior | `Object` | No |
 | metadata | `Object` | No |
 | request_options | `Object` | No |
 
@@ -634,11 +670,11 @@ require "sellapp"
 
 client = SellApp::Client.new(base_url: ENV.fetch("SELLAPP_API_BASE_URL"), api_key: ENV.fetch("SELLAPP_API_KEY"), store: ENV.fetch("SELLAPP_STORE"))
 
-result = client.subscriptions.confirm_renewal_date(
+result = client.subscriptions.preview_plan_change(
   product_subscription: 1,
-  renewal_date: "2026-10-01T12:00:00Z",
-  preview_token: "subprev_project_library_55",
-  reason: "Align Maya's membership with the monthly reading circle."
+  target_variant_id: 4321,
+  effective_timing: "immediate",
+  proration_behavior: "provider_default"
 )
 puts result.inspect
 ```
@@ -665,18 +701,34 @@ Documented HTTP responses: 200, 400, 401, 403, 404, 422, 429, 500. See the API r
 
 [Response access, transport controls, pagination, and typed errors](../usage.md)
 
-## list_subscriptions
+## confirm_plan_change
 
-List subscriptions
+Confirm a subscription plan change
 
-[API reference](https://sell.app/docs/api/subscriptions/read-subscriptions) · Effect: **read**
+[API reference](https://sell.app/docs/api/subscriptions/confirm-plan-change) · Effect: **consequential**
 
 ```ruby
-def list_subscriptions(request_options: {})
+def confirm_plan_change(
+      product_subscription:,
+      target_variant_id:,
+      preview_token:,
+      idempotency_key: SellApp::OMIT,
+      effective_timing: nil,
+      proration_behavior: nil,
+      metadata: nil,
+      request_options: {}
+    )
 ```
 
 | Argument | Native type | Required |
 | --- | --- | --- |
+| product_subscription | `Object` | Yes |
+| target_variant_id | `Object` | Yes |
+| preview_token | `Object` | Yes |
+| idempotency_key | `Object` | No |
+| effective_timing | `Object` | No |
+| proration_behavior | `Object` | No |
+| metadata | `Object` | No |
 | request_options | `Object` | No |
 
 Returns: `Object`.
@@ -686,7 +738,11 @@ require "sellapp"
 
 client = SellApp::Client.new(base_url: ENV.fetch("SELLAPP_API_BASE_URL"), api_key: ENV.fetch("SELLAPP_API_KEY"), store: ENV.fetch("SELLAPP_STORE"))
 
-result = client.subscriptions.list_subscriptions
+result = client.subscriptions.confirm_plan_change(
+  product_subscription: 55,
+  target_variant_id: 4321,
+  preview_token: "subprev_9c4b2f"
+)
 puts result.inspect
 ```
 
@@ -708,28 +764,34 @@ Supported credential alternatives (each object is one alternative):
 ]
 ```
 
-Documented HTTP responses: 200, 400, 401, 403, 404, 409, 410, 422, 429, 500. See the API reference for field-level validation and consequences.
+Documented HTTP responses: 200, 400, 401, 403, 404, 422, 429, 500. See the API reference for field-level validation and consequences.
 
 [Response access, transport controls, pagination, and typed errors](../usage.md)
 
-## search_subscriptions
+## preview_renewal_date
 
-Search subscriptions
+Preview a subscription renewal date change
 
-[API reference](https://sell.app/docs/api/subscriptions/read-subscriptions) · Effect: **read**
+[API reference](https://sell.app/docs/api/subscriptions/preview-renewal-date-change) · Effect: **consequential**
 
 ```ruby
-def search_subscriptions(
-      search: nil,
-      status: nil,
+def preview_renewal_date(
+      product_subscription:,
+      renewal_date:,
+      idempotency_key: SellApp::OMIT,
+      reason: SellApp::OMIT,
+      metadata: nil,
       request_options: {}
     )
 ```
 
 | Argument | Native type | Required |
 | --- | --- | --- |
-| search | `Object` | No |
-| status | `Object` | No |
+| product_subscription | `Object` | Yes |
+| renewal_date | `Object` | Yes |
+| idempotency_key | `Object` | No |
+| reason | `Object` | No |
+| metadata | `Object` | No |
 | request_options | `Object` | No |
 
 Returns: `Object`.
@@ -739,9 +801,10 @@ require "sellapp"
 
 client = SellApp::Client.new(base_url: ENV.fetch("SELLAPP_API_BASE_URL"), api_key: ENV.fetch("SELLAPP_API_KEY"), store: ENV.fetch("SELLAPP_STORE"))
 
-result = client.subscriptions.search_subscriptions(
-  search: "maya.chen@example.com",
-  status: "active"
+result = client.subscriptions.preview_renewal_date(
+  product_subscription: 1,
+  renewal_date: "2026-10-01T12:00:00Z",
+  reason: "Align Maya's membership with the monthly reading circle."
 )
 puts result.inspect
 ```
@@ -764,19 +827,24 @@ Supported credential alternatives (each object is one alternative):
 ]
 ```
 
-Documented HTTP responses: 200, 400, 401, 403, 404, 409, 410, 422, 429, 500. See the API reference for field-level validation and consequences.
+Documented HTTP responses: 200, 400, 401, 403, 404, 422, 429, 500. See the API reference for field-level validation and consequences.
 
 [Response access, transport controls, pagination, and typed errors](../usage.md)
 
-## get_subscription
+## confirm_renewal_date
 
-Retrieve a subscription
+Confirm a subscription renewal date change
 
-[API reference](https://sell.app/docs/api/subscriptions/read-subscriptions) · Effect: **read**
+[API reference](https://sell.app/docs/api/subscriptions/confirm-renewal-date-change) · Effect: **consequential**
 
 ```ruby
-def get_subscription(
+def confirm_renewal_date(
       product_subscription:,
+      renewal_date:,
+      idempotency_key: SellApp::OMIT,
+      preview_token: SellApp::OMIT,
+      reason: SellApp::OMIT,
+      metadata: nil,
       request_options: {}
     )
 ```
@@ -784,6 +852,11 @@ def get_subscription(
 | Argument | Native type | Required |
 | --- | --- | --- |
 | product_subscription | `Object` | Yes |
+| renewal_date | `Object` | Yes |
+| idempotency_key | `Object` | No |
+| preview_token | `Object` | No |
+| reason | `Object` | No |
+| metadata | `Object` | No |
 | request_options | `Object` | No |
 
 Returns: `Object`.
@@ -793,7 +866,12 @@ require "sellapp"
 
 client = SellApp::Client.new(base_url: ENV.fetch("SELLAPP_API_BASE_URL"), api_key: ENV.fetch("SELLAPP_API_KEY"), store: ENV.fetch("SELLAPP_STORE"))
 
-result = client.subscriptions.get_subscription(product_subscription: 991)
+result = client.subscriptions.confirm_renewal_date(
+  product_subscription: 1,
+  renewal_date: "2026-10-01T12:00:00Z",
+  preview_token: "subprev_project_library_55",
+  reason: "Align Maya's membership with the monthly reading circle."
+)
 puts result.inspect
 ```
 
@@ -815,7 +893,7 @@ Supported credential alternatives (each object is one alternative):
 ]
 ```
 
-Documented HTTP responses: 200, 400, 401, 403, 404, 409, 410, 422, 429, 500. See the API reference for field-level validation and consequences.
+Documented HTTP responses: 200, 400, 401, 403, 404, 422, 429, 500. See the API reference for field-level validation and consequences.
 
 [Response access, transport controls, pagination, and typed errors](../usage.md)