Projekt löschen

Mit diesem Endpunkt können Sie ein Projekt dauerhaft aus dem System löschen.

Request

curl --request DELETE \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/projects/123' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}'

Parameter

• id (integer, erforderlich): Die ID des zu löschenden Projekts

Response

Erfolgreiche Löschung

{
	"message": "Project deleted successfully"
}

Eine erfolgreiche Löschung gibt eine Erfolgsmeldung zurück.

Fehlercodes

• 401 Unauthorized: Ungültige oder fehlende Authentifizierung
• 404 Not Found: Projekt mit der angegebenen ID wurde nicht gefunden
• 500 Internal Server Error: Projekt konnte nicht gelöscht werden. Dies kann auftreten, wenn das Projekt verknüpfte Datensätze hat, die eine Löschung verhindern.

Hinweise

• Das Löschen eines Projekts ist eine endgültige Aktion und kann nicht rückgängig gemacht werden
• Ein Projekt kann möglicherweise nicht gelöscht werden, wenn verknüpfte Datensätze existieren, z.B.:
  • Projektzeiten (Attendances)
  • Projektaufgaben (Tasks)
  • Projektmitarbeiter-Zuordnungen
  • Rechnungen
  • Angebote
• Stellen Sie sicher, dass Sie die richtige Projekt-ID verwenden, bevor Sie den Löschvorgang ausführen
• Überprüfen Sie, ob der Benutzer die notwendigen Berechtigungen zum Löschen von Projekten hat
• In vielen Fällen ist es empfehlenswerter, den Projektstatus zu ändern oder das Projekt zu archivieren, anstatt es zu löschen

Beispiel

DELETE /api/v1/projects/123

Response bei Erfolg:

{
	"message": "Project deleted successfully"
}

Response bei Fehler (500):

{
	"message": "Project could not be deleted"
}