Delete a vault
Deletes an existing vault.
Note: Protected vaults are only deleted if they are empty.
Request
Security
| Any | Super User | System Admin | Security Admin | Operator |
|---|---|---|---|---|
| superUser | systemAdmin |
HTTP method
POST /manager/api/{apiResponseType}/1.0/deleteVault.adm HTTP/1.1 Host:{manager.dsnet}
id={vaultId}&password={password}&action={delete|deny}
Curl method
curl -u {admin}:{password} -k
”https://{manager.dsnet}/manager/api/{apiResponseType}/1.0/deleteVault.adm“ -d
”id={vaultId}&password={password}&action={delete|deny}“
Parameters
| Parameter | Type | Usage | Default | Description |
|---|---|---|---|---|
| id | Long | Required |
ID of vault to delete. This ID is returned after vault creation. |
|
| password | String | Required |
Password of account that is making request. |
|
| action | String | The vault deletion action for multi-user vault deletion requests - either "delete" or "deny". This only applies if Vault Deletion Authorization is enabled. |
Response
Returns success or failure status.
HTTP response codes
- When using an incorrect mirror ID, the request responds with the 422 HTTP status code and the The given mirror id is invalid HTTP status message.
JSON response example
Default JSON success or failure response that is shown in Default JSON success response and Default JSON failure response.
Parameters
None other than the default response parameters shown in Common response parameters.