EaserixDocs
DevelopersAPI referenceTasksIssues

List an issue's relations

Both directions of every link on this issue. blocks is one stored row: the source is holding the target up, and the target reads that same row as blocked by. A completed or canceled blocker is returned under resolvedBlocks rather than blockedBy, and the row stays type blocks so reopening the blocker counts again. related is one row shown on both issues. duplicateOf is set when this issue is the copy. A soft-deleted other end is omitted until that issue is restored.

View as Markdown
GET
/v1/issues/{id}/relations

Authorization

bearer
AuthorizationBearer <token>

In: header

Path Parameters

id*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/issues/497f6eca-6276-4993-bfeb-53cbbbba6f08/relations"
{  "blockedBy": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "type": "blocks",      "direction": "blocks",      "issue": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",        "number": 0,        "title": "string",        "stateId": "871bb69c-5872-42b2-88b0-72e9da663aaa",        "state": {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",          "name": "string",          "type": "backlog",          "color": "string",          "position": 0,          "description": "string",          "canDelete": true        }      }    }  ],  "blockedByTotal": 0,  "blocks": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "type": "blocks",      "direction": "blocks",      "issue": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",        "number": 0,        "title": "string",        "stateId": "871bb69c-5872-42b2-88b0-72e9da663aaa",        "state": {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",          "name": "string",          "type": "backlog",          "color": "string",          "position": 0,          "description": "string",          "canDelete": true        }      }    }  ],  "blocksTotal": 0,  "related": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "type": "blocks",      "direction": "blocks",      "issue": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",        "number": 0,        "title": "string",        "stateId": "871bb69c-5872-42b2-88b0-72e9da663aaa",        "state": {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",          "name": "string",          "type": "backlog",          "color": "string",          "position": 0,          "description": "string",          "canDelete": true        }      }    }  ],  "relatedTotal": 0,  "resolvedBlocks": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "type": "blocks",      "direction": "blocks",      "issue": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",        "number": 0,        "title": "string",        "stateId": "871bb69c-5872-42b2-88b0-72e9da663aaa",        "state": {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",          "name": "string",          "type": "backlog",          "color": "string",          "position": 0,          "description": "string",          "canDelete": true        }      }    }  ],  "resolvedBlocksTotal": 0,  "duplicateOf": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "type": "blocks",    "direction": "blocks",    "issue": {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",      "number": 0,      "title": "string",      "stateId": "871bb69c-5872-42b2-88b0-72e9da663aaa",      "state": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",        "name": "string",        "type": "backlog",        "color": "string",        "position": 0,        "description": "string",        "canDelete": true      }    }  },  "duplicates": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "type": "blocks",      "direction": "blocks",      "issue": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",        "number": 0,        "title": "string",        "stateId": "871bb69c-5872-42b2-88b0-72e9da663aaa",        "state": {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",          "name": "string",          "type": "backlog",          "color": "string",          "position": 0,          "description": "string",          "canDelete": true        }      }    }  ],  "duplicatesTotal": 0,  "truncated": true}

Permanently delete an issue

Erases the issue row for good, and only this row: a sub-issue still sitting in Recently Deleted is untouched and stays independently restorable or purgeable. Comments cascade for real here, and the issue's attachments are marked for the sweeper to reclaim their files - this is the first point the issue is genuinely gone. Only valid on an issue already in Recently Deleted; anything else, including a live issue, is a 404.

Link this issue to another

Idempotent. The same pair and type returns the existing row with created false and writes nothing. blocked_by is stored as blocks with the two ids swapped. related is stored with the lower id as the source so asking from either issue is the same row. Both issues must be in this issue's team. A blocks link that would close a loop is refused, and so is a duplicate link that would loop back on itself. An issue can be a duplicate of only one other issue.