diff --git a/deploy/deployments.mdx b/deploy/deployments.mdx index 2859ff253a..24cbcce1c2 100644 --- a/deploy/deployments.mdx +++ b/deploy/deployments.mdx @@ -30,6 +30,10 @@ If you have the GitHub App installed, but changes are still not deploying, manua You can permanently delete a deployment from the [Danger zone](https://app.mintlify.com/settings/organization/danger-zone) in your dashboard settings. This action is irreversible and removes all deployment data, including any associated preview deployments. + + Only organization admins can delete a deployment. If you are not an admin, ask an admin in your organization to perform this action. + + Go to the [Danger zone](https://app.mintlify.com/settings/organization/danger-zone) in the settings page of your dashboard. @@ -49,3 +53,26 @@ You can permanently delete a deployment from the [Danger zone](https://app.mintl If you have multiple deployments, Mintlify redirects you to another deployment after deletion. If you delete your only deployment, Mintlify redirects you to the Mintlify homepage. When you delete a deployment, the organization admin receives an email notification confirming the deletion. + +## Delete your organization or account + +Mintlify does not have a separate "delete organization" or "delete account" control. Your organization exists to contain your deployments, so removing your deployments is how you decommission it. + +- If your organization has a single deployment, follow [Delete a deployment](#delete-a-deployment) to remove it. Deleting your only deployment effectively decommissions the organization: any active subscription is cancelled with a prorated credit, and you are redirected to the Mintlify homepage. +- If your organization has multiple deployments, delete each one from the Danger zone to fully wind down the organization. + +What is removed when you delete your only deployment: + +- All deployment data, including preview deployments, content, and analytics history. +- Your active subscription for that deployment, with a prorated credit for any unused time in the billing period. + +What is retained: + +- The organization record itself, including its name and member list, remains in Mintlify's systems so that historical billing records stay attached to a valid entity. The organization has no active deployments and incurs no further charges. +- Prior billing history and invoices are kept for accounting and tax purposes. + +If you need the organization record, member list, or personal account data itself erased (for example, to exercise a data deletion right), contact [support@mintlify.com](mailto:support@mintlify.com) after deleting your deployments. + + + Only organization admins can delete deployments and therefore decommission an organization. Non-admin members should ask an admin in their organization rather than contacting support. +