Skip to main content
DELETE
Delete Database
Deleting a database first takes an automatic safety snapshot, on every plan. If that snapshot fails, nothing is deleted and the request answers INTERNAL_SERVER_ERROR. An API key needs the databases:delete scope.
string
required
The ID of the database to delete.
string
If the database belongs to a workspace, the workspace’s ID.

Response

string
The ID of the deleted database.

Error Responses

string
  • DATABASE_NOT_FOUND: The database does not exist (404).
  • ACCESS_DENIED: Your account can’t act on this database (403).
  • FORCED_SNAPSHOT_RATE_LIMIT: Too many safety snapshots were attempted recently on this database or on your account; the database was not deleted (429).
  • INTERNAL_SERVER_ERROR: The safety snapshot could not be taken; the database was not deleted (500).
  • OPERATION_IN_PROGRESS: Another lifecycle operation is running on this database (409).
  • INTERNAL_SERVER_ERROR: The platform could not remove the database; retry later (500).