Blocklist

Delete blocklist entries

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.

delete/blocklist

Request

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

Request body

idsinteger[]

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.

valuesstring[]

Values are domains or email addresses to unblock, matched case-insensitively. Values not present are counted as skipped.

Example request

{
  "scope": "workspace",
  "values": [
    "competitor.com",
    "jane@acme.com"
  ]
}

Response

OK

deletedinteger

Deleted is the number of entries removed.

skippedinteger

Skipped is the number of requested values or ids that matched nothing the caller may delete.

Example response

{
  "deleted": 12,
  "skipped": 1
}

Changes

No recorded changes to this operation across all 1 revision of this API.