Deletes a database.

DELETE {{baseUrl}}/api/v2/databases/:name?ifExists=false&restrict=false

Deletes the specified database. If you enable the ifExists parameter, the operation succeeds even if the database does not exist. Otherwise, a 404 failure is returned if the database does not exist. if the drop is unsuccessful.

Request Params

KeyDatatypeRequiredDescription
ifExistsbooleanQuery parameter that specifies how to handle the request for a resource that does not exist:
  • true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource.
  • false: The endpoint throws an error if the resource doesn't exist. | | restrict | boolean | | Whether to drop the database if foreign keys exist that reference any tables in the database.
  • true: Return a warning about existing foreign key references and don't drop the database.
  • false: Drop the database and all objects in the database, including tables with primary or unique keys that are referenced by foreign keys in other tables. |

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"status":"\u003cstring\u003e"}