@slack/web-api
8.4.0 · 13 Nov 2026MIT21.5M / weekRepositoryHomepagenpmAtom feed
85 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 8.x · latest line
8.4.0
13 Nov 2026Summary· from the note as AI read it
Nothing to change: 5 new, 1 fixed.
Minor Changes
web-api: Add
admin.apps.mcp.servers.listmethodweb-api: Add
admin.apps.mcp.servers.permissions.listmethodweb-api: Add
admin.apps.mcp.servers.permissions.setmethodweb-api: Add
admin.slackbot.skills.listmethodweb-api: Add
admin.slackbot.skills.publishmethodweb-api: Add
admin.slackbot.skills.setAutoEnabledmethodweb-api: Add
admin.slackbot.skills.unpublishmethodweb-api: Add
slackbot.skills.createmethodweb-api: Add
slackbot.skills.deletemethodweb-api: Add
slackbot.skills.infomethodweb-api: Add
slackbot.skills.library.addmethodweb-api: Add
slackbot.skills.library.removemethodweb-api: Add
slackbot.skills.listmethodweb-api: Add
slackbot.skills.updatemethod
Patch Changes
Retry API calls whose response body is interrupted mid-read, as v7 did (#2738). A dropped connection or a
timeoutthat fires while the body downloads now rejects with aWebAPIRequestError(withcodeandoriginal) after the configured retries, instead of a rawTypeError: terminatedwith no retry.
8.3.0
30 Oct 2026Summary· from the note as AI read it
Nothing breaks, but check what is deprecated or unsure.
- Deprecated
Image alt text passed to
files.uploadV2is now saved. Before, it was sent asalt_text, which Slack ignores. Addalt_txttofiles.uploadV2andfiles.getUploadURLExternalarguments, and deprecatealt_textin both. A deprecatedalt_textpassed tofiles.uploadV2is still sent asalt_txt
Minor Changes
Add support for apps.user.connection.requestAuth and apps.user.connection.bulkUpdate
web-api: Add
canvases.getContentmethodAdd the
code_channelsapp manifest feature and thecode_channels:managebot scope to manifest typesAdd the
user_connectionsfeature (is_enabled,auth_hosts) and theuser_connectionanduser_connection_status_requestedevents to the app manifest typesAdd the optional
include_slackbot_availabilityargument andteam.slackbot_availabilityresponse field toteam.info.
Patch Changes
- Deprecated
Image alt text passed to
files.uploadV2is now saved. Before, it was sent asalt_text, which Slack ignores. Addalt_txttofiles.uploadV2andfiles.getUploadURLExternalarguments, and deprecatealt_textin both. A deprecatedalt_textpassed tofiles.uploadV2is still sent asalt_txt
8.2.0
30 Sep 2026Add the
agents.conversations.*methods for Slack Code (create,archive,setProperties,setView,setCommands,listViews,removeView,getCanvas,setCanvasContent).
Minor Changes
Add the
agents.conversations.*methods for Slack Code (create,archive,setProperties,setView,setCommands,listViews,removeView,getCanvas,setCanvasContent).
8.1.1
27 Aug 2026Revert internal packages requiring esm loading for backward compatible support
8.1.0
27 Aug 2026web-api: Add support for
admin.users.getExpirationweb-api: Add
agents.sessions.renameandagents.sessions.setStatusweb-api: Add
session_statustochat.stopStreamarguments
Minor Changes
web-api: Add support for
admin.users.getExpirationweb-api: Add
agents.sessions.renameandagents.sessions.setStatusweb-api: Add
session_statustochat.stopStreamargumentsweb-api: Add webapi response changes as of 2026-08-21
Regenerate response types with new stable response properties (e.g.
agent_sessionon message-bearing responses,ListViewgrouping/sort/filter fields,bots.infoconnector/workflow flags).Two fields are removed from
UsersListResponse, neither of which is a real success-response property:Member.is_connector_bot— not returned byusers.list; this flag is surfaced onbots.info(added here toBotsInfoResponse).arg— an error-response echo field, not part of a successfulusers.listbody.
web-api: Add
blocks.validatemethod
8.0.0
14 Jul 2026- Breaking
Drop Node.js 18 support. The minimum supported Node.js version is now 20.
- Breaking
Redesigned error handling to use proper
Errorsubclasses instead of plain objects with acodeproperty.Migration: Replace
if (error.code === ErrorCode.PlatformError)withif (error instanceof WebAPIPlatformError). All error classes extend a commonSlackErrorbase class (which extendsError), so you can also catch all SDK errors withif (error instanceof SlackError).New error class hierarchy:
Removed factory functions (these were internal but exported — use
newwith the corresponding class instead):Other breaking type changes:
- Breaking
Replaced
axioswith the standard Fetch API for all HTTP transport. The following options and types have been removed fromWebClientOptions:The dependencies
axios,form-data,is-electron, andis-streamhave been removed. The defaultfetchimplementation isglobalThis.fetch(available in Node.js 20+).New exported types for custom fetch implementations:
FetchFunction,FetchResponse,FetchRequestInit,FetchHeaders.
Major Changes
- Breaking
Drop Node.js 18 support. The minimum supported Node.js version is now 20.
- Breaking
Redesigned error handling to use proper
Errorsubclasses instead of plain objects with acodeproperty.Migration: Replace
if (error.code === ErrorCode.PlatformError)withif (error instanceof WebAPIPlatformError). All error classes extend a commonSlackErrorbase class (which extendsError), so you can also catch all SDK errors withif (error instanceof SlackError).New error class hierarchy:
SlackError(abstract base)WebAPIPlatformError— Slack API returnedok: falseWebAPIRequestError— Network/transport failure (original error incause)WebAPIHTTPError— Non-200 HTTP status from SlackWebAPIRateLimitedError— HTTP 429 withretryAftersecondsWebAPIFileUploadInvalidArgumentsError— Invalid file upload argumentsWebAPIFileUploadReadFileDataError— Failed to read file data for upload
Removed factory functions (these were internal but exported — use
newwith the corresponding class instead):errorWithCode()platformErrorFromResult()→new WebAPIPlatformError(...)requestErrorWithOriginal()→new WebAPIRequestError(...)httpErrorFromResponse()→new WebAPIHTTPError(...)rateLimitedErrorWithDelay()→new WebAPIRateLimitedError(...)
Other breaking type changes:
WebAPIHTTPError.headerstype changed fromIncomingHttpHeaderstoRecord<string, string>.The
CodedErrorinterface is deprecated — useinstanceofchecks with specific error classes instead.Error
.namevalues changed from generic'Error'to descriptive class names (e.g.,'WebAPIPlatformError').
- Breaking
Replaced
axioswith the standard Fetch API for all HTTP transport. The following options and types have been removed fromWebClientOptions:agent— Use the newfetchoption to provide a custom fetch implementation with proxy or keep-alive support. For proxies, prefer the built-inhttp.setGlobalProxyFromEnv()orNODE_USE_ENV_PROXY=1(Node.js 24+). For advanced use cases:import { fetch, Agent } from "undici"; const client = new WebClient(token, { fetch: (url, init) => fetch(url, { ...init, dispatcher: new Agent({ keepAliveTimeout: 60_000 }), }), });tlsandTLSOptions— Configure TLS via a customfetchimplementation with an undiciAgent, or use theNODE_EXTRA_CA_CERTSenvironment variable.requestInterceptorandRequestInterceptortype — Wrap thefetchfunction to intercept or modify requests before they are sent.adapterandAdapterConfigtype — Use thefetchoption instead.RequestConfigtype (was an alias for Axios'InternalAxiosRequestConfig) — Removed entirely.attachOriginalToWebAPIRequestErroroption — Removed. The original error is now always available via the standardcauseproperty onWebAPIRequestError.
The dependencies
axios,form-data,is-electron, andis-streamhave been removed. The defaultfetchimplementation isglobalThis.fetch(available in Node.js 20+).New exported types for custom fetch implementations:
FetchFunction,FetchResponse,FetchRequestInit,FetchHeaders. - Breaking
Removed previously-deprecated API methods and their associated request/response types:
files.upload— UsefilesUploadV2instead (available since v6.7). ThefilesUploadV2method handles the multi-step upload process automatically.rtm.start— Usertm.connectinstead. Thertm.startmethod was deprecated by Slack in favor of the lighter-weightrtm.connect.workflows.stepCompleted,workflows.stepFailed,workflows.updateStep— These methods supported the retired Steps from Apps feature (deprecated August 2023, retired September 2024). Theworkflows.featured.*andadmin.workflows.*methods for the current Workflow Builder remain available.
Minor Changes
Expand app manifest types — add
agent_viewandassistant_viewfeatures, recent agent events (app_context_changed,assistant_thread_started,assistant_thread_context_changed), optional OAuth scopes (bot_optional/user_optional), and eventmetadata_subscriptions
Patch Changes
Apply redact() to API response bodies in debug logs and recurse into nested objects, preventing tokens from leaking into logs when debug logging is enabled
- 7.x
7.19.0
6 Jul 2026Expand app manifest types — add
agent_viewandassistant_viewfeatures, recent agent events (app_context_changed,assistant_thread_started,assistant_thread_context_changed), optional OAuth scopes (bot_optional/user_optional), and eventmetadata_subscriptions
7.18.0
30 Jun 2026Make
thread_tsoptional forassistant.threads.setSuggestedPrompts
7.17.0
11 Jun 2026Expose public read-only
tsgetter onChatStreamerfor fallback tochat.updatewhen a stream expires server-sideimport { WebClient } from "@slack/web-api"; const client = new WebClient(process.env.SLACK_BOT_TOKEN); const streamer = client.chatStream({ channel: "C0123456789", thread_ts: "1700000001.123456", recipient_team_id: "T0123456789", recipient_user_id: "U0123456789", }); await streamer.append({ markdown_text: "hello!" }); // streamer.ts is now set after the first flush console.log(streamer.ts); await streamer.stop();
7.16.0
14 May 2026Add
highlight_typetofiles.completeUploadExternalandfilesUploadV2for optimistic renderingimport { WebClient } from "@slack/web-api"; const client = new WebClient(process.env.SLACK_BOT_TOKEN); await client.filesUploadV2({ channel_id: "C0123456789", file: "./image.png", filename: "image.png", title: "Image Upload", highlight_type: "png", });
7.15.2
4 May 2026Add authorship arguments -
icon_emoji,icon_url, andusername- to theassistant.threads.setStatusandchat.startStreammethods
Patch Changes
Add authorship arguments -
icon_emoji,icon_url, andusername- to theassistant.threads.setStatusandchat.startStreammethods
7.15.1
13 Apr 2026Fix user-agent header to URI-encode characters outside the Latin-1 range, preventing errors when
process.titlecontains non-ASCII characters
7.15.0
13 Mar 2026Add support for apps.user.connection.update
Minor Changes
Add support for apps.user.connection.update
7.14.1
13 Feb 2026Maintenance only: docs, tests, build or refactoring. Nothing changes in how you use it.
7.14.0
10 Feb 2026Plan Display Mode
Timeline Display Mode
🔠 Markdown Text Block to format your text with standard markdown
Agent Thinking Steps: Display Tasks/Tools, Plans, and Markdown Text
Preview: Display as Plan
github.com/user-attachments/assets/1a6478c2-37a…
Preview: Display as Timeline
github.com/user-attachments/assets/984f84e5-c0e…
Chat Stream with 2 Display Mode
Plan Display Mode
Timeline Display Mode
Chat Stream Structured Content
Now, you can display a mixture of structured content called "chunks":
🔠 Markdown Text Block to format your text with standard markdown
☑️ Task Card Block to display a single task, representing an AI Tool Call or general action
🗒️ Plan Block to display a collection of related tasks
📚 URL Sources Element to display references within a task card block
Available in:
🔌 API Methods:
chat.startStream,chat.appendStream, andchat.stopStream🛟 Chat Stream Helper:
const stream = new ChatStreamer(...);,stream.append(...)
Minor Changes
Add thinking steps support to streaming methods
chat.appendStream,chat.startStream, andchat.stopStreamnow accept achunksparameter for streaming structured content including markdown text, plan updates, and task updates.Related PRs:
accept chunks as arguments to chat.{start,append,stop}Stream methods
accept chunks as arguments to chat stream helper
add task display mode option to start of chat streams
export the chat streamer and related options from the package
Example
```js const stream = new ChatStreamer(client, client.logger, { channel: CHANNEL_ID, thread_ts: threadTs, }); await stream.append({ chunks: [ { type: "markdown_text", text: "**Hello!** I am starting to process your request...\n\n", }, ], }); await stream.append({ chunks: [ { type: "plan_update", title: "Processing tasks...", }, { type: "task_update", id: "task-1", title: "Fetching data from API", status: "complete", output: "Successfully retrieved 42 records", }, ], }); await stream.stop({ chunks: [ { type: "markdown_text", text: "\n\n---\n\n✅ **All tasks completed successfully!**\n", }, ], }); ```Patch Changes
web-api: Add channel_id to canvases.create method
7.13.0
25 Nov 2025web-api: Add slackLists methods
What's Changed
Enhancements
web-api: Add slackLists methods
🍿 Expand for a slackLists API method example
const list = await app.client.slackLists.create({ name: 'Test List - SlackLists API', description_blocks: [ { type: 'rich_text', elements: [ { type: 'rich_text_section', elements: [ { type: 'text', text: 'List to keep track of tasks!', }, ], }, ], }, ], schema: [ { key: 'task_name', name: 'Task Name', type: 'text', is_primary_column: true, }, { key: 'due_date', name: 'Due Date', type: 'date', }, { key: 'status', name: 'Status', type: 'select', options: { choices: [ { value: 'not_started', label: 'Not Started', color: 'red' }, { value: 'in_progress', label: 'In Progress', color: 'yellow' }, { value: 'completed', label: 'Completed', color: 'green' }, ], }, }, { key: 'assignee', name: 'Assignee', type: 'user', }, ], }); console.log('List created:', list); const listId = list.list_id; // extract column IDs from the response (map key -> id) const keyToId = {}; if (list.list_metadata?.schema) { for (const col of list.list_metadata.schema) { keyToId[col.key] = col.id; } } const taskNameColId = keyToId['task_name']; console.log('Column IDs:', keyToId); const response = await app.client.slackLists.access.set({ list_id: listId, access_level: 'write', user_ids: ['U09G4FG3TRN'], }); console.log('Access set:', response); const createItemResponse = await app.client.slackLists.items.create({ list_id: listId, initial_fields: [ { column_id: taskNameColId, rich_text: [ { type: 'rich_text', elements: [ { type: 'rich_text_section', elements: [ { type: 'text', text: 'CLI app unlink command', }, ], }, ], }, ], }, ], }); console.log('Item created:', createItemResponse); const itemId = createItemResponse.id; if (itemId) { await app.client.slackLists.items.info({ list_id: listId, id: itemId, include_is_subscribed: true, }); console.log('Item info retrieved'); await app.client.slackLists.items.update({ list_id: listId, cells: [ { row_id: itemId, column_id: taskNameColId, checkbox: true, }, ], }); console.log('Item updated'); } const listItemsResponse = await app.client.slackLists.items.list({ list_id: listId, limit: 50, }); console.log('Items listed:', listItemsResponse); const downloadStartResponse = await app.client.slackLists.download.start({ list_id: listId, include_archived: false, }); console.log('Download started:', downloadStartResponse); const jobId = downloadStartResponse.job_id; if (jobId) { await app.client.slackLists.download.get({ list_id: listId, job_id: jobId, }); console.log('Download status retrieved'); } if (itemId) { await app.client.slackLists.items.delete({ list_id: listId, id: itemId, }); console.log('Item deleted'); } await app.client.slackLists.items.deleteMultiple({ list_id: listId, ids: ['item1', 'item2'], }); console.log('Multiple items deleted'); await app.client.slackLists.access.delete({ list_id: listId, user_ids: ['U09G4FG3TRN'], }); console.log('Access removed');7.12.0
24 Oct 2025Add support to @slack/web-api for work objects
web-api(fix): Update SearchMessagesArguments to support cursor pagination
What's Changed
👾 Enhancements
Add support to @slack/web-api for work objects
web-api(fix): Update SearchMessagesArguments to support cursor pagination
🧰 Maintenance
📚 Changelog
docs.slack.dev/changelog/2025/10/22/work-object…Package: npmjs.com/package/@slack/web-api@7.12.0
Milestone: github.com/slackapi/node-slack-sdk/milestone/1567.11.0
7 Oct 2025AI-Enabled Features: Loading States, Text Streaming, and Feedback Buttons
Preview
github.com/user-attachments/assets/bc16597b-163…
Loading States
Loading states allows you to not only set the status (e.g. "My app is typing...") but also sprinkle some personality by cycling through a collection of loading messages:
app.event('message', async ({ client, context, event, logger }) => { // ... await client.assistant.threads.setStatus({ channel_id: channelId, thread_ts: threadTs, status: 'thinking...', loading_messages: [ 'Teaching the hamsters to type faster…', 'Untangling the internet cables…', 'Consulting the office goldfish…', 'Polishing up the response just for you…', 'Convincing the AI to stop overthinking…', ], }); // Start a new message stream });Text Streaming Helper
The
client.chatStream()helper utility can be used to streamline calling the 3 text streaming methods:app.event('message', async ({ client, context, event, logger }) => { // ... // Start a new message stream const streamer = client.chatStream({ channel: channelId, recipient_team_id: teamId, recipient_user_id: userId, thread_ts: threadTs, }); // Loop over OpenAI response stream // https://platform.openai.com/docs/api-reference/responses/create for await (const chunk of llmResponse) { if (chunk.type === 'response.output_text.delta') { await streamer.append({ markdown_text: chunk.delta, }); } } // Stop the stream and attach feedback buttons await streamer.stop({ blocks: [feedbackBlock] }); });Text Streaming Methods
Alternative to the Text Streaming Helper is to call the individual methods.
1)
client.chat.startStreamFirst, start a chat text stream to stream a response to any message:
app.event('message', async ({ client, context, event, logger }) => { // ... const streamResponse = await client.chat.startStream({ channel: channelId, recipient_team_id: teamId, recipient_user_id: userId, thread_ts: threadTs, }); const streamTs = streamResponse.ts2)
client.chat.appendStreamAfter starting a chat text stream, you can then append text to it in chunks (often from your favourite LLM SDK) to convey a streaming effect:
for await (const chunk of llmResponse) { if (chunk.type === 'response.output_text.delta') { await client.chat.appendSteam({ channel: channelId, markdown_text: chunk.delta, ts: streamTs, }); } }3)
client.chat.stopStreamLastly, you can stop the chat text stream to finalize your message:
await client.chat.stopStream({ blocks: [feedbackBlock], channel: channelId, ts: streamTs, });🏻 Feedback Buttons
Add feedback buttons to the bottom of a message, after stopping a text stream, to gather user feedback:
const feedbackBlock = { type: 'context_actions', elements: [{ type: 'feedback_buttons', action_id: 'feedback', positive_button: { text: { type: 'plain_text', text: 'Good Response' }, accessibility_label: 'Submit positive feedback on this response', value: 'good-feedback', }, negative_button: { text: { type: 'plain_text', text: 'Bad Response' }, accessibility_label: 'Submit negative feedback on this response', value: 'bad-feedback', }, }], }; // Using the Text Streaming Helper await streamer.stop({ blocks: [feedbackBlock] });// Or, using the Text Streaming Method await client.chat.stopStream({ blocks: [feedbackBlock], channel: channelId, ts: streamTs, });7.10.0
22 Aug 2025web-api: Add workflows.featured.{add|list|remove|set} methods
web-api: Add markdown_text property to chat.{postEphemeral|postMessage|scheduleMessage|update} methods
web-api: Remove bounds on assistant.threads.setSuggestedPrompts prompts count in types
What's Changed
Messaging with
markdown_textis supported in this release, alongside a few methods to feature workflows in channel:const response = await client.chat.postMessage({ channel: "C0123456789", markdown_text: "**bold**" });Enhancements
web-api: Add workflows.featured.{add|list|remove|set} methods
web-api: Add markdown_text property to chat.{postEphemeral|postMessage|scheduleMessage|update} methods
Bugs
web-api: Remove bounds on assistant.threads.setSuggestedPrompts prompts count in types
Dependencies
- Security
Bump form-data to at least 4.0.4. to resolve CVE-2025-7783
7.9.3
19 Jun 2025web-api: Include a blocks argument for file uploads
Add "title" property to conversations.canvases.create API method arguments
What's Changed
This release has a few small updates to align with arguments of various Slack API methods.
Enhancements
web-api: Include a blocks argument for file uploads
Fixes
Add "title" property to conversations.canvases.create API method arguments
Maintenance
7.9.2
20 May 2025Add trailing slash to slackApiUrl if none is provided
What's Changed
Fixes
Add trailing slash to slackApiUrl if none is provided
Maintenance
7.9.1
26 Mar 2025web-api: Complete file upload v2 calls if absolute urls are not allowed
What's Changed
This release fixes a bug where setting
allowAbsoluteUrlsto false caused thefilesUploadV2method to error when uploading files. Files can now be uploaded withallowAbsoluteUrlsset to false.Bug fixes
web-api: Complete file upload v2 calls if absolute urls are not allowed
Maintenance
7.9.0
20 Mar 2025- Security
web-api: Bump axios to 1.8.3 to address CVE-2025-27152
web-api: Add configs to toggle absolute url usage in dynamic api calls
What's Changed
This release adds the
allowAbsoluteUrlsoption to theWebClientconstructor.For code using dynamic method names with
.apiCall, this will toggle if requests should be sent to absolute URLs provided:const { WebClient } = require('@slack/web-api'); const web = new WebClient(token, { allowAbsoluteUrls: false, // Default: true }); const _response = await web.apiCall('https://example.com', { /* ... */ });$ node index.js [DEBUG] web-api:WebClient:0 http request url: https://slack.com/api/https://example.com ... [WARN] web-api:WebClient:0 http request failed An HTTP protocol error occurred: statusCode = 404
The default
allowAbsoluteUrlsvalue istrueto avoid a breaking change with this update, but we suggest deciding if this option should be applied to scripts and adjacent code.Enhancements
web-api: Add configs to toggle absolute url usage in dynamic api calls
Maintenance
- Security
web-api: Bump axios to 1.8.3 to address CVE-2025-27152
7.8.0
6 Dec 2024- Breaking
deps: Bump minimum axios version for web-api and webhook to avoid security vuln
web-api: Generate Web API response types
Revert "feat(web-api): add new
is_send_allowedoptional parameter toassistant.threads.setStatusmethod"
What's Changed
- Breaking
deps: Bump minimum axios version for web-api and webhook to avoid security vuln
web-api: Generate Web API response types
Revert "feat(web-api): add new
is_send_allowedoptional parameter toassistant.threads.setStatusmethod"web-api: Add new
is_send_allowedoptional parameter toassistant.threads.setStatusmethod
7.6.0
8 Oct 2024We've added support for a new Slack Connect invite automation API:
conversations.requestShared.list. Use thelistAPI as well as theapproveanddenyAPIs to automate approval and denial of Slack Connect invites into your Slack workspaces. More details about this feature are available in our Governing Slack Connect invites docs.What's New
We've added support for a new Slack Connect invite automation API:
conversations.requestShared.list. Use thelistAPI as well as theapproveanddenyAPIs to automate approval and denial of Slack Connect invites into your Slack workspaces. More details about this feature are available in our Governing Slack Connect invites docs.Also, the response types for a few APIs were extended with a few new properties. Check out #2071 for the minor details.
Changelog
59f200a web-api(feat): add support for
conversations.requestShared.listAPI (#2072)
01d9d2d web-api(feat): minor additions to some admin API response types (#2071)7.5.0
17 Sep 2024What's Changed
We've released support for AI Assistants & Agents via
@slack/web-api:Full Changelog
571bc3a feat (web-api / types): Add support for assistant.threads.* API (#2033)
7.4.0
5 Sep 2024We've released two new APIs for use via
@slack/web-api:What's Changed
We've released two new APIs for use via
@slack/web-api:Full Changelog
a3a06ec web-api(feat): add support for
conversations.requestSharedapprove,denyAPIs (#1843)7.3.4
15 Aug 2024This patch release bumps the minimum version of axios to 1.7.4 to address a CVE - see Axios 1.7.4 release notes for more information.
7.3.3
14 Aug 2024What's Changed
Herein is a patch to allow a typed
tokenattribute in a few API methods that accept it -apps.uninstall,admin.apps.uninstall, andadmin.apps.clearResolution. Experiment using the snippet below and caution if you're using an app in production:client.apps.uninstall({ + token: 'xoxb-example', client_id: 'example', client_secret: '123', });Changes
7.3.1
4 Jul 2024This release fixes a problem between web-api 7.3.0 and projects consuming it that used versions of TypeScript older than 5.0. Moving forward, web-api should guarantee compatibility with at least TypeScript 4.7.2 or newer; if this changes, that will likely warrant a major new semver release.
This release fixes a problem between web-api 7.3.0 and projects consuming it that used versions of TypeScript older than 5.0. Moving forward, web-api should guarantee compatibility with at least TypeScript 4.7.2 or newer; if this changes, that will likely warrant a major new semver release.
What's Changed
b284994 web-api(fix): revert use of
export type *to maintain backwards compatibility with TS 4.7 (#1841)7.3.0
3 Jul 2024What's New
We've added two new APIs:
What's Changed
a18c1ea feat (web-api): add support for
teams.externalTeams.disconnectAPI (#1837)
4ef80b7 web-api: add newconversations.externalInvitePermissions.setAPI (#1834)
9e20ca3 web-api: updatefiles.info,files.listfiles.remote.listandteam.externalTeams.listresponse types (#1833)
fc87d51 chore: tweak lint config to allow foreslint --fixto fix import order (#1827)7.1.0
12 Jun 2024Previously in v7 of
web-api, if you were using an API method that required no arguments (e.g.api.test), you still had to pass it an empty object ({}). Thanks to @davidlj95's work in #1809, that is no longer a requirement!You can now set the
attachOriginalToWebAPIRequestErrortofalseto ensure API responses are not logged. By default, this option will be set tofalse. Many thanks to @Parama92 for their work in this area!
What's Changed
The new feature available in this release is access to new Canvas APIs - programmatically manipulate your Canvases to your heart's content!
Additionally:
Previously in v7 of
web-api, if you were using an API method that required no arguments (e.g.api.test), you still had to pass it an empty object ({}). Thanks to @davidlj95's work in #1809, that is no longer a requirement!You can now set the
attachOriginalToWebAPIRequestErrortofalseto ensure API responses are not logged. By default, this option will be set tofalse. Many thanks to @Parama92 for their work in this area!
a2c0fe5 web-api: public canvas APIs (#1813)
9f2935f feat: allow using WebClient APIs without argument (#1809) - fixes #1769; thank you @davidlj95 for your contribution! ❤️
b98ef1e feat: providing a way to disable message content being logged (#1786) - fixes #1751; thank you @Parama92 for your contribution! ❤️7.0.4
19 Apr 2024We released a fix for the
oauth.v2.exchangemethod argument type; previously it did not require atoken, which was incorrect. It now requires atokenparameter, which matches the expectations of this API method.What's Changed
We released a fix for the
oauth.v2.exchangemethod argument type; previously it did not require atoken, which was incorrect. It now requires atokenparameter, which matches the expectations of this API method.Full Changelog
ae755dc web-api(fix):
oauth.v2.exchangemethod requires atokenparameter (#1779) - thanks for reporting @iggyray!7.0.3
15 Apr 2024We've deprecated the
files.uploadmethod. Check out our announcement on the topic here. Instead, use theuploadV2method provided by the client.What's Changed
We've deprecated the
files.uploadmethod. Check out our announcement on the topic here. Instead, use theuploadV2method provided by the client.Full Changelog
ae9ace8 web-api(fix): fix node-retry types (#1772) - thanks @cotsupa!
fec4895 web-api(docs): Add deprecation JSdoc tofiles.uploadmethod (#1773)
8bff32f web-api(fix): Fix typo in error throwing for rate limit exceeded (#1755) - thanks @WhiteKiwi!7.0.2
12 Feb 2024web-api: Prevent apps.event.authorizations.list API from ever sending token in the body
web-api(fix): include file or contents types in file_uploads arguments
web-api(fix): share tokens provided as arguments in files upload to upload jobs
What's Changed
Nothing major or even minor in this release! Just a few patches:
web-api: Prevent apps.event.authorizations.list API from ever sending token in the body
web-api(fix): include file or contents types in file_uploads arguments
web-api(fix): share tokens provided as arguments in files upload to upload jobs
web-api(chore): release @slack/web-api@7.0.2
7.0.1
19 Jan 2024Only relevant to consumers in TypeScript projects: we mistakenly removed the types for method arguments as exports in the 7.0.0 major release (e.g.
ViewsPushArguments, etc. - any of the types listed in this file). These were available for consumers toimportin the 6.x versions ofweb-api. Woops! This release simply adds these back in.What's Changed
Only relevant to consumers in TypeScript projects: we mistakenly removed the types for method arguments as exports in the 7.0.0 major release (e.g.
ViewsPushArguments, etc. - any of the types listed in this file). These were available for consumers toimportin the 6.x versions ofweb-api. Woops! This release simply adds these back in.Full Changelog
7.0.0
16 Jan 2024The minimum supported (and thus tested) version of node.js is now v18. While older versions of node should still work, we no longer guarantee this, especially now that versions of node.js older than 18 are end-of-life'd.
If you use this library in a TypeScript project, many of the HTTP API methods that this library exposes now have stricter, and more correct / accurate, argument types and constraints modeled.
What's Changed
There are two big (potentially) breaking changes library users should be aware of:
The minimum supported (and thus tested) version of node.js is now v18. While older versions of node should still work, we no longer guarantee this, especially now that versions of node.js older than 18 are end-of-life'd.
If you use this library in a TypeScript project, many of the HTTP API methods that this library exposes now have stricter, and more correct / accurate, argument types and constraints modeled.
But do not fear! We have written a migration guide for v6 -> v7 users which painstakingly list out the changes per-method, which should provide you with an easy upgrade process.
As usual, if you have trouble with this library, feel free to file an issue! We are here to help 🫂 😄
Much love,
The Slack DevRel Engineering teamChangelog
e29f6a1 Add support for overriding token when using
fileUploadV2(#1723 fixes #1644)
d53ef02@slack/web-apiargument type safety (#1673)
4a8eeac Remove warning about lack of fallback text fromchat.updateinvocations (#1674)
6e8a31e Bump minimum node version to v18 (#1667)- 6.x
6.13.0
27 Sep 2024What's Changed
We've released support for AI Assistants & Agents via
@slack/web-api:Changes
Feat (web-api): Add support for assistant.* API - Thanks @misscoded! #2042
6.12.1
15 Aug 2024- Security
web-api@6(chore): bump axios to 1.7.4 to address CVE-2024-39338
What's Changed
This patch release bumps the minimum version of axios to 1.7.4 to address a CVE - see Axios 1.7.4 release notes for more information.
Changelog
- Security
web-api@6(chore): bump axios to 1.7.4 to address CVE-2024-39338
6.12.0
26 Jan 2024What's Changed
The following methods were added to the web client to support
functions.*methods:Full Changelog
4f39371 Add support for functions.* (complete) methods in #1702 - Thanks @misscoded!
6.11.2
9 Jan 2024Bumps axios to 1.6.5 to address another security vulnerability.
6.11.1
2 Jan 2024Bumps axios to 1.6.3 to address a security vulnerability.
6.9.1
30 Oct 2023Maintenance only: docs, tests, build or refactoring. Nothing changes in how you use it.
6.9.0
2 Aug 2023- Deprecated
Mark
stars.*API methods as deprecated Fix bug with
files.uploadV2to ensure complete file is uploadedAdd cursor pagination to
team.accessLogs
What's Changed
Fix bug with
files.uploadV2to ensure complete file is uploadedAdd cursor pagination to
team.accessLogs- Deprecated
Mark
stars.*API methods as deprecated Add context to rate-limited event
Upgrade dependency to
@slack/types
6.8.1
1 Feb 2023Add
include_categoriestoemoji.listAPI argumentsSet default max concurrency to 100 for
Use
Readableinstead ofReadStreaminuploadV2
What's Changed
Add
include_categoriestoemoji.listAPI argumentsSet default max concurrency to 100 for
Use
Readableinstead ofReadStreaminuploadV2Add
admin.conversations.bulk{Archive|Delete|Move}API method supportFix auth.revoke argument type definition (
testshould be optional)
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.