Skip to main content
PUT
Mettre à jour une automatisation
API Famulor 1.0 (héritée). Cette page concerne uniquement Famulor 1.0 (app.famulor.de) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la référence API Famulor 2.0.
Ce point de terminaison propose deux modes :
  • Renommer / activer-désactiver — envoyez name et/ou enabled pour renommer l’automatisation ou l’activer/la désactiver.
  • Réparer — envoyez une définition flow corrigée : l’automatisation est reconstruite en place, retestée avec une exécution réelle, puis réactivée uniquement si le test réussit. Utilisez ce mode après avoir diagnostiqué un échec avec Obtenir une automatisation et Lister les exécutions d’automatisation.
Pour annuler une réparation qui a empiré la situation, revenez à la version précédemment publiée avec Restaurer la version précédente.
Une définition de réparation remplace l’automatisation entière — elle n’est jamais fusionnée. Lisez d’abord la définition actuelle et renvoyez la chaîne complète, y compris chaque étape à conserver ; les étapes omises sont supprimées. L’exécution de test de la réparation exécute réellement l’automatisation, donc confirm_side_effects: true est à nouveau requis lorsque la définition corrigée contient des étapes d’envoi.

Paramètres de chemin

string
requis
L’ID de l’automatisation (voir Lister les automatisations)

Corps de la requête

string
Un nouveau nom pour l’automatisation (255 caractères maximum). En mode réparation, le nom actuel est conservé si omis.
boolean
true pour activer l’automatisation, false pour la désactiver
object
Mode réparation : la définition complète corrigée, au même format que Créer une automatisation ({"trigger": {...}, "steps": [...]}). 1 Mo maximum.
object
Le payload d’exemple pour l’exécution de test de la réparation (pour les événements d’assistant, l’exemple canonique est utilisé si omis). 256 Ko maximum.
integer
Pour les réparations d’automatisations liées à un événement d’assistant : l’assistant auquel (ré)attacher l’automatisation. Généralement déjà présent dans le déclencheur de la définition.
boolean
Requis (true) lorsque la définition corrigée contient des étapes qui envoient des messages ou des e-mails, démarrent des appels, ou effectuent des requêtes HTTP autres que GET
Une requête sans name, enabled ni flow renvoie un 422 demandant au moins l’un des trois.

Response — Renommage / activation-désactivation

object
Le résumé actualisé de l’automatisation

Response — Réparation

La même enveloppe que Créer une automatisation (automation_id, status, test, response, binding), sans webhook_url — une automatisation réparée conserve son URL de webhook d’origine. Renvoyée avec le code HTTP 200 ; status vaut active, active_untested ou test_failed. Une réparation dont le test échoue laisse l’automatisation désactivée ; une réparation rejetée avant l’exécution de test (par ex. no_steps) laisse l’automatisation existante inchangée. Une automatisation introuvable — ou qui n’appartient pas à votre compte — renvoie un 404 avec {"message": "Automation not found"}.