# What changed in @slack/types

> 31 changes in @slack/types 2 to 3 from its official release notes, upgrade guides and advisories: 10 breaking, 18 new APIs and options. Each one cited. Sources checked 2026-10-20. HTML: https://unstale.sh/npm/@slack/types/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @slack/types 3

### Breaking changes

- Support for fetchOrgInstallation in the Installation Store was dropped; handle organization-wide installation lookups through fetchInstallation instead. (3.0.0) — [upgrade guide](https://docs.slack.dev/tools/bolt-js/migration/migration-v3)
- The minimum required Node version is 12.13.0. (3.0.0) — [upgrade guide](https://docs.slack.dev/tools/bolt-js/migration/migration-v3)
- The minimum required npm version is 6.12.0. (3.0.0) — [upgrade guide](https://docs.slack.dev/tools/bolt-js/migration/migration-v3)
- The minimum required TypeScript version is 4.1. (3.0.0) — [upgrade guide](https://docs.slack.dev/tools/bolt-js/migration/migration-v3)
- Node.js 18 is no longer supported; the minimum supported Node.js version is now 20. (3.0.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%403.0.0)
- Support for orgAuthorize was dropped; use authorize for both single-workspace and organization-wide installations. (3.0.0) — [upgrade guide](https://docs.slack.dev/tools/bolt-js/migration/migration-v3)
- Support for storeOrgInstallation in the Installation Store was dropped; handle organization-wide installation storage through storeInstallation instead. (3.0.0) — [upgrade guide](https://docs.slack.dev/tools/bolt-js/migration/migration-v3)

### New APIs and options

- Adds the event type for users stopping an agent session. (3.1.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%403.1.0)
- Adds the event type for an agent session title changing. (3.1.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%403.1.0)
- Adds the optional max_lines property to the RichTextInput element. (3.1.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%403.1.0)
- Adds the optional min_lines property to the RichTextInput element. (3.1.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%403.1.0)
- Use authorize for both single-workspace and organization-wide installations, checking isEnterpriseInstall to determine which installation details to fetch. (3.0.0) — [upgrade guide](https://docs.slack.dev/tools/bolt-js/migration/migration-v3)

### Behavior and default changes

- HTTPReceiver replaces ExpressReceiver as the default receiver, enabling apps to work with other popular web frameworks; custom routes still require ExpressReceiver. (3.0.0) — [upgrade guide](https://docs.slack.dev/tools/bolt-js/migration/migration-v3)

## @slack/types 2

### Breaking changes

- The authenticated public client property was removed. Use isActive() to determine whether the WebSocket connection powering the client is healthy. (2.0.0) — [upgrade guide](https://docs.slack.dev/tools/node-slack-sdk/migration/socket-mode/migrating-socket-mode-package-to-v2)
- The connected public client property was removed. Use isActive() to determine whether the WebSocket connection powering the client is healthy. (2.0.0) — [upgrade guide](https://docs.slack.dev/tools/node-slack-sdk/migration/socket-mode/migrating-socket-mode-package-to-v2)
- Use isActive() to determine whether the WebSocket connection powering the client is healthy, instead of the removed connected and authenticated client properties. (2.0.0) — [upgrade guide](https://docs.slack.dev/tools/node-slack-sdk/migration/socket-mode/migrating-socket-mode-package-to-v2)

### New APIs and options

- Adds a type for passing Block Kit blocks within streaming messages. (2.21.1) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%402.21.1)
- Adds the Alert block type so developers can represent alert blocks in @slack/types. (2.21.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%402.21.0)
- Adds the Card block type so developers can represent card blocks in @slack/types. (2.21.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%402.21.0)
- Adds the Carousel block type so developers can represent carousel blocks in @slack/types. (2.21.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%402.21.0)
- Adds the MarkdownTextChunk type for streaming. (2.20.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%402.20.0)
- Adds the PlanBlock type for displaying task progress in messages. (2.20.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%402.20.0)
- Adds the PlanUpdateChunk type for streaming. (2.20.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%402.20.0)
- Adds the TaskCard type for displaying task progress in messages. (2.20.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%402.20.0)
- Adds the TaskUpdateChunk type for streaming. (2.20.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%402.20.0)
- Adds the UrlSourceElements type for displaying sources within task cards. (2.20.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%402.20.0)
- A table block type was added. (2.19.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%402.19.0)
- The rich text section block element types now include underline. (2.19.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%402.19.0)
- Added support for work objects in @slack/types, allowing developers to use types for this feature. (2.18.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%402.18.0)

### Tooling

- Build support was added for Node 24. (2.20.1) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%402.20.1)

### Fixes and other changes

- Work object types were updated. (2.19.0) — [release notes](https://github.com/slackapi/node-slack-sdk/releases/tag/%40slack/types%402.19.0)
