---
name: hs-crypto-uko-edit-vaults
title: Editing vault details
description: You can edit your vaults in Unified Key Orchestrator with the UI, or programmatically with the Unified Key Orchestrator. With a vault, you can create key templates, create managed keys, add keystores, and manage resources that are contained in the vault.
last-updated: 2026-06-16
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/hs-crypto?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Editing vault details
{: #edit-vaults}

You can edit your vaults in Unified Key Orchestrator with the UI, or programmatically with the Unified Key Orchestrator. With a vault, you can create key templates, create managed keys, add keystores, and manage resources that are contained in the vault.
{: shortdesc}


## Editing vault details with the UI
{: #edit-vaults-ui}
{: ui}

To edit vault details by using the UI, complete the following steps:

1. [Log in to the Hyper Protect Crypto Services instance](https://cloud.ibm.com/login){: external}.
1. Click **Vaults** from the navigation to view all the available vaults.
1. Click the vault that you want to edit. The Details side panel is displayed.
1. Click **Edit** to update the **Vault name** and **Description**. 
  
    The vault name must be of 1 to 100 characters in length. The characters can be letters (case-sensitive), digits (0-9), or symbols (#@!$%\’_-).
  
1. Click **Save** to save the property changes.

1. The key templates, keys, and keystores that are assigned to this vault are displayed in tables. 
1.  Optionally, you can add additional key templates to the vault by clicking **Create key template** under **Key templates**, add keys by clicking **Create key** under **Managed keys**, or connect to keystores by clicking **Connect to keystore** under **Keystores**.

## Editing vault details with the API
{: #edit-vaults-api}
{: api}

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

1. [Retrieve your service and authentication credentials to work with vaults in the service](https://cloud.ibm.com/docs/hs-crypto?topic=hs-crypto-set-up-uko-api&format=markdown).
   
1. Edit a vault by making a `PATCH` call to the following endpoint.

    
    ```
    https://<instance_ID>.uko.<region>.hs-crypto.appdomain.cloud/api/v4/vaults/<vault_id>
    
    ```
    {: codeblock}

    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](https://cloud.ibm.com/apidocs/uko#update-vault){: external}.



## What's next
{: #edit-vaults-next}

- To find out how to create a vault, check out [Creating vaults](https://cloud.ibm.com/docs/hs-crypto?topic=hs-crypto-create-vaults&format=markdown).

- To find out how to delete a vault, check out [Deleting vaults](https://cloud.ibm.com/docs/hs-crypto?topic=hs-crypto-delete-vaults&format=markdown).
  
- To find out how to grant access to vaults, see [Granting access to vaults](https://cloud.ibm.com/docs/hs-crypto?topic=hs-crypto-grant-access-vaults&format=markdown).