Skip to main content
PUT
Update automation
This endpoint has two modes:
  • Rename / toggle — pass name and/or enabled to rename the automation or turn it on/off.
  • Repair — pass a corrected flow definition and the automation is rebuilt in place, re-tested with a real run, and re-activated only when the test passes. Use this after diagnosing a failure with Get automation and List automation runs.
To undo a repair that made things worse, roll back to the previous published version with Restore previous version.
A repair definition replaces the whole automation — it is never merged. Read the current definition first and resend the complete chain, including every step that must stay; steps you leave out are deleted. The repair test run executes the automation for real, so confirm_side_effects: true is required again when the corrected definition contains sending steps.

Path Parameters

string
required
The ID of the automation (from List automations)

Request body

string
A new name for the automation (max 255 characters). In repair mode, the current name is kept when omitted.
boolean
true to turn the automation on, false to turn it off
object
Repair mode: the corrected full definition, in the same format as Create automation ({"trigger": {...}, "steps": [...]}). Max 1 MB.
object
Sample payload for the repair test run (for assistant events, the canonical sample is used when omitted). Max 256 KB.
integer
For repairs of assistant-event automations: the assistant to (re)attach to. Usually already carried inside the definition’s trigger.
boolean
Required (true) when the corrected definition contains steps that send messages or emails, start calls, or make non-GET HTTP requests
A request with none of name, enabled or flow returns a 422 asking for at least one of them.

Response — rename / toggle

object
The refreshed automation summary

Response — repair

The same envelope as Create automation (automation_id, status, test, response, binding), without webhook_url — a repaired automation keeps its original webhook URL. Returned with HTTP 200; status is active, active_untested or test_failed. A repair whose test fails leaves the automation disabled; a repair rejected before the test run (e.g. no_steps) leaves the existing automation untouched. A missing automation — or one that does not belong to your account — returns a 404 with {"message": "Automation not found"}.