## Python SDK Changes Detected:

* `polar.events.list()`:  `response.[list_resource_event_].items.[].[system_event]` **Changed** **Breaking** ⚠️
* `polar.events.get()`:  `response.[system_event]` **Changed** **Breaking** ⚠️
* `polar.metrics.list_dashboards()`: **Added**
* `polar.metrics.create_dashboard()`: **Added**
* `polar.metrics.get_dashboard()`: **Added**
* `polar.metrics.update_dashboard()`: **Added**
* `polar.metrics.delete_dashboard()`: **Added**
* `polar.subscriptions.list()`:  `request` **Changed**
* `polar.payments.list()`:  `response.items.[]` **Changed**

Author: speakeasybot

.speakeasy/gen.lock

@@ -31,7 +31,7 @@ generation:
   persistentEdits: {}
   versioningStrategy: automatic
 python:
-  version: 0.31.0
+  version: 0.31.1
   additionalDependencies:
     dev:
       pydantic-ai-slim: ^0.1.0

.speakeasy/gen.yaml

@@ -2,20 +2,20 @@ speakeasyVersion: 1.648.0
 sources:
     Polar-OAS:
         sourceNamespace: polar-oas
-        sourceRevisionDigest: sha256:f8709a4eb128eae2205cf1850fcb774e6636048b4118f83edf6e319c86e3a552
-        sourceBlobDigest: sha256:ee09c80bc23acb7e1dbe17d2e87b0b118445325f0a5138541f39a45f7638fb04
+        sourceRevisionDigest: sha256:cb1dd23a3e799d0f6bf3cd438b6852cc9ef2efff04bdab18e2ee9e537704730a
+        sourceBlobDigest: sha256:253455b40f6f46010a798891608324cbb2be43bbe9398b5b709ef569b8ffa24c
         tags:
             - latest
-            - speakeasy-sdk-regen-1774543542
+            - speakeasy-sdk-regen-1774657294
             - 0.1.0
 targets:
     polar:
         source: Polar-OAS
         sourceNamespace: polar-oas
-        sourceRevisionDigest: sha256:f8709a4eb128eae2205cf1850fcb774e6636048b4118f83edf6e319c86e3a552
-        sourceBlobDigest: sha256:ee09c80bc23acb7e1dbe17d2e87b0b118445325f0a5138541f39a45f7638fb04
+        sourceRevisionDigest: sha256:cb1dd23a3e799d0f6bf3cd438b6852cc9ef2efff04bdab18e2ee9e537704730a
+        sourceBlobDigest: sha256:253455b40f6f46010a798891608324cbb2be43bbe9398b5b709ef569b8ffa24c
         codeSamplesNamespace: polar-oas-py-code-samples
-        codeSamplesRevisionDigest: sha256:14eeea3aef164d3b51fee6ab9ac4850c1a9a4ec82778fb87aacea7e77ab78c7f
+        codeSamplesRevisionDigest: sha256:7e59522c8aa334069e79bc56cbf9ff298473ea28826a87200c1f206d825c4f8c
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

.speakeasy/workflow.lock

