Databases
Delete Database
Deletes a database by its ID right away, without creating a snapshot. Create one first if you want a backup. Requires the databases:delete scope.
DELETE
Delete Database
Deleting a database through the API deletes it right away and does not create a snapshot. If you want a backup,
call Create snapshot first. (The panel’s delete dialog offers
Create snapshot before deleting, off by default.) 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).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).
Last modified on November 8, 2026