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

Delete a Storage Service

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

Delete by ID

id
string
required
UUID of the storage service to delete.
recursive
boolean
default:"false"
Recursively delete child entities (containers).
hardDelete
boolean
default:"false"
Permanently delete the storage service. If false, the storage service is soft-deleted and can be restored.

Delete by Name

Use DELETE /v1/services/storageServices/name/{fqn} to delete by fully qualified name.
fqn
string
required
Fully qualified name of the storage service (e.g., s3_datalake).
recursive
boolean
default:"false"
Recursively delete child entities (containers).
hardDelete
boolean
default:"false"
Permanently delete the storage service.

Restore a Soft-Deleted Storage Service

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

Returns

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

Error Handling