Ticket Links
Create dependencies and relationships between tickets.
Ticket links define relationships between tickets -- blocking dependencies, duplicates, or general associations. When you create a BLOCKS or DUPLICATES link, the inverse link is automatically created on the target ticket.
Link Types
| Type | Inverse | Description |
|---|---|---|
RELATES_TO | RELATES_TO | General relationship (symmetric) |
BLOCKS | IS_BLOCKED_BY | This ticket blocks the target |
IS_BLOCKED_BY | BLOCKS | This ticket is blocked by the target |
DUPLICATES | IS_DUPLICATED_BY | This ticket duplicates the target |
IS_DUPLICATED_BY | DUPLICATES | This ticket is duplicated by the target |
List Links
GET /api/v1/boards/{boardId}/tickets/{ticketId}/linksExample Response
{
"data": [
{
"id": "lnk_abc123",
"type": "BLOCKS",
"targetTicket": {
"id": "tkt_def456",
"displayId": "WEB-10",
"title": "Deploy new auth system"
},
"createdAt": "2025-03-15T14:30:00Z"
}
]
}Create Link
POST /api/v1/boards/{boardId}/tickets/{ticketId}/linksRequest Body
| Field | Type | Required | Description |
|---|---|---|---|
| targetTicketId | string | Yes | Target ticket ID to link to |
| type | string | Yes | Link type (see table above) |
Example Request
{
"targetTicketId": "tkt_def456",
"type": "BLOCKS"
}Delete Link
DELETE /api/v1/boards/{boardId}/tickets/{ticketId}/links/{linkId}Removes the link and its inverse. Returns 204 No Content.