Skip to main content
PUT
Automation aktualisieren
Dieser Endpunkt hat zwei Modi:
  • Umbenennen / Umschalten — mit name und/oder enabled die Automation umbenennen oder ein-/ausschalten.
  • Reparieren — mit einer korrigierten flow-Definition wird die Automation an Ort und Stelle neu gebaut, mit einem echten Lauf erneut getestet und nur bei bestandenem Test wieder aktiviert. Nutze das nach der Diagnose mit Automation abrufen und Runs auflisten.
Um eine Reparatur rückgängig zu machen, die die Lage verschlechtert hat, rolle mit Vorherige Version wiederherstellen zurück.
Eine Reparatur-Definition ersetzt die gesamte Automation — sie wird nie gemerged. Lies zuerst die aktuelle Definition und sende die komplette Kette zurück, inklusive aller Steps, die bleiben sollen; weggelassene Steps werden gelöscht. Der Reparatur-Testlauf führt die Automation echt aus — daher ist confirm_side_effects: true erneut nötig, wenn die korrigierte Definition sendende Steps enthält.

Path Parameters

string
erforderlich
Die ID der Automation (aus Automationen auflisten)

Request Body

string
Ein neuer Name für die Automation (max. 255 Zeichen). Im Reparatur-Modus bleibt der aktuelle Name erhalten, wenn weggelassen.
boolean
true zum Einschalten, false zum Ausschalten
object
Reparatur-Modus: die korrigierte vollständige Definition im gleichen Format wie Automation erstellen ({"trigger": {...}, "steps": [...]}). Max. 1 MB.
object
Sample-Payload für den Reparatur-Testlauf (bei Assistant-Events wird bei Weglassen das kanonische Sample verwendet). Max. 256 KB.
integer
Bei Reparaturen von Assistant-Event-Automationen: der Assistant, an den (erneut) gebunden wird. Meist bereits im Trigger der Definition enthalten.
boolean
Pflicht (true), wenn die korrigierte Definition Steps enthält, die Nachrichten oder E-Mails senden, Anrufe starten oder Non-GET-HTTP-Requests machen
Ein Request ohne name, enabled oder flow liefert 422 und verlangt mindestens eines davon.

Response — Umbenennen / Umschalten

object
Die aktualisierte Automation-Zusammenfassung

Response — Reparatur

Dieselbe Envelope wie Automation erstellen (automation_id, status, test, response, binding), ohne webhook_url — eine reparierte Automation behält ihre ursprüngliche Webhook-URL. Mit HTTP 200; status ist active, active_untested oder test_failed. Schlägt der Reparatur-Test fehl, bleibt die Automation deaktiviert; eine vor dem Testlauf abgelehnte Reparatur (z. B. no_steps) lässt die bestehende Automation unberührt. Eine fehlende Automation — oder eine, die nicht zu deinem Account gehört — liefert 404 mit {"message": "Automation not found"}.