--- name: schematics-delete-schematics-data title: Deleting Schematics data description: IBM Cloud® Schematics stores your data in a highly available and secure environment. All your data such as automation code, input configuration data, input credentials, and the runtime data are stored in Object Storage. This data-at-rest is encrypted using AES GCM 256 with an envelope encryption technique. As the IBM Cloud account owner, you can control access to the IBM Cloud® Schematics objects in your account. You can choose to delete your data, by using the Schematics API, UI, or CLI as described. last-updated: 2026-06-17 --- > ## Documentation Index > The table of contents for this documentation set is at https://cloud.ibm.com/docs/schematics?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 Schematics data {: #delete-schematics-data-intro} IBM Cloud® Schematics stores your data in a highly available and secure environment. All your data such as automation code, input configuration data, input credentials, and the runtime data are stored in Object Storage. This data-at-rest is encrypted using AES GCM 256 with an envelope encryption technique. As the IBM Cloud account owner, you can control access to the IBM Cloud® Schematics objects in your account. You can choose to delete your data, by using the Schematics API, UI, or CLI as described. When you delete these Schematics objects, the corresponding data in Object Storage is marked for deletion. The soft delete option enable you to recover the Schematics data by raising a [support ticket](https://cloud.ibm.com/docs/schematics?topic=schematics-schematics-help&format=markdown). Further, your data are automatically purged after 7 days of soft delete.   Also, Schematics service maintains a backup copy of your data in a separate Object Storage bucket. This backup copy is automatically overwritten, every 30 days. Hence, all backup copy of your data are purged in 30 days. After a soft or hard delete of the Schematics objects, if the Schematics services fails to delete the objects in your account. You need to raise a [Schematics support ticket](https://cloud.ibm.com/docs/schematics?topic=schematics-schematics-help&format=markdown) to completely remove from the resource controller. {: note} ## Scope {: #delete-schematics-data-scope} The scope of deletion is limited to data stored in Schematics service and its backup. Following points does not include in the scope of deletion of Schematics objects. - The deletion or removal of the Cloud resources that were provisioned by using Schematics. - The data stored by the Cloud resources provisioned by the Schematics.   - At the time of Schematics object deletion, you are provided with the option to destroy the cloud resources. However, it is suggested to independently confirm and destroy the Cloud resources from the cloud services. You can explore the list of Cloud resources, from the [Cloud resource list](https://cloud.ibm.com/resources){: external} page. ## Deleting Schematics objects from UI {: #delete-schematics-data-ui} {: ui} You can delete Schematics objects by using IBM Cloud console. Following Schematics objects are used to store your data and helps to delete the IBM Cloud® Schematics objects. You must have [Manager role](https://cloud.ibm.com/docs/schematics?topic=schematics-access&format=markdown#access-roles) to delete from these IBM Cloud® Schematics objects. {: important} ### Workspaces {: #delete-schematics-data-wkscategory} You can follow these steps to delete the Schematics objects by using IBM Cloud console. 1. From the [Schematics workspaces dashboard](https://cloud.ibm.com/automation/schematics/terraform){: external}, select the workspace that you want to delete. 2. Click **actions** tab and select **Delete workspace** option. 3. Type your workspace name in **Type `workspace_name` to confirm** text box. 4. Click **Delete** button. ### Actions {: #delete-schematics-data-actionscategory} You can follow these steps to delete the Schematics objects by using IBM Cloud Console. 1. From the [Schematics workspaces dashboard](https://cloud.ibm.com/schematics/actions){: external}, select the actions that you want to delete. 2. Click Select the **Actions** drop down list and select **Delete** option. 3. Type your actions name in **Type `action_name` to confirm** text box. 4. Click **Delete** button. ### Inventories {: #delete-schematics-data-invcategory} You can follow these steps to delete the Schematics objects by using IBM Cloud Console. 1. From the [Schematics workspaces dashboard](https://cloud.ibm.com/schematics/inventories){: external}, select the inventories that you want to delete. 2. Click `...` dots against the inventory you want to delete and click **Delete**. 3. Type your inventory name in **Type `Inventory_name` to confirm** text box. 4. Click **Delete** button. ## Deleting Schematics objects from CLI {: #delete-schematics-data-cli} {: cli} You can delete Schematics objects by using command-line. Following Schematics objects are used to store your data and helps to delete the IBM Cloud® Schematics objects. You must have [Manager role](https://cloud.ibm.com/docs/schematics?topic=schematics-access&format=markdown#access-roles) to delete from these IBM Cloud® Schematics objects. {: important} ### Workspaces {: #delete-schematics-data-cliwks} You can follow these steps to delete the Schematics objects. 1. Install the [IBM Cloud CLI](https://cloud.ibm.com/docs/schematics?topic=schematics-setup-cli&format=markdown#install-schematics-cli) and install the [IBM Cloud® Schematics plug-in](https://cloud.ibm.com/docs/schematics?topic=schematics-setup-cli&format=markdown#install-schematics-plugin) 2. Run `ibmcloud schematics workspace list [--limit LIMIT] [--offset OFFSET] [--output] [--region]` to list and select the workspace ID that you want to delete. For more information about listing the workspace, see [Schematics workspaces list](https://cloud.ibm.com/docs/schematics?topic=schematics-schematics-cli-reference&format=markdown#schematics-workspace-list) command. 3. Run `ibmcloud schematics workspace delete --id [--force]` to delete the workspace. For more information about workspace delete, see [Schematics workspaces delete](https://cloud.ibm.com/docs/schematics?topic=schematics-schematics-cli-reference&format=markdown#schematics-workspace-delete) command. ### Actions {: #delete-schematics-data-cliactions} You can follow these steps to delete the Schematics objects. 1. Install the [IBM Cloud CLI](https://cloud.ibm.com/docs/schematics?topic=schematics-setup-cli&format=markdown#install-schematics-cli) and install the [IBM Cloud® Schematics plug-in](https://cloud.ibm.com/docs/schematics?topic=schematics-setup-cli&format=markdown#install-schematics-plugin) 2. Run `ibmcloud schematics action list` to list and select an action ID that you want to delete. For more information about listing the actions, see [Schematics actions list](https://cloud.ibm.com/docs/schematics?topic=schematics-schematics-cli-reference&format=markdown#schematics-list-action) command. 3. Run `ibmcloud schematics action delete --id ACTION_ID [--force]` to delete an action. For more information about Schematics actions delete, see [Schematics actions delete](https://cloud.ibm.com/docs/schematics?topic=schematics-schematics-cli-reference&format=markdown#schematics-delete-action) command. ### Inventories {: #delete-schematics-data-cliinvcategory} You can follow these steps to delete the Schematics objects. 1. Install the [IBM Cloud CLI](https://cloud.ibm.com/docs/schematics?topic=schematics-setup-cli&format=markdown#install-schematics-cli) and install the [IBM Cloud® Schematics plug-in](https://cloud.ibm.com/docs/schematics?topic=schematics-setup-cli&format=markdown#install-schematics-plugin) 2. Run `ibmcloud schematics inventory list [--limit LIMIT] [--offset OFFSET] [--output OUTPUT]` to list and select the inventory ID that you want to delete. For more information about listing the inventories, see [Schematics inventory list](https://cloud.ibm.com/docs/schematics?topic=schematics-schematics-cli-reference&format=markdown#schematics-list-inv) command. 3. Run `ibmcloud schematics inventory delete --id ACTION_ID` to delete an inventory. For more information about Schematics inventory delete, see [Schematics inventory delete](https://cloud.ibm.com/docs/schematics?topic=schematics-schematics-cli-reference&format=markdown#schematics-delete-inventory) command. ## Deleting Schematics objects from API {: #delete-schematics-data-api} {: api} You can delete Schematics objects by using API. Following Schematics objects are used to store your data and helps to delete the IBM Cloud® Schematics objects. You must have [Manager role](https://cloud.ibm.com/docs/schematics?topic=schematics-access&format=markdown#access-roles) to delete from these IBM Cloud® Schematics objects. And select the Schematics endpoint to call the delete API. {: important} ### Workspaces {: #delete-schematics-data-apiwks} You can follow these steps to delete the Schematics objects. 1. [Set up your REST client](https://cloud.ibm.com/docs/schematics?topic=schematics-setup-api&interface=api&format=markdown#cs_api) to execute Schematics API. 2. Run `curl -X GET https://schematics.cloud.ibm.com/v1/workspaces -H "Authorization: "` to list and select the workspace ID that you want to delete. For more information about listing the workspace, see [Schematics workspaces list](https://cloud.ibm.com/apis/schematics/schematics#list-workspaces) API. 3. Run `curl -X DELETE https://schematics.cloud.ibm.com/v1/workspaces/{id} -H "Authorization: "` to delete the workspace. For more information about workspace delete, see [Schematics workspace delete](https://cloud.ibm.com/apis/schematics/schematics#delete-workspace) API. ### Actions {: #delete-schematics-data-apiactions} You can follow these steps to delete the Schematics objects. 1. [Set up your REST client](https://cloud.ibm.com/docs/schematics?topic=schematics-setup-api&interface=api&format=markdown#cs_api) to execute Schematics API. 2. Run `curl --location --request GET https://schematics.cloud.ibm.com/v2/actions/actions --header "Authorization: "` to list and select an action ID that you want to delete. For more information about listing the actions, see [Schematics actions list](https://cloud.ibm.com/apis/schematics/schematics#list-actions) API. 3. Run `curl --location --request DELETE https://schematics.cloud.ibm.com/v2/actions/{action_id} --header "Authorization: "` to delete an action. For more information about Schematics actions delete, see [Schematics actions delete](https://cloud.ibm.com/apis/schematics/schematics#delete-action) API. ### Inventories {: #delete-schematics-data-apicategory} You can follow these steps to delete the Schematics objects. 1. [Set up your REST client](https://cloud.ibm.com/docs/schematics?topic=schematics-setup-api&interface=api&format=markdown#cs_api) to execute Schematics API. 2. Run `curl --location --request GET https://schematics.cloud.ibm.com/v2/inventories --header "Content-Type: application/json" --header "Authorization: " --data-raw "{"name": "dev-inventory538","description": "My dev env inventory","location": "us-east","resource_group": "Default",,"inventories_ini": "[windows] \n 158.177.7.181"}` to list and select the inventory ID that you want to delete. For more information about listing the inventories, see [Schematics inventory list](https://cloud.ibm.com/apis/schematics/schematics#list-inventories) API. 3. Run `curl --location --request DELETE https://schematics.cloud.ibm.com/v2/inventories/us-east.INVENTORY.dev-inventory523.244223cf/ --header "Content-Type: application/json" --header "Authorization: " --data-raw "{"name": "dev-inventory538","description": "My dev env inventory","location": "us-east","resource_group": "Default","resource_queries": ["default.RESOURCEQUERY.string.dxxx8a47"]}` to delete an inventory. For more information about Schematics inventory delete, see [Schematics inventory delete](https://cloud.ibm.com/apis/schematics/schematics#delete-inventory) API.