> For the complete documentation index, see [llms.txt](https://docs.wproofreader.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wproofreader.com/v6.12.0/api-reference/custom-dictionary-api/actions/delete-dictionary-delete.md).

# Delete dictionary (delete)

Deletes one or more dictionaries.

This operation is irreversible.

### What it does

* Deletes dictionaries by `id`.
* Accepts one `id` or a comma-separated list.

{% hint style="warning" %}
Delete is permanent. There is no undo.
{% endhint %}

### Required parameters

| Parameter | Type                                | Notes                                |
| --------- | ----------------------------------- | ------------------------------------ |
| `cmd`     | string                              | `custom_dictionary`                  |
| `action`  | string                              | `delete`                             |
| `id`      | integer or comma-separated integers | Example: `101565` or `101565,101566` |

### Optional parameters

| Parameter  | Type   | Notes                     |
| ---------- | ------ | ------------------------- |
| `format`   | string | `json` (default) or `xml` |
| `callback` | string | JSONP wrapper (JSON only) |

### Request example

```
cmd=custom_dictionary&action=delete&id=101565,101566
```

### Response example

```json
{
  "result": [
    {
      "id": 101565,
      "description": "Engineering terms",
      "status": "success",
      "message": ["Dictionary deleted."]
    }
  ]
}
```

### Possible errors

* Missing `id`.
* Dictionary `id` not found.

See [Errors reference](/v6.12.0/api-reference/custom-dictionary-api/errors-reference.md).

### Notes and edge cases

* Duplicate IDs are ignored.
* Use `getdicts` before delete to confirm IDs and descriptions.