Zum Hauptinhalt springen

DELETE /tasks

Beschreibung

Löscht Daten einer Aufgabe und gibt ein leeres JSON-Objekt zurück

Die Route verarbeitet die DELETE-Anfrage an den Pfad /tasks/{id} oder /tasks.

Eine oder mehrere Aufgaben können in einer Anfrage gelöscht werden. Alle untergeordneten Aufgaben, sofern vorhanden, werden ebenfalls gelöscht.

HTTP-MethodeRouteQuery-Parameter
DELETE/tasksid

Query-Parameter

Die ID der zu entfernenden Aufgabe wird in der Anfrage-URL übermittelt.

NameTypBeschreibung
idnumberOptional. Die ID der zu entfernenden Aufgabe.

Payload

Der Server erwartet ein JSON-Objekt mit einer Eigenschaft:

NameTypBeschreibung
batcharrayOptional. Die Liste der zu entfernenden Aufgaben-IDs.

Beispiel:

{
"batch": [1, 2, 3]
}

Antwort

Die Route gibt bei einer erfolgreichen Anfrage ein leeres JSON-Objekt zurück.

Der HTTP-Statuscode zeigt an, ob die Anfrage erfolgreich war (response.status == 200) oder fehlgeschlagen ist (response.status == 500).


Änderungsprotokoll: Der batch-Payload wurde in v1.3 hinzugefügt

Verwandte Artikel: