> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Blocklist

> Manage blocked contacts, email domains, and IP addresses. Use when stopping abusive or unwanted visitors from reaching your AI assistant.

The Blocklist API lets you manage blocked contacts, blocked email domains, and blocked IP addresses. Blocked visitors are ignored by the AI — instead of an automated response they receive a short message explaining they cannot contact the company right now. You can customise that message per organization in **Settings → Autopilot**.

## Blocked Contacts

Block individual contacts by email. Useful for stopping the AI from responding to abusive users, spam accounts, or internal test contacts.

## Blocked Domains

Block entire email domains (e.g. "spam.com"). All contacts with emails on blocked domains will be ignored by the AI. Supports blocking multiple domains at once.

## Blocked IPs

Block a single address (e.g. "203.0.113.7") or a whole CIDR range (e.g. "203.0.113.0/24"), IPv4 or IPv6. Useful against widget abuse where the visitor keeps creating throwaway contacts, so contact- and domain-blocking never bite.

The address is resolved from Cloudflare's `CF-Connecting-IP` header, which cannot be forged by the client. A client IP is only observable on the web/widget channels; once a session has been seen from a blocked address the block continues to apply to that session on every channel.

## Available Endpoints

<CardGroup>
  <Card title="List Blocked Contacts" icon="list" href="/api-reference/blocklist/list_contacts">
    List all blocked contacts
  </Card>

  <Card title="Block Contact" icon="user-slash" href="/api-reference/blocklist/block_contact">
    Block a contact by email
  </Card>

  <Card title="Check Contact" icon="magnifying-glass" href="/api-reference/blocklist/check_contact">
    Check if a contact is blocked
  </Card>

  <Card title="Unblock Contact" icon="user-check" href="/api-reference/blocklist/unblock_contact">
    Remove a contact from the blocklist
  </Card>

  <Card title="List Blocked Domains" icon="list" href="/api-reference/blocklist/list_domains">
    List all blocked domains
  </Card>

  <Card title="Block Domains" icon="globe" href="/api-reference/blocklist/block_domains">
    Block one or more email domains
  </Card>

  <Card title="Check Domain" icon="magnifying-glass" href="/api-reference/blocklist/check_domain">
    Check if a domain or email is blocked
  </Card>

  <Card title="Unblock Domain" icon="globe" href="/api-reference/blocklist/unblock_domain">
    Remove a domain from the blocklist
  </Card>

  <Card title="List Blocked IPs" icon="list" href="/api-reference/blocklist/list_ips">
    List all blocked IPs and CIDR ranges
  </Card>

  <Card title="Block IPs" icon="network-wired" href="/api-reference/blocklist/block_ips">
    Block one or more IP addresses or ranges
  </Card>

  <Card title="Check IP" icon="magnifying-glass" href="/api-reference/blocklist/check_ip">
    Check if an IP is blocked
  </Card>

  <Card title="Unblock IP" icon="network-wired" href="/api-reference/blocklist/unblock_ip">
    Remove an IP from the blocklist
  </Card>
</CardGroup>
