EaserixDocs
DevelopersAPI referenceTasksIssues

Restore a deleted issue

Moves a soft-deleted issue out of Recently Deleted together with its whole sub-issue subtree, unconditionally - including a sub-issue that was deleted separately beforehand, so restore is the exact mirror of the delete it undoes. An issue that is not soft-deleted is a 404, as is one in a team the caller is not in.

View as Markdown
POST
/v1/issues/{id}/restore

Authorization

bearer
AuthorizationBearer <token>

In: header

Path Parameters

id*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/issues/497f6eca-6276-4993-bfeb-53cbbbba6f08/restore"
{  "issue": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",    "projectId": "5a8591dd-4039-49df-9202-96385ba3eff8",    "number": 0,    "title": "string",    "description": "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    },    "priority": 0,    "assigneeId": "665a9750-71bd-4b96-bacd-9efa4ae022dd",    "assignee": {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",      "name": "string",      "email": "string",      "created": "2019-08-24T14:15:22Z"    },    "creatorId": "688ebf54-d343-4104-8711-82c2feac534a",    "parentId": "70850378-7d3c-4f45-91b7-942d4dfbbd43",    "cycleId": "811bdbf8-a42f-4f8c-b62e-39c77332ffe1",    "estimate": 0,    "position": 0,    "dueDate": "2019-08-24",    "labels": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",        "name": "string",        "color": "string"      }    ],    "childCount": 0,    "blockedByCount": 0,    "match": {      "field": "title",      "snippet": [        {          "text": "string",          "hit": true        }      ],      "commentId": "ee0469af-2fa1-4b7e-b5f1-8e711a95821b",      "author": "string",      "at": "2019-08-24T14:15:22Z"    },    "created": "2019-08-24T14:15:22Z",    "modified": "2019-08-24T14:15:22Z",    "completedAt": "2019-08-24T14:15:22Z",    "mentions": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string",        "email": "string"      }    ],    "following": true  }}

Delete an issue

Soft delete. The issue moves to Recently Deleted (list it with deleted=true) along with every sub-issue at any depth - none is left live and none is orphaned. Comments and attachments are untouched, because nothing about the issue is actually gone yet. A descendant that was already deleted keeps its original timestamp, so its own 30-day clock is not reset. Deleting an already-deleted issue is a 404.

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.