SpedySpedy Docs

Ticket-Verknüpfungen

Abhängigkeiten und Beziehungen zwischen Tickets erstellen.

Ticket-Verknüpfungen definieren Beziehungen zwischen Tickets -- blockierende Abhängigkeiten, Duplikate oder allgemeine Verbindungen. Wenn du eine BLOCKS- oder DUPLICATES-Verknüpfung erstellst, wird die inverse Verknüpfung automatisch auf dem Ziel-Ticket erstellt.

Verknüpfungstypen

TypInversBeschreibung
RELATES_TORELATES_TOAllgemeine Beziehung (symmetrisch)
BLOCKSIS_BLOCKED_BYDieses Ticket blockiert das Ziel
IS_BLOCKED_BYBLOCKSDieses Ticket wird vom Ziel blockiert
DUPLICATESIS_DUPLICATED_BYDieses Ticket dupliziert das Ziel
IS_DUPLICATED_BYDUPLICATESDieses Ticket wird vom Ziel dupliziert

Verknüpfungen auflisten

GET /api/v1/boards/{boardId}/tickets/{ticketId}/links

Beispiel-Response

{
  "data": [
    {
      "id": "lnk_abc123",
      "type": "BLOCKS",
      "targetTicket": {
        "id": "tkt_def456",
        "displayId": "WEB-10",
        "title": "Neues Auth-System deployen"
      },
      "createdAt": "2025-03-15T14:30:00Z"
    }
  ]
}

Verknüpfung erstellen

POST /api/v1/boards/{boardId}/tickets/{ticketId}/links

Request Body

FeldTypPflichtBeschreibung
targetTicketIdstringJaZiel-Ticket-ID zur Verknüpfung
typestringJaVerknüpfungstyp (siehe Tabelle oben)

Beispiel-Request

{
  "targetTicketId": "tkt_def456",
  "type": "BLOCKS"
}

Verknüpfung löschen

DELETE /api/v1/boards/{boardId}/tickets/{ticketId}/links/{linkId}

Entfernt die Verknüpfung und ihre Inverse. Gibt 204 No Content zurück.