@@ -398,6 +398,11 @@ def webhook():
 
 * [get](docs/sdks/metricssdk/README.md#get) - Get Metrics
 * [limits](docs/sdks/metricssdk/README.md#limits) - Get Metrics Limits
+* [list_dashboards](docs/sdks/metricssdk/README.md#list_dashboards) - List Metric Dashboards
+* [create_dashboard](docs/sdks/metricssdk/README.md#create_dashboard) - Create Metric Dashboard
+* [get_dashboard](docs/sdks/metricssdk/README.md#get_dashboard) - Get Metric Dashboard
+* [update_dashboard](docs/sdks/metricssdk/README.md#update_dashboard) - Update Metric Dashboard
+* [delete_dashboard](docs/sdks/metricssdk/README.md#delete_dashboard) - Delete Metric Dashboard
 
 ### [oauth2](docs/sdks/oauth2/README.md)
 
@@ -587,25 +592,25 @@ with Polar(
 
 
 **Inherit from [`PolarError`](./src/polar_sdk/models/polarerror.py)**:
-* [`ResourceNotFound`](./src/polar_sdk/models/resourcenotfound.py): Status code `404`. Applicable to 82 of 169 methods.*
-* [`NotPermitted`](./src/polar_sdk/models/notpermitted.py): Status code `403`. Applicable to 10 of 169 methods.*
-* [`Unauthorized`](./src/polar_sdk/models/unauthorized.py): Not authorized to manage license key. Status code `401`. Applicable to 5 of 169 methods.*
-* [`AlreadyCanceledSubscription`](./src/polar_sdk/models/alreadycanceledsubscription.py): Status code `403`. Applicable to 4 of 169 methods.*
-* [`AlreadyActiveSubscriptionError`](./src/polar_sdk/models/alreadyactivesubscriptionerror.py): The checkout is expired, the customer already has an active subscription, or the organization is not ready to accept payments. Status code `403`. Applicable to 3 of 169 methods.*
-* [`NotOpenCheckout`](./src/polar_sdk/models/notopencheckout.py): The checkout is expired, the customer already has an active subscription, or the organization is not ready to accept payments. Status code `403`. Applicable to 3 of 169 methods.*
-* [`PaymentNotReady`](./src/polar_sdk/models/paymentnotready.py): The checkout is expired, the customer already has an active subscription, or the organization is not ready to accept payments. Status code `403`. Applicable to 3 of 169 methods.*
-* [`TrialAlreadyRedeemed`](./src/polar_sdk/models/trialalreadyredeemed.py): The checkout is expired, the customer already has an active subscription, or the organization is not ready to accept payments. Status code `403`. Applicable to 3 of 169 methods.*
-* [`ExpiredCheckoutError`](./src/polar_sdk/models/expiredcheckouterror.py): The checkout session is expired. Status code `410`. Applicable to 3 of 169 methods.*
-* [`PaymentFailed`](./src/polar_sdk/models/paymentfailed.py): Payment required to apply the subscription update. Status code `402`. Applicable to 2 of 169 methods.*
-* [`SubscriptionLocked`](./src/polar_sdk/models/subscriptionlocked.py): Subscription is pending an update. Status code `409`. Applicable to 2 of 169 methods.*
-* [`MissingInvoiceBillingDetails`](./src/polar_sdk/models/missinginvoicebillingdetails.py): Order is not paid or is missing billing name or address. Status code `422`. Applicable to 2 of 169 methods.*
-* [`NotPaidOrder`](./src/polar_sdk/models/notpaidorder.py): Order is not paid or is missing billing name or address. Status code `422`. Applicable to 2 of 169 methods.*
-* [`PaymentError`](./src/polar_sdk/models/paymenterror.py): The payment failed. Status code `400`. Applicable to 1 of 169 methods.*
-* [`CustomerNotReady`](./src/polar_sdk/models/customernotready.py): Customer is not ready to confirm a payment method. Status code `400`. Applicable to 1 of 169 methods.*
-* [`PaymentMethodInUseByActiveSubscription`](./src/polar_sdk/models/paymentmethodinusebyactivesubscription.py): Payment method is used by active subscription(s). Status code `400`. Applicable to 1 of 169 methods.*
-* [`RefundedAlready`](./src/polar_sdk/models/refundedalready.py): Order is already fully refunded. Status code `403`. Applicable to 1 of 169 methods.*
-* [`PaymentAlreadyInProgress`](./src/polar_sdk/models/paymentalreadyinprogress.py): Payment already in progress. Status code `409`. Applicable to 1 of 169 methods.*
-* [`OrderNotEligibleForRetry`](./src/polar_sdk/models/ordernoteligibleforretry.py): Order not eligible for retry or payment confirmation failed. Status code `422`. Applicable to 1 of 169 methods.*
+* [`ResourceNotFound`](./src/polar_sdk/models/resourcenotfound.py): Status code `404`. Applicable to 82 of 174 methods.*
+* [`NotPermitted`](./src/polar_sdk/models/notpermitted.py): Status code `403`. Applicable to 10 of 174 methods.*
+* [`Unauthorized`](./src/polar_sdk/models/unauthorized.py): Not authorized to manage license key. Status code `401`. Applicable to 5 of 174 methods.*
+* [`AlreadyCanceledSubscription`](./src/polar_sdk/models/alreadycanceledsubscription.py): Status code `403`. Applicable to 4 of 174 methods.*
+* [`AlreadyActiveSubscriptionError`](./src/polar_sdk/models/alreadyactivesubscriptionerror.py): The checkout is expired, the customer already has an active subscription, or the organization is not ready to accept payments. Status code `403`. Applicable to 3 of 174 methods.*
+* [`NotOpenCheckout`](./src/polar_sdk/models/notopencheckout.py): The checkout is expired, the customer already has an active subscription, or the organization is not ready to accept payments. Status code `403`. Applicable to 3 of 174 methods.*
+* [`PaymentNotReady`](./src/polar_sdk/models/paymentnotready.py): The checkout is expired, the customer already has an active subscription, or the organization is not ready to accept payments. Status code `403`. Applicable to 3 of 174 methods.*
+* [`TrialAlreadyRedeemed`](./src/polar_sdk/models/trialalreadyredeemed.py): The checkout is expired, the customer already has an active subscription, or the organization is not ready to accept payments. Status code `403`. Applicable to 3 of 174 methods.*
+* [`ExpiredCheckoutError`](./src/polar_sdk/models/expiredcheckouterror.py): The checkout session is expired. Status code `410`. Applicable to 3 of 174 methods.*
+* [`PaymentFailed`](./src/polar_sdk/models/paymentfailed.py): Payment required to apply the subscription update. Status code `402`. Applicable to 2 of 174 methods.*
+* [`SubscriptionLocked`](./src/polar_sdk/models/subscriptionlocked.py): Subscription is pending an update. Status code `409`. Applicable to 2 of 174 methods.*
+* [`MissingInvoiceBillingDetails`](./src/polar_sdk/models/missinginvoicebillingdetails.py): Order is not paid or is missing billing name or address. Status code `422`. Applicable to 2 of 174 methods.*
+* [`NotPaidOrder`](./src/polar_sdk/models/notpaidorder.py): Order is not paid or is missing billing name or address. Status code `422`. Applicable to 2 of 174 methods.*
+* [`PaymentError`](./src/polar_sdk/models/paymenterror.py): The payment failed. Status code `400`. Applicable to 1 of 174 methods.*
+* [`CustomerNotReady`](./src/polar_sdk/models/customernotready.py): Customer is not ready to confirm a payment method. Status code `400`. Applicable to 1 of 174 methods.*
+* [`PaymentMethodInUseByActiveSubscription`](./src/polar_sdk/models/paymentmethodinusebyactivesubscription.py): Payment method is used by active subscription(s). Status code `400`. Applicable to 1 of 174 methods.*
+* [`RefundedAlready`](./src/polar_sdk/models/refundedalready.py): Order is already fully refunded. Status code `403`. Applicable to 1 of 174 methods.*
+* [`PaymentAlreadyInProgress`](./src/polar_sdk/models/paymentalreadyinprogress.py): Payment already in progress. Status code `409`. Applicable to 1 of 174 methods.*
+* [`OrderNotEligibleForRetry`](./src/polar_sdk/models/ordernoteligibleforretry.py): Order not eligible for retry or payment confirmation failed. Status code `422`. Applicable to 1 of 174 methods.*
 * [`ResponseValidationError`](./src/polar_sdk/models/responsevalidationerror.py): Type mismatch between the response data and the expected Pydantic model. Provides access to the Pydantic validation error via the `cause` attribute.
 
 </details>

README.md

@@ -1073,4 +1073,14 @@ Based on:
 ### Generated
 - [python v0.31.0] .
 ### Releases
-- [PyPI v0.31.0] https://pypi.org/project/polar-sdk/0.31.0 - .
+- [PyPI v0.31.0] https://pypi.org/project/polar-sdk/0.31.0 - .
+
+## 2026-04-03 00:23:09
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.648.0 (2.737.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.31.1] .
+### Releases
+- [PyPI v0.31.1] https://pypi.org/project/polar-sdk/0.31.1 - .

RELEASES.md

@@ -735,6 +735,36 @@ actions:
         - "lang": "python"
           "label": "Python (SDK)"
           "source": "from datetime import date\nimport polar_sdk\nfrom polar_sdk import Polar\n\n\nwith Polar(\n    access_token=\"<YOUR_BEARER_TOKEN_HERE>\",\n) as polar:\n\n    res = polar.metrics.get(start_date=date.fromisoformat(\"2026-03-14\"), end_date=date.fromisoformat(\"2026-03-18\"), interval=polar_sdk.TimeInterval.HOUR, timezone=\"UTC\", organization_id=None)\n\n    # Handle response\n    print(res)"
+  - target: $["paths"]["/v1/metrics/dashboards"]["get"]
+    update:
+      "x-codeSamples":
+        - "lang": "python"
+          "label": "Python (SDK)"
+          "source": "from polar_sdk import Polar\n\n\nwith Polar(\n    access_token=\"<YOUR_BEARER_TOKEN_HERE>\",\n) as polar:\n\n    res = polar.metrics.list_dashboards(organization_id=\"1dbfc517-0bbf-4301-9ba8-555ca42b9737\")\n\n    # Handle response\n    print(res)"
+  - target: $["paths"]["/v1/metrics/dashboards"]["post"]
+    update:
+      "x-codeSamples":
+        - "lang": "python"
+          "label": "Python (SDK)"
+          "source": "from polar_sdk import Polar\n\n\nwith Polar(\n    access_token=\"<YOUR_BEARER_TOKEN_HERE>\",\n) as polar:\n\n    res = polar.metrics.create_dashboard(request={\n        \"name\": \"<value>\",\n        \"organization_id\": \"1dbfc517-0bbf-4301-9ba8-555ca42b9737\",\n    })\n\n    # Handle response\n    print(res)"
+  - target: $["paths"]["/v1/metrics/dashboards/{id}"]["delete"]
+    update:
+      "x-codeSamples":
+        - "lang": "python"
+          "label": "Python (SDK)"
+          "source": "from polar_sdk import Polar\n\n\nwith Polar(\n    access_token=\"<YOUR_BEARER_TOKEN_HERE>\",\n) as polar:\n\n    polar.metrics.delete_dashboard(id=\"<value>\")\n\n    # Use the SDK ..."
+  - target: $["paths"]["/v1/metrics/dashboards/{id}"]["get"]
+    update:
+      "x-codeSamples":
+        - "lang": "python"
+          "label": "Python (SDK)"
+          "source": "from polar_sdk import Polar\n\n\nwith Polar(\n    access_token=\"<YOUR_BEARER_TOKEN_HERE>\",\n) as polar:\n\n    res = polar.metrics.get_dashboard(id=\"<value>\")\n\n    # Handle response\n    print(res)"
+  - target: $["paths"]["/v1/metrics/dashboards/{id}"]["patch"]
+    update:
+      "x-codeSamples":
+        - "lang": "python"
+          "label": "Python (SDK)"
+          "source": "from polar_sdk import Polar\n\n\nwith Polar(\n    access_token=\"<YOUR_BEARER_TOKEN_HERE>\",\n) as polar:\n\n    res = polar.metrics.update_dashboard(id=\"<value>\", metric_dashboard_update={})\n\n    # Handle response\n    print(res)"
   - target: $["paths"]["/v1/metrics/limits"]["get"]
     update:
       "x-codeSamples":

codeSamples.yaml

@@ -54,6 +54,7 @@
 | `REFUNDS_WRITE`                    | refunds:write                      |
 | `PAYMENTS_READ`                    | payments:read                      |
 | `METRICS_READ`                     | metrics:read                       |
+| `METRICS_WRITE`                    | metrics:write                      |
 | `WEBHOOKS_READ`                    | webhooks:read                      |
 | `WEBHOOKS_WRITE`                   | webhooks:write                     |
 | `LICENSE_KEYS_READ`                | license_keys:read                  |

docs/models/availablescope.md

@@ -0,0 +1,19 @@
+# CustomerCancellationReasonFilter
+
+Filter by customer cancellation reason.
+
+
+## Supported Types
+
+### `models.CustomerCancellationReason`
+
+```python
+value: models.CustomerCancellationReason = /* values here */
+```
+
+### `List[models.CustomerCancellationReason]`
+
+```python
+value: List[models.CustomerCancellationReason] = /* values here */
+```
+

docs/models/customercancellationreasonfilter.md

@@ -3,6 +3,6 @@
 
 ## Fields
 
-| Field                                            | Type                                             | Required                                         | Description                                      |
-| ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------ |
-| `result`                                         | [models.ListResource](../models/listresource.md) | :heavy_check_mark:                               | N/A                                              |
+| Field                                                            | Type                                                             | Required                                                         | Description                                                      |
+| ---------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------- |
+| `result`                                                         | [models.ListResourceCustomer](../models/listresourcecustomer.md) | :heavy_check_mark:                                               | N/A                                                              |

docs/models/customerslistresponse.md

@@ -1,4 +1,4 @@
-# ListResource
+# ListResourceCustomer
 
 
 ## Fields