Labels
Labels zum Kategorisieren von Tickets erstellen und verwalten.
Labels bieten eine flexible Möglichkeit, Tickets über Boards hinweg zu kategorisieren und zu filtern. Jedes Label hat einen Namen, eine Farbe und eine optionale Beschreibung.
Labels auflisten
GET /api/v1/labelsGibt alle Labels der Organisation zurück.
Beispiel-Response
[
{
"id": "lbl_abc123",
"name": "Frontend",
"color": "#3B82F6",
"description": "Frontend-bezogene Arbeit",
"createdAt": "2025-01-15T10:00:00Z"
},
{
"id": "lbl_def456",
"name": "Dringend",
"color": "#EF4444",
"description": null,
"createdAt": "2025-01-15T10:00:00Z"
}
]Label erstellen
POST /api/v1/labelsBerechtigung erforderlich: settings:edit
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | string | Ja | Label-Name (max. 50 Zeichen) |
| color | string | Ja | Farbe im Hex-Format (z.B. #3B82F6) |
| description | string | Nein | Label-Beschreibung (max. 200 Zeichen) |
Beispiel-Request
{
"name": "Frontend",
"color": "#3B82F6",
"description": "Frontend-bezogene Arbeit"
}Label abrufen
GET /api/v1/labels/{labelId}Gibt ein einzelnes Label zurück.
Label aktualisieren
PATCH /api/v1/labels/{labelId}Berechtigung erforderlich: settings:edit
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | string | Nein | Label-Name |
| color | string | Nein | Farbe im Hex-Format |
| description | string | Nein | Label-Beschreibung |
Label löschen
DELETE /api/v1/labels/{labelId}Berechtigung erforderlich: settings:edit
Löscht das Label dauerhaft und entfernt es von allen Tickets. Gibt 204 No Content zurück.