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

Ticket aktualisieren

Mit diesem Endpunkt können Sie ein bestehendes Ticket aktualisieren. Alle Felder sind optional; es werden nur die übermittelten Felder aktualisiert.

Request

PATCH /api/v1/tickets/:id
curl --request PATCH \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/tickets/789' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
  "status": 2,
  "priority": 4,
  "processor_username": "anna.mueller",
  "start_date": "2024-11-16"
}'

Optionale Felder

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

  • status (integer): Ticket-Status (1=Neu, 2=In Bearbeitung, 3=Erledigt, 4=Abgelehnt, 5=Genehmigt, 8=Abgerechnet)
  • project_id (integer): Projekt-ID
  • project_task_id (string): Projektaufgaben-ID
  • priority (integer): Priorität von 1 bis 5
  • subject (string): Ticket-Betreff (max. 255 Zeichen)
  • planned_hours (number): Geplante Stunden
  • creator_username (string): Ersteller-Benutzername
  • receipt_date (string): Eingangsdatum (YYYY-MM-DD)
  • processor_username (string): Bearbeiter-Benutzername
  • start_date (string): Startdatum (YYYY-MM-DD)
  • deadline (string): Fälligkeitsdatum (YYYY-MM-DD)
  • from_mail (string): Ursprungs-E-Mail
  • external_ticket_number (string): Externe Ticketnummer (max. 255 Zeichen)
  • notify_of_completion (boolean): Benachrichtigung bei Fertigstellung
  • prevent_overbooking (integer): Überbuchungsverhinderung (0-4)
  • customer_contact_person (string): Kundenkontakt-E-Mail
  • customer_reference (string): Kundenreferenz (max. 255 Zeichen)
  • keywords (string): Schlüsselwörter (max. 255 Zeichen)
  • categories (array): Kategorienamen

Response

{
	"data": {
		"id": 789,
		"status": 2,
		"project_id": 456,
		"project_task_id": "12",
		"priority": 4,
		"subject": "Fehler in der Benutzeroberfläche beheben",
		"planned_hours": "8.50",
		"creator_username": "max.mustermann",
		"receipt_date": "2024-11-15",
		"processor_username": "anna.mueller",
		"start_date": "2024-11-16",
		"deadline": "2024-11-20",
		"created": "2024-11-15T10:30:00.000000Z",
		"modified": "2024-11-16T09:15:00.000000Z"
	}
}

Fehlercodes

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