Skip to main content
POST
Deactivate an automation
Desactivar una automatización hace que deje de procesar disparadores nuevos y cambia el estado a paused. Tu clave de API necesita el alcance automations:activate y acceso a la cuenta indicada en el cuerpo de la solicitud. Envía el ID de la automatización en la ruta. Envía account_id y el valor más reciente de updated_at como expected_updated_at en el cuerpo. Ambos campos son obligatorios y no se acepta ningún otro campo. Una solicitud correcta devuelve 200 con la automatización pausada y su configuration tipada completa.

Lo que la desactivación no cambia

La desactivación detiene el procesamiento de disparadores nuevos. No elimina la automatización, su configuración, sus métricas ni su historial de contactos. Vuelve a activar la misma automatización con Activar una automatización cuando quieras reanudarla. Usa Eliminar una automatización cuando quieras archivar la automatización en lugar de pausarla.

Protege los cambios simultáneos

Lee la automatización justo antes de desactivarla y envía su valor exacto de updated_at. Si la automatización cambió después de esa lectura, la API devuelve 409 con api_automation_version_conflict. Lee la automatización de nuevo y crea una solicitud con el valor que devuelva.

Solicitud de ejemplo

Esta operación no es idempotente. No la reintentes de forma automática después de una respuesta desconocida.
Si la API devuelve api_automation_committed_response_unavailable con committed: true y retryable: false, la automatización se pausó pero la API no pudo verificar la respuesta. Lee la automatización antes de realizar otra acción.

Ejemplo de respuesta correcta

ID, fechas y contenido ilustrativos. HTTP 200.

Autorizaciones

Authorization
string
header
requerido

Levios API key sent as a Bearer token.

Parámetros de ruta

automationId
string<uuid>
requerido

Cuerpo

application/json
account_id
string<uuid>
requerido
expected_updated_at
string
requerido
Required string length: 20 - 32
Pattern: ^(?:(?:(?!0000)\d{4})-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|02-(?:0[1-9]|1\d|2[0-8]))|(?:(?!0000)(?:\d{2}(?:0[48]|[2468][048]|[13579][26])|(?:[02468][048]|[13579][26])00))-02-29)T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{1,6})?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$

Respuesta

Successful response.