version 3.1.1

Changes

• #908 #900 WebClient#files_upload fails with the default team_id param for Org-wide installations - Thanks @gburek-fastly @seratch
• #909 #901 Incorrect type hint for WebClient#files_upload's file argument - Thanks @gburek-fastly @seratch
• #904 Fix #903 by parsing in ActionsBlock - Thanks @KharchenkoDmitriy
• #896 Update WebClient to accept not only list but also tuple - Thanks @seratch

The following changes are related to documents and tutorial contents:

• #897 Improve code in the PythOnBoardingBot tutorial - Thanks @stephenfrench9
• #890 Fix #889 by correcting the team_join event handler in the PythOnBoardingBot tutorial - Thanks @spectreConstantine @seratch

---

• All issues/pull requests: https://github.com/slackapi/python-slack-sdk/milestone/21?closed=1
• All changes: v3.1.0...v3.1.1

version 3.1.0

New Features

Org-Wide App Installation support

This version includes the changes related to Org-Wide App feature, which is for Enterprise Grid organizations.

https://api.slack.com/enterprise/apps

• Add a few fields in installation data models (see the following migration guide for details)
• Switch to use InstallationStore#find_installation from InstallationStore#find_bot in authorize functions
• Enable Bolt apps to handle new events - team_access_granted / team_access_removed
• Add is_enterprise_install: bool in context object

Data Model Migration guide

If you're already using a built-in InstallationStore implementation, the following fields in the data row will be expected since v3.1. If your app uses relational database tables, please add the corresponding columns to the tables.

• is_enterprise_install: bool (true if it is an org-level installation)
• enterprise_url: Optional[str] (URL; this is available only for org-level installation)
• enterprise_name: Optional[str] (the name of the installed org; this value is just a snapshot data at the timing of installations. So, it can be changed afterwards)
• team_name: Optional[str] (the name of the installed workspace)
• incoming_webhook_channel: Optional[str] (channel name)
• token_type: Optional[str]

Also, since this version, the built-in InstallationStore based authorize functions try to fetch Installation. The Installation object contains Bot data too. So, you will be able to utilize more fields like user_token, thanks to this change.

If your application does not maintain the data when handling Slack app installations, upgrading to this version may result in errors due to this incompatibility. If you need to continue using Bot over Installation data rows, please consider implementing and using your own Authorize classes.

Changes

• #877 #881 Add Org App Support - Thanks @stevegill @seratch
• #875 Typo fix in docs - Thanks @timgates42
• #885 PlainTextInputElement class comment fix - Thanks @jelizaga3-gatech

---

• All issues/pull requests: https://github.com/slackapi/python-slack-sdk/milestone/4?closed=1
• All changes: v3.0.0...v3.1.0

version 3.1.0 RC1

Check v3.1.0 release note.

version 3.1.0 beta 1

v3.1.0 includes org-level installation support (for Enterprise Grid users). The detailed release note will be available soon.

• milestone: https://github.com/slackapi/python-slack-sdk/milestone/4?closed=1
• diff: v3.0.0...v3.1.0b1

version 3.0.0

This is the first stable version of slack_sdk v3. The remarkable updates in this major version are:

• Newly added OAuth flow support
• Better Async/sync separation for WebClient and WebhookClient
• Renamed packages (from slack to slack_sdk) with deprecation warnings

Refer to the documents for details. The migration guide for slackclient v2.x users is available at https://slack.dev/python-slack-sdk/v3-migration/

version 3.0.0 RC3

This is the third release candidate version of slack_sdk v3.0.0. The remarkable updates in this major version are:

• Newly added OAuth flow support
• Better Async/sync separation for WebClient and WebhookClient
• Renamed packages (from slack to slack_sdk) with deprecation warnings

Refer to the documents for details.

The migration guide for slackclient v2.x users is available at https://slack.dev/python-slack-sdk/v3-migration/

version 3.0.0 RC2

see v3.0.0rc3

version 3.0.0 RC1

This is the first release candidate version of slack_sdk v3.0.0. The remarkable updates in this major version are:

• Newly added OAuth flow support
• Better Async/sync separation for WebClient and WebhookClient
• Renamed packages (from slack to slack_sdk) with deprecation warnings

Refer to the documents for details.

The migration guide for slackclient v2.x users is available at https://slack.dev/python-slack-sdk/v3-migration/

version 3.0.0 beta1

see 3.0.0rc1

version 2.9.3

Refer to v2.9.3 milestone to know the complete list of the issues resolved by this release.

Updates

1. [Block Kit] #851 #852 Set default_type for HeaderBlock text - Thanks @fwump38
2. [Block Kit] #853 #854 Enable to use input blocks in Home tab views - Thanks @fwump38
3. [RTMClient] #857 #846 RTMClient does not pass timeout value to WebClient - Thanks @Luden @seratch