Teilaufgabe eines Tickets aktualisieren

Aktualisiert eine Teilaufgabe des angegebenen Tickets und liefert sie zurück. In der Anfrage ausgelassene Felder behalten den aktuellen Wert der Teilaufgabe.

Verfügbarkeit: Nur Vollversion — eine Clock-Instanz antwortet auf diesen Endpunkt mit 404.

PUT wird für diese Operation als Alias von PATCH akzeptiert.

Request

PATCH /api/v1/tickets/{id}/subtasks/{subtask_id}

curl --request PATCH \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/tickets/{id}/subtasks/{subtask_id}' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
       "subject": "Fehler in der Benutzeroberfläche beheben",
       "name": "EU",
       "customer_reference": "string",
       "start_date": "2024-01-15T00:00:00.000000Z",
       "receipt_date": "2024-11-15",
       "deadline": "2024-11-20",
       "planned_hours": 1.5,
       "prevent_overbooking": 0,
       "creator_username": "max.mustermann",
       "processor_username": "frank",
       "status": 1,
       "categories": [
         "string"
       ],
       "keywords": "modi",
       "customer_contact_person": "max.mustermann@example.com"
     }'

Pfad-Parameter

Name
id
Type
integer
Description
Die ID des Tickets
Name
subtask_id
Type
integer
Description
Die ID der Teilaufgabe

Request-Body

Name
subject
Type
string, erforderlich
Description
Die Betreffzeile der Teilaufgabe.
Name
name
Type
string, erforderlich
Description
Der Kurzname der Teilaufgabe.
Name
customer_reference
Type
string, nullable
Description
Eine vom Kunden angegebene Freitext-Referenznummer für diese Teilaufgabe.
Name
start_date
Type
string (date-time), nullable
Description
Das Datum, an dem die Arbeit an der Teilaufgabe planmäßig beginnen soll.
Name
receipt_date
Type
string (date-time), nullable
Description
Das Datum, an dem die zugrunde liegende Anfrage eingegangen ist.
Name
deadline
Type
string (date-time), nullable
Description
Das Datum, bis zu dem die Teilaufgabe abgeschlossen sein soll.
Name
planned_hours
Type
number, nullable
Description
Die Anzahl der für diese Teilaufgabe geplanten Stunden.
Name
prevent_overbooking
Type
integer, nullable
Description
Ob die erfasste Zeit für diese Teilaufgabe die geplanten Stunden überschreiten darf, und für welche Zeitarten.
Einer der Werte: 0, 1, 2, 3, 4
Name
creator_username
Type
string, erforderlich
Description
Der Benutzername des Mitarbeiters, der die Teilaufgabe angelegt hat.
Name
processor_username
Type
string, nullable
Description
Der Benutzername des Mitarbeiters, der die Teilaufgabe aktuell bearbeitet.
Name
status
Type
integer, erforderlich
Description
Der Zielstatus der Teilaufgabe.
Einer der Werte: 1, 2, 3, 4, 5, 8
Name
categories
Type
Liste von string, erforderlich
Description
Die IDs der Kategorien, die der Teilaufgabe zugeordnet werden sollen.
Name
keywords
Type
string, nullable
Description
Freitext-Schlagwörter, kommagetrennt, zum Suchen und Filtern von Teilaufgaben.
Name
customer_contact_person
Type
string (email), nullable
Description
Die E-Mail-Adresse des Ansprechpartners, den diese Teilaufgabe betrifft, falls vorhanden.

Response

{
  "data": {
    "id": 1,
    "name": "EU",
    "ticket_id": 1234,
    "date": "2024-07-20T00:00:00.000000Z",
    "creator_username": "max.mustermann",
    "processor_username": "frank",
    "subject": "Fehler in der Benutzeroberfläche beheben",
    "status": {
      "id": 1,
      "name": "neu"
    },
    "receipt_date": "2024-11-15",
    "start_date": "2024-01-15T00:00:00.000000Z",
    "deadline": "2024-11-20",
    "processing_date": "2024-02-28 14:09:38",
    "done_date": "2024-02-28 14:11:38",
    "planned_hours": 1.5,
    "prevent_overbooking": 0,
    "history_modified": "2024-03-12 08:23:54",
    "keywords": {},
    "created": "2024-07-20T11:30:00.000000Z",
    "modified": "2024-07-20T12:30:00.000000Z",
    "customer_contact_person_id": 1,
    "history_creator_username": "max.mustermann"
  }
}

Response-Felder

Name
id
Type
integer
Description
Die eindeutige Kennung der Teilaufgabe.
Name
name
Type
string
Description
Der Kurzname der Teilaufgabe.
Name
ticket_id
Type
integer
Description
Die ID des Tickets, zu dem diese Teilaufgabe gehört.
Name
date
Type
string (date-time), nullable
Description
Das Datum, an dem die Teilaufgabe erstellt wurde.
Name
creator_username
Type
string
Description
Der Benutzername des Mitarbeiters, der die Teilaufgabe angelegt hat.
Name
processor_username
Type
string, nullable
Description
Der Benutzername des Mitarbeiters, der die Teilaufgabe aktuell bearbeitet.
Name
subject
Type
string
Description
Die Betreffzeile der Teilaufgabe.
Name
status
Type
object
Description
Der Bearbeitungsstatus der Teilaufgabe (z. B. neu, in Bearbeitung, erledigt) — dieselben Zustände wie bei einem Ticket.
Name
status.id
Type
integer
Description
Der gespeicherte Wert. Vergleichen Sie gegen diesen, nicht gegen name.
Name
status.name
Type
string
Description
Die lesbare Bezeichnung in der Sprache des Mandanten. Nicht parsen.
Einer der Werte: "neu", "in Bearbeitung", "fertig", "abgelehnt", "bewilligt", "billed"
Name
receipt_date
Type
string (date-time), nullable
Description
Das Datum, an dem die zugrunde liegende Anfrage eingegangen ist.
Name
start_date
Type
string (date-time), nullable
Description
Das Datum, an dem die Arbeit an der Teilaufgabe planmäßig beginnen soll.
Name
deadline
Type
string (date-time), nullable
Description
Das Datum, bis zu dem die Teilaufgabe abgeschlossen sein soll.
Name
processing_date
Type
string (date-time), nullable
Description
Das Datum, an dem die Teilaufgabe in Bearbeitung genommen wurde.
Name
done_date
Type
string (date-time), nullable
Description
Das Datum, an dem die Teilaufgabe als erledigt markiert wurde.
Name
planned_hours
Type
number, nullable
Description
Die Anzahl der für diese Teilaufgabe geplanten Stunden.
Name
prevent_overbooking
Type
integer
Description
Ob die erfasste Zeit für diese Teilaufgabe die geplanten Stunden überschreiten darf, und für welche Zeitarten.
Einer der Werte: 0, 1, 2, 3, 4
Name
history_modified
Type
string (date-time)
Description
Wann der jüngste Verlaufseintrag der Teilaufgabe erfasst wurde.
Name
keywords
Type
object, nullable
Description
Freitext-Schlagwörter, kommagetrennt, zum Suchen und Filtern von Teilaufgaben.
Name
created
Type
string (date-time), nullable
Description
Wann der Datensatz der Teilaufgabe erstellt wurde.
Name
modified
Type
string (date-time), nullable
Description
Wann der Datensatz der Teilaufgabe zuletzt geändert wurde.
Name
customer_contact_person_id
Type
integer, nullable
Description
Die ID des Ansprechpartners, von dem oder für den diese Teilaufgabe erstellt wurde.
Name
history_creator_username
Type
string, nullable
Description
Der Benutzername des Mitarbeiters, der den ersten Verlaufseintrag der Teilaufgabe angelegt hat.

Aus der OpenAPI-Spezifikation erzeugt — Änderungen gehören in den Quellcode, nicht auf diese Seite.

GET Teilaufgabe eines Tickets abrufen DELETE Teilaufgabe eines Tickets löschen