POST /accounts/{account_id}/email-security/settings/trusted_domains/batch

Execute multiple operations atomically. All four operation arrays (deletes, patches, puts, posts) are required and executed in order. Send empty arrays for unused operations.

Servers

https://api.cloudflare.com/client/v4

Path parameters

Name	Type	Required	Description
`account_id`	String	Yes	Account identifier tag.

Request headers

Name	Type	Required	Description
`Content-Type`	String	Yes	The media type of the request body. Default value: "application/json"

Request body fields

Name	Type	Required	Description
`posts[]`	Array	Yes
`posts[].id`	String	No	Trusted domain identifier
`posts[].is_similarity`	Boolean	Yes	Select for partner or other approved domains that have similar spelling to your connected domains. Prevents listed domains from triggering a Spoof disposition.
`posts[].last_modified`	String	No	Deprecated, use `modified_at` instead. End of life: November 1, 2026.
`posts[].is_recent`	Boolean	Yes	Select to prevent recently registered domains from triggering a Suspicious or Malicious disposition.
`posts[].modified_at`	String	No
`posts[].created_at`	String	No
`posts[].is_regex`	Boolean	Yes
`posts[].pattern`	String	Yes
`posts[].comments`	String	No
`deletes[]`	Array	Yes
`deletes[].id`	String	Yes	Trusted domain identifier
`patches[]`	Array	Yes
`patches[].id`	String	Yes	Trusted domain identifier
`patches[].is_similarity`	Boolean	No	Select for partner or other approved domains that have similar spelling to your connected domains. Prevents listed domains from triggering a Spoof disposition.
`patches[].last_modified`	String	No	Deprecated, use `modified_at` instead. End of life: November 1, 2026.
`patches[].is_recent`	Boolean	No	Select to prevent recently registered domains from triggering a Suspicious or Malicious disposition.
`patches[].modified_at`	String	No
`patches[].created_at`	String	No
`patches[].is_regex`	Boolean	No
`patches[].pattern`	String	No
`patches[].comments`	String	No
`puts[]`	Array	Yes
`puts[].id`	String	Yes	Trusted domain identifier
`puts[].is_similarity`	Boolean	No	Select for partner or other approved domains that have similar spelling to your connected domains. Prevents listed domains from triggering a Spoof disposition.
`puts[].last_modified`	String	No	Deprecated, use `modified_at` instead. End of life: November 1, 2026.
`puts[].is_recent`	Boolean	No	Select to prevent recently registered domains from triggering a Suspicious or Malicious disposition.
`puts[].modified_at`	String	No
`puts[].created_at`	String	No
`puts[].is_regex`	Boolean	No
`puts[].pattern`	String	No
`puts[].comments`	String	No

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.