Skip to main content
DELETE
/
api
/
automations
/
{id}
curl -X DELETE https://api.disparador.com/api/automations/10 \
  -H "X-Access-Token: seu-access-token"

// Sem conteúdo (No Content)
Esta ação é irreversível. A automação e todo seu histórico de execução serão permanentemente removidos.

​
Path Parameters

​
id
number
required
ID da automação

​
Headers

​
X-Access-Token
string
required
Token de acesso da empresa
curl -X DELETE https://api.disparador.com/api/automations/10 \
  -H "X-Access-Token: seu-access-token"

​
Response

// Sem conteúdo (No Content)

​
O que é Excluído

Ao excluir uma automação, os seguintes dados são removidos permanentemente:
  1. Configuração da Automação
    • Nome, descrição e agendamento
    • Filtros e segmentação
    • Configuração de mensagem
  2. Histórico de Execução
    • Registros de todas as execuções (runs)
    • Logs de envio de mensagens
    • Estatísticas acumuladas
  3. Configurações Relacionadas
    • Deduplicação de contatos
    • Configurações de intervalo
    • Notificações configuradas

​
Quando Excluir

Automação Obsoleta

Automações antigas que não são mais necessárias

Erro de Configuração

Automação criada incorretamente que precisa ser refeita

Mudança de Estratégia

Alteração completa na abordagem de comunicação

Limpeza de Testes

Remover automações criadas para teste

​
Alternativas à Exclusão

Antes de excluir, considere:
  1. Desativar: Use o endpoint toggle para pausar temporariamente
  2. Arquivar: Adicione prefixo “[ARQUIVADA]” no nome e desative
  3. Exportar: Salve a configuração antes de excluir
// Arquivar ao invés de excluir
async function archiveAutomation(automationId, accessToken) {
  // Obter dados atuais
  const getResponse = await fetch(
    `https://api.disparador.com/api/automations/${automationId}`,
    {
      headers: { 'X-Access-Token': accessToken }
    }
  );
  
  const automation = await getResponse.json();
  
  // Atualizar nome e desativar
  const updateResponse = await fetch(
    `https://api.disparador.com/api/automations/${automationId}`,
    {
      method: 'PUT',
      headers: {
        'Content-Type': 'application/json',
        'X-Access-Token': accessToken
      },
      body: JSON.stringify({
        name: `[ARQUIVADA] ${automation.name}`,
        isActive: false
      })
    }
  );
  
  if (updateResponse.ok) {
    console.log('Automação arquivada com sucesso');
  }
}

​
Segurança

Boas Práticas:
  • Sempre confirme antes de excluir
  • Faça backup da configuração se necessário
  • Considere desativar ao invés de excluir
  • Verifique se não há dependências