Modifier une automatisation
Modifie le nom, la description, les paramètres ou la définition du brouillon. Les paramètres s'appliquent aussitôt. Une nouvelle définition remplace tout le brouillon et ne change rien pour les personnes en cours tant que vous ne publiez pas.
Exécute le véritable appel sur votre espace de travail.
PATCH /automations/{id}
Modifie le nom, la description, les paramètres ou la définition du brouillon. Les paramètres s'appliquent aussitôt. Une nouvelle définition remplace tout le brouillon et ne change rien pour les personnes en cours tant que vous ne publiez pas.
Exemple
Nécessite automations:write. N'envoyez que ce qui change.
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"}'{ "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 sont des jours de la semaine, de 0 pour dimanche à 6 pour samedi, et les minutes se comptent depuis minuit dans settings.timezone. null supprime le créneau.
Envoyez le updatedAt que vous avez lu dans expectedUpdatedAt, et un enregistrement qui écraserait la modification de quelqu'un d'autre est refusé avec 409 version_conflict.
Une automatisation archivée ne peut pas être modifiée : 409 automation_archived.