Sign in
Lists

Remove items from a list

Removes the specified items from the list. Values not currently in the list are silently ignored. The response returns the updated List object with a refreshed items_count. You can submit up to 1000 items per request.

delete/v3/lists/{list_id}/items

Request body

itemsstring[] required

Example request

{
  "items": [
    "spam-domain.com"
  ]
}

Response

OK

request_idstring

ID of the request.

Example response

{
  "request_id": "5fa64c92-e840-4357-86b9-2aa364d35b88",
  "data": {
    "id": "d1e2f3a4-5678-4abc-9def-0123456789ab",
    "name": "Blocked domains",
    "description": "Domains we've identified as sending unwanted mail.",
    "type": "domain",
    "items_count": 42,
    "application_id": "ad410018-d306-43f9-8361-fa5d7b2172e0",
    "organization_id": "org-abc123",
    "created_at": 1742932766,
    "updated_at": 1742932766
  }
}

Changes