Como excluir projetos no Blue.
Excluir um Projeto
A mutação deleteProject remove permanentemente um projeto e todos os seus dados associados do Blue.
Exemplo Básico
mutation {
deleteProject(id: "{project-id}") {
success
}
}
Com Variáveis
mutation DeleteProject($projectId: String!) {
deleteProject(id: $projectId) {
success
}
}
Variáveis:
{
"projectId": "abc123-project-id"
}
A exclusão do projeto é permanente. Uma vez que um projeto é excluído, todos os dados associados serão removidos permanentemente do sistema. Isso inclui:
- Todas as tarefas e listas
- Comentários e anexos
- Campos personalizados e seus valores
- Automações
- Tags e dependências
- Atribuições de usuários
- Anexos de arquivos
Por favor, certifique-se de ter feito backup de qualquer informação importante antes de prosseguir com a exclusão.
- Todas as tarefas e listas
- Comentários e anexos
- Campos personalizados e seus valores
- Automações
- Tags e dependências
- Atribuições de usuários
- Anexos de arquivos
Por favor, certifique-se de ter feito backup de qualquer informação importante antes de prosseguir com a exclusão.
Parâmetros da Mutação
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id |
String! | ✅ Sim | O identificador único do projeto a ser excluído |
Campos de Resposta
| Campo | Tipo | Descrição |
|---|---|---|
success |
Boolean! | Indica se a exclusão foi bem-sucedida |
Permissões Necessárias
Para excluir um projeto, você deve ter:
- Acesso em nível de empresa:
OWNER,ADMIN, ouMEMBERfunção na empresa - Acesso em nível de projeto:
OWNERouADMINfunção no projeto específico
Permissões de Função do Projeto
| Função do Projeto | Pode Excluir Projeto |
|---|---|
OWNER |
✅ Sim |
ADMIN |
✅ Sim |
MEMBER |
❌ Não |
CLIENT |
❌ Não |
COMMENT_ONLY |
❌ Não |
VIEW_ONLY |
❌ Não |
Processo de Exclusão
Quando você exclui um projeto, o Blue realiza os seguintes passos:
- Validação: Verifica se o projeto existe e se você tem permissão para excluí-lo
- Backup: Salva os dados do projeto em uma tabela de lixeira para recuperação potencial (uso interno apenas)
- Exclusão imediata: Remove o projeto do banco de dados ativo
- Notificações: Atualiza sistemas relacionados e notifica serviços relevantes
- Limpeza em segundo plano: Remove assíncronamente todos os dados associados
Respostas de Erro
Projeto Não Encontrado
{
"errors": [{
"message": "Project not found",
"extensions": {
"code": "PROJECT_NOT_FOUND"
}
}]
}
Permissões Insuficientes
{
"errors": [{
"message": "You are not authorized to delete this project",
"extensions": {
"code": "UNAUTHORIZED"
}
}]
}
Notas Importantes
- A exclusão é cascata - todos os dados do projeto são removidos
- O processo é assíncrono - projetos grandes podem levar tempo para serem totalmente limpos
- Considere usar arquivo em vez de excluir se você pode precisar do projeto mais tarde
- Projetos excluídos são salvos internamente para fins de recuperação, mas não são acessíveis via API