Tickettypen
Tickettypen wie Bug, Feature und Epic verwalten.
Tickettypen klassifizieren, welche Art von Arbeit ein Ticket repräsentiert. Gängige Typen sind Bug, Feature und Epic. Jeder Typ hat einen Namen, eine Farbe und eine Anzeigereihenfolge.
Tickettypen auflisten
GET /api/v1/ticket-typesGibt alle Tickettypen der Organisation zurück.
Beispiel-Response
{
"data": [
{
"id": "typ_abc123",
"name": "Feature",
"color": "#3B82F6",
"description": "Neue Funktionalität",
"order": 0,
"isOrgDefault": true
},
{
"id": "typ_def456",
"name": "Bug",
"color": "#EF4444",
"description": "Etwas, das repariert werden muss",
"order": 1,
"isOrgDefault": false
}
]
}Standard-Tickettyp abrufen
GET /api/v1/ticket-types/defaultGibt den Standard-Tickettyp der Organisation zurück, der verwendet wird, wenn bei der Ticket-Erstellung kein Typ angegeben wird.
Tickettyp erstellen
POST /api/v1/ticket-typesBerechtigung erforderlich: settings:manage-ticket-types
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | string | Ja | Typname (max. 50 Zeichen) |
| color | string | Ja | Farbe im Hex-Format (z.B. #EF4444) |
| description | string | Nein | Typbeschreibung (max. 500 Zeichen) |
| order | number | Nein | Anzeigereihenfolge (0-100) |
| isOrgDefault | boolean | Nein | Als Standardtyp festlegen |
| enabledByDefault | boolean | Nein | Standardmäßig auf neuen Boards aktiviert |
Beispiel-Request
{
"name": "Epic",
"color": "#8B5CF6",
"description": "Großes Feature über mehrere Tickets"
}Tickettyp abrufen
GET /api/v1/ticket-types/{typeId}Gibt einen einzelnen Tickettyp zurück.
Tickettyp aktualisieren
PATCH /api/v1/ticket-types/{typeId}Berechtigung erforderlich: settings:manage-ticket-types
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | string | Nein | Typname |
| color | string | Nein | Farbe im Hex-Format |
| description | string | Nein | Typbeschreibung |
| order | number | Nein | Anzeigereihenfolge |
| isOrgDefault | boolean | Nein | Als Standardtyp festlegen |
Tickettyp löschen
DELETE /api/v1/ticket-types/{typeId}Berechtigung erforderlich: settings:manage-ticket-types
Löscht einen Tickettyp. Optional kann ein Ersatztyp für bestehende Tickets angegeben werden.
Query-Parameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| replacementTypeId | string | Nein | Bestehende Tickets vor der Löschung diesem Typ zuweisen |
Gibt 204 No Content zurück.