Cómo eliminar proyectos en Blue.
Eliminar un Proyecto
La mutación deleteProject elimina permanentemente un proyecto y todos sus datos asociados de Blue.
Ejemplo Básico
mutation {
deleteProject(id: "{project-id}") {
success
}
}
Con Variables
mutation DeleteProject($projectId: String!) {
deleteProject(id: $projectId) {
success
}
}
Variables:
{
"projectId": "abc123-project-id"
}
La eliminación del proyecto es permanente. Una vez que un proyecto es eliminado, todos los datos asociados se eliminarán permanentemente del sistema. Esto incluye:
- Todas las tareas y listas
- Comentarios y archivos adjuntos
- Campos personalizados y sus valores
- Automatizaciones
- Etiquetas y dependencias
- Asignaciones de usuarios
- Archivos adjuntos
Por favor, asegúrese de haber respaldado cualquier información importante antes de proceder con la eliminación.
- Todas las tareas y listas
- Comentarios y archivos adjuntos
- Campos personalizados y sus valores
- Automatizaciones
- Etiquetas y dependencias
- Asignaciones de usuarios
- Archivos adjuntos
Por favor, asegúrese de haber respaldado cualquier información importante antes de proceder con la eliminación.
Parámetros de la Mutación
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
id |
String! | ✅ Sí | El identificador único del proyecto a eliminar |
Campos de Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
success |
Boolean! | Indica si la eliminación fue exitosa |
Permisos Requeridos
Para eliminar un proyecto, debe tener:
- Acceso a nivel de empresa:
OWNER,ADMIN, oMEMBERrol en la empresa - Acceso a nivel de proyecto:
OWNERoADMINrol en el proyecto específico
Permisos de Rol de Proyecto
| Rol de Proyecto | Puede Eliminar Proyecto |
|---|---|
OWNER |
✅ Sí |
ADMIN |
✅ Sí |
MEMBER |
❌ No |
CLIENT |
❌ No |
COMMENT_ONLY |
❌ No |
VIEW_ONLY |
❌ No |
Proceso de Eliminación
Cuando elimina un proyecto, Blue realiza los siguientes pasos:
- Validación: Verifica que el proyecto exista y que tenga permiso para eliminarlo
- Respaldo: Guarda los datos del proyecto en una tabla de reciclaje para una posible recuperación (uso interno solamente)
- Eliminación inmediata: Elimina el proyecto de la base de datos activa
- Notificaciones: Actualiza sistemas relacionados y notifica a los servicios relevantes
- Limpieza en segundo plano: Elimina de manera asíncrona todos los datos asociados
Respuestas de Error
Proyecto No Encontrado
{
"errors": [{
"message": "Project not found",
"extensions": {
"code": "PROJECT_NOT_FOUND"
}
}]
}
Permisos Insuficientes
{
"errors": [{
"message": "You are not authorized to delete this project",
"extensions": {
"code": "UNAUTHORIZED"
}
}]
}
Notas Importantes
- La eliminación es cascada - todos los datos del proyecto son eliminados
- El proceso es asíncrono - los proyectos grandes pueden tardar tiempo en limpiarse completamente
- Considere usar archivo en lugar de eliminar si podría necesitar el proyecto más tarde
- Los proyectos eliminados se guardan internamente para fines de recuperación, pero no son accesibles a través de la API