--- title: Update account Email Sending suppression --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Email Sending](https://developers.cloudflare.com/api/python/resources/email_sending) [Suppressions](https://developers.cloudflare.com/api/python/resources/email_sending/subresources/suppressions) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Update account Email Sending suppression email\_sending.suppressions.edit(strsuppression\_id, SuppressionEditParams\*\*kwargs) -> [SuppressionEditResponse]() PATCH/accounts/{account\_id}/email/sending/suppressions/{suppression\_id} Updates expiry or advisory note fields without changing legacy internal zone memberships. Scope cannot be changed. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### ParametersExpand Collapse account\_id: str Cloudflare account ID. [Link to this property](<#(resource)%20email_sending.suppressions%20%3E%20(method)%20edit%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) suppression\_id: str The suppression’s identifier. formatuuid [Link to this property](<#(resource)%20email_sending.suppressions%20%3E%20(method)%20edit%20%3E%20(params)%20default%20%3E%20(param)%20suppression_id%20%3E%20(schema)>) expires\_at: Optional\[Union\[str, datetime, null]] New expiry. Send `null` to make the suppression permanent; omit to leave it unchanged. formatdate-time [Link to this property](<#(resource)%20email_sending.suppressions%20%3E%20(method)%20edit%20%3E%20(params)%20default%20%3E%20(param)%20expires_at%20%3E%20(schema)>) note: Optional\[str] Replacement advisory note. Send an empty string to clear it; omit to leave it unchanged. maxLength1000 [Link to this property](<#(resource)%20email_sending.suppressions%20%3E%20(method)%20edit%20%3E%20(params)%20default%20%3E%20(param)%20note%20%3E%20(schema)>) scope: Optional\[[object]()] Not editable. Scope is fixed when the suppression is created; any value returns 400 with code `scope_immutable`. Delete and recreate the suppression to change it. [Link to this property](<#(resource)%20email_sending.suppressions%20%3E%20(method)%20edit%20%3E%20(params)%20default%20%3E%20(param)%20scope%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class SuppressionEditResponse: … id: str Unique identifier for this suppression. formatuuid Link to this property created\_at: datetime When the suppression was created. formatdate-time Link to this property email: str The suppressed email address. formatemail Link to this property expires\_at: Optional\[datetime] When the suppression expires. Null for a permanent suppression. formatdate-time Link to this property read\_only: bool Whether clients may mutate this suppression. This is determined by the server and must not be inferred from reason. Link to this property reason: str Why the address is suppressed: manual, complaint, hard_bounce, soft_bounce, or policy. Link to this property note: Optional\[str] Advisory note for this suppression, if any. Link to this property
scope: Optional\[Scope] Where the suppression applies: account for every sending domain of the account, or sending_domain for one envelope MAIL FROM domain. One of the following:
class ScopeType: … type: Literal\["account"] Blocks the recipient for every sending domain of the account. Link to this property
Link to this property
class ScopeUnionMember1: … type: Literal\["sending\_domain"] Blocks the recipient only for mail whose envelope MAIL FROM uses value. Link to this property value: str The sending domain: the domain part of the envelope MAIL FROM, lowercase, without a trailing dot. maxLength1024 Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20email_sending.suppressions%20%3E%20(model)%20suppression_edit_response%20%3E%20(schema)>) ### Update account Email Sending suppression Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) response = client.email_sending.suppressions.edit( suppression_id="396a5436-d4b0-42a6-b3fc-48e8fa522321", account_id="12345678", ) print(response.id) ``` 200 example ``` { "errors": [ {} ], "messages": [ {} ], "result": { "id": "396a5436-d4b0-42a6-b3fc-48e8fa522321", "created_at": "2026-01-02T02:20:00Z", "email": "user@example.com", "expires_at": "2027-01-01T00:00:00Z", "read_only": false, "reason": "hard_bounce", "note": "Imported from CRM", "scope": { "type": "sending_domain", "value": "mail.example.com" } }, "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [ {} ], "messages": [ {} ], "result": { "id": "396a5436-d4b0-42a6-b3fc-48e8fa522321", "created_at": "2026-01-02T02:20:00Z", "email": "user@example.com", "expires_at": "2027-01-01T00:00:00Z", "read_only": false, "reason": "hard_bounce", "note": "Imported from CRM", "scope": { "type": "sending_domain", "value": "mail.example.com" } }, "success": true } ```