Packages

@slack/web-api

8.4.0 · 13 Nov 2026MIT21.5M / weekRepositoryHomepagenpmAtom feed

Your version

85 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.

  1. 8.x · latest line
  2. 8.4.0

    13 Nov 2026

    Summary· from the note as AI read it

    Nothing to change: 5 new, 1 fixed.

  3. 8.3.0

    30 Oct 2026

    Summary· from the note as AI read it

    Nothing breaks, but check what is deprecated or unsure.

    • Deprecated

      Image alt text passed to files.uploadV2 is now saved. Before, it was sent as alt_text, which Slack ignores. Add alt_txt to files.uploadV2 and files.getUploadURLExternal arguments, and deprecate alt_text in both. A deprecated alt_text passed to files.uploadV2 is still sent as alt_txt

  4. 8.2.0

    30 Sep 2026
  5. 8.1.1

    27 Aug 2026
    • Revert internal packages requiring esm loading for backward compatible support

  6. 8.1.0

    27 Aug 2026
  7. 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 Error subclasses instead of plain objects with a code property.

      Migration: Replace if (error.code === ErrorCode.PlatformError) with if (error instanceof WebAPIPlatformError). All error classes extend a common SlackError base class (which extends Error), so you can also catch all SDK errors with if (error instanceof SlackError).

      New error class hierarchy:

      Removed factory functions (these were internal but exported — use new with the corresponding class instead):

      Other breaking type changes:

    • Breaking

      Replaced axios with the standard Fetch API for all HTTP transport. The following options and types have been removed from WebClientOptions:

      The dependencies axios, form-data, is-electron, and is-stream have been removed. The default fetch implementation is globalThis.fetch (available in Node.js 20+).

      New exported types for custom fetch implementations: FetchFunction, FetchResponse, FetchRequestInit, FetchHeaders.

  8. 7.x
  9. 7.19.0

    6 Jul 2026
    • Expand app manifest types — add agent_view and assistant_view features, recent agent events (app_context_changed, assistant_thread_started, assistant_thread_context_changed), optional OAuth scopes (bot_optional/user_optional), and event metadata_subscriptions

  10. 7.18.0

    30 Jun 2026
    • Make thread_ts optional for assistant.threads.setSuggestedPrompts

  11. 7.17.0

    11 Jun 2026
    • Expose public read-only ts getter on ChatStreamer for fallback to chat.update when a stream expires server-side

      import { 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();
  12. 7.16.0

    14 May 2026
    • Add highlight_type to files.completeUploadExternal and filesUploadV2 for optimistic rendering

      import { 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",
      });
  13. 7.15.2

    4 May 2026
  14. 7.15.1

    13 Apr 2026
    • Fix user-agent header to URI-encode characters outside the Latin-1 range, preventing errors when process.title contains non-ASCII characters

  15. 7.15.0

    13 Mar 2026
  16. 7.14.1

    13 Feb 2026

    Maintenance only: docs, tests, build or refactoring. Nothing changes in how you use it.

  17. 7.14.0

    10 Feb 2026
    • Plan Display Mode

    • Timeline Display Mode

    • 🔠 Markdown Text Block to format your text with standard markdown

  18. 7.13.0

    25 Nov 2025
    • web-api: Add slackLists methods

  19. 7.12.0

    24 Oct 2025
    • Add support to @slack/web-api for work objects

    • web-api(fix): Update SearchMessagesArguments to support cursor pagination

  20. 7.11.0

    7 Oct 2025
  21. 7.10.0

    22 Aug 2025
    • web-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

  22. 7.9.3

    19 Jun 2025
    • web-api: Include a blocks argument for file uploads

    • Add "title" property to conversations.canvases.create API method arguments

  23. 7.9.2

    20 May 2025
    • Add trailing slash to slackApiUrl if none is provided

  24. 7.9.1

    26 Mar 2025
    • web-api: Complete file upload v2 calls if absolute urls are not allowed

  25. 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

  26. 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_allowed optional parameter to assistant.threads.setStatus method"

  27. 7.7.0

    23 Oct 2024

    8ba3a43 feat(web-api): add request interceptor and HTTP adapter config to WebClient (#2076), resolves #2073

  28. 7.6.0

    8 Oct 2024

    We've added support for a new Slack Connect invite automation API: conversations.requestShared.list. Use the list API as well as the approve and deny APIs 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.

  29. 7.5.0

    17 Sep 2024
  30. 7.4.0

    5 Sep 2024

    We've released two new APIs for use via @slack/web-api:

  31. 7.3.4

    15 Aug 2024

    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.

  32. 7.3.3

    14 Aug 2024
    • web-api(fix): allow typed token overrides in supported methods - Thanks @zimeg! #1872

  33. 7.3.2

    31 Jul 2024

    20491c8 fix (web-api): tweak type of chat.postMessage's reply_broadcast property to be wider, fixes #1859 (#1860)
    a055e66 fix: add deprecated channels property for upload file v2 method, fixes #1846 (#1848)

  34. 7.3.1

    4 Jul 2024

    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.

  35. 7.3.0

    3 Jul 2024
  36. 7.2.0

    18 Jun 2024

    4df9fb8 feat(web-api): add new Slack Connect APIs team.externalTeams.list and users.discoverableContacts.lookup (#1826)
    f3acb2f feat(web-api): Update response types to latest automatically generated (#1824)
    20f026b feat(web-api): user id map in MigrationExchangeResponse as map (#1821)

  37. 7.1.0

    12 Jun 2024
    • 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 attachOriginalToWebAPIRequestError to false to ensure API responses are not logged. By default, this option will be set to false. Many thanks to @Parama92 for their work in this area!

  38. 7.0.4

    19 Apr 2024

    We released a fix for the oauth.v2.exchange method argument type; previously it did not require a token, which was incorrect. It now requires a token parameter, which matches the expectations of this API method.

  39. 7.0.3

    15 Apr 2024

    We've deprecated the files.upload method. Check out our announcement on the topic here. Instead, use the uploadV2 method provided by the client.

  40. 7.0.2

    12 Feb 2024
    • 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

  41. 7.0.1

    19 Jan 2024

    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 to import in the 6.x versions of web-api. Woops! This release simply adds these back in.

  42. 7.0.0

    16 Jan 2024
    • 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.

  43. 6.x
  44. 6.13.0

    27 Sep 2024
  45. 6.12.1

    15 Aug 2024
    • Security

      web-api@6(chore): bump axios to 1.7.4 to address CVE-2024-39338

  46. 6.12.0

    26 Jan 2024
  47. 6.11.2

    9 Jan 2024

    Bumps axios to 1.6.5 to address another security vulnerability.

  48. 6.11.1

    2 Jan 2024

    Bumps axios to 1.6.3 to address a security vulnerability.

  49. 6.11.0

    20 Dec 2023
    • Adds support for style.code properties on rich text elements. See original issue #1706 and PR to resolve #1707.

  50. 6.10.0

    14 Nov 2023

    66eb303 Add support for apps.manifest.* endpoints - thanks @misscoded! (#1690)
    6e07903 Add new args to admin.users.list and update web API response types - thanks @seratch! (#1688)

  51. 6.9.1

    30 Oct 2023

    Maintenance only: docs, tests, build or refactoring. Nothing changes in how you use it.

  52. 6.9.0

    2 Aug 2023
    • Deprecated

      Mark stars.* API methods as deprecated

    • Fix bug with files.uploadV2 to ensure complete file is uploaded

    • Add cursor pagination to team.accessLogs

  53. 6.8.1

    1 Feb 2023
    • Add include_categories to emoji.list API arguments

    • Set default max concurrency to 100 for

    • Use Readable instead of ReadStream in uploadV2

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.