Restore a recently deleted folder
POST/folders/:folderKey/restoration
Restores a soft-deleted folder back to the live project, together with the descendants that were soft-deleted with it. If the folder's original parent folder was also deleted, the folder is restored into a new wrapper folder under the nearest surviving ancestor folder, or at the project root if no ancestor folder survives. The folder cannot be restored while its containing project or workspace is still deleted. Only a folder that is the root of its own deletion can be restored via this endpoint; a folder that was soft-deleted as part of an ancestor folder, project, or workspace's deletion event must be restored through the corresponding ancestor restoration endpoint instead.
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 500
The folder was restored successfully. Returns the restored folder.
The request lacks valid authentication credentials.
Response Headers
Forbidden. The request is not allowed.
The recently deleted folder was not found, or is not the root of its own deletion.
The folder cannot be restored because its containing project or workspace is itself deleted. Restore that first.
An internal error occurred while processing the request.