Skip to main content
POST
Activate an automation
Ativar uma automação publica as alterações pendentes dela e muda o status para live. Sua chave de API precisa do escopo automations:activate e de acesso à conta informada no corpo da requisição. Envie o ID da automação no caminho. Envie account_id e o valor mais recente de updated_at como expected_updated_at no corpo. Os dois campos são obrigatórios e nenhum outro campo é aceito. Uma requisição bem-sucedida retorna 200 com a automação publicada e a configuration tipada completa dela.

A validação acontece antes da publicação

A ativação valida o rascunho armazenado contra o contrato público de automações antes de publicar qualquer coisa. Quando o rascunho não pode ser executado, a API retorna 422 com api_automation_invalid_configuration e não altera a automação. Leia error.details.issues para ver o path, o code e a message de cada problema e envie uma configuração corrigida por Atualizar uma automação. Quando o plano da conta não cobre o gatilho configurado, a ação configurada ou a quantidade de automações ativas, a API retorna 402 com api_automation_plan_limit. A causa legível por máquina fica em error.details.reason.

Proteja alterações simultâneas

Leia a automação imediatamente antes de ativá-la e envie o valor exato de updated_at dela. Se a automação mudou depois dessa leitura, a API retorna 409 com api_automation_version_conflict. Leia a automação de novo e monte uma nova requisição a partir do valor retornado.

Exemplo de requisição

Esta operação não é idempotente. Não repita a chamada automaticamente depois de uma resposta desconhecida.
Se a API retornar api_automation_committed_response_unavailable com committed: true e retryable: false, a automação foi ativada, mas a API não conseguiu verificar a resposta. Leia a automação antes de executar outra ação.

Exemplo de resposta de sucesso

IDs, horários e conteúdo ilustrativos. HTTP 200.

Autorizações

Authorization
string
header
obrigatório

Levios API key sent as a Bearer token.

Parâmetros de caminho

automationId
string<uuid>
obrigatório

Corpo

application/json
account_id
string<uuid>
obrigatório
expected_updated_at
string
obrigatório
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)$

Resposta

Successful response.