Delete

[POST] .../v1/widget/delete

Deletes widgets. Use this destructive batch method to soft-delete one or more widgets from editable dashboards. The request body is a required array; every item must contain a positive widget id and each widget is checked against its dashboard ownership, dashboard all-delete permission, system dashboard protection and fixed-dashboard restriction. The method marks all requested widget rows deleted in one transaction, writes action log records, clears widget cache and returns row_affected with the deleted ids. Business errors such as missing or empty array body, invalid ids, missing widgets or dashboards, denied access, system or fixed dashboard restrictions, database errors, transaction failures, no affected rows and action-log failures are returned as HTTP 200 ErrorResult.

Request Parameters

Request Example

[
  {
    "id": 15
  },
  {
    "id": 16
  }
]

Response Parameters

Response Example

{
  "ok": true,
  "result": {
    "row_affected": 2,
    "ids": [
      15,
      16
    ]
  }
}