v1

latestOpenAPI 3.0.32026-07-14314472448.6 KB

folders

Delete folder.

Deletes an existing folder identified by UID along with all dashboards (and their alerts) stored in the folder. This operation cannot be reverted. If nested folders are enabled then it also deletes all the subfolders.

Use: /apis/folder.grafana.app/v1/namespaces/{ns}/folders/{folder_uid}

delete/folders/{folder_uid}

Path parameters

folder_uidstring required

Query parameters

forceDeleteRulesboolean

If true any Grafana 8 Alerts under this folder will be deleted. Set to false so that the request will fail if the folder contains any Grafana 8 Alerts.

Response

(empty)

idinteger required

ID Identifier of the deleted folder.

messagestring required

Message Message of the deleted folder.

titlestring required

Title of the deleted folder.

Example response

{
  "id": 65,
  "message": "Folder My Folder deleted",
  "title": "My Folder"
}