Restore space

The restore space operation is used to restore a deleted space within 30 days of its deletion. When a space is restored, all the resources under the space will be restored in their original hierarchy. This operation requires the identifier of the deleted space. Please note that spaces will be restored to the original CDH account and only soft deleted spaces can be restored.

The restore operation will immediately restore the explicitly specified space and it’s root folder. Any resources nested under the restored space or folder will be restored through an asynchronous process. The job ID for this asynchronous process can be found in the Location response header. By using this job ID with the Get Jobs API, users can monitor the progress of the restoration.

Prerequisites

• A space should be in soft deleted state. To know more about deleting a space refer here

Request

POST {baseUrl}/spaces/{spaceId}/restore

• HEADER:

  • Authorization: Bearer {tid token}

Response

Response Headers:

Location: /jobs/d5fdc7b4-5ddd-44f0-8129-7596895c6fa6

Example response:

{
       "id": "f85bc802-5481-4581-b972-c4652d595ec7",
       "name": "My space",
       "type": "SPACE",
       "rootId": "5f4e3d8e-4b0e-4b3e-8f3d-3e4b0e4b3e8f",
       "acl": {
       "spaceManager": [
           "trn:tid:user:<user-id>",
           "trn:tid:user:<user-id>"
       ]
       },
       "createdAt": "2024-03-17T00:00:00Z",
       "updatedAt": "2023-03-19T11:00:00Z",
       "createdByTrn": "trn:tid:user:<user-id>",
       "updatedByTrn": "trn:tid:user:<user-id>",
       "deleted": false
   }

To know more about the restore space API refer here.