Replace automation workflow blocks

Replace the full block tree for an automation workflow.

Blocks identified by id are updated in place. Blocks identified by temporaryID are created as new blocks. Existing blocks not included in this array are removed.

Enabled automations cannot be restructured. Disable the automation via POST /automations/{id}/disable, send the new block tree, then re-enable via POST /automations/{id}/enable when ready. When disabling, contactsInWorkflow controls whether contacts already in the workflow continue through the remaining blocks (keep) or exit immediately (exit).

Scopes: automations.write

Path Params
string
required

Automation workflow ID (24 character hexadecimal)

Body Params

Full block tree replacement

Replace all blocks in an automation workflow.

blocks
array of objects
required

Full block list. Replaces the entire block tree. At least one block is required. Blocks with id update existing blocks; blocks with temporaryID create new ones. Existing blocks not included in this array are removed.

blocks*
Headers
string
required
Defaults to 2026-03-15

API version that specifies the response format and behaviour

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json