So löschen Sie Projekte in Blue.
Ein Projekt löschen
Die deleteProject
Mutation entfernt ein Projekt und alle zugehörigen Daten dauerhaft aus Blue.
Einfaches Beispiel
mutation {
deleteProject(id: "{project-id}") {
success
}
}
Mit Variablen
mutation DeleteProject($projectId: String!) {
deleteProject(id: $projectId) {
success
}
}
Variablen:
{
"projectId": "abc123-project-id"
}
Die Löschung des Projekts ist dauerhaft. Sobald ein Projekt gelöscht wurde, werden alle zugehörigen Daten dauerhaft aus dem System entfernt. Dies umfasst:
- Alle To-dos und Listen
- Kommentare und Anhänge
- Benutzerdefinierte Felder und deren Werte
- Automatisierungen
- Tags und Abhängigkeiten
- Benutzerzuweisungen
- Dateianhänge
Bitte stellen Sie sicher, dass Sie alle wichtigen Informationen gesichert haben, bevor Sie mit der Löschung fortfahren.
- Alle To-dos und Listen
- Kommentare und Anhänge
- Benutzerdefinierte Felder und deren Werte
- Automatisierungen
- Tags und Abhängigkeiten
- Benutzerzuweisungen
- Dateianhänge
Bitte stellen Sie sicher, dass Sie alle wichtigen Informationen gesichert haben, bevor Sie mit der Löschung fortfahren.
Mutationsparameter
Parameter | Typ | Erforderlich | Beschreibung |
---|---|---|---|
id |
String! | ✅ Ja | Der eindeutige Identifikator des zu löschenden Projekts |
Antwortfelder
Feld | Typ | Beschreibung |
---|---|---|
success |
Boolean! | Gibt an, ob die Löschung erfolgreich war |
Erforderliche Berechtigungen
Um ein Projekt zu löschen, müssen Sie folgende Berechtigungen haben:
- Unternehmenszugriff:
OWNER
,ADMIN
oderMEMBER
Rolle im Unternehmen - Projektzugriff:
OWNER
oderADMIN
Rolle im spezifischen Projekt
Projektrollenberechtigungen
Projektrolle | Kann Projekt löschen |
---|---|
OWNER |
✅ Ja |
ADMIN |
✅ Ja |
MEMBER |
❌ Nein |
CLIENT |
❌ Nein |
COMMENT_ONLY |
❌ Nein |
VIEW_ONLY |
❌ Nein |
Löschprozess
Wenn Sie ein Projekt löschen, führt Blue die folgenden Schritte aus:
- Validierung: Überprüft, ob das Projekt existiert und ob Sie die Berechtigung haben, es zu löschen
- Backup: Speichert Projektdaten in einer Papierkorb-Tabelle für eine mögliche Wiederherstellung (nur für interne Verwendung)
- Sofortige Löschung: Entfernt das Projekt aus der aktiven Datenbank
- Benachrichtigungen: Aktualisiert verwandte Systeme und benachrichtigt relevante Dienste
- Hintergrundbereinigung: Entfernt asynchron alle zugehörigen Daten
Fehlerantworten
Projekt nicht gefunden
{
"errors": [{
"message": "Project not found",
"extensions": {
"code": "PROJECT_NOT_FOUND"
}
}]
}
Unzureichende Berechtigungen
{
"errors": [{
"message": "You are not authorized to delete this project",
"extensions": {
"code": "UNAUTHORIZED"
}
}]
}
Wichtige Hinweise
- Die Löschung ist kaskadierend - alle Projektdaten werden entfernt
- Der Prozess ist asynchron - große Projekte können Zeit in Anspruch nehmen, um vollständig bereinigt zu werden
- Erwägen Sie die Verwendung von Archivieren anstelle von Löschen, wenn Sie das Projekt später möglicherweise benötigen
- Gelöschte Projekte werden intern für Wiederherstellungszwecke gespeichert, sind jedoch nicht über die API zugänglich