Anhänge
Dateianhänge zu Tickets hochladen, herunterladen und verwalten.
Anhänge ermöglichen es dir, Dateien zu Tickets hinzuzufügen -- Screenshots, Dokumente, Design-Mockups oder alles andere, was dein Team als Referenz benötigt.
Anhänge auflisten
GET /api/v1/boards/{boardId}/tickets/{ticketId}/attachmentsQuery-Parameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| page | number | Nein | Seitennummer (Standard: 1) |
| limit | number | Nein | Einträge pro Seite (Standard: 20) |
| commentId | string | Nein | Nach Kommentar-ID filtern, oder "ticket" für nur Ticket-Anhänge |
Beispiel-Response
{
"data": [
{
"id": "att_abc123",
"filename": "screenshot.png",
"mimeType": "image/png",
"size": 245760,
"uploadedBy": {
"id": "usr_abc123",
"name": "Alex Smith"
},
"createdAt": "2025-03-15T14:30:00Z"
}
]
}Anhang hochladen
POST /api/v1/boards/{boardId}/tickets/{ticketId}/attachments/uploadRate-Limit: 50 Uploads pro Stunde pro IP.
Lade eine Datei per multipart/form-data hoch. Maximale Dateigröße ist 50 MB. Der MIME-Typ der Datei wird validiert und muss zur Dateiendung passen.
Formular-Felder
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| file | binary | Ja | Die hochzuladende Datei |
Query-Parameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| commentId | string | Nein | An einen bestimmten Kommentar anhängen statt an das Ticket |
Beispiel-Request
curl -X POST \
"https://acme-corp.spedy.ai/api/v1/boards/{boardId}/tickets/{ticketId}/attachments/upload" \
-H "Authorization: Bearer {token}" \
-F "[email protected]"Anhang herunterladen
GET /api/v1/boards/{boardId}/tickets/{ticketId}/attachments/{attachmentId}/downloadGibt die Datei als Stream zurück. Bilder werden inline bereitgestellt, andere Dateien als Download.
Anhang löschen
DELETE /api/v1/boards/{boardId}/tickets/{ticketId}/attachments/{attachmentId}Nur der Uploader oder Nutzer mit tickets:delete-Berechtigung können Anhänge löschen. Gibt 204 No Content zurück.