|
| 1 | +--- |
| 2 | +sidebar_label: Removing an app |
| 3 | +slug: /tools/slack-cli/guides/removing-an-app |
| 4 | +--- |
| 5 | + |
| 6 | +# Removing an app |
| 7 | + |
| 8 | +<PaidPlanBanner /> |
| 9 | + |
| 10 | +All good things must come to an end. You can `uninstall` your app if you need to remove an app from a workspace, change app permissions, or `delete` the app in its entirety. |
| 11 | + |
| 12 | +## Uninstall an app from your team {#uninstall-app} |
| 13 | + |
| 14 | +Removing an app from a workspace doesn't have to be a permanent decision. Sometimes uninstalling the app to remove it's active presence in channels is sufficient! This option has the added benefit of reinstallation at a later time without recreating the entire app. |
| 15 | + |
| 16 | +To uninstall an app using the CLI, use the [`uninstall`](/tools/slack-cli/reference/commands/slack_app_uninstall/) command. Then, choose the workspace you want to remove the app from: |
| 17 | + |
| 18 | +```bash |
| 19 | +slack uninstall -a A123ABC456 -t T123ABC456 |
| 20 | +``` |
| 21 | + |
| 22 | +```bash |
| 23 | +⚠️ Warning |
| 24 | + App (A123ABC456) will be uninstalled from my-workspace (T123ABC456) |
| 25 | + All triggers, workflows, and functions will be deleted |
| 26 | + Datastore records will be persisted |
| 27 | + |
| 28 | +❓ Are you sure you want to uninstall? Yes |
| 29 | + |
| 30 | +🏠 Workspace uninstall |
| 31 | + Uninstalled the app "my-app" from workspace "my-workspace" |
| 32 | +``` |
| 33 | + |
| 34 | +## Delete an app from your team {#delete-app} |
| 35 | + |
| 36 | +:::danger[Deleting your app _permanently_ deletes all of its data] |
| 37 | + |
| 38 | +Your app's related workflows, functions, and datastores will also be deleted. This decision is final and cannot be undone. |
| 39 | + |
| 40 | +::: |
| 41 | + |
| 42 | +To delete an app using the CLI, use the [`delete`](/tools/slack-cli/reference/commands/slack_app_delete/) command: |
| 43 | + |
| 44 | +```bash |
| 45 | +slack delete -a A123ABC456 -t T123ABC456 |
| 46 | +``` |
| 47 | + |
| 48 | +```bash |
| 49 | +⚠️ Danger zone |
| 50 | + App (A123ABC456) will be permanently deleted |
| 51 | + All triggers, workflows, and functions will be deleted |
| 52 | + All datastores for this app will be deleted |
| 53 | + Once you delete this app, there is no going back |
| 54 | + |
| 55 | +❓ Are you sure you want to delete the app? Yes |
| 56 | + |
| 57 | +🏠 App Uninstall |
| 58 | + Uninstalled the app "my-app" from "my-workspace" |
| 59 | + |
| 60 | +📚 App Manifest |
| 61 | + Deleted the app manifest for "my-app" from "my-workspace" |
| 62 | + |
| 63 | +🏘️ Apps |
| 64 | + This project has no apps |
| 65 | +``` |
0 commit comments