Skip to main content
DELETE
DELETE /v1/services/databaseServices/{id}

Delete a Database Service

Delete a database service by ID or fully qualified name. Supports soft delete (default), hard delete, and restore operations.

Delete by ID

string
required
UUID of the database service to delete.
boolean
default:"false"
Recursively delete child databases, schemas, and tables.
boolean
default:"false"
Permanently delete the database service. If false, the service is soft-deleted and can be restored.

Delete by Name

Use DELETE /v1/services/databaseServices/name/{fqn} to delete by fully qualified name.
string
required
Fully qualified name of the database service (e.g., snowflake_prod).
boolean
default:"false"
Recursively delete child databases, schemas, and tables.
boolean
default:"false"
Permanently delete the database service.

Restore a Soft-Deleted Database Service

Use PUT /v1/services/databaseServices/restore to restore a soft-deleted database service.
string
required
UUID of the soft-deleted database service to restore.
DELETE /v1/services/databaseServices/{id}

Returns

Soft delete returns the database service object with deleted: true. Hard delete returns no content (204). Restore returns the restored database service object.

Error Handling