Remove an address's suppressions

Removes every suppression of the address, or only the one of scope. The address is the path segment, percent-decoded and normalized (any case and surrounding whitespace find it). Subscriber statuses are not changed: an unsubscribed subscriber stays unsubscribed. Needs scope write.

Parameters

Name	In	Type	Description
`project_id`required	path	string · uuid	The project’s id
`email`required	path	string · email	The address, percent-encoded
`scope`	query	string	Only this suppression: `project` or `list:<list_id>`; none: every one of the address

Request body

None.

Responses

204

The suppressions are removed

No content.

401

No valid key

Problem (application/problem+json)

403

A project key without scope write (forbidden)

Problem (application/problem+json)

404

The address has no such suppression, or no such project, or another project’s (not_found)

Problem (application/problem+json)

409

The project is deleted (conflict)

Problem (application/problem+json)

422

scope is not project or list:<list_id> (validation_failed)

Problem (application/problem+json)

429

The key is over its rate limit, api.rate_limit_per_minute requests a minute on this node (rate_limited)

Header	Type	Description
`Retry-After`	integer	Seconds until the key’s next request passes; rounded up.

Problem (application/problem+json)

504

Postwind’s storage did not answer within its time limit (storage_timeout). A change the request makes may still take effect: check before repeating it. A repeat with the same Idempotency-Key never runs it twice: it is 409 idempotency_key_in_progress until the key’s 24 h end

Problem (application/problem+json)

MCP tool remove_suppression requires confirm

Call it

when a suppression was made by mistake or no longer applies.

Needs

an admin key with project_id, or a project key with scope write (its own project; the argument is ignored), and confirm: true; without it the call changes nothing and tells what it would do.

Returns

outcome (would_remove, removed), effect naming the suppressions and suppressions, what list_suppressions with the email returns after the call; the API’s DELETE /api/v1/projects/{project_id}/suppressions/{email} answers 204.

jsontools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "remove_suppression",
    "arguments": {
      "email": "ann@example.com",
      "confirm": false
    }
  }
}