---
title: "Delete blocklist entries"
method: DELETE
path: "/blocklist"
tags: ["Blocklist"]
---

# Delete blocklist entries

`DELETE /blocklist`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/blocklist`
- Auth: HTTP bearer

Removes up to 1000 entries in one call, by id or by value. Values are matched case-insensitively against both the domain and the email-address column, so unblocking "acme.com" removes the domain entry, not the individual addresses on it. `scope` limits the delete to one list and defaults to "workspace"; "all" covers both, and anything touching the account-wide list requires a main workspace's key. Entries that match nothing the caller may delete are counted as skipped rather than failing the call.

## Request body

- ModelsBlocklistDeleteRequest
  - `ids` integer[]: Ids are entry ids as returned by GET /blocklist.
  - `scope` 'workspace' | 'global' | 'all': Scope limits the delete to one list: "workspace" (default), "global", or "all". Deleting from "global" requires a main workspace's key.
  - `values` string[]: Values are domains or email addresses to unblock, matched case-insensitively. Values not present are counted as skipped.

## Response `200`

OK

- ModelsBlocklistDeleteResponse
  - `deleted` integer: Deleted is the number of entries removed.
  - `skipped` integer: Skipped is the number of requested values or ids that matched nothing the caller may delete.

## Other responses

- `400`: Invalid request body
- `401`: Unauthorized - invalid or missing API key
- `403`: Only a main workspace's key may write the account-wide blocklist
- `500`: Failed to delete entries

---

[API](https://skmtc.dev/emailchaser/apis/emailchaser-api.md) · [All operations](https://skmtc.dev/emailchaser/apis/emailchaser-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emailchaser/apis/emailchaser-api/revisions/8b114990abb7?raw)