# Unblock Person

`DELETE https://api.getprospect.com/v2/blocklist/people/{id}`

Unblocks the person an entry blocks: removes the entry and every other entry of the workspace with the same name, and answers their ids. A repeat answers 404. Free, no credits; spends no rate-limit units, but counts against the per-second window of the `search` bucket. Blocked people and companies are left out of people and company search, people and company enrich, email find and suggestions in this workspace, within 15 seconds. Saving a person by id and email verify are not filtered by workspace block lists, and blocked domains that resolve to more than 10,000 companies are only partly excluded from people search. Any member or API key of the workspace may call it; a credential that belongs to no workspace answers 403.

## Authentication

Pass your API key in the `x-api-key` header.

## Path parameters

- `id` (string, required): The entry id (`BlockedPerson.id`).

## Example request

```bash
curl --request DELETE \
  --url https://api.getprospect.com/v2/blocklist/people/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Response 200

The ids of the removed entries.

```json
{
  "success": true,
  "data": {
    "deleted_ids": [
      "64f0c3d2a1b2c3d4e5f60718",
      "64f0c3d2a1b2c3d4e5f6071a"
    ]
  },
  "metadata": {
    "timestamp": "2026-10-08T09:30:00.000Z"
  }
}
```

## Response 401

Missing, unknown or inactive credentials (`UNAUTHORIZED`).

## Response 403

The credential belongs to no workspace (`FORBIDDEN`, `workspace_required`).

```json
{
  "success": false,
  "data": null,
  "metadata": {
    "timestamp": "2026-10-08T09:30:00.000Z"
  },
  "errors": [
    {
      "name": "FORBIDDEN",
      "message": "This operation works inside a workspace, and the credential used belongs to none",
      "payload": {
        "code": "workspace_required"
      }
    }
  ]
}
```

## Response 404

No such entry in this workspace (`NOT_FOUND`): an unknown, malformed or already deleted id. A retried delete answers this.

```json
{
  "success": false,
  "data": null,
  "metadata": {
    "timestamp": "2026-10-08T09:30:00.000Z"
  },
  "errors": [
    {
      "name": "NOT_FOUND",
      "message": "Blocked person not found"
    }
  ]
}
```

## Response 429

Over the per-second window of the `search` bucket (`RATE_LIMIT`). Sent only where rate-limit enforcement is on; wait `Retry-After` seconds.

## Response 500

Unexpected server error.