Workspace blocklist

Delete a workspace blocklist address

Changed on

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.

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

Path parameters

addressstring 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.

Example:jane@acme.com

Response

Success

object required

Success

Changes