Lists & exclusions

Remove companies from a list

Remove domains from one of your lists.

DELETE/v1/lists/:list_id/items

MCP tool remove_from_listscope lists:writeNo record cost

Parameters

list_idstringrequired

domainsstring[]required

(up to 5000 items)

What your agent reads

The tool description exactly as an MCP client receives it in tools/list — it doubles as the full behaviour of the endpoint.

Remove domains from one of your lists. The change applies to the very next search.

Errors follow one format.

Request

curl -X DELETE "https://api.breaknorm.co/v1/lists/lst_85332ec76012442a8d8e/items" \
  -H "Authorization: Bearer $BREAKNORM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": [
      "acme.de"
    ]
  }'