license_manager 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df11434afa2a9be8fd6ec9871332171ca914152a8aa2285a7f407bec5f00a9b7
-  data.tar.gz: 939d7f2662be1617ffbea8419207821c1840df7b71a07bfa6280b1413adb317a
+  metadata.gz: 6bcf4262163e03a08877a9fcd90c3ca632ed44a53507b49fd7ec1791aeb9f09a
+  data.tar.gz: d139d65dc28028b48968c2445fe26a2002d9a648cf786c07d4e74dcde28c4dbd
 SHA512:
-  metadata.gz: adcd4c107f820fc357e3295a4fc559536a336d607555d0021344fdc189cfe24dc99004e9f43ac57b47a78a6e98fbfe204857e07a9d7a95fe946856a0fe867e44
-  data.tar.gz: 719c8d3ebd7f357cc171c0f47622981fba13a36bf8c478fd6cabce01ac50679babac98d1327bbdbe2cd2d7cc30d862f46b23edde29ac122cba83dec4e20945c3
+  metadata.gz: 328ad38f8a2d30478b298c05c9adfcd98202fade7632455005bef6f535a7ca8a1e48bff28405963b2957f4ef40f5b12cf79e92dcfdac3bda13ecfb76fded9382
+  data.tar.gz: b1366be4e6662bb272b916a1ac1f2bc72b7182a97bc0fa1824a01a05b4a27c4e216bff5af55426a6ccd0ffac466dedabb4f084b472c3cdd9f2d169e5e7f0d6b0

data/CHANGELOG.md

@@ -1,5 +1,100 @@
 # Changelog
 
+## 0.2.0 (2026-10-27)
+
+### Breaking changes
+
+- `GET /v1/customers/{customerId}/licenses`: added the new `canceled` enum value to the `data/items/status` response property for the response status `200`
+- `POST /v1/customers/{id}/tokens`: added the new `license:cancel` enum value to the `scope/items/` response property for the response status `201`
+- `GET /v1/licenses/{id}`: added the new `canceled` enum value to the `status` response property for the response status `200`
+- `PATCH /v1/licenses/{id}`: added the new `canceled` enum value to the `status` response property for the response status `200`
+- `GET /v1/licenses/{id}/events`: added the new `license.canceled` enum value to the `data/items/type` response property for the response status `200`
+- `GET /v1/licenses/{id}/events`: added the new `license.refund_failed` enum value to the `data/items/type` response property for the response status `200`
+- `GET /v1/licenses/{id}/events`: added the new `license.refunded` enum value to the `data/items/type` response property for the response status `200`
+- `POST /v1/licenses/{id}/tokens`: added the new `license:cancel` enum value to the `scope/items/` response property for the response status `201`
+- `GET /v1/licenses/{licenseId}/machines`: added the new `locked` enum value to the `data/items/status` response property for the response status `200`
+- `GET /v1/machines/{id}`: added the new `locked` enum value to the `status` response property for the response status `200`
+- `POST /v1/machines/{id}/deactivate`: added the new `locked` enum value to the `status` response property for the response status `200`
+- `POST /v1/machines/{id}/tokens`: added the new `license:cancel` enum value to the `scope/items/` response property for the response status `201`
+- `GET /v1/policies/{id}/events`: added the new `license.canceled` enum value to the `data/items/type` response property for the response status `200`
+- `GET /v1/policies/{id}/events`: added the new `license.refund_failed` enum value to the `data/items/type` response property for the response status `200`
+- `GET /v1/policies/{id}/events`: added the new `license.refunded` enum value to the `data/items/type` response property for the response status `200`
+- `GET /v1/products/{productId}/licenses`: added the new `canceled` enum value to the `data/items/status` response property for the response status `200`
+- `POST /v1/products/{productId}/licenses`: added the new `canceled` enum value to the `status` response property for the response status `201`
+
+### Changes
+
+- `GET /v1/customers/{customerId}/licenses`: added the enum value `canceled` to the property `allOf[#/components/schemas/LicenseStatus]/` of the `query` request parameter `status`
+- `GET /v1/customers/{customerId}/licenses`: added the required property `data/items/canceledAt` to the response with the `200` status
+- `GET /v1/customers/{customerId}/licenses`: added the required property `data/items/cancellableUntil` to the response with the `200` status
+- `GET /v1/customers/{customerId}/licenses`: added the required property `data/items/cancellationComment` to the response with the `200` status
+- `GET /v1/customers/{customerId}/licenses`: added the required property `data/items/cancellationReason` to the response with the `200` status
+- `GET /v1/customers/{customerId}/licenses`: added the required property `data/items/stripeRefundId` to the response with the `200` status
+- `POST /v1/customers/{id}/tokens`: added the new `license:cancel` enum value to the request property `scope/items/`
+- `PATCH /v1/integrations/{id}`: endpoint added
+- `POST /v1/integrations/{id}/check`: added the required property `autoRefund` to the response with the `200` status
+- `POST /v1/integrations/{id}/check`: added the required property `canRefund` to the response with the `200` status
+- `GET /v1/licenses/{id}`: added the required property `canceledAt` to the response with the `200` status
+- `GET /v1/licenses/{id}`: added the required property `cancellableUntil` to the response with the `200` status
+- `GET /v1/licenses/{id}`: added the required property `cancellationComment` to the response with the `200` status
+- `GET /v1/licenses/{id}`: added the required property `cancellationReason` to the response with the `200` status
+- `GET /v1/licenses/{id}`: added the required property `stripeRefundId` to the response with the `200` status
+- `PATCH /v1/licenses/{id}`: added the new optional request property `cancellableUntil`
+- `PATCH /v1/licenses/{id}`: added the required property `canceledAt` to the response with the `200` status
+- `PATCH /v1/licenses/{id}`: added the required property `cancellableUntil` to the response with the `200` status
+- `PATCH /v1/licenses/{id}`: added the required property `cancellationComment` to the response with the `200` status
+- `PATCH /v1/licenses/{id}`: added the required property `cancellationReason` to the response with the `200` status
+- `PATCH /v1/licenses/{id}`: added the required property `stripeRefundId` to the response with the `200` status
+- `POST /v1/licenses/{id}/cancel`: endpoint added
+- `GET /v1/licenses/{id}/events`: added the enum value `license.canceled` to the property `anyOf[#/components/schemas/EventType]/` of the `query` request parameter `type` (shared schema: `EventType`, also at `anyOf[#/components/schemas/EventType]`, `anyOf[subschema #2]/items`)
+- `GET /v1/licenses/{id}/events`: added the enum value `license.refund_failed` to the property `anyOf[#/components/schemas/EventType]/` of the `query` request parameter `type` (shared schema: `EventType`, also at `anyOf[#/components/schemas/EventType]`, `anyOf[subschema #2]/items`)
+- `GET /v1/licenses/{id}/events`: added the enum value `license.refunded` to the property `anyOf[#/components/schemas/EventType]/` of the `query` request parameter `type` (shared schema: `EventType`, also at `anyOf[#/components/schemas/EventType]`, `anyOf[subschema #2]/items`)
+- `POST /v1/licenses/{id}/tokens`: added the new `license:cancel` enum value to the request property `scope/items/`
+- `GET /v1/licenses/{licenseId}/machines`: added the new enum value `locked` to the `query` request parameter `status`
+- `GET /v1/licenses/{licenseId}/machines`: added the required property `data/items/overriddenByMachineId` to the response with the `200` status
+- `GET /v1/machines/{id}`: added the required property `overriddenByMachineId` to the response with the `200` status
+- `POST /v1/machines/{id}/deactivate`: added the required property `overriddenByMachineId` to the response with the `200` status
+- `POST /v1/machines/{id}/tokens`: added the new `license:cancel` enum value to the request property `scope/items/`
+- `GET /v1/policies/{id}`: added the required property `moneyBackGuaranteeDays` to the response with the `200` status
+- `PATCH /v1/policies/{id}`: added the new optional request property `moneyBackGuaranteeDays`
+- `PATCH /v1/policies/{id}`: added the required property `moneyBackGuaranteeDays` to the response with the `200` status
+- `GET /v1/policies/{id}/events`: added the enum value `license.canceled` to the property `anyOf[#/components/schemas/EventType]/` of the `query` request parameter `type` (shared schema: `EventType`, also at `anyOf[#/components/schemas/EventType]`, `anyOf[subschema #2]/items`)
+- `GET /v1/policies/{id}/events`: added the enum value `license.refund_failed` to the property `anyOf[#/components/schemas/EventType]/` of the `query` request parameter `type` (shared schema: `EventType`, also at `anyOf[#/components/schemas/EventType]`, `anyOf[subschema #2]/items`)
+- `GET /v1/policies/{id}/events`: added the enum value `license.refunded` to the property `anyOf[#/components/schemas/EventType]/` of the `query` request parameter `type` (shared schema: `EventType`, also at `anyOf[#/components/schemas/EventType]`, `anyOf[subschema #2]/items`)
+- `GET /v1/products`: added the required property `data/items/autoMachineChange` to the response with the `200` status
+- `POST /v1/products`: added the new optional request property `allOf[subschema #2]/defaultPolicy/moneyBackGuaranteeDays`
+- `POST /v1/products`: added the required property `autoMachineChange` to the response with the `201` status
+- `GET /v1/products/{id}`: added the required property `autoMachineChange` to the response with the `200` status
+- `PATCH /v1/products/{id}`: added the new optional request property `autoMachineChange`
+- `PATCH /v1/products/{id}`: added the required property `autoMachineChange` to the response with the `200` status
+- `DELETE /v1/products/{id}/logo`: added the required property `autoMachineChange` to the response with the `200` status
+- `PUT /v1/products/{id}/logo`: added the required property `autoMachineChange` to the response with the `200` status
+- `POST /v1/products/{id}/reset`: added the required property `autoMachineChange` to the response with the `200` status
+- `GET /v1/products/{id}/stats`: added the required property `cancellation` to the response with the `200` status
+- `GET /v1/products/{id}/stats`: added the required property `revenue/items/canceledLicenseCount` to the response with the `200` status
+- `GET /v1/products/{id}/stats`: added the required property `revenue/items/canceledTotal` to the response with the `200` status
+- `GET /v1/products/{productId}/integrations/stripe`: added the required property `integration/anyOf[#/components/schemas/Integration]/autoRefund` to the response with the `200` status
+- `GET /v1/products/{productId}/integrations/stripe`: added the required property `integration/anyOf[#/components/schemas/Integration]/canRefund` to the response with the `200` status
+- `GET /v1/products/{productId}/integrations/stripe`: added the required property `requiredPermissions/items/optional` to the response with the `200` status
+- `PUT /v1/products/{productId}/integrations/stripe`: added the required property `integration/anyOf[#/components/schemas/Integration]/autoRefund` to the response with the `200` status
+- `PUT /v1/products/{productId}/integrations/stripe`: added the required property `integration/anyOf[#/components/schemas/Integration]/canRefund` to the response with the `200` status
+- `PUT /v1/products/{productId}/integrations/stripe`: added the required property `requiredPermissions/items/optional` to the response with the `200` status
+- `GET /v1/products/{productId}/licenses`: added the enum value `canceled` to the property `allOf[#/components/schemas/LicenseStatus]/` of the `query` request parameter `status`
+- `GET /v1/products/{productId}/licenses`: added the required property `data/items/canceledAt` to the response with the `200` status
+- `GET /v1/products/{productId}/licenses`: added the required property `data/items/cancellableUntil` to the response with the `200` status
+- `GET /v1/products/{productId}/licenses`: added the required property `data/items/cancellationComment` to the response with the `200` status
+- `GET /v1/products/{productId}/licenses`: added the required property `data/items/cancellationReason` to the response with the `200` status
+- `GET /v1/products/{productId}/licenses`: added the required property `data/items/stripeRefundId` to the response with the `200` status
+- `POST /v1/products/{productId}/licenses`: added the new optional request property `cancellableUntil`
+- `POST /v1/products/{productId}/licenses`: added the required property `canceledAt` to the response with the `201` status
+- `POST /v1/products/{productId}/licenses`: added the required property `cancellableUntil` to the response with the `201` status
+- `POST /v1/products/{productId}/licenses`: added the required property `cancellationComment` to the response with the `201` status
+- `POST /v1/products/{productId}/licenses`: added the required property `cancellationReason` to the response with the `201` status
+- `POST /v1/products/{productId}/licenses`: added the required property `stripeRefundId` to the response with the `201` status
+- `GET /v1/products/{productId}/policies`: added the required property `data/items/moneyBackGuaranteeDays` to the response with the `200` status
+- `POST /v1/products/{productId}/policies`: added the new optional request property `moneyBackGuaranteeDays`
+- `POST /v1/products/{productId}/policies`: added the required property `moneyBackGuaranteeDays` to the response with the `201` status
+
 ## 0.1.1 (2026-10-20)
 
 Regenerated from the same API.

data/README.md

@@ -76,7 +76,7 @@ Every method is documented, with its parameters and responses, in the [`docs`](d
 
 | Class | Methods |
 | --- | --- |
-| [`LicensesApi`](docs/LicensesApi.md) | `validate_key`, `list_licenses`, `create_license`, `list_customer_licenses`, `get_license`, `delete_license`, `update_license`, `get_license_stats`, `send_license_keys`, `get_signing_key` |
+| [`LicensesApi`](docs/LicensesApi.md) | `validate_key`, `list_licenses`, `create_license`, `list_customer_licenses`, `get_license`, `delete_license`, `update_license`, `get_license_stats`, `cancel_license`, `send_license_keys`, `get_signing_key` |
 | [`PortalApi`](docs/PortalApi.md) | `get_portal`, `request_portal_link`, `create_portal_link`, `send_portal_link` |
 | [`ProductsApi`](docs/ProductsApi.md) | `list_products`, `create_product`, `get_product`, `delete_product`, `update_product`, `reset_product`, `upload_product_logo`, `delete_product_logo`, `get_product_stats` |
 | [`PoliciesApi`](docs/PoliciesApi.md) | `list_policies`, `create_policy`, `get_policy`, `delete_policy`, `update_policy` |
@@ -85,7 +85,7 @@ Every method is documented, with its parameters and responses, in the [`docs`](d
 | [`ReleasesApi`](docs/ReleasesApi.md) | `list_releases`, `create_release`, `get_release`, `delete_release`, `update_release` |
 | [`TokensApi`](docs/TokensApi.md) | `create_customer_token`, `create_license_token`, `create_machine_token` |
 | [`EventsApi`](docs/EventsApi.md) | `list_policy_events`, `list_license_events` |
-| [`IntegrationsApi`](docs/IntegrationsApi.md) | `get_stripe_integration`, `connect_stripe`, `disconnect_integration`, `check_integration`, `list_stripe_prices`, `create_stripe_mapping`, `delete_stripe_mapping`, `update_stripe_mapping` |
+| [`IntegrationsApi`](docs/IntegrationsApi.md) | `get_stripe_integration`, `connect_stripe`, `disconnect_integration`, `update_integration`, `check_integration`, `list_stripe_prices`, `create_stripe_mapping`, `delete_stripe_mapping`, `update_stripe_mapping` |
 
 ## Versioning
 

data/docs/CancelLicense.md

@@ -0,0 +1,22 @@
+# LicenseManager::CancelLicense
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **reason** | [**CancellationReason**](CancellationReason.md) |  |  |
+| **comment** | **String** | What the customer said about the cancellation. | [optional] |
+| **refund** | **Boolean** | Whether to refund the license's Stripe payment, when it was bought through the Stripe integration. Defaults to the integration's `autoRefund`. Ignored for tokens, which always follow `autoRefund`, and when the integration's `canRefund` is false: its API key can't create refunds. | [optional] |
+
+## Example
+
+```ruby
+require 'license_manager'
+
+instance = LicenseManager::CancelLicense.new(
+  reason: null,
+  comment: I only needed it for one project.,
+  refund: true
+)
+```
+

data/docs/CancellationReason.md

@@ -0,0 +1,15 @@
+# LicenseManager::CancellationReason
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'license_manager'
+
+instance = LicenseManager::CancellationReason.new()
+```
+

data/docs/CancellationStats.md

@@ -0,0 +1,30 @@
+# LicenseManager::CancellationStats
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **license_count** | **Integer** | Number of licenses with a money back guarantee: a `cancellableUntil`. |  |
+| **canceled_license_count** | **Integer** | Number of them that were canceled. |  |
+| **cancellable_license_count** | **Integer** | Number of them whose money back guarantee hasn't ended, and that weren't canceled: they can still be. |  |
+| **rate** | **Float** | Share of them that were canceled, from 0 to 1: `canceledLicenseCount` over `licenseCount`. |  |
+| **canceled_by_day** | **Array<Integer>** | Number of them canceled each day, aligned on `days`, on the day of their cancellation. |  |
+| **canceled_by_month** | **Array<Integer>** | Number of them canceled each month, aligned on `months`, on the month of their cancellation. |  |
+| **by_reason** | [**Array<CancellationStatsByReasonInner>**](CancellationStatsByReasonInner.md) | Number of them canceled for each reason, from the most given one. Reasons never given are left out. |  |
+
+## Example
+
+```ruby
+require 'license_manager'
+
+instance = LicenseManager::CancellationStats.new(
+  license_count: 80,
+  canceled_license_count: 4,
+  cancellable_license_count: 12,
+  rate: 0.05,
+  canceled_by_day: [0, 1, 0],
+  canceled_by_month: [1, 0, 2],
+  by_reason: null
+)
+```
+

data/docs/CancellationStatsByReasonInner.md

@@ -0,0 +1,20 @@
+# LicenseManager::CancellationStatsByReasonInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **reason** | [**CancellationReason**](CancellationReason.md) |  |  |
+| **count** | **Integer** |  |  |
+
+## Example
+
+```ruby
+require 'license_manager'
+
+instance = LicenseManager::CancellationStatsByReasonInner.new(
+  reason: null,
+  count: 2
+)
+```
+

data/docs/ConnectStripe.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **api_key** | **String** | Restricted API key of the Stripe account (`rk_live_…` for live products, `rk_test_…` for test products), with the `requiredPermissions` of `getStripeIntegration`. A secret key works too, but gives the app more access than it needs. |  |
+| **api_key** | **String** | Restricted API key of the Stripe account (`rk_live_…` for live products, `rk_test_…` for test products), with the `requiredPermissions` of `getStripeIntegration`. Without the optional ones, it connects with what they're for turned off. A secret key works too, but gives the app more access than it needs. |  |
 
 ## Example
 

data/docs/CreateLicense.md

@@ -13,6 +13,7 @@
 | **max_offline_duration_seconds** | **Integer** | Longest the applications can run offline with the license, in seconds. At least one hour (`3600`). Defaults to the one of the policy. | [optional] |
 | **price** | [**PriceInput**](PriceInput.md) |  | [optional] |
 | **max_version** | [**LicenseMaxVersionInput**](LicenseMaxVersionInput.md) |  | [optional] |
+| **cancellable_until** | **Time** | End of the money back guarantee: until then, the customer can cancel the license from the customer portal, or with a token. `null` to not let them. Defaults to the creation date plus the policy's `moneyBackGuaranteeDays`, or `null` when it has none. | [optional] |
 | **send_key** | **Boolean** | `true` emails the key to the customer once the license is created, like `sendLicenseKeys`. Sent in the background: a failed email doesn't fail the creation. In test products, it's only sent when the customer's email is a member's of the organization. Defaults to `false`. | [optional] |
 
 ## Example
@@ -30,6 +31,7 @@ instance = LicenseManager::CreateLicense.new(
   max_offline_duration_seconds: 604800,
   price: null,
   max_version: null,
+  cancellable_until: 2026-02-14T09:30:00.000Z,
   send_key: true
 )
 ```

data/docs/CreatePolicy.md

@@ -11,6 +11,7 @@
 | **max_machines** | **Integer** | Maximum number of active machines of the licenses created with this policy, copied to each of them. `null` for no limit. Defaults to `null`. | [optional] |
 | **max_offline_duration_seconds** | **Integer** | Longest the applications can run offline with the licenses created with this policy, in seconds, copied to each of them. At least one hour (`3600`). Defaults to one week. | [optional] |
 | **max_version** | [**PolicySettingsMaxVersion**](PolicySettingsMaxVersion.md) |  | [optional] |
+| **money_back_guarantee_days** | **Integer** | Number of days after their creation during which customers can cancel the licenses created with this policy, from the customer portal or with `cancelLicense`, which refunds their Stripe payment. Each license keeps the end of its own period as `cancellableUntil`. `null` for no money back guarantee. Defaults to `null`. | [optional] |
 
 ## Example
 
@@ -24,7 +25,8 @@ instance = LicenseManager::CreatePolicy.new(
   duration: null,
   max_machines: 3,
   max_offline_duration_seconds: 604800,
-  max_version: null
+  max_version: null,
+  money_back_guarantee_days: 30
 )
 ```
 

data/docs/CreateProductWithPolicy.md

@@ -7,7 +7,7 @@
 | **name** | **String** |  |  |
 | **slug** | **String** | Unique within the organization. Defaults to the name, lower cased, without accents and special characters. Starts with `test_` in test products, which is added when missing, and removed in live products. | [optional] |
 | **default_policy** | [**PolicySettings**](PolicySettings.md) |  | [optional] |
-| **is_test_from_product_id** | **String** | Creates a test product: a sandbox of this live product of the organization, starting with copies of its policies, releases and portal settings. | [optional] |
+| **is_test_from_product_id** | **String** | Creates a test product: a sandbox of this live product of the organization, starting with copies of its policies, releases, portal settings and `autoMachineChange`. | [optional] |
 
 ## Example
 

data/docs/CreateToken.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **scope** | **Array<String>** | Permissions of the token. A write permission implies the matching read one. A token creating a token can only give the permissions it has. |  |
+| **scope** | **Array<String>** | Permissions of the token. A write permission implies the other ones of its resource, like the read one: `license:write` implies `license:read` and `license:cancel`. A token creating a token can only give the permissions it has. |  |
 | **expires_in_seconds** | **Integer** | How long the token works, in seconds, from 60 (1 minute) to 31536000 (365 days). Defaults to 900 (15 minutes). A token creating a token can't give it a later expiration than its own: it's shortened to it. | [optional][default to 900] |
 
 ## Example

data/docs/EventActorOneOf.md

@@ -19,7 +19,7 @@ instance = LicenseManager::EventActorOneOf.new(
   type: null,
   id: u2Hk9PzLq,
   name: Jane Doe,
-  email: jane@example.com,
+  email: jane@licensemanager.dev,
   image: https://example.com/jane.png
 )
 ```

data/docs/Integration.md

@@ -14,6 +14,8 @@
 | **status_reason** | **String** | Why the integration isn't `active`, `null` when it is. |  |
 | **last_checked_at** | **Time** | Last time its health was checked, done every day. |  |
 | **last_event_at** | **Time** | Last time it received an event from the provider. |  |
+| **auto_refund** | **Boolean** | Whether canceling a license bought through Stripe refunds its payment. On by default, always off when `canRefund` is false. |  |
+| **can_refund** | **Boolean** | Whether the API key has the optional Refunds: Write permission, checked when connecting and every day. Without it, canceled licenses aren't refunded: refund their payments from Stripe. |  |
 | **created_at** | **Time** |  |  |
 
 ## Example
@@ -27,11 +29,13 @@ instance = LicenseManager::Integration.new(
   livemode: null,
   account_name: Acme Inc.,
   api_key_hint: rk_live_…Ab3d,
-  webhook_url: https://api.example.com/v1/webhooks/stripe/i8Fz4QnRt,
+  webhook_url: https://api.licensemanager.dev/v1/webhooks/stripe/i8Fz4QnRt,
   status: null,
   status_reason: The API key can't manage webhook endpoints: give it the Webhook Endpoints: Write permission,
   last_checked_at: null,
   last_event_at: null,
+  auto_refund: true,
+  can_refund: true,
   created_at: null
 )
 ```

data/docs/IntegrationsApi.md

@@ -11,6 +11,7 @@ All URIs are relative to *https://api.licensemanager.dev*
 | [**disconnect_integration**](IntegrationsApi.md#disconnect_integration) | **DELETE** /v1/integrations/{id} | Disconnect an integration |
 | [**get_stripe_integration**](IntegrationsApi.md#get_stripe_integration) | **GET** /v1/products/{productId}/integrations/stripe | Get the Stripe integration of a product |
 | [**list_stripe_prices**](IntegrationsApi.md#list_stripe_prices) | **GET** /v1/integrations/{id}/stripe/prices | List the Stripe prices of an integration |
+| [**update_integration**](IntegrationsApi.md#update_integration) | **PATCH** /v1/integrations/{id} | Update an integration |
 | [**update_stripe_mapping**](IntegrationsApi.md#update_stripe_mapping) | **PATCH** /v1/integration-mappings/{id} | Change the policy of a mapping |
 
 
@@ -513,6 +514,79 @@ end
 - **Accept**: application/json
 
 
+## update_integration
+
+> <Integration> update_integration(id, update_integration)
+
+Update an integration
+
+Changes the settings of the integration, for every product of its mode. Doesn't accept tokens: only API keys and sessions.  **Required role permission**: `integration:update` when called with a session, granted by the member's role. API keys aren't limited by roles.
+
+### Examples
+
+```ruby
+require 'time'
+require 'license_manager'
+# setup authorization
+LicenseManager.configure do |config|
+  # Configure API key authorization: apiKey
+  config.api_key['x-api-key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['x-api-key'] = 'Bearer'
+end
+
+api_instance = LicenseManager::IntegrationsApi.new
+id = 'i8Fz4QnRt' # String | 
+update_integration = LicenseManager::UpdateIntegration.new # UpdateIntegration | 
+
+begin
+  # Update an integration
+  result = api_instance.update_integration(id, update_integration)
+  p result
+rescue LicenseManager::ApiError => e
+  puts "Error when calling IntegrationsApi->update_integration: #{e}"
+end
+```
+
+#### Using the update_integration_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<Integration>, Integer, Hash)> update_integration_with_http_info(id, update_integration)
+
+```ruby
+begin
+  # Update an integration
+  data, status_code, headers = api_instance.update_integration_with_http_info(id, update_integration)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <Integration>
+rescue LicenseManager::ApiError => e
+  puts "Error when calling IntegrationsApi->update_integration_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **update_integration** | [**UpdateIntegration**](UpdateIntegration.md) |  |  |
+
+### Return type
+
+[**Integration**](Integration.md)
+
+### Authorization
+
+[apiKey](../README.md#apiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## update_stripe_mapping
 
 > <IntegrationMapping> update_stripe_mapping(id, update_integration_mapping)

data/docs/License.md

@@ -20,6 +20,11 @@
 | **max_version** | [**LicenseMaxVersion**](LicenseMaxVersion.md) |  |  |
 | **price** | [**Price**](Price.md) |  |  |
 | **status** | [**LicenseStatus**](LicenseStatus.md) |  |  |
+| **cancellable_until** | **Time** | End of the money back guarantee: until then, the customer can cancel the license from the customer portal, or with a token. Set from the policy's `moneyBackGuaranteeDays` when the license is created. `null` when the customer can't cancel it. |  |
+| **canceled_at** | **Time** | When the license was canceled: validating its key fails since. `null` when it wasn't. |  |
+| **cancellation_reason** | [**CancellationReason**](CancellationReason.md) |  |  |
+| **cancellation_comment** | **String** | Comment given when the license was canceled. `null` when there's none. |  |
+| **stripe_refund_id** | **String** | Id of the Stripe refund of the license's payment once it was canceled, through the Stripe integration. `null` otherwise. |  |
 | **updated_at** | **Time** | Last time the license's settings were edited, not when its key was validated. |  |
 
 ## Example
@@ -44,6 +49,11 @@ instance = LicenseManager::License.new(
   max_version: null,
   price: null,
   status: null,
+  cancellable_until: 2026-02-14T09:30:00.000Z,
+  canceled_at: 2026-01-20T16:12:00.000Z,
+  cancellation_reason: null,
+  cancellation_comment: I only needed it for one project.,
+  stripe_refund_id: re_3MtwBwLkdIwHu7ix0Bs5rA2b,
   updated_at: 2026-01-15T09:30:00.000Z
 )
 ```

data/docs/LicensesApi.md

@@ -4,6 +4,7 @@ All URIs are relative to *https://api.licensemanager.dev*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
+| [**cancel_license**](LicensesApi.md#cancel_license) | **POST** /v1/licenses/{id}/cancel | Cancel a license |
 | [**create_license**](LicensesApi.md#create_license) | **POST** /v1/products/{productId}/licenses | Create a license |
 | [**delete_license**](LicensesApi.md#delete_license) | **DELETE** /v1/licenses/{id} | Delete a license |
 | [**get_license**](LicensesApi.md#get_license) | **GET** /v1/licenses/{id} | Get a license |
@@ -16,13 +17,89 @@ All URIs are relative to *https://api.licensemanager.dev*
 | [**validate_key**](LicensesApi.md#validate_key) | **POST** /v1/products/{productId}/validate-key | Validate a license key |
 
 
+## cancel_license
+
+> <License> cancel_license(id, cancel_license)
+
+Cancel a license
+
+Cancels the license right away: validating its key then fails with `license_expired`, like an expired license, and its status is `canceled`. A cancellation can't be undone.  Customers can cancel their licenses until their `cancellableUntil`, the end of their money back guarantee: tokens can't cancel a license past it, or without one. API keys and sessions can cancel any license.  When the license was bought through the Stripe integration, its payment is refunded in the background, unless the integration disables `autoRefund`, its API key lacks the optional Refunds: Write permission (`canRefund`), or `refund` is `false`: the refund is its price paid, taxes included, and its id is set as `stripeRefundId`. The customer is emailed a confirmation, and the owners and admins of the organization are told about the cancellation and its refund. In test products, the customer is only emailed when their email is a member's of the organization.  Records a `license.canceled` event, then a `license.refunded` or `license.refund_failed` one once the refund is done.  **Token access**: customer, license tokens with the `license:cancel` permission (or the matching write one). A token reaches the license it's scoped to, or the licenses of its customer.  **Required role permission**: `license:cancel` when called with a session, granted by the member's role. API keys aren't limited by roles.
+
+### Examples
+
+```ruby
+require 'time'
+require 'license_manager'
+# setup authorization
+LicenseManager.configure do |config|
+  # Configure API key authorization: apiKey
+  config.api_key['x-api-key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['x-api-key'] = 'Bearer'
+
+  # Configure Bearer authorization (JWT): token
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = LicenseManager::LicensesApi.new
+id = 'l3Nv8KwB' # String | 
+cancel_license = LicenseManager::CancelLicense.new({reason: LicenseManager::CancellationReason::TOO_EXPENSIVE}) # CancelLicense | 
+
+begin
+  # Cancel a license
+  result = api_instance.cancel_license(id, cancel_license)
+  p result
+rescue LicenseManager::ApiError => e
+  puts "Error when calling LicensesApi->cancel_license: #{e}"
+end
+```
+
+#### Using the cancel_license_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<License>, Integer, Hash)> cancel_license_with_http_info(id, cancel_license)
+
+```ruby
+begin
+  # Cancel a license
+  data, status_code, headers = api_instance.cancel_license_with_http_info(id, cancel_license)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <License>
+rescue LicenseManager::ApiError => e
+  puts "Error when calling LicensesApi->cancel_license_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **cancel_license** | [**CancelLicense**](CancelLicense.md) |  |  |
+
+### Return type
+
+[**License**](License.md)
+
+### Authorization
+
+[apiKey](../README.md#apiKey), [token](../README.md#token)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## create_license
 
 > <License> create_license(product_id, create_license)
 
 Create a license
 
-Without a `key`, the license gets a random one, like `7KQ2M-X9ZPA-H4TRC-WN6EY-B3JDF`: 5 groups of 5 characters separated by dashes, each character an upper case letter or a digit other than `O`, `0`, `I` and `1`. That's 32 possible characters encoding 5 bits each, for 125 random bits.  Without a `policyId`, the license follows the product's default policy.  Without an `expiresAt`, the license expires after the duration of its policy, or never when the policy has none. `expiresAt: null` makes it never expire.  Without a `price`, the price paid for the license is unknown: it's left out of the revenue stats.  The values of `maxVersion` left out are taken from the max version of the policy: its hard-coded version, or the times after the creation of the license its versions lock.  The license belongs to the product's customer with the given `email`, which is created when there's none.  With `sendKey: true`, the key is emailed to the customer once the license is created.  The license copies the settings of its policy when it's created: later changes to the policy don't affect it. Its key, policy and customer can't be changed afterwards.  **Required role permission**: `license:create` when called with a session, granted by the member's role. API keys aren't limited by roles.
+Without a `key`, the license gets a random one, like `7KQ2M-X9ZPA-H4TRC-WN6EY-B3JDF`: 5 groups of 5 characters separated by dashes, each character an upper case letter or a digit other than `O`, `0`, `I` and `1`. That's 32 possible characters encoding 5 bits each, for 125 random bits.  Without a `policyId`, the license follows the product's default policy.  Without an `expiresAt`, the license expires after the duration of its policy, or never when the policy has none. `expiresAt: null` makes it never expire.  Without a `price`, the price paid for the license is unknown: it's left out of the revenue stats.  Without a `cancellableUntil`, the customer can cancel the license during the policy's `moneyBackGuaranteeDays` after its creation, or never when the policy has none.  The values of `maxVersion` left out are taken from the max version of the policy: its hard-coded version, or the times after the creation of the license its versions lock.  The license belongs to the product's customer with the given `email`, which is created when there's none.  With `sendKey: true`, the key is emailed to the customer once the license is created.  The license copies the settings of its policy when it's created: later changes to the policy don't affect it. Its key, policy and customer can't be changed afterwards.  **Required role permission**: `license:create` when called with a session, granted by the member's role. API keys aren't limited by roles.
 
 ### Examples
 
@@ -683,7 +760,7 @@ nil (empty response body)
 
 Update a license
 
-The key, policy and customer of a license can't be changed: sending them does nothing.  The changes apply to the next validations of the key, not to the license tokens `validateKey` already returned, which stay valid until they expire. Lowering `maxMachines` doesn't deactivate machines: the ones already active keep validating, and new ones are refused until enough are deactivated.  **Required role permission**: `license:update` when called with a session, granted by the member's role. API keys aren't limited by roles.
+The key, policy and customer of a license can't be changed: sending them does nothing.  The changes apply to the next validations of the key, not to the license tokens `validateKey` already returned, which stay valid until they expire. Lowering `maxMachines` doesn't deactivate machines: the ones already active keep validating, and new ones replace them one at a time when the product has `autoMachineChange`, or are refused until enough are deactivated.  **Required role permission**: `license:update` when called with a session, granted by the member's role. API keys aren't limited by roles.
 
 ### Examples
 
@@ -756,7 +833,7 @@ end
 
 Validate a license key
 
-Checks the license key of the product on a machine and returns a token the application can verify offline with the organization's public key. Doesn't need authentication.  The license must allow the `version`: up to its `maxVersion.version` when it has one, like `\"2.3\"` for every 2.3.z version and older. Its `maxVersion.lockMajorAt` and `maxVersion.lockMinorAt` are enforced once they hard-code `maxVersion.version`, within the hour they're reached. When it doesn't, the error's `latestAllowedVersion` is the latest release of the product the license allows, so the application can offer to install it.  The machine with the `fingerprint` is created when the license has none, and activated when it's deactivated, unless the license is already active on its maximum number of machines. A machine that's already active is never refused for the maximum number of machines, even when it was lowered below the number of active machines. Its `version`, and its `name` and `platform` when given, are updated: they can't be cleared.  The checks run in this order, and the first one failing answers: the license has expired, then it doesn't allow the version, then it's on its maximum number of machines. Each failure is recorded as a `license.validation_failed` event, except for keys that don't exist.  Changes to the license, like deactivating the machine or shortening its expiration, don't revoke the tokens already returned: the application only sees them when it validates its key again, at the latest when its token expires.
+Checks the license key of the product on a machine and returns a token the application can verify offline with the organization's public key. Doesn't need authentication.  The license must allow the `version`: up to its `maxVersion.version` when it has one, like `\"2.3\"` for every 2.3.z version and older. Its `maxVersion.lockMajorAt` and `maxVersion.lockMinorAt` are enforced once they hard-code `maxVersion.version`, within the hour they're reached. When it doesn't, the error's `latestAllowedVersion` is the latest release of the product the license allows, so the application can offer to install it.  The machine with the `fingerprint` is created when the license has none, and activated when it's deactivated, unless the license is already active on its maximum number of machines. A machine that's already active is never refused for the maximum number of machines, even when it was lowered below the number of active machines. Its `version`, and its `name` and `platform` when given, are updated: they can't be cleared.  Unless the product disables `autoMachineChange`, a new machine isn't refused when the license is on its maximum number of machines: it takes the place of the active machine validated the longest ago, which is deactivated with its `overriddenByMachineId` set to the new machine, and recorded as a `machine.deactivated` event. When a machine deactivated this way is validated again, it takes its place back: the machine that overrode it, and the ones that overrode that one in turn, are locked, with their `overriddenByMachineId` set to the machine coming back. A locked machine is always refused, so two machines can't take turns on one place.  The checks run in this order, and the first one failing answers: the license has expired or was canceled, then it doesn't allow the version, then the machine is locked, then it's on its maximum number of machines. Each failure is recorded as a `license.validation_failed` event, except for keys that don't exist.  Changes to the license, like deactivating the machine or shortening its expiration, don't revoke the tokens already returned: the application only sees them when it validates its key again, at the latest when its token expires.
 
 ### Examples
 

data/docs/Machine.md

@@ -9,8 +9,9 @@
 | **fingerprint** | **String** | Identifies the machine. Unique within the license. |  |
 | **platform** | **String** |  |  |
 | **name** | **String** |  |  |
-| **status** | **String** | Whether the machine counts as using the license. |  |
+| **status** | **String** | Whether the machine counts as using the license. A `locked` machine doesn't, and its validations are refused with `machine_locked`: it overrode a machine that came back. See `validateKey`. |  |
 | **version** | **String** | Version of the application last validated on the machine. |  |
+| **overridden_by_machine_id** | **String** | For a machine deactivated or locked by automatic machine changes, the machine that took its place. Validating the key on a deactivated machine that has one takes its place back. `null` otherwise. |  |
 | **last_validated_at** | **Time** | When the license was last validated on the machine. |  |
 | **created_at** | **Time** |  |  |
 | **updated_at** | **Time** |  |  |
@@ -28,6 +29,7 @@ instance = LicenseManager::Machine.new(
   name: Jane's MacBook,
   status: active,
   version: 1.4.2,
+  overridden_by_machine_id: null,
   last_validated_at: 2026-01-15T09:30:00.000Z,
   created_at: 2026-01-15T09:30:00.000Z,
   updated_at: 2026-01-15T09:30:00.000Z

data/docs/MachinesApi.md

@@ -15,7 +15,7 @@ All URIs are relative to *https://api.licensemanager.dev*
 
 Deactivate a machine
 
-The machine no longer counts as using the license, freeing its place when the license has a maximum number of machines. Validating the license key on the machine activates it again, unless the license is on its maximum number of machines by then. Deactivating a deactivated machine does nothing.  The license token `validateKey` returned to the machine isn't revoked: the application can keep running offline until it expires. Machines can't be deleted: they're deleted with their license.  **Token access**: customer, license, machine tokens with the `machine:write` permission (or the matching write one). A token reaches the machine it's scoped to, or the machines of its license or customer.  **Required role permission**: `machine:deactivate` when called with a session, granted by the member's role. API keys aren't limited by roles.
+The machine no longer counts as using the license, freeing its place when the license has a maximum number of machines. Validating the license key on the machine activates it again, unless the license is on its maximum number of machines by then. Deactivating a deactivated or locked machine does nothing.  The license token `validateKey` returned to the machine isn't revoked: the application can keep running offline until it expires. Machines can't be deleted: they're deleted with their license.  **Token access**: customer, license, machine tokens with the `machine:write` permission (or the matching write one). A token reaches the machine it's scoped to, or the machines of its license or customer.  **Required role permission**: `machine:deactivate` when called with a session, granted by the member's role. API keys aren't limited by roles.
 
 ### Examples
 

data/docs/Policy.md

@@ -13,6 +13,7 @@
 | **max_machines** | **Integer** | Maximum number of active machines of the licenses created with this policy. `null` when there's no limit. |  |
 | **max_offline_duration_seconds** | **Integer** | Longest the applications can run offline with the licenses created with this policy, in seconds. |  |
 | **max_version** | [**PolicyMaxVersion**](PolicyMaxVersion.md) |  |  |
+| **money_back_guarantee_days** | **Integer** | Number of days after their creation during which customers can cancel the licenses created with this policy, from the customer portal or with `cancelLicense`. `null` when they can't. |  |
 | **license_count** | **Integer** | Number of licenses following this policy. |  |
 | **created_at** | **Time** |  |  |
 | **updated_at** | **Time** |  |  |
@@ -32,6 +33,7 @@ instance = LicenseManager::Policy.new(
   max_machines: 3,
   max_offline_duration_seconds: 604800,
   max_version: null,
+  money_back_guarantee_days: 30,
   license_count: 12,
   created_at: 2026-01-15T09:30:00.000Z,
   updated_at: 2026-01-15T09:30:00.000Z