> ## Documentation Index
> Fetch the complete documentation index at: https://commet.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# subscription.version_change_canceled

> Fired when a move to another plan version scheduled for renewal will no longer happen.

## When this fires

A move to another version that was waiting for the subscription's renewal will not happen, and the subscription stays on its version. `toVersionId` is the version it was going to move to, and `reason` says why:

| `reason` | What happened |
| - | - |
| `canceled_by_merchant` | You canceled the move with [Revoke scheduled version change](https://commet.co/docs/api-reference/subscriptions/revoke-scheduled-version-change.md), or canceled the plan move for every subscriber or for this one. |
| `addon_unavailable` | At renewal the subscription has an active add-on the destination version does not sell. |
| `seat_limit_exceeded` | At renewal the subscription has more seats than the destination version allows. |
| `price_not_found` | The destination version does not sell the price the subscription pays. |
| `missing_regional_price` | The destination version does not sell the subscription's currency. A move never changes the currency. |
| `version_change_failed` | The move could not be applied at renewal. |

A move made now has nothing pending, so it never fires this event. Neither does a new move that replaces the pending one, a change to another plan, or a subscription that ends instead of renewing: the pending move is dropped and `scheduledVersionChange` becomes `null`. To move the subscription later, resolve what `reason` names and request the move again.

Only endpoints that list this event receive it. New event types are not added to existing endpoints: add it to the endpoint's events in **Settings → Webhooks** or with [Update webhook endpoint](https://commet.co/docs/api-reference/webhooks/update-webhook-endpoint.md).


## OpenAPI

````yaml /openapi/en/webhooks/2026-08-27.json webhook subscription.version_change_canceled
openapi: 3.1.0
info:
  title: Commet Webhooks
  version: '2026-08-27'
  description: >-
    Outbound webhook events emitted by the Commet API. Each event is delivered
    as a signed POST to your configured endpoints.
servers: []
security: []
paths: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.