Zur Dokumentation springen
API

Eine Automatisierung aktualisieren

Ändert den Namen, die Beschreibung, die Einstellungen oder die Entwurfsdefinition. Einstellungen gelten sofort. Eine neue Definition ersetzt den ganzen Entwurf und ändert für die Personen darin nichts, bis Sie veröffentlichen.

PATCH/automations/{id}

Führt den echten Aufruf in Ihrem Workspace aus.

PATCH /automations/{id}

Ändert den Namen, die Beschreibung, die Einstellungen oder die Entwurfsdefinition. Einstellungen gelten sofort. Eine neue Definition ersetzt den ganzen Entwurf und ändert für die Personen darin nichts, bis Sie veröffentlichen.

Beispiel

Erfordert automations:write. Senden Sie nur, was sich ändert.

curl
curl -X PATCH "$OE/automations/aut_7c2e9a1f4b8d30c65e1a9f27" -H "$AUTH" -H 'content-type: application/json' -d '{  "settings": { "sendWindow": { "days": [1, 2, 3, 4, 5], "startMinute": 540, "endMinute": 1020 } },  "expectedUpdatedAt": "2026-10-02T09:14:00.000Z"}'
Antwort
{  "object": "automation",  "id": "aut_7c2e9a1f4b8d30c65e1a9f27",  "name": "Welcome series",  "description": null,  "status": "live",  "triggerKind": "audience_joined",  "stepCount": 4,  "emailCount": 2,  "hasUnpublishedChanges": false,  "publishedVersion": 2,  "pausedReason": null,  "lastError": null,  "counts": { "active": 38, "completed": 412, "exited": 9 },  "createdBy": "q7Vd3kX9mT2pLw8RzN4bYc6HfJ1sGa5E",  "publishedAt": "2026-10-02T09:14:00.000Z",  "pausedAt": null,  "archivedAt": null,  "createdAt": "2026-10-01T16:40:12.000Z",  "updatedAt": "2026-10-02T09:14:00.000Z",  "definition": {    "trigger": { "kind": "audience_joined", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "includeImported": false },    "entry": "welcome",    "steps": [      {        "key": "welcome",        "kind": "send_email",        "next": "pause",        "templateId": "tpl_9c1f0a4b7e05d3862c1f0a44",        "templateVersion": null,        "from": { "email": "[email protected]", "name": "Acme" },        "replyTo": null,        "subject": null,        "props": { "firstName": { "source": "contact", "field": "firstName" } }      },      { "key": "pause", "kind": "wait", "next": "opened", "wait": { "mode": "duration", "amount": 3, "unit": "days" } },      {        "key": "opened",        "kind": "branch",        "condition": { "kind": "email_opened", "stepKey": "welcome" },        "yes": null,        "no": "nudge"      },      {        "key": "nudge",        "kind": "send_email",        "next": null,        "templateId": "tpl_8f3a1c2e9b7d4a60",        "templateVersion": null,        "from": { "email": "[email protected]", "name": "Acme" },        "replyTo": null,        "subject": "{{firstName|Hello}}, did you see this?",        "props": {}      }    ]  },  "published": { "trigger": { "kind": "audience_joined", "…": "…" }, "entry": "welcome", "steps": ["…"] },  "settings": {    "timezone": "Europe/London",    "sendWindow": { "days": [1, 2, 3, 4, 5], "startMinute": 540, "endMinute": 1020 },    "reentryDays": null,    "exitOnLeave": true,    "listAudienceId": null  },  "problems": []}

sendWindow.days sind Wochentage von 0 für Sonntag bis 6 für Samstag, und die Minuten zählen ab Mitternacht in settings.timezone. null entfernt das Sendefenster.

Senden Sie das gelesene updatedAt als expectedUpdatedAt, dann wird ein Speichern, das die Änderung einer anderen Person überschreiben würde, mit 409 version_conflict abgelehnt.

Eine archivierte Automatisierung kann nicht geändert werden: 409 automation_archived.

Referenz