Skip to main content
POST
Activate an automation
Activar una automatización publica sus cambios pendientes y cambia el estado a live. 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 publicada y su configuration tipada completa.

La validación ocurre antes de publicar

La activación valida el borrador almacenado contra el contrato público de automatizaciones antes de publicar cualquier cosa. Cuando el borrador no puede ejecutarse, la API devuelve 422 con api_automation_invalid_configuration y deja la automatización intacta. Lee error.details.issues para ver el path, el code y el message de cada problema, y envía una configuración corregida con Actualizar una automatización. Cuando el plan de la cuenta no cubre el disparador configurado, la acción configurada o la cantidad de automatizaciones activas, la API devuelve 402 con api_automation_plan_limit. La causa legible por máquina está en error.details.reason.

Protege los cambios simultáneos

Lee la automatización justo antes de activarla 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 activó 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.