The /restore endpoint of the Disguise Cloud API restores a specific archived drive by its unique identifier.
When you restore a drive, it will be accessible again through the API and the Disguise Cloud Drive app. Your drive will be restored to the state it was in when it was archived, and none of your data will be lost. Active/restored drives count towards your organisation’s drive limit.
You can only restore drives that have been previously archived, either via the API or the Disguise Cloud Dashboard.
The response from the /restore endpoint includes the following fields:
| Field | Type | Description |
|---|---|---|
| message | string | If successful, the message will be `Drive restored’. |
curl -X POST https://api.disguise.cloud/v1/drives/{{uuid}}/restore \
-H "Authorization: Token YOUR_API_TOKEN"
A successful response will return a 200 OK status code and the following JSON:
{
"message": "Drive restored"
}
If the drive cannot be found or is not archived, the response will return a 404 Not Found status code and the following JSON:
{
"error": {
"message": "Drive not found",
"details": "The drive you are trying to restore either does not exist or has not been archived"
}
}