Skip to content

Commit f30df06

Browse files
haleychaaszimeg
andauthored
docs: add "removing an app" page from Deno docs (#248)
* add page from Deno docs * Update docs/guides/removing-an-app.md Co-authored-by: Eden Zimbelman <[email protected]> * Update docs/guides/removing-an-app.md Co-authored-by: Eden Zimbelman <[email protected]> * update a link --------- Co-authored-by: Eden Zimbelman <[email protected]>
1 parent 8fbd910 commit f30df06

File tree

3 files changed

+67
-1
lines changed

3 files changed

+67
-1
lines changed

docs/_sidebar.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@
2121
"tools/slack-cli/guides/troubleshooting-slack-cli-errors",
2222
"tools/slack-cli/guides/setting-up-ci-cd-with-the-slack-cli",
2323
"tools/slack-cli/guides/deploying-with-the-slack-cli-and-github-actions",
24+
"tools/slack-cli/guides/removing-an-app",
2425
"tools/slack-cli/guides/uninstalling-the-slack-cli"
2526
]
2627
},

docs/guides/removing-an-app.md

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
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+
```

docs/guides/uninstalling-the-slack-cli.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ slug: /tools/slack-cli/guides/uninstalling-the-slack-cli
66

77
All good things come to an end! If you need to uninstall the Slack CLI, run the commands below. Note that these instructions will uninstall the Slack CLI, but not its dependencies. Follow [these instructions](https://docs.deno.com/runtime/manual/tools/script_installer#uninstall) to uninstall Deno.
88

9-
**Just need to uninstall an app?** Refer to [Removing an app](/tools/deno-slack-sdk/guides/removing-an-app).
9+
**Just need to uninstall an app?** Refer to [Removing an app](/tools/slack-cli/guides/removing-an-app).
1010

1111

1212
<Tabs groupId="operating-systems">

0 commit comments

Comments
 (0)