Commands › Inventory
inventory_delete_folder
Permanently delete a folder and its contents
Usage
curl -X POST "https://api.lifebots.cloud/api/bot.html" \
-H "Content-Type: application/json" \
-d '{
"action": "inventory_delete_folder",
"apikey": "YOUR_API_KEY",
"botname": "Joe Resident",
"secret": "bot-secret-123",
"folderId": "7c1e9b2a-4d3f-4a8b-9c6d-000000000000",
"dataType": "json"
}' Every request also needs apikey, botname and secret — see Authentication.
Parameters
| Name | Required | Description |
|---|---|---|
folderIdUUID | yes | Folder UUID. Also accepted as: folderUuid |
Example response
{
"result": "OK",
"message": "Folder deleted successfully"
} With dataType=json. A failure has result: "FAIL" and the reason in resulttext — see Responses & errors.
Good to know
- Deletes outright — it does not go to Trash.
- Answers OK even if the folder did not exist.