The /archive endpoint of the Disguise Cloud API archives a specific drive by its unique identifier.
When you archive a drive, it is no longer accessible through the API (except for restoring) and is not visible in the Disguise Cloud Drive app outside of the archived drives section.
Your drive will be archived and not deleted, so you can restore it at any time, and none of your data will be lost. Archived drives do not count towards your organisation’s drive limit.
The response from the /archive endpoint includes the following fields:
| Field | Type | Description |
|---|---|---|
| message | string | If successful, the message will be `Drive archived’. |
curl -X POST https://api.disguise.cloud/v1/drives/{{uuid}}/archive \
-H "Authorization: Token YOUR_API_TOKEN"
A successful response will return a 200 OK status code and the following JSON:
{
"message": "Drive archived"
}
If the drive cannot be found or is already 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 archive either does not exist or has already been archived"
}
}