Skip to main content

Delete a database

DELETE /projects/:projectid/databases/:dbid

Destroy a database and everything in it.

Irreversible. Every table, column and row goes with it.

Authentication

  • Project API key: The credential for everything external. Created in Project Settings, bound to one project, and limited to the scopes it was granted. Format: proj.<keyId>.<secret>.
  • Required permission: databases.admin on :dbid.

Path parameters

NameTypeRequiredDefaultDescription
projectidstringYes-The project id.
dbidstringYes-The database to destroy.

Example request

curl -X DELETE \
-H "Authorization: proj.KEY_ID.SECRET" \
{{BASE_URL}}/projects/{{PROJECT_ID}}/databases/DATABASE_ID

Responses

204

Deleted. No body.

403

The key lacks the provision permission.