<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Cancels your workspace's paid subscription. Only the workspace owner can cancel.

<Warning>This takes effect right away, with no confirmation step. By default the plan stops renewing: it stays active until the end of the billing period, then the workspace moves to the Free plan, and nothing is refunded. With ils_refund_consent: true, the paid plan ends immediately and part of the period is refunded, which can't be undone.</Warning>

Before the period ends, you can undo a default cancellation with Reactivate subscription, or with Turn on auto-renew for a workspace billed through Wix.

Immediate cancellation with a refund. When Preview ILS refund shows you're eligible, send ils_refund_consent: true to cancel right away and get part of the period back. The response then carries ils_refund. If an earlier immediate cancellation on this subscription refunded you but didn't finish, this call finishes it right away, even without consent.

<Warning>Check ils_refund.status. refund_issued_cancel_failed means you were refunded but the subscription is still active. Call this endpoint again to finish cancelling.</Warning>

Apps over the Free plan's limit. If Get cancellation impact shows apps.over_limit: true, send cancellation_selection.keep_app_ids to choose which apps stay published. When the plan ends, if the workspace is still over the limit, every other app is unpublished. Leave cancellation_selection out to unpublish nothing.

If a request fails after Base44 reached the payment provider, the cancellation may already have taken effect. Cancelling again is safe.

The base rate limit is 5 requests per hour per user. See Rate limits for the multiplier your plan gets.

<Warning>Send only the fields documented here. Other request fields aren't supported and their behavior can change.</Warning>

{
  "reason": "Too expensive",
  "feedback": "We only needed it for one launch.",
  "missing_features_description": "A Salesforce connector.",
  "cancellation_selection": {
    "keep_app_ids": [
      "6820f3a4e7b91d003c45a1f2"
    ]
  }
}

{
  "success": true,
  "ils_refund": {
    "refund_agorot": 4275,
    "currency": "ils",
    "status": "issued",
    "interval": "monthly"
  }
}