Deleting a database

To delete a database and its contents, send a DELETE request to https://$ACCOUNT.cloudant.com/$DATABASE.

No additional check is made to ensure that you really intended to delete the database.

See the following example that uses HTTP to delete an IBM Cloudant database:

DELETE /$DATABASE HTTP/1.1
Host: $ACCOUNT.cloudant.com

See the following example to delete an IBM Cloudant database:

curl -H "Authorization: Bearer $API_BEARER_TOKEN" -X DELETE "$SERVICE_URL/$DB_NAME"

import com.ibm.cloud.cloudant.v1.Cloudant;
import com.ibm.cloud.cloudant.v1.model.DeleteDatabaseOptions;
import com.ibm.cloud.cloudant.v1.model.Ok;

Cloudant service = Cloudant.newInstance();

DeleteDatabaseOptions databaseOptions =
    new DeleteDatabaseOptions.Builder()
        .db("<db-name>")
        .build();

Ok response =
    service.deleteDatabase(databaseOptions).execute()
        .getResult();

System.out.println(response);

import { CloudantV1 } from '@ibm-cloud/cloudant';

const service = CloudantV1.newInstance({});

service.deleteDatabase({db: '<db-name>'}).then(response => {
  console.log(response.result);
});

from ibmcloudant.cloudant_v1 import CloudantV1

service = CloudantV1.new_instance()

response = service.delete_database(db='<db-name>').get_result()

print(response)

deleteDatabaseOptions := service.NewDeleteDatabaseOptions(
  "<db-name>",
)

ok, response, err := service.DeleteDatabase(deleteDatabaseOptions)
if err != nil {
  panic(err)
}

b, _ := json.MarshalIndent(ok, "", "  ")
fmt.Println(string(b))

The previous Go example requires the following import block:

import (
   "encoding/json"
   "fmt"
   "github.com/IBM/cloudant-go-sdk/cloudantv1"
)

All Go examples require the service object to be initialized. For more information, see the API documentation's Authentication section for examples.

If deletion succeeds, you get a 200 or 202 response. An error response uses the HTTP status code to indicate what went wrong.

See the following example response that is received after a database is deleted successfully:

{
	"ok": true
}