Delete
[POST] .../v1/folder/delete
Deletes folder (soft-delete). Use this destructive method only after confirming that an empty folder should be removed from the visible file storage tree. The request body is required and must include a positive id; successful deletion performs a soft delete and returns row_affected for the folder record. Root and protected system folders cannot be deleted and deletion is rejected while the folder contains non-deleted files or non-deleted child folders. The caller must have folder delete permission and write access to the folder; missing body, invalid id, protected folder deletion, missing folder, denied permission, unsupported database version, non-empty folders and database errors are returned as HTTP 200 ErrorResult business errors.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | Int64 | Required | Folder ID. |
Request Example
{
"id": 10
}
Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
| result | Update | Update operation result. |
Response Example
{
"ok": true,
"result": {
"row_affected": 1
}
}