---
title: "Update a blocklist entry"
method: PUT
path: "/blocklist/{id}"
tags: ["Blocklist"]
---

# Update a blocklist entry

`PUT /blocklist/{id}`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/blocklist/{id}`
- Auth: HTTP bearer

Changes the blocked value, the scope, or both. A value containing "@" is stored as an email address, otherwise as a domain, so an entry can be converted between the two. Moving an entry to or from the account-wide list requires a main workspace's key, and moves the entry onto the main workspace.

## Path parameters

- `id` integer, required

## Request body

- ModelsBlocklistUpdateRequest
  - `scope` 'workspace' | 'global': Scope moves the entry between the workspace list and the account-wide list. Moving an entry to "global" requires a main workspace's key.
  - `value` string: Value is the new domain or email address. Which of the two the entry holds is re-inferred from whether the value contains "@", so an entry can be converted between a domain block and an address block.

## Response `200`

OK

- ModelsBlocklistEntry
  - `createdAt` string
  - `domain` string
  - `emailAddress` string: EmailAddress is the blocked address when the entry blocks one address rather than a whole domain.
  - `id` integer
  - `scope` 'workspace' | 'global': Scope is "workspace" for the calling workspace's own entry, "global" for an account-wide one.
  - `workspaceId` integer: WorkspaceId is the workspace the entry is stored on. For a global entry read from a sub-workspace this is the main workspace, not the caller.

## Other responses

- `400`: Invalid request body or id
- `401`: Unauthorized - invalid or missing API key
- `403`: Only a main workspace's key may write the account-wide blocklist
- `404`: Entry not found
- `409`: That value is already blocked in the target list
- `500`: Failed to update entry

---

[API](https://skmtc.dev/emailchaser/apis/emailchaser-api.md) · [All operations](https://skmtc.dev/emailchaser/apis/emailchaser-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emailchaser/apis/emailchaser-api/revisions/8b114990abb7?raw)