---
title: "Delete a workspace blocklist address"
method: DELETE
path: "/v2/workspace_blocklist_addresses/{address}"
tags: ["Workspace blocklist"]
---

# Delete a workspace blocklist address

`DELETE /v2/workspace_blocklist_addresses/{address}`

## Request

- Base URL: `https://api.attio.com`
- URL: `https://api.attio.com/v2/workspace_blocklist_addresses/{address}`
- Auth: OAuth 2
  - Authorization code: `https://app.attio.com/authorize`
  - Token URL: `https://app.attio.com/oauth/token` scopes: `email_calendar_blocklist:read-write`

An address is an email address (jane@acme.com) or a domain (acme.com).

Removes an address from the workspace blocklist, whatever its enforcement level. The address itself is its key: there is no separate ID.

The address is normalized as when it is added: email addresses and domains are trimmed and lowercased, a URL is reduced to its hostname, and a leading `www.` is removed. So the address is found whatever form it was added in. A URL, or any other value with reserved characters, must be percent-encoded in the path.

An address that isn't on the workspace blocklist returns a `404`. A client retrying a request can treat a `404` as done.

Removing a protected address takes effect immediately. Removing a blocked address takes effect once each connected mailbox has re-synced, which may take a few minutes.

A user-level access token can only call this endpoint if the workspace member it acts for is a workspace admin.

This endpoint is in alpha and may be subject to breaking changes as we gather feedback.

Required scopes: `email_calendar_blocklist:read-write`.

Supported token levels: `workspace`, `user`.

## Path parameters

- `address` string, required: An email address or a domain. Attio works out which one it is. Email addresses are trimmed and lowercased, and their host must be a valid domain. Domains are trimmed and lowercased, a URL is reduced to its hostname, and a leading `www.` is removed; subdomains are kept. Single labels (`acme`), bare public suffixes (`com`), unknown suffixes, IP addresses, wildcards and values over 253 characters are rejected.

## Response `200`

Success

- object: Success

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found

## Changes

- **2026-11-02** `7d2c7472b378`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/attio/apis/attio-api/changes/v2/workspace_blocklist_addresses/:address/delete.md)

---

[API](https://skmtc.dev/attio/apis/attio-api.md) - [All operations](https://skmtc.dev/attio/apis/attio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/attio/apis/attio-api/revisions/7d2c7472b378?raw)