Deleting vaults

You can delete your vaults in Unified Key Orchestrator with the UI, or programmatically with the Unified Key Orchestrator API.

If you want to delete a vault, you need to delete all managed keys, delete or archive all key templates, and delete or disconnect from all keystores that are managed in the vault first. The Delete function is available for empty vaults only. Make sure to have an empty vault by referring to the following instructions:

To delete managed keys, see Deleting managed keys.
To delete or archive all key templates, see Deleting key templates and Archiving and unarchiving key templates.
To delete or disconnect from all keystores, see Deleting internal keystores and Disconnecting from external keystores.

Deleting vaults with the UI

By deleting a vault, access groups that are assigned to this vault can no longer access the vault.

To delete a vault by using the UI, complete the following steps:

Log in to the Hyper Protect Crypto Services instance.
Click Vaults from the navigation to view all the available vaults.
Click the vault that you want to delete. The Details side panel is displayed.
Make sure that the vault does not contain any key templates, keys, or keystores, and then click Delete.

If any archived key templates are assigned to this vault, the archived key templates are also deleted with the vault.
Click Delete vault to confirm the deletion.

The vault has been deleted and removed from the vault list. Access groups that are assigned to this vault no longer have access to the vault.

Deleting vaults with the API

To delete a vault through the API, follow these steps:

Retrieve your service and authentication credentials to work with vaults in the service.
Delete a vault by making a DELETE call to the following endpoint.
```
https://uko.<region>.hs-crypto.cloud.ibm.com:<port>/api/v4/vaults/<vault_id>
```
Replace <vault_id> with the ID of your vault.

For detailed instructions and code examples about using the API method, check out the Hyper Protect Crypto Services Unified Key Orchestrator API reference doc.

What's next

To find out how to create a vault, check out Creating vaults.
To find out instructions on editing a vault, check out Editing vault details.
To find out how to grant access to vaults, see Granting access to vaults.