Meilensteine
Fortschritt mit Meilensteinen auf Boards planen und verfolgen.
Meilensteine gruppieren Tickets um ein Ziel oder einen Termin. Jeder Meilenstein verfolgt den Fortschritt durch Aggregation des Status seiner zugewiesenen Tickets. Meilensteine erfordern, dass das Feature Meilensteine & Releases auf dem Board aktiviert ist.
Meilensteine auflisten
GET /api/v1/boards/{boardId}/milestonesBerechtigung erforderlich: milestones:view
Query-Parameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| includeDeleted | boolean | Nein | Soft-gelöschte Meilensteine einschließen |
| sortBy | string | Nein | Sortierfeld |
| sortOrder | string | Nein | asc oder desc |
Beispiel-Response
[
{
"id": "ms_abc123",
"name": "v2.0 Launch",
"description": "Großes Plattform-Release",
"dueDate": "2025-06-01T00:00:00Z",
"color": "#8B5CF6",
"progress": {
"total": 12,
"completed": 8,
"percentage": 67
},
"createdAt": "2025-01-15T10:00:00Z"
}
]Meilenstein erstellen
POST /api/v1/boards/{boardId}/milestonesBerechtigung erforderlich: milestones:create
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | string | Ja | Meilensteinname (max. 200 Zeichen, eindeutig pro Board) |
| description | string | Nein | Meilenstein-Beschreibung |
| dueDate | string | Ja | Fälligkeitsdatum (ISO 8601) |
| color | string | Nein | Farbe im Hex-Format (z.B. #8B5CF6) |
| sortOrder | number | Nein | Anzeigereihenfolge |
Beispiel-Request
{
"name": "v2.0 Launch",
"description": "Großes Plattform-Release",
"dueDate": "2025-06-01T00:00:00Z",
"color": "#8B5CF6"
}Meilenstein abrufen
GET /api/v1/boards/{boardId}/milestones/{milestoneId}Berechtigung erforderlich: milestones:view
Gibt einen Meilenstein mit Fortschrittsinformationen zurück.
Meilenstein aktualisieren
PATCH /api/v1/boards/{boardId}/milestones/{milestoneId}Berechtigung erforderlich: milestones:edit
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | string | Nein | Meilensteinname |
| description | string | Nein | Meilenstein-Beschreibung |
| dueDate | string | Nein | Fälligkeitsdatum (ISO 8601) |
| color | string | Nein | Farbe im Hex-Format |
Meilenstein löschen
DELETE /api/v1/boards/{boardId}/milestones/{milestoneId}Berechtigung erforderlich: milestones:delete
Löscht den Meilenstein (Soft-Delete). Gibt 204 No Content zurück.
Meilenstein-Tickets abrufen
GET /api/v1/boards/{boardId}/milestones/{milestoneId}/ticketsBerechtigung erforderlich: milestones:view
Gibt alle Tickets zurück, die einem Meilenstein zugewiesen sind.
Query-Parameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| status | string | Nein | Nach Statuskategorie filtern: PLANNING, ACTIVE oder FINAL |