Untertickets
Tickets in kleinere Aufgaben mit Untertickets aufteilen und zwischen eigenständigen Tickets und Untertickets konvertieren.
Untertickets ermöglichen es dir, ein Ticket in kleinere, nachverfolgbare Arbeitspakete aufzuteilen. Jedes Unterticket hat seinen eigenen Status, Verantwortlichen und Lebenszyklus, bleibt aber mit seinem Eltern-Ticket verknüpft.
Untertickets auflisten
GET /api/v1/boards/{boardId}/tickets/{ticketId}/subticketsGibt alle Untertickets eines Eltern-Tickets mit aggregiertem Fortschritt zurück.
Beispiel-Response
{
"data": [
{
"id": "tkt_sub123",
"displayId": "WEB-43",
"title": "Button-Styles aktualisieren",
"status": {
"id": "sts_abc123",
"name": "In Bearbeitung",
"category": "ACTIVE"
},
"assignee": {
"id": "usr_abc123",
"name": "Alex Smith"
}
}
],
"aggregation": {
"total": 3,
"completed": 1,
"inProgress": 1,
"planning": 1
}
}Unterticket erstellen
POST /api/v1/boards/{boardId}/tickets/{ticketId}/subticketsErstellt ein neues Unterticket unter dem angegebenen Eltern-Ticket.
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| title | string | Ja | Unterticket-Titel (max. 200 Zeichen) |
| description | string | Nein | Unterticket-Beschreibung |
| assigneeId | string | Nein | Verantwortlicher Nutzer-ID |
Beispiel-Request
{
"title": "Button-Styles aktualisieren",
"assigneeId": "usr_abc123"
}Unterticket-Status aktualisieren
PATCH /api/v1/boards/{boardId}/tickets/{ticketId}/subtickets/{subticketId}/statusÄndert den Status eines Untertickets.
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| statusId | string | Ja | Ziel-Status-ID |
In Unterticket konvertieren
POST /api/v1/boards/{boardId}/tickets/{ticketId}/convert-to-subticketKonvertiert ein bestehendes eigenständiges Ticket in ein Unterticket eines anderen Tickets.
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| parentTicketId | string | Ja | Das Ticket, das zum Eltern-Ticket wird |
Zu eigenständigem Ticket heraufstufen
POST /api/v1/boards/{boardId}/tickets/{ticketId}/promote-to-standaloneStuft ein Unterticket wieder zu einem eigenständigen Ticket herauf und entfernt die Eltern-Beziehung.