Kommentare
Kommentare zu Tickets hinzufügen, bearbeiten und verwalten.
Kommentare ermöglichen es Teammitgliedern, auf Tickets zu diskutieren und zusammenzuarbeiten. Spedy unterstützt verschachtelte Antworten und geheime Kommentare, die nur für Teammitglieder sichtbar sind (nicht für Kunden).
Kommentare auflisten
GET /api/v1/boards/{boardId}/tickets/{ticketId}/commentsQuery-Parameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| page | number | Nein | Seitennummer (Standard: 1) |
| limit | number | Nein | Einträge pro Seite (Standard: 20) |
Beispiel-Response
{
"data": [
{
"id": "cmt_abc123",
"content": "Ich habe das auf Chrome 120 reproduziert.",
"isSecret": false,
"author": {
"id": "usr_abc123",
"name": "Alex Smith"
},
"parentId": null,
"createdAt": "2025-03-15T14:30:00Z",
"updatedAt": "2025-03-15T14:30:00Z"
}
]
}Kommentar erstellen
POST /api/v1/boards/{boardId}/tickets/{ticketId}/commentsRequest Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| content | string | Ja | Kommentarinhalt (max. 10.000 Zeichen) |
| isSecret | boolean | Nein | Geheimer Kommentar, nur für Teammitglieder sichtbar (erfordert tickets:add-secret-comments-Berechtigung) |
| parentId | string | Nein | Eltern-Kommentar-ID für verschachtelte Antworten |
Beispiel-Request
{
"content": "Ich habe das auf Chrome 120 reproduziert.",
"isSecret": false
}Kommentar abrufen
GET /api/v1/boards/{boardId}/tickets/{ticketId}/comments/{commentId}Gibt einen einzelnen Kommentar zurück.
Kommentar aktualisieren
PATCH /api/v1/boards/{boardId}/tickets/{ticketId}/comments/{commentId}Nur der Kommentarautor oder Nutzer mit tickets:edit-Berechtigung können Kommentare aktualisieren.
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| content | string | Ja | Aktualisierter Kommentarinhalt |
Kommentar löschen
DELETE /api/v1/boards/{boardId}/tickets/{ticketId}/comments/{commentId}Nur der Kommentarautor oder Nutzer mit tickets:edit-Berechtigung können Kommentare löschen. Gibt 204 No Content zurück.