Spedy Docs

Releases repräsentieren eine versionierte Auslieferung deines Produkts. Jedes Release kann Meilensteine und einzelne Tickets enthalten. Releases erfordern, dass das Feature Meilensteine & Releases auf dem Board aktiviert ist.

Releases auflisten

GET /api/v1/boards/{boardId}/releases

Berechtigung erforderlich: releases:view

Beispiel-Response

[
  {
    "id": "rel_abc123",
    "name": "v2.0",
    "version": "2.0.0",
    "description": "Großes Plattform-Release",
    "releaseDate": "2025-06-15T00:00:00Z",
    "milestones": [
      {
        "id": "ms_abc123",
        "name": "v2.0 Launch"
      }
    ],
    "ticketCount": 24,
    "createdAt": "2025-01-15T10:00:00Z"
  }
]

Release erstellen

POST /api/v1/boards/{boardId}/releases

Berechtigung erforderlich: releases:create

Request Body

Feld	Typ	Pflicht	Beschreibung
name	string	Ja	Release-Name (max. 200 Zeichen)
version	string	Nein	Versionsbezeichner, z.B. `2.0.0` (max. 50 Zeichen)
description	string	Nein	Release-Beschreibung
releaseDate	string	Nein	Ziel-Veröffentlichungsdatum (ISO 8601)
milestoneIds	string[]	Nein	Meilenstein-IDs zum Einschließen

Beispiel-Request

{
  "name": "v2.0",
  "version": "2.0.0",
  "description": "Großes Plattform-Release",
  "releaseDate": "2025-06-15T00:00:00Z",
  "milestoneIds": ["ms_abc123"]
}

Release abrufen

GET /api/v1/boards/{boardId}/releases/{releaseId}

Berechtigung erforderlich: releases:view

Release aktualisieren

PATCH /api/v1/boards/{boardId}/releases/{releaseId}

Berechtigung erforderlich: releases:edit

Request Body

Feld	Typ	Pflicht	Beschreibung
name	string	Nein	Release-Name
version	string	Nein	Versionsbezeichner
description	string	Nein	Release-Beschreibung
releaseDate	string	Nein	Ziel-Veröffentlichungsdatum

Release löschen

DELETE /api/v1/boards/{boardId}/releases/{releaseId}

Berechtigung erforderlich: releases:delete

Gibt 204 No Content zurück.

Meilenstein zu Release hinzufügen

POST /api/v1/boards/{boardId}/releases/{releaseId}/milestones

Berechtigung erforderlich: releases:edit

Request Body

Feld	Typ	Pflicht	Beschreibung
milestoneId	string	Ja	Hinzuzufügende Meilenstein-ID

Meilenstein aus Release entfernen

DELETE /api/v1/boards/{boardId}/releases/{releaseId}/milestones/{milestoneId}

Berechtigung erforderlich: releases:edit

Ticket zu Release hinzufügen

POST /api/v1/boards/{boardId}/releases/{releaseId}/tickets

Berechtigung erforderlich: releases:edit

Request Body

Feld	Typ	Pflicht	Beschreibung
ticketId	string	Ja	Hinzuzufügende Ticket-ID

Ticket aus Release entfernen

DELETE /api/v1/boards/{boardId}/releases/{releaseId}/tickets/{ticketId}

Berechtigung erforderlich: releases:edit

Releases

Inhaltsverzeichnis