---
name: schematics-action-delete
title: Deleting Schematics action
description: If you no longer need your Schematics action, you can delete it. Deleting an action removes the Ansible playbook and your action data. However, any configurations applied to your target host by using the action are not removed.
last-updated: 2026-07-07
---

> ## 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 action
{: #delete-ansible-actions}

If you no longer need your Schematics action, you can delete it. Deleting an action removes the Ansible playbook and your action data. However, any configurations applied to your target host by using the action are not removed.
{: shortdesc}

## Deleting an action by using Console
{: #create-action-working-ui}
{: ui}

1. Log in to [IBM Cloud console](https://cloud.ibm.com/){: external}.
2. Navigate to **Menu** icon ![Hamburger icon](images/icon_hamburger.svg) > **Platform Automation** > **Schematics** > [**Ansible**](https://cloud.ibm.com/automation/schematics/ansible){: external}
3. Click the three vertical dots to view the **Delete** option against the Ansible action that you want to delete.
4. From the **Delete ansible** popup window, type and confirm the action that you want to delete.
5. Click **Delete**

## Deleting an action by using CLI
{: #delete-action-working-cli}
{: cli}

1. From your [local command line interface](https://cloud.ibm.com/docs/schematics?topic=schematics-setup-cli&format=markdown){: external} setup your CLI and Schematics plug-in.
2. Delete an action by using the [ibmcloud schematics action delete](https://cloud.ibm.com/docs/schematics?topic=schematics-schematics-cli-reference&format=markdown#schematics-delete-action) command.
3. Delete an inventory by using the [ibmcloud schematics inventory delete](https://cloud.ibm.com/docs/schematics?topic=schematics-schematics-cli-reference&format=markdown#schematics-delete-inventory) command.
4. Check the logs to verify that the creation was successful.

## Deleting an action by using API
{: #delete-action-settings-api}
{: api}

1. Retrieve your [IAM access token and authenticate](https://cloud.ibm.com/docs/schematics?topic=schematics-setup-api&format=markdown#cs_api) with Schematics by using the API.
2. Delete an action by sending a [DELETE](https://cloud.ibm.com/apis/schematics#delete-action) request.
3. Delete an inventory by sending a [DELETE](https://cloud.ibm.com/apis/schematics#delete-inventory) request.
3. Check the response status to verify that the deletion was successful.

## Next steps
{: #action-working-update-nextsteps}

After your Schematics action or inventory delete, you can further enhance your automation workflow with the following options:

- [Creating an auto deploy button](https://cloud.ibm.com/docs/schematics?topic=schematics-auto-deploy-url&format=markdown). The feature allows you to trigger your Schematics action automatically, streamlining the deployment process and reducing manual intervention.