Como excluir cards em massa via API
Douglas Aliot avatar
Escrito por Douglas Aliot
Atualizado há mais de uma semana

🔐 Disponível para todos os planos

🎯 Para quem quer atualizar informações de cards em massa

⏩ Resumo:

Aprenda a tirar o máximo proveito da API do Pipefy para realizar consultas e ações para excluir cards em massa:

  • Crie relatórios no pipe para extrair os IDs dos cards a serem excluídos;

  • Use mutations para deletar cards;

  • Atente-se ao volume de chamadas de API disponíveis em seu plano.

Como excluir cards em massa

É possível excluir cards em massa utilizando a API do Pipefy (GraphiQL). Na API, é possível realizar consultas (queries) e ações (mutations) em seus processos. Saiba mais sobre como usar a API do Pipefy.

📢 Atenção: Para que você possa utilizar a API, você precisa ter a função de administrador na empresa. Saiba mais sobre funções e permissões no Pipefy.

Apesar de ser necessário um pouco de código, neste artigo você encontrará todos os passos necessários para que você faça as atualizações.

Passos para excluir cards em massa

Você vai precisar realizar algumas ações dentro do pipe que deseja excluir os cards e depois na API do Pipefy.

🎥 Se preferir, veja esse vídeo gravado pelo nosso time de Suporte:

Dentro do pipe que deseja excluir cards

Você precisará dos IDs dos cards a serem excluídos. Para não precisar acessar um a um, basta criar um Relatório com o parâmetro definido e exportar o arquivo CSV.

Um novo relatório será criado com parâmetros predeterminados.

Clique no seletor de colunas para adicionar o código (ID) dos cards.

Exporte seu relatório para utilizar os IDs na construção da mutation.

💡 Dica: Você pode salvar seu relatório para utilizar sempre que necessário, economizando tempo e trabalho quando precisar atualizar mais cards ou consultar outras informações do seu processo.

Na API do Pipefy

Acesse a API e siga as instruções abaixo.

Com as informações que você tem em mãos, você pode construir a mutation copiando a planilha ou adicionando os IDs manualmente.

mutation{			
N1:deleteCard(input: {id:ID do card})
N2:deleteCard(input: {id:ID do card})
N3:deleteCard(input: {id:ID do card})
N4:deleteCard(input: {id:Id do card})
N5:deleteCard(input: {id:ID do card})
}

A mutation deverá estar parecida com esta:

Após rodar a mutation, no lado direito, você terá o retorno sobre o sucesso de cada card excluído:

📢 Atenção: Atente-se ao rodar atualizações ou consultas em massa, uma vez que as chamadas de API consomem parte dos limites do seu plano. Saiba mais sobre os limites dos planos.

Conteúdos relacionados

🎓 Aprenda a fazer muito mais com os cursos gratuitos da Pipefy Academy!

🌎 Faça parte da Comunidade do Pipefy para tirar dúvidas, compartilhar sugestões, ficar por dentro das novidades e dividir seu conhecimento com pessoas do mundo todo!

Respondeu à sua pergunta?