Jak usunąć projekty w Blue.
Usuń projekt
Mutacja deleteProject
trwale usuwa projekt oraz wszystkie powiązane z nim dane z Blue.
Podstawowy przykład
mutation {
deleteProject(id: "{project-id}") {
success
}
}
Z zmiennymi
mutation DeleteProject($projectId: String!) {
deleteProject(id: $projectId) {
success
}
}
Zmienne:
{
"projectId": "abc123-project-id"
}
Usunięcie projektu jest trwałe. Po usunięciu projektu wszystkie powiązane dane zostaną trwale usunięte z systemu. Obejmuje to:
- Wszystkie zadania i listy
- Komentarze i załączniki
- Pola niestandardowe i ich wartości
- Automatyzacje
- Tagowanie i zależności
- Przypisania użytkowników
- Załączniki plików
Proszę upewnić się, że zrobiono kopię zapasową wszelkich ważnych informacji przed przystąpieniem do usunięcia.
- Wszystkie zadania i listy
- Komentarze i załączniki
- Pola niestandardowe i ich wartości
- Automatyzacje
- Tagowanie i zależności
- Przypisania użytkowników
- Załączniki plików
Proszę upewnić się, że zrobiono kopię zapasową wszelkich ważnych informacji przed przystąpieniem do usunięcia.
Parametry mutacji
Parametr | Typ | Wymagane | Opis |
---|---|---|---|
id |
String! | ✅ Tak | Unikalny identyfikator projektu do usunięcia |
Pola odpowiedzi
Pole | Typ | Opis |
---|---|---|
success |
Boolean! | Wskazuje, czy usunięcie było udane |
Wymagane uprawnienia
Aby usunąć projekt, musisz mieć:
- Dostęp na poziomie firmy:
OWNER
,ADMIN
lubMEMBER
rolę w firmie - Dostęp na poziomie projektu:
OWNER
lubADMIN
rolę w konkretnym projekcie
Uprawnienia ról projektu
Rola projektu | Może usunąć projekt |
---|---|
OWNER |
✅ Tak |
ADMIN |
✅ Tak |
MEMBER |
❌ Nie |
CLIENT |
❌ Nie |
COMMENT_ONLY |
❌ Nie |
VIEW_ONLY |
❌ Nie |
Proces usuwania
Kiedy usuwasz projekt, Blue wykonuje następujące kroki:
- Walidacja: Weryfikuje, czy projekt istnieje i czy masz uprawnienia do jego usunięcia
- Kopia zapasowa: Zapisuje dane projektu w tabeli kosza na potencjalne odzyskanie (tylko do użytku wewnętrznego)
- Natychmiastowe usunięcie: Usuwa projekt z aktywnej bazy danych
- Powiadomienia: Aktualizuje powiązane systemy i powiadamia odpowiednie usługi
- Czyszczenie w tle: Asynchronicznie usuwa wszystkie powiązane dane
Odpowiedzi błędów
Projekt nie znaleziony
{
"errors": [{
"message": "Project not found",
"extensions": {
"code": "PROJECT_NOT_FOUND"
}
}]
}
Niewystarczające uprawnienia
{
"errors": [{
"message": "You are not authorized to delete this project",
"extensions": {
"code": "UNAUTHORIZED"
}
}]
}
Ważne uwagi
- Usunięcie jest kaskadowe - wszystkie dane projektu są usuwane
- Proces jest asynchroniczny - duże projekty mogą wymagać czasu na pełne oczyszczenie
- Rozważ użycie archiwum zamiast usunięcia, jeśli możesz potrzebować projektu później
- Usunięte projekty są przechowywane wewnętrznie w celach odzyskiwania, ale nie są dostępne za pośrednictwem API