Skip to main content
PUT
Actualizar automatización
API de Famulor 1.0 (legado). Esta página se aplica únicamente a Famulor 1.0 (app.famulor.de) y se conserva por compatibilidad. Para la plataforma actual, usa la referencia de la API de Famulor 2.0.
Este endpoint tiene dos modos:
  • Renombrar / activar-desactivar — pasa name y/o enabled para renombrar la automatización o activarla/desactivarla.
  • Reparar — pasa una definición flow corregida y la automatización se reconstruye en el sitio, se vuelve a probar con una ejecución real, y se reactiva solo cuando la prueba se supera. Usa esto después de diagnosticar un fallo con Obtener automatización y Listar ejecuciones de automatización.
Para deshacer una reparación que empeoró las cosas, revierte a la versión publicada anterior con Restaurar versión anterior.
Una definición de reparación reemplaza toda la automatización — nunca se combina. Lee primero la definición actual y reenvía la cadena completa, incluyendo cada paso que deba permanecer; los pasos que omitas se eliminan. La ejecución de prueba de la reparación ejecuta la automatización de verdad, así que se requiere de nuevo confirm_side_effects: true cuando la definición corregida contiene pasos de envío.

Parámetros de ruta

string
requerido
El ID de la automatización (de Listar automatizaciones)

Cuerpo de la solicitud

string
Un nuevo nombre para la automatización (máx. 255 caracteres). En el modo de reparación, se conserva el nombre actual si se omite.
boolean
true para activar la automatización, false para desactivarla
object
Modo de reparación: la definición completa corregida, en el mismo formato que Crear automatización ({"trigger": {...}, "steps": [...]}). Máx. 1 MB.
object
Payload de ejemplo para la ejecución de prueba de la reparación (en eventos de asistente, se usa el ejemplo canónico si se omite). Máx. 256 KB.
integer
Para reparaciones de automatizaciones de eventos de asistente: el asistente al que (re)vincularse. Normalmente ya viene incluido dentro del activador de la definición.
boolean
Obligatorio (true) cuando la definición corregida contiene pasos que envían mensajes o correos, inician llamadas, o realizan solicitudes HTTP que no son GET
Una solicitud que no incluya ninguno de name, enabled o flow devuelve un 422 pidiendo al menos uno de ellos.

Respuesta — renombrar / activar-desactivar

object
El resumen actualizado de la automatización

Respuesta — reparación

El mismo formato que Crear automatización (automation_id, status, test, response, binding), sin webhook_url — una automatización reparada conserva su URL de webhook original. Se devuelve con HTTP 200; status es active, active_untested o test_failed. Una reparación cuya prueba falla deja la automatización desactivada; una reparación rechazada antes de la ejecución de prueba (p. ej. no_steps) deja la automatización existente sin cambios. Una automatización inexistente — o que no pertenece a tu cuenta — devuelve un 404 con {"message": "Automation not found"}.