> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bulk Delete Widgets

> Delete up to 500 widget configurations in a single request.

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

<ParamField body="ids" type="string[]" required>
  Widget config UUIDs to delete (max 500). Duplicates are ignored.
</ParamField>

## Response

<ResponseField name="deleted" type="string[]">
  IDs that were deleted.
</ResponseField>

<ResponseField name="not_deleted" type="string[]">
  Requested IDs that were skipped (not found or not owned by the caller).
</ResponseField>

<ResponseField name="requested" type="number">
  Count of distinct IDs requested.
</ResponseField>

## Example

```bash curl theme={null}
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"] }'
```