Neue API-Version v7.8.64 wurde veröffentlicht! 🎉
REST Dokumentation
PATCH Teilaufgabe aktualisieren

Teilaufgabe aktualisieren

Mit diesem Endpunkt können Sie eine bestehende Teilaufgabe aktualisieren. Alle Felder sind optional; es werden nur die übermittelten Felder aktualisiert.

Request

PATCH /api/v1/tickets/:id/subtasks/:subtask_id
curl --request PATCH \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/tickets/123/subtasks/456' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
  "status": 2,
  "processor_username": "anna.mueller",
  "deadline": "2024-11-28",
  "planned_hours": 15.0
}'

Parameter

  • id (integer, erforderlich): Die ID des übergeordneten Tickets
  • subtask_id (integer, erforderlich): Die ID der zu aktualisierenden Teilaufgabe

Optionale Felder

Alle Felder sind optional. Sie können einzelne oder mehrere Felder gleichzeitig aktualisieren:

  • subject (string): Betreff der Teilaufgabe (max. 255 Zeichen)
  • name (string): Name/Titel der Teilaufgabe (max. 255 Zeichen)
  • status (integer): Status der Teilaufgabe (1=Neu, 2=In Bearbeitung, 3=Erledigt, 4=Abgelehnt, 5=Genehmigt, 8=Abgerechnet)
  • creator_username (string): Benutzername des Erstellers
  • customer_reference (string): Kundenreferenznummer (max. 255 Zeichen)
  • start_date (string): Startdatum (YYYY-MM-DD)
  • receipt_date (string): Eingangsdatum (YYYY-MM-DD)
  • deadline (string): Fälligkeitsdatum (YYYY-MM-DD)
  • planned_hours (number): Geplante Stunden
  • prevent_overbooking (integer): Überbuchungsverhinderung (0-4)
  • processor_username (string): Bearbeiter-Benutzername
  • keywords (string): Schlüsselwörter (max. 255 Zeichen)
  • customer_contact_person (string): Kundenkontakt-E-Mail
  • categories (array): Kategorienamen

Response

{
	"data": {
		"id": 456,
		"ticket_id": 123,
		"subject": "Datenbankoptimierung durchführen",
		"name": "DB-Optimierung Phase 1",
		"status": 2,
		"creator_username": "max.mustermann",
		"processor_username": "anna.mueller",
		"start_date": "2024-11-20",
		"deadline": "2024-11-28",
		"planned_hours": "15.00",
		"created": "2024-11-18T14:30:00.000000Z",
		"modified": "2024-11-19T10:15:00.000000Z",
		"categories": [
			{
				"id": 22,
				"name": "Performance"
			},
			{
				"id": 18,
				"name": "Backend"
			}
		]
	}
}

Fehlercodes

  • 401 Unauthorized: Ungültige oder fehlende Authentifizierung
  • 404 Not Found: Ticket oder Teilaufgabe nicht gefunden
  • 422 Unprocessable Entity: Validierungsfehler