---
name: hs-crypto-uko-delete-template
title: Deleting key templates
description: You can delete your key templates in Unified Key Orchestrator with the UI, or programmatically with the Unified Key Orchestrator. After you delete the key template, you can no longer create managed keys based on this key template.
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.

# Deleting key templates
{: #delete-template}

You can delete your key templates in Unified Key Orchestrator with the UI, or programmatically with the Unified Key Orchestrator. After you delete the key template, you can no longer create managed keys based on this key template.
{: shortdesc}


## Deleting key templates with the UI
{: #delete-key-template-ui}
{: ui}

 
To delete a key template, you need to destroy all keys that are created with the template and remove them from the vault first. For more information, see [Deleting managed keys](https://cloud.ibm.com/docs/hs-crypto?topic=hs-crypto-delete-managed-keys&format=markdown).
{: note}
 

Follow these steps to complete the process:

1. [Log in to the Hyper Protect Crypto Services instance](https://cloud.ibm.com/login){: external}.
2. Click **Key templates** from the navigation to view all the available key templates.

    You can also view archived key templates by clicking the **Show archived templates** icon ![Show archived templates icon](/images/archive.svg "Show archived templates") on the table.

3. Locate the key template that you want to delete, click the Actions icon ![Actions icon](../icons/action-menu-icon.svg "Actions"), and select **Delete** to remove the key template.
4. Click **Delete key template** to confirm the deletion.

   Alternatively, locate the key template that you want to delete, click the Actions icon ![Actions icon](../icons/action-menu-icon.svg "Actions"), and then click **Show details**. A side panel is displayed to show the key template properties, click **Actions** > **Delete**.
   
The key template is deleted from the vault. You can no longer create managed keys based on this key template. 


## Deleting key templates with the API
{: #delete-key-template-api}
{: api}

To delete a key template through the API, follow these steps:

 
To delete a key template, you need to destroy all keys that are created with the template and remove them from the vault first. For more information, see [Deleting managed keys](https://cloud.ibm.com/docs/hs-crypto?topic=hs-crypto-delete-managed-keys&interface=api&format=markdown).
{: note}


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

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

    Replace `<id>` with the ID of your key template.

    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#delete-key-template){: external}.


## What's next
{: #delete-key-template-next}

- To create another key template, check out [Creating key templates](https://cloud.ibm.com/docs/hs-crypto?topic=hs-crypto-create-template&format=markdown).

- To find out instructions on managing a key template, check out [Editing key template details](https://cloud.ibm.com/docs/hs-crypto?topic=hs-crypto-edit-template&format=markdown).