Skip to main content
POST
/
api
/
v1
/
iframes
/
bulk-delete
Bulk Delete Widgets
curl --request POST \
  --url https://api.example.com/api/v1/iframes/bulk-delete \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    "<string>"
  ]
}
'
{
  "deleted": [
    "<string>"
  ],
  "not_deleted": [
    "<string>"
  ],
  "requested": 123
}
Deletes multiple widgets at once. Deletion is always scoped to your own widgets — IDs that don’t belong to you are skipped and returned in not_deleted.

​
Authentication

Requires a Bearer token (API key) or a dashboard session.

​
Request

​
ids
string[]
required
Widget config UUIDs to delete (max 500). Duplicates are ignored.

​
Response

​
deleted
string[]
IDs that were deleted.
​
not_deleted
string[]
Requested IDs that were skipped (not found or not owned by the caller).
​
requested
number
Count of distinct IDs requested.

​
Example

curl
curl -X POST https://www.hitheo.ai/api/v1/iframes/bulk-delete \
  -H "Authorization: Bearer $THEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ids": ["CONFIG_A", "CONFIG_B"] }'