feat(dedicated): task-based for delete databases

content/influxdb/cloud-dedicated/admin/databases/delete.md

@@ -2,6 +2,7 @@
 title: Delete a database
 description: >
   Use the [`influxctl database delete` command](/influxdb/cloud-dedicated/reference/cli/influxctl/database/delete/)
+  or the Management HTTP API
   to delete a database from your InfluxDB Cloud Dedicated cluster.
   Provide the name of the database you want to delete.
 menu:
@@ -9,30 +10,29 @@ menu:
     parent: Manage databases
 weight: 203
 list_code_example: |
+  ##### CLI
   ```sh
   influxctl database delete <DATABASE_NAME>
   ```
+
+  ##### API
+  ```sh
+  curl \
+    --location "https://console.influxdata.com/api/v0/accounts/ACCOUNT_ID/clusters/CLUSTER_ID/databases/DATABASE_NAME" \
+    --request DELETE \
+    --header "Accept: application/json" \
+    --header "Authorization: Bearer MANAGEMENT_TOKEN"
+  ```
 related:
   - /influxdb/cloud-dedicated/reference/cli/influxctl/database/delete/
+  - /influxdb/cloud-dedicated/reference/api/
 ---
 
-Use the [`influxctl database delete` command](/influxdb/cloud-dedicated/reference/cli/influxctl/database/delete/)
+Use the [`influxctl` CLI](/influxdb/cloud-dedicated/reference/cli/influxctl/)
-to delete a database from your InfluxDB Cloud Dedicated cluster.
+or the Management HTTP API to create a database in your {{< product-name omit=" Clustered" >}} cluster.
-
-1.  If you haven't already, [download and install the `influxctl` CLI](/influxdb/cloud-dedicated/reference/cli/influxctl/#download-and-install-influxctl).
-2.  Run the `influxctl database delete` command and provide the following:
-
-    - Name of the database to delete
-
-3. Confirm that you want to delete the database.
-
-{{% code-placeholders "DATABASE_NAME" %}}
-```sh
-influxctl database delete DATABASE_NAME
-```
-{{% /code-placeholders %}}
 
 {{% warn %}}
+
 #### Deleting a database cannot be undone
 
 Once a database is deleted, data stored in that database cannot be recovered.
@@ -40,4 +40,78 @@ Once a database is deleted, data stored in that database cannot be recovered.
 #### Cannot reuse database names
 
 After a database is deleted, you cannot reuse the same name for a new database.
-{{% /warn %}}
+{{% /warn %}}
+
+{{< tabs-wrapper >}}
+{{% tabs %}}
+[influxctl](#)
+[Management API](#)
+{{% /tabs %}}
+{{% tab-content %}}
+
+<!------------------------------- BEGIN INFLUXCTL ----------------------------->
+
+1.  If you haven't already, [download and install the `influxctl` CLI](/influxdb/cloud-dedicated/reference/cli/influxctl/#download-and-install-influxctl), and then [configure an `influxctl` connection profile](/influxdb/cloud-dedicated/reference/cli/influxctl/#configure-connection-profiles) for your cluster.
+
+2.  Run the `influxctl database delete` command and provide the following:
+
+    - Name of the database to delete
+
+3. Confirm that you want to delete the database.
+
+{{% code-placeholders "DATABASE_NAME" %}}
+
+```sh
+influxctl database delete DATABASE_NAME
+```
+
+{{% /code-placeholders %}}
+
+<!-------------------------------- END INFLUXCTL ------------------------------>
+{{% /tab-content %}}
+{{% tab-content %}}
+<!------------------------------- BEGIN cURL ---------------------------------->
+
+_This example uses [cURL](https://curl.se/) to send a Management HTTP API request, but you can use any HTTP client._
+
+1. If you haven't already, follow the instructions to [install cURL](https://everything.curl.dev/install/index.html) for your system.
+2. In your terminal, use cURL to send a request to the following {{% product-name %}} console endpoint:
+
+   {{% api-endpoint endpoint="https://console.influxdata.com/api/v0/accounts/ACCOUNT_ID/clusters/CLUSTER_ID/databases/DATABASE_NAME" method="delete" api-ref="/influxdb/cloud-dedicated/api/management/#operation/DeleteClusterDatabase" %}}
+
+   In the URL, provide the following:
+
+   - `ACCOUNT_ID`: The ID of the [account](/influxdb/cloud-dedicated/get-started/setup/#request-an-influxdb-cloud-dedicated-cluster) that the cluster belongs to _(see how to [list cluster details](/influxdb/cloud-dedicated/admin/clusters/list/#detailed-output-in-json))_.
+   - `CLUSTER_ID`: The ID of the [cluster](/influxdb/cloud-dedicated/get-started/setup/#request-an-influxdb-cloud-dedicated-cluster) that you want to manage _(see how to [list cluster details](/influxdb/cloud-dedicated/admin/clusters/list/#detailed-output-in-json))_.
+   - `DATABASE_NAME`: The name of the [database](/influxdb/cloud-dedicated/admin/databases/) that you want to delete _(see how to [list databases](/influxdb/cloud-dedicated/admin/databases/list/))_.
+
+   Provide the following request headers:
+
+   - `Accept: application/json` to ensure the response body is JSON content
+   - `Authorization: Bearer` and a [Management API token](/influxdb/cloud-dedicated/admin/tokens/management/) for your cluster _(see how to [create a management token](/influxdb/cloud-dedicated/admin/tokens/management/) for Management API requests)_.
+
+   Specify the `DELETE` request method.
+
+The following example shows how to use the Management API to delete a database:
+
+{{% code-placeholders "DATABASE_NAME|ACCOUNT_ID|CLUSTER_ID|MANAGEMENT_TOKEN" %}}
+
+```sh
+curl \
+   --location "https://console.influxdata.com/api/v0/accounts/ACCOUNT_ID/clusters/CLUSTER_ID/databases/DATABASE_NAME" \
+   --request DELETE \
+   --header "Accept: application/json" \
+   --header "Authorization: Bearer MANAGEMENT_TOKEN"
+```
+
+{{% /code-placeholders %}}
+
+Replace the following in your request:
+
+- {{% code-placeholder-key %}}`ACCOUNT_ID`{{% /code-placeholder-key %}}: the ID of the {{% product-name %}} account to create the database for
+- {{% code-placeholder-key %}}`CLUSTER_ID`{{% /code-placeholder-key %}}: the ID of the {{% product-name %}} cluster to create the database for
+- {{% code-placeholder-key %}}`MANAGEMENT TOKEN`{{% /code-placeholder-key %}}: a [management token](/influxdb/cloud-dedicated/admin/tokens/management/) for your {{% product-name %}} cluster
+- {{% code-placeholder-key %}}`DATABASE_NAME`{{% /code-placeholder-key %}}: your {{% product-name %}} database
+<!------------------------------- END cURL ------------------------------------>
+{{% /tab-content %}}
+{{< /tabs-wrapper >}}