HockeyStick Knowledge Base Knowledge Base Open Command Centre

Slack agent

Uninstall, reinstall and disconnect

Exactly what each lifecycle change invalidates, so you can tell a customer what they will need to redo.

Uninstall, reinstall and disconnect

Lifecycle changes are fenced conservatively. When in doubt the agent drops access and asks people to reconnect, rather than carry access across a change.

What each change does

ChangeWorkspace bindingPersonal linksLicences and credit
Person selects Unlink account in App HomeUnchangedThat person onlyUnchanged
Administrator revokes a licenceUnchangedKept, but the person is refusedLicence removed
Administrator turns Slack offUnchangedKept, but everyone is refusedUnchanged
Administrator Disconnects the workspaceRemovedAll revoked in that workspaceUnchanged
Administrator confirms (or re-confirms) a workspaceSet to this organisationAll revoked in that workspaceUnchanged
App uninstalled from the workspaceMarked revoked, shows Reconnect requiredAll revokedUnchanged
App reinstalledActive binding cleared; needs a fresh reviewPeople must relinkUnchanged
Slack token rotationPreservedPreservedUnchanged
Enterprise org uninstall or shared bot token revokedEvery affected workspace revokedAll revokedUnchanged
One workspace removed from an Enterprise org installThat workspace onlyThat workspace onlyUnchanged

Usage and completed actions always stay recorded. Paid usage is kept even if a turn was cancelled or access was revoked mid-turn.

After a reinstall

  1. The customer administrator opens Slack & agent access and selects Connect Slack workspace to verify the workspace again.
  2. They confirm the reviewed workspace.
  3. Each person relinks the next time they message the agent.

Moving a workspace to another organisation

A workspace bound, or last claimed, by one organisation cannot be bound by another. The first organisation's administrator must Disconnect it first. Staff cannot override this.

New links last 365 days from the person's explicit accept or reconnect. Using the agent does not extend it. The sign-in provider can end it earlier, for example after long inactivity or a revoked session, and the person is told to reconnect. Older links keep the deadline they were created with until the person reconnects.

Before a customer reinstalls the app, tell them everyone will need to relink, and that licences and credit are unaffected.