Merge pull request #17903 from newrelic/rhs-delete-accounts

Add account deletion section.

src/content/docs/accounts/accounts-billing/account-setup/downgradecancel-account.mdx

@@ -57,21 +57,49 @@ If you have a Pro or Enterprise edition with [a long-term contract](/docs/accoun
  </Collapser>
 </CollapserGroup>
 
-## Delete organization or accounts [#cancel]
+## Cancel an account [#cancel-account]
 
-If you're seeking to delete one or more accounts in an organization, but keep your organization, contact [support](/docs/using-new-relic/welcome-new-relic/get-started/find-help-use-support-portal).
+If you're using the Pro or Enterprise edition, or if you've downgraded to the Free edition, you can cancel one or more accounts while keeping your organization.
 
-If you're seeking to delete your New Relic organization entirely, including any and all accounts within it, your organization must meet the following requirements:
+When you cancel an account:
 
-* It has only one account, and one user.
- * If you have more than one account in your organization, contact [support](/docs/using-new-relic/welcome-new-relic/get-started/find-help-use-support-portal).
- * If you have more than one user, you can delete users via the [User management UI](/docs/accounts/accounts-billing/new-relic-one-user-management/user-management-ui-and-tasks/#delete-users) or via [Nerdgraph](/docs/apis/nerdgraph/examples/nerdgraph-manage-users/#delete-users).
-* It's on our newer pricing model. 
- * Most organizations are, but if you're not sure, see [Pricing models](/docs/accounts/original-accounts-billing/original-product-based-pricing/overview-pricing-models/#determine-pricing) for how to determine that. If you're on the older pricing model, contact [support](/docs/using-new-relic/welcome-new-relic/get-started/find-help-use-support-portal).
-* It must not have an active paid subscription.
- * If you have an active paid subscription, see the section [Downgrade your edition](#downgrading) above in this document.
+* It is disabled, but it's still present in your organization in **Accounts > Cancelled accounts**.
+* Users, groups, and custom roles remain, but access grants that are assigned to that cancelled account lose all connections to the account. You should also remove any access grant associated with this account, otherwise users may see errors when they try to view it.
+* Any API keys associated with a cancelled account become inactive and can't be reassigned to another account. 
 
-### To delete your organization, follow these steps:
+### Who can cancel an account [#who-cancel]
+
+To cancel an account you must be a user who is:
+
+* A full platform user.
+* In a group that has the Organization [administrative setting](/docs/accounts/accounts-billing/new-relic-one-user-management/user-management-concepts/#admin-settings).
+
+### How to cancel an account [#how-to-cancel]
+
+You can only cancel an account using our NerdGraph API. You can't cancel an account in the UI.
+
+Make sure you're a user who can cancel an account, and then see the NerdGraph tutorial [Cancel an account](/docs/apis/nerdgraph/examples/manage-accounts-nerdgraph).
+
+## Delete your organization [#delete-org]
+
+Besides cancelling individual accounts, you can also delete your entire New Relic organization. This takes some preparation, so review the steps below. 
+
+### Preparation for deleting an organization [#preparation-org-delete]
+
+Before trying to delete your organization, please confirm the following: 
+
+* Your organization only has one account. If your organization has more than one account:
+ 1. Cancel additional accounts using our [Nerdgraph API](/docs/apis/nerdgraph/examples/manage-accounts-nerdgraph) (see [Cancel an account](#cancel-account)). 
+ 2. After you've cancelled all but one account, contact [New Relic support](/docs/using-new-relic/welcome-new-relic/get-started/find-help-use-support-portal) to remove any cancelled accounts.
+* Your organization only has one user. If you have more than one user, you can delete users via the [User management UI](/docs/accounts/accounts-billing/new-relic-one-user-management/user-management-ui-and-tasks/#delete-users) or via [Nerdgraph](/docs/apis/nerdgraph/examples/nerdgraph-manage-users/#delete-users).
+* Your organization is on our newer pricing model. 
+ * If you're not sure which model you're on, see [Pricing models](/docs/accounts/original-accounts-billing/original-product-based-pricing/overview-pricing-models/#determine-pricing) for how to determine that. 
+ * If you're on the older pricing model, contact [support](/docs/using-new-relic/welcome-new-relic/get-started/find-help-use-support-portal).
+* You organization is on the Free edition. In other words, you can't be on Standard, Pro, or Enterprise editions with paid subscriptions. If you have an active paid subscription, see the [Downgrade your edition](#downgrading) above in this document.
+
+### How to delete your organization [#how-to-delete-org]
+
+If you meet the [requirements](#delete-org) for deleting your organization, complete these steps:
 
 1. From the [user menu](/docs/accounts/accounts-billing/general-account-settings/intro-account-settings), click <DNT>**Administration**</DNT>.
 2. Click <DNT>**Access management**</DNT>.

src/content/docs/apis/nerdgraph/examples/manage-accounts-nerdgraph.mdx

@@ -1,17 +1,17 @@
 ---
-title: "NerdGraph tutorial: view, create, and rename accounts"
+title: "NerdGraph tutorial: View, create, rename, or cancel accounts"
 tags:
  - APIs
  - NerdGraph
  - Examples
-metaDescription: "Examples of using New Relic's NerdGraph API to view, create, and rename accounts." 
+metaDescription: "Examples of using New Relic's NerdGraph API to view, create, rename, or cancel accounts." 
 redirects:
  - /docs/apis/nerdgraph/examples/export-dashboards-pdfpng-api-tutorial
  - /docs/apis/nerdgraph/examples
 freshnessValidatedDate: never
 ---
 
-As an alternative to [using the New Relic UI](/docs/accounts/accounts-billing/account-structure/add-accounts), you can use [NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph) to view your organization's accounts, create accounts, and rename accounts. 
+As an alternative to [using the New Relic UI](/docs/accounts/accounts-billing/account-structure/add-accounts), you can use [NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph) to view your organization's accounts, as well as create, rename, or cancel accounts. 
 
 ## Requirements [#requirements]
 
@@ -26,12 +26,6 @@ Before you use NerdGraph to manage your accounts, it will probably help you to u
 * [The basics of using NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph)
 * That you can [track changes to your New Relic account](/docs/data-apis/understand-data/event-data/query-account-audit-logs-nrauditevent) 
 
-This tutorial will show you how to: 
-
-* View accounts 
-* Rename accounts
-* Add accounts
-
 ## Tips on terms and fields [#field-definitions]
 
 Some tips about some of the fields used in these requests: 
@@ -106,6 +100,27 @@ mutation {
 }
 ```
 
+## Cancel an account [#cancel-an-account]
+
+If you no longer want to keep an account active, you can cancel it using NerdGraph. The option to cancel an account is only available with NerdGraph. You can't cancel an account in the UI.
+
+Before you cancel an account, review the effects of [cancelling an account](/docs/accounts/accounts-billing/account-setup/downgradecancel-account). Once you're sure you want to cancel an account, you can use this mutation:
+
+```graphql
+mutation {
+ accountManagementCancelAccount(id: $accountId) {
+ id
+ isCanceled
+ name
+ regionCode
+ }
+}
+```
+
+<Callout variant="tip">
+ As an alternative to cancelling an account, consider [removing a monitored entity](/docs/apis/nerdgraph/examples/nerdgraph-entities-api-tutorial/#delete-entities).
+</Callout>
+
 ## Errors [#errors]
 
 Here are some errors and what they mean: 
@@ -163,11 +178,6 @@ Contact [support](/docs/new-relic-solutions/solve-common-issues/find-help-use-su
 </tbody>
 </table>
 
-## Delete an account [#delete]
-
-You currently cannot delete accounts using NerdGraph. Instead, try these related options: 
 
-* [Downgrade or canceling accounts](/docs/accounts/accounts-billing/account-setup/downgradecancel-account)
-* [Remove a monitored entity](/docs/apis/nerdgraph/examples/nerdgraph-entities-api-tutorial/#delete-entities)