Restore a deleted project
Moves a soft-deleted project out of Recently Deleted, and with it every issue currently pointing at it that belongs to the project's own team - unconditionally, regardless of when each issue was deleted, so restore is the exact mirror of the delete it undoes. A project that is not soft-deleted is a 404, as is one belonging to another org.
View as MarkdownAuthorization
bearer In: header
Path Parameters
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/restore"{ "project": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec", "name": "string", "description": "string", "status": "planned", "leadId": "3c6e2b8e-0e8f-48db-8791-27271df10113", "targetDate": "2019-08-24", "created": "2019-08-24T14:15:22Z", "modified": "2019-08-24T14:15:22Z" }}Delete a project
Soft delete. The project moves to Recently Deleted (list it with deleted=true) together with every live issue in it that belongs to the project's OWN team - the cascade is bounded to that team because permission was checked against the project row, so it must not reach a row that check never covered. Deleting an already-deleted project is a 404. Nothing is erased until permanentlyDeleteProject is called or the 30-day retention window expires.
Permanently delete a project
Erases the project row for good. Only valid on a project already in Recently Deleted - anything else, including a live project, is a 404. Issues sitting in Recently Deleted are NOT erased with it: permanent deletion never cascades destruction downward, and issues.project_id is ON DELETE SET NULL, so they simply lose the link and stay independently restorable.