slack-ruby-client 2.2.0 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 88d9fc4c82be7eb365f184eb9be4babf355c4422e7aa981a669c68df866fcd89
-  data.tar.gz: 6380fa106f4b05359bc4b0e8598aa02a4f2ab2bd6f31ff5fdb5f2e356c2ee76f
+  metadata.gz: b846ffe66e3daaec235dd458c3e695cdf109b5834d5b699f4c548366bebdb1a5
+  data.tar.gz: c70470051b9a5fa2ed6bb58a284e86e30c123429b6f9a183b929c5a303c128d1
 SHA512:
-  metadata.gz: 8d41b9da28c2e14c25567e4ab620779095cc0c0f12b633937e4e4f2aa7c69b482f13cb1b9ad0353576cd2f2bd1d8c710680115b70f2fae2ef68488b334ee759e
-  data.tar.gz: 1ac12afca5aa38457b9fc72da39662e0b301fa2fd4ffc7d5aefddca62dc7c5988193104356e4a5b16a8c6b9ec0b28adce52f7ceda2486982c85e7eba07fbfcac
+  metadata.gz: 89b2d6c310698ab94521bd9b1acf4b25362199fcc0e4effc4f860468668eb1cb365c8f3bfdc1ab1a4fb660715eac6c13935272217756ef36e412e245d8b272b6
+  data.tar.gz: e7afd74cd61d65c6bd36d51a1f2cbe50ac9903862daaa999743e27648f3e1f910458b7b6d0d4183fbfb6d93e60b6f2e6484480aae58c64507ec722594255c1e9

data/.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

data/.github/workflows/integration_test.yml

@@ -27,7 +27,7 @@ jobs:
     name: test (ruby=${{ matrix.entry.ruby }}, concurrency=${{ matrix.entry.concurrency || 'none' }})
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:

data/.github/workflows/lint.yml

@@ -6,7 +6,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:

data/.github/workflows/pr_lint.yml

@@ -8,7 +8,7 @@ jobs:
       BUNDLE_GEMFILE: ${{ github.workspace }}/Gemfile.danger
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
       - name: Set up Ruby

data/.github/workflows/test.yml

@@ -11,33 +11,43 @@ jobs:
           - { ruby: "3.0" }
           - { ruby: "3.1" }
           - { ruby: "3.2" }
+          - { ruby: "3.3" }
           - { ruby: ruby-head, ignore: true }
           - { ruby: jruby-head, ignore: true }
-    name: test (ruby=${{ matrix.entry.ruby }}, concurrency=${{ matrix.entry.concurrency || 'none' }})
+    name: test (ruby=${{ matrix.entry.ruby }}${{ matrix.entry.concurrency && ', concurrency=' }}${{ matrix.entry.concurrency }})
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: ${{ matrix.entry.ruby }}
-          bundler-cache: true
+        uses: actions/checkout@v4
       - name: Set Concurrency
         run: |
           if [[ ! -z "${{ matrix.entry.concurrency }}" ]]; then
             echo "Setting concurrency to ${{ matrix.entry.concurrency }}."
             echo "CONCURRENCY=${{ matrix.entry.concurrency }}" >> $GITHUB_ENV
           fi
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.entry.ruby }}
+          bundler-cache: true # 'bundle install' and cache gems
       - name: Run Tests
         continue-on-error: ${{ matrix.entry.ignore || false }}
         env:
           RACK_ENV: test
-        run: |
-          bundle install
-          bundle exec rake
+        run: bundle exec rake
       - name: Coveralls
-        uses: coverallsapp/github-action@master
+        uses: coverallsapp/github-action@v2
         with:
+          parallel: true
           github-token: ${{ secrets.GITHUB_TOKEN }}
-      - name: Coveralls Finished
-        uses: coverallsapp/github-action@master
+          flag-name: run-${{ matrix.entry.ruby }}${{ matrix.entry.concurrency && '-'}}${{ matrix.entry.concurrency }}
+
+  finish:
+    name: coveralls
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Close Parallel Build
+        uses: coverallsapp/github-action@v2
+        with:
+          parallel-finished: true
+          carryforward: 'run-2.7,run-2.7-async-websocket,run-3.0,run-3.1,run-3.2,run-3.3'

data/.github/workflows/update_api.yml

@@ -11,7 +11,7 @@ jobs:
       contents: write
       pull-requests: write
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           submodules: recursive
           fetch-depth: 0
@@ -35,14 +35,14 @@ jobs:
       - name: GitHub App token
         if: ${{ github.repository == 'slack-ruby/slack-ruby-client' }}
         id: github_app_token
-        uses: tibdex/github-app-token@v1.6.0
+        uses: tibdex/github-app-token@v2.1.0
         with:
           app_id: ${{ secrets.CI_APP_ID }}
           private_key: ${{ secrets.CI_APP_PRIVATE_KEY }}
           installation_id: 36985419
       - name: Create pull request
         id: cpr
-        uses: peter-evans/create-pull-request@v4
+        uses: peter-evans/create-pull-request@v6
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           commit-message: Update API from slack-api-ref@${{ steps.api-ref.outputs.api-ref }} (${{ steps.date.outputs.date }})
@@ -55,6 +55,11 @@ jobs:
           base: master
           committer: slack-ruby-ci-bot <noreply@github.com>
           author: slack-ruby-ci-bot <noreply@github.com>
+      - name: Check out update branch
+        if: ${{ steps.cpr.outputs.pull-request-number != '' }}
+        run: |
+          git fetch origin automated-api-update
+          git checkout automated-api-update
       - name: Update CHANGELOG
         uses: jacobtomlinson/gha-find-replace@v3
         if: ${{ steps.cpr.outputs.pull-request-number != '' }}

data/.gitignore

@@ -5,5 +5,6 @@
 .idea
 .rspec_status
 Gemfile.lock
+Gemfile.danger.lock
 pkg
 coverage

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+### 2.4.0 (2024/07/14)
+
+* [#516](https://github.com/slack-ruby/slack-ruby-client/pull/516): Add support for Ruby 3.3 - [@olleolleolle](https://github.com/olleolleolle).
+* [#520](https://github.com/slack-ruby/slack-ruby-client/pull/520): Add support for basic markdown formatting - [@nbgoodall](https://github.com/nbgoodall).
+* [#523](https://github.com/slack-ruby/slack-ruby-client/pull/523): Fix coveralls handling parallel jobs - [@dblock](https://github.com/dblock).
+* [#522](https://github.com/slack-ruby-client/pulls/522): Update API from [slack-api-ref@8a22e57](https://github.com/slack-ruby/slack-api-ref/commit/8a22e57) - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
+
+### 2.3.0 (2024/01/31)
+
+* [#494](https://github.com/slack-ruby/slack-ruby-client/pull/494): Configure Dependabot to update GitHub Actions - [@olleolleolle](https://github.com/olleolleolle).
+* [#508](https://github.com/slack-ruby/slack-ruby-client/pull/508): Fix `Slack::Events::Request#verify!` compatibility with Rack 3.x - [@dblock](https://github.com/dblock).
+* [#503](https://github.com/slack-ruby/slack-ruby-client/pull/503): Update Slack API Update API from [slack-api-ref@bc545649](https://github.com/slack-ruby/slack-api-ref/commit/bc545649) - [@dblock](https://github.com/dblock).
+* [#504](https://github.com/slack-ruby-client/pulls/504): Update API from [slack-api-ref@bc54564](https://github.com/slack-ruby/slack-api-ref/commit/bc54564) - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
+
 ### 2.2.0 (2023/09/17)
 
 * [#458](https://github.com/slack-ruby/slack-ruby-client/pull/458): Add workflow for automatic API updates - [@duffn](https://github.com/duffn).

data/README.md

@@ -58,6 +58,7 @@ A Ruby client for the Slack [Web](https://api.slack.com/web), [RealTime Messagin
       - [Channel ID formatting](#channel-id-formatting)
       - [User ID formatting](#user-id-formatting)
       - [URL formatting](#url-formatting)
+      - [Markdown formatting](#markdown-formatting)
     - [Parsing Messages](#parsing-messages)
       - [Unescaping message content](#unescaping-message-content)
       - [Escaping message content](#escaping-message-content)
@@ -81,7 +82,7 @@ A Ruby client for the Slack [Web](https://api.slack.com/web), [RealTime Messagin
 
 ## Stable Release
 
-You're reading the documentation for the **stable** release of slack-ruby-client, 2.2.0. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
+You're reading the documentation for the **stabke** release of slack-ruby-client, 2.4.0. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
 
 ## Installation
 
@@ -177,7 +178,7 @@ Upload a file with [files_upload](https://api.slack.com/methods/files.upload).
 client.files_upload(
   channels: '#general',
   as_user: true,
-  file: Faraday::UploadIO.new('/path/to/avatar.jpg', 'image/jpeg'),
+  file: Faraday::Multipart::FilePart.new('/path/to/avatar.jpg', 'image/jpeg'),
   title: 'My Avatar',
   filename: 'avatar.jpg',
   initial_comment: 'Attached a selfie.'
@@ -657,6 +658,30 @@ Slack::Messages::Formatting.url_link(text, url)
   # => "<https://media.giphy.com/media/AcfTF7tyikWyroP0x7/giphy.gif|party time>"
 ```
 
+##### Markdown formatting
+
+Slack uses a mishmash of regular markdown formatting with its own syntax. Some features like headings aren't supported and will be left as-is, but others like bold, strikethrough, and links are converted.
+
+```ruby
+text = """
+## A heading
+**Bold text**
+~~Strikethrough text~~
+_Italic text_
+[A link](https://example.com)
+`code`
+"""
+Slack::Messages::Formatting.markdown(text)
+  # => """
+  # ## A heading
+  # *Bold text*
+  # ~Strikethrough text~
+  # _Italic text_
+  # <https://example.com|A link>
+  # `code`
+  # """
+```
+
 #### Parsing Messages
 
 `Slack::Messages::Formatting` also provides ways to escape or unescape messages. This comes handy, for example, you want to treat all input to a real time bot as plain text.

data/bin/commands/admin_apps_activities.rb

@@ -10,16 +10,16 @@ module Slack
         g.long_desc %( Get logs for a specified team/org )
         g.command 'list' do |c|
           c.flag 'app_id', desc: 'The ID of the app to get activities from.'
-          c.flag 'component_id', desc: "The component ID of log events to be returned. Will be 'FnXXXXXX' for functions, and 'WfXXXXXX' for worflows."
-          c.flag 'component_type', desc: "The component type of log events to be returned. Acceptable values are ('events_api', 'workflows', 'functions', 'tables')."
+          c.flag 'component_id', desc: 'The component ID of log events to be returned. Will be FnXXXXXX for functions, and WfXXXXXX for worflows.'
+          c.flag 'component_type', desc: 'The component type of log events to be returned. Acceptable values are events_api, workflows, functions and tables.'
           c.flag 'cursor', desc: "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. See pagination for more detail."
           c.flag 'limit', desc: 'The maximum number of items to return.'
           c.flag 'log_event_type', desc: 'The event type of log events to be returned.'
           c.flag 'max_date_created', desc: 'The latest timestamp of the log to retrieve (epoch microseconds).'
           c.flag 'min_date_created', desc: 'The earliest timestamp of the log to retrieve (epoch microseconds).'
-          c.flag 'min_log_level', desc: "The minimum log level of the log events to be returned. Defaults to 'info'. Acceptable values (in order of relative importance from smallest to largest) are ('trace', 'debug', 'info', 'warn', 'error', 'fatal')."
+          c.flag 'min_log_level', desc: 'The minimum log level of the log events to be returned. Defaults to info. Acceptable values (in order of relative importance from smallest to largest) are trace, debug, info, warn, error and fatal.'
           c.flag 'sort_direction', desc: 'The direction you want the data sorted by (always by timestamp).'
-          c.flag 'source', desc: "The source of log events to be returned. Acceptable values are ('slack', 'developer')."
+          c.flag 'source', desc: 'The source of log events to be returned. Acceptable values are slack and developer.'
           c.flag 'team_id', desc: 'The team who owns this log.'
           c.flag 'trace_id', desc: 'The trace ID of log events to be returned.'
           c.action do |_global_options, options, _args|

data/bin/commands/admin_apps_config.rb

@@ -19,8 +19,8 @@ module Slack
         g.long_desc %( Set the app config for a connector )
         g.command 'set' do |c|
           c.flag 'app_id', desc: 'The encoded app ID to set the app config for.'
-          c.flag 'domain_restrictions', desc: 'Domain restrictions for the app.'
-          c.flag 'workflow_auth_strategy', desc: 'The workflow auth permission.'
+          c.flag 'domain_restrictions', desc: 'Domain restrictions for the app. Should be an object with two properties: urls and emails. Each is an array of strings, and each sets the allowed URLs and emails for connector authorization, respectively.'
+          c.flag 'workflow_auth_strategy', desc: 'The workflow auth permission. Can be one of builder_choice or end_user_only.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_apps_config_set(options))
           end

data/bin/commands/admin_conversations.rb

@@ -18,7 +18,7 @@ module Slack
         g.desc 'Archive public or private channels in bulk.'
         g.long_desc %( Archive public or private channels in bulk. )
         g.command 'bulkArchive' do |c|
-          c.flag 'channel_ids', desc: 'An array of channel IDs to archive.'
+          c.flag 'channel_ids', desc: 'An array of channel IDs to archive. No more than 100 items are allowed.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_conversations_bulkArchive(options))
           end
@@ -176,6 +176,7 @@ module Slack
           c.flag 'sort', desc: 'Possible values are relevant (search ranking based on what we think is closest), name (alphabetical), member_count (number of users in the channel), and created (date channel was created). You can optionally pair this with the sort_dir arg to change how it is sorted.'
           c.flag 'sort_dir', desc: 'Sort direction. Possible values are asc for ascending order like (1, 2, 3) or (a, b, c), and desc for descending order like (3, 2, 1) or (c, b, a).'
           c.flag 'team_ids', desc: 'Comma separated string of team IDs, signifying the internal workspaces to search through.'
+          c.flag 'total_count_only', desc: 'Only return the total_count of channels. Omits channel data and allows access for admins without channel manager permissions.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_conversations_search(options))
           end

data/bin/commands/admin_emoji.rb

@@ -9,7 +9,7 @@ module Slack
         g.desc 'Add an emoji.'
         g.long_desc %( Add an emoji. )
         g.command 'add' do |c|
-          c.flag 'name', desc: 'The name of the emoji to be added. Colons (:myemoji:) around the value are not required, although they may be included.'
+          c.flag 'name', desc: 'The name of the emoji to be added (using lower-case letters only). Colons (:myemoji:) around the value are not required, although they may be included.'
           c.flag 'url', desc: 'The URL of a file to use as an image for the emoji. Square images under 128KB and with transparent backgrounds work best.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_emoji_add(options))

data/bin/commands/admin_users.rb

@@ -41,6 +41,8 @@ module Slack
         g.long_desc %( List users on a workspace )
         g.command 'list' do |c|
           c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
+          c.flag 'include_deactivated_user_workspaces', desc: 'Only applies with org token and no team_id. If true, return workspaces for a user even if they may be deactivated on them. If false, return workspaces for a user only when user is active on them. Default is false.'
+          c.flag 'is_active', desc: 'If true, only active users will be returned. If false, only deactivated users will be returned. Default is true.'
           c.flag 'limit', desc: 'Limit for how many users to be retrieved per page.'
           c.flag 'team_id', desc: 'The ID (T1234) of the workspace. The team_id is required if you use an org-level token.'
           c.action do |_global_options, options, _args|
@@ -58,8 +60,8 @@ module Slack
           end
         end
 
-        g.desc 'Set an existing guest, regular user, or owner to be an admin user.'
-        g.long_desc %( Set an existing guest, regular user, or owner to be an admin user. )
+        g.desc 'Set an existing regular user or owner to be a workspace admin.'
+        g.long_desc %( Set an existing regular user or owner to be a workspace admin. )
         g.command 'setAdmin' do |c|
           c.flag 'team_id', desc: 'The ID (T1234) of the workspace.'
           c.flag 'user_id', desc: 'The ID of the user to designate as an admin.'
@@ -79,8 +81,8 @@ module Slack
           end
         end
 
-        g.desc 'Set an existing guest, regular user, or admin user to be a workspace owner.'
-        g.long_desc %( Set an existing guest, regular user, or admin user to be a workspace owner. )
+        g.desc 'Set an existing regular user or admin to be a workspace owner.'
+        g.long_desc %( Set an existing regular user or admin to be a workspace owner. )
         g.command 'setOwner' do |c|
           c.flag 'team_id', desc: 'The ID (T1234) of the workspace.'
           c.flag 'user_id', desc: 'Id of the user to promote to owner.'

data/bin/commands/admin_workflows.rb

@@ -10,15 +10,17 @@ module Slack
         g.long_desc %( Search workflows within the team or enterprise )
         g.command 'search' do |c|
           c.flag 'app_id', desc: 'The parent app ID for which to return workflows.'
-          c.flag 'collaborator_ids', desc: 'Only include workflows by the collaborators inputted.'
+          c.flag 'collaborator_ids', desc: 'Only include workflows where the provided user IDs are a manager/collaborator of that workflow.'
           c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
+          c.flag 'is_sales_elevate', desc: 'Filter workflows by their Sales Elevate status.'
           c.flag 'limit', desc: 'The number of results that will be returned by the API on each invocation.'
           c.flag 'no_collaborators', desc: 'Only include workflows with no collaborators in the result; default is false.'
-          c.flag 'num_trigger_ids', desc: 'Number of trigger IDs to fetch for each workflow; default is 0.'
+          c.flag 'num_trigger_ids', desc: 'Number of trigger IDs to fetch for each workflow; default is 10.'
           c.flag 'query', desc: 'A search query to filter for workflow name or description.'
           c.flag 'sort', desc: 'The field used to sort the returned workflows.'
           c.flag 'sort_dir', desc: 'Sort direction. Possible values are asc for ascending order like (1, 2, 3) or (a, b, c), and desc for descending order like (3, 2, 1) or (c, b, a).'
           c.flag 'source', desc: 'Source of workflow creation, either from code or workflow builder.'
+          c.flag 'trigger_type_id', desc: 'Only include workflows with this trigger type.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_workflows_search(options))
           end

data/bin/commands/admin_workflows_triggers_types_permissions.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AdminWorkflowsTriggersTypesPermissions methods.'
+      command 'admin_workflows_triggers_types_permissions' do |g|
+        g.desc 'list the permissions for using each trigger type in workflow builder'
+        g.long_desc %( list the permissions for using each trigger type in workflow builder )
+        g.command 'lookup' do |c|
+          c.flag 'trigger_type_ids', desc: 'The trigger types IDs for which to get the permissions.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_workflows_triggers_types_permissions_lookup(options))
+          end
+        end
+
+        g.desc 'Set the permissions for using a trigger type in workflow builder'
+        g.long_desc %( Set the permissions for using a trigger type in workflow builder )
+        g.command 'set' do |c|
+          c.flag 'id', desc: 'The trigger type ID for which to set the permissions.'
+          c.flag 'visibility', desc: 'The function visibility.'
+          c.flag 'user_ids', desc: 'List of user IDs to allow for named_entities visibility.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_workflows_triggers_types_permissions_set(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/apps_datastore.rb

@@ -6,6 +6,52 @@ module Slack
     class App
       desc 'AppsDatastore methods.'
       command 'apps_datastore' do |g|
+        g.desc 'Delete items from a datastore in bulk'
+        g.long_desc %( Delete items from a datastore in bulk )
+        g.command 'bulkDelete' do |c|
+          c.flag 'datastore', desc: 'name of the datastore.'
+          c.flag 'ids', desc: 'IDs of items to be deleted.'
+          c.flag 'app_id', desc: '.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.apps_datastore_bulkDelete(options))
+          end
+        end
+
+        g.desc 'Get items from a datastore in bulk'
+        g.long_desc %( Get items from a datastore in bulk )
+        g.command 'bulkGet' do |c|
+          c.flag 'datastore', desc: 'name of the datastore.'
+          c.flag 'ids', desc: "items' ids."
+          c.flag 'app_id', desc: '.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.apps_datastore_bulkGet(options))
+          end
+        end
+
+        g.desc 'Creates or replaces existing items in bulk'
+        g.long_desc %( Creates or replaces existing items in bulk )
+        g.command 'bulkPut' do |c|
+          c.flag 'datastore', desc: 'name of the datastore.'
+          c.flag 'items', desc: 'attribute names and values of the items; limit of 25.'
+          c.flag 'app_id', desc: '.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.apps_datastore_bulkPut(options))
+          end
+        end
+
+        g.desc 'Count the number of items in a datastore that match a query'
+        g.long_desc %( Count the number of items in a datastore that match a query )
+        g.command 'count' do |c|
+          c.flag 'datastore', desc: 'Name of the datastore.'
+          c.flag 'app_id', desc: 'Required if calling with user token.'
+          c.flag 'expression', desc: 'A query filter expression https://api.slack.com/future/datastores.'
+          c.flag 'expression_attributes', desc: 'A map of attributes referenced in expression.'
+          c.flag 'expression_values', desc: 'A map of values referenced in expression.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.apps_datastore_count(options))
+          end
+        end
+
         g.desc 'Delete an item from a datastore'
         g.long_desc %( Delete an item from a datastore )
         g.command 'delete' do |c|

data/bin/commands/canvases.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'Canvases methods.'
+      command 'canvases' do |g|
+        g.desc 'Create Canvas for a user.'
+        g.long_desc %( Create Canvas for a user. )
+        g.command 'create' do |c|
+          c.flag 'document_content', desc: 'Structure describing the type and value of the content to create.'
+          c.flag 'title', desc: 'Title of the newly created canvas.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.canvases_create(options))
+          end
+        end
+
+        g.desc 'Deletes a canvas.'
+        g.long_desc %( Deletes a canvas. )
+        g.command 'delete' do |c|
+          c.flag 'canvas_id', desc: 'Encoded ID of the canvas.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.canvases_delete(options))
+          end
+        end
+
+        g.desc 'Update an existing canvas'
+        g.long_desc %( Update an existing canvas )
+        g.command 'edit' do |c|
+          c.flag 'canvas_id', desc: 'Encoded ID of the canvas.'
+          c.flag 'changes', desc: 'List of changes to apply on the specified canvas.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.canvases_edit(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/canvases_access.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'CanvasesAccess methods.'
+      command 'canvases_access' do |g|
+        g.desc 'Remove access to a canvas for specified entities'
+        g.long_desc %( Remove access to a canvas for specified entities )
+        g.command 'delete' do |c|
+          c.flag 'canvas_id', desc: 'Encoded ID of the canvas.'
+          c.flag 'channel_ids', desc: 'List of channels you wish to update access for.'
+          c.flag 'user_ids', desc: 'List of users you wish to update access for.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.canvases_access_delete(options))
+          end
+        end
+
+        g.desc 'Sets the access level to a canvas for specified entities'
+        g.long_desc %( Sets the access level to a canvas for specified entities )
+        g.command 'set' do |c|
+          c.flag 'access_level', desc: 'Desired level of access (e.g. read, write).'
+          c.flag 'canvas_id', desc: 'Encoded ID of the canvas.'
+          c.flag 'channel_ids', desc: 'List of channels you wish to update access for.'
+          c.flag 'user_ids', desc: 'List of users you wish to update access for.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.canvases_access_set(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/canvases_sections.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'CanvasesSections methods.'
+      command 'canvases_sections' do |g|
+        g.desc 'Find sections matching the provided criteria'
+        g.long_desc %( Find sections matching the provided criteria )
+        g.command 'lookup' do |c|
+          c.flag 'canvas_id', desc: 'Encoded ID of the canvas.'
+          c.flag 'criteria', desc: 'Filtering criteria.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.canvases_sections_lookup(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/chat.rb

@@ -63,11 +63,11 @@ module Slack
         g.long_desc %( Sends an ephemeral message to a user in a channel. )
         g.command 'postEphemeral' do |c|
           c.flag 'channel', desc: 'Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name.'
-          c.flag 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
           c.flag 'user', desc: 'id of the user who will receive the ephemeral message. The user should be in the channel specified by the channel argument.'
-          c.flag 'as_user', desc: '(Legacy) Pass true to post the message as the authed user. Defaults to true if the chat:write:bot scope is not included. Otherwise, defaults to false.'
           c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string.'
           c.flag 'blocks', desc: 'A JSON-based array of structured blocks, presented as a URL-encoded string.'
+          c.flag 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
+          c.flag 'as_user', desc: '(Legacy) Pass true to post the message as the authed user. Defaults to true if the chat:write:bot scope is not included. Otherwise, defaults to false.'
           c.flag 'icon_emoji', desc: 'Emoji to use as the icon for this message. Overrides icon_url.'
           c.flag 'icon_url', desc: 'URL to an image to use as the icon for this message.'
           c.flag 'link_names', desc: 'Find and link channel names and usernames.'
@@ -85,7 +85,7 @@ module Slack
           c.flag 'channel', desc: 'Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name. See below for more details.'
           c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string.'
           c.flag 'blocks', desc: 'A JSON-based array of structured blocks, presented as a URL-encoded string.'
-          c.flag 'text', desc: 'The formatted text of the message to be published. If blocks are included, this will become the fallback text used in notifications.'
+          c.flag 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
           c.flag 'as_user', desc: '(Legacy) Pass true to post the message as the authed user instead of as a bot. Defaults to false. Can only be used by classic Slack apps. See authorship below.'
           c.flag 'icon_emoji', desc: 'Emoji to use as the icon for this message. Overrides icon_url.'
           c.flag 'icon_url', desc: 'URL to an image to use as the icon for this message.'
@@ -107,11 +107,11 @@ module Slack
         g.long_desc %( Schedules a message to be sent to a channel. )
         g.command 'scheduleMessage' do |c|
           c.flag 'channel', desc: 'Channel, private group, or DM channel to send message to. Can be an encoded ID, or a name. See below for more details.'
-          c.flag 'post_at', desc: 'Unix EPOCH timestamp of time in future to send the message.'
-          c.flag 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
-          c.flag 'as_user', desc: 'Set to true to post the message as the authed user, instead of as a bot. Defaults to false. Cannot be used by new Slack apps. See chat.postMessage.'
+          c.flag 'post_at', desc: 'Unix timestamp representing the future time the message should post to Slack.'
           c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string.'
           c.flag 'blocks', desc: 'A JSON-based array of structured blocks, presented as a URL-encoded string.'
+          c.flag 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
+          c.flag 'as_user', desc: 'Set to true to post the message as the authed user, instead of as a bot. Defaults to false. Cannot be used by new Slack apps. See chat.postMessage.'
           c.flag 'link_names', desc: 'Find and link user groups. No longer supports linking individual users; use syntax shown in Mentioning Users instead.'
           c.flag 'metadata', desc: 'JSON object with event_type and event_payload fields, presented as a URL-encoded string. Metadata you post to Slack is accessible to any app or user who is a member of that workspace.'
           c.flag 'parse', desc: 'Change how messages are treated. See chat.postMessage.'
@@ -146,15 +146,15 @@ module Slack
         g.command 'update' do |c|
           c.flag 'channel', desc: 'Channel containing the message to be updated.'
           c.flag 'ts', desc: 'Timestamp of the message to be updated.'
+          c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string.'
+          c.flag 'blocks', desc: 'A JSON-based array of structured blocks, presented as a URL-encoded string.'
+          c.flag 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
           c.flag 'as_user', desc: 'Pass true to update the message as the authed user. Bot users in this context are considered authed users.'
-          c.flag 'attachments', desc: "A JSON-based array of structured attachments, presented as a URL-encoded string. This field is required when not presenting text. If you don't include this field, the message's previous attachments will be retained. To remove previous attachments, include an empty array for this field."
-          c.flag 'blocks', desc: "A JSON-based array of structured blocks, presented as a URL-encoded string. If you don't include this field, the message's previous blocks will be retained. To remove previous blocks, include an empty array for this field."
           c.flag 'file_ids', desc: 'Array of new file ids that will be sent with this message.'
           c.flag 'link_names', desc: 'Find and link channel names and usernames. Defaults to none. If you do not specify a value for this field, the original value set for the message will be overwritten with the default, none.'
           c.flag 'metadata', desc: "JSON object with event_type and event_payload fields, presented as a URL-encoded string. If you don't include this field, the message's previous metadata will be retained. To remove previous metadata, include an empty object for this field. Metadata you post to Slack is accessible to any app or user who is a member of that workspace."
           c.flag 'parse', desc: 'Change how messages are treated. Defaults to client, unlike chat.postMessage. Accepts either none or full. If you do not specify a value for this field, the original value set for the message will be overwritten with the default, client.'
           c.flag 'reply_broadcast', desc: 'Broadcast an existing thread reply to make it visible to everyone in the channel or conversation.'
-          c.flag 'text', desc: "New text for the message, using the default formatting rules. It's not required when presenting blocks or attachments."
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.chat_update(options))
           end

data/bin/commands/conversations.rb

@@ -77,7 +77,7 @@ module Slack
           c.flag 'include_all_metadata', desc: 'Return all metadata associated with this message.'
           c.flag 'inclusive', desc: 'Include messages with oldest or latest timestamps in results. Ignored unless either timestamp is specified.'
           c.flag 'latest', desc: 'Only messages before this Unix timestamp will be included in results. Default is the current time.'
-          c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the users list hasn't been reached."
+          c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the conversation history hasn't been reached. Maximum of 999."
           c.flag 'oldest', desc: 'Only messages after this Unix timestamp will be included in results.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_history(options))
@@ -100,6 +100,7 @@ module Slack
         g.command 'invite' do |c|
           c.flag 'channel', desc: 'The ID of the public or private channel to invite user(s) to.'
           c.flag 'users', desc: 'A comma separated list of user IDs. Up to 1000 users may be listed.'
+          c.flag 'force', desc: 'When set to true and multiple user IDs are provided, continue inviting the valid ones while disregarding invalid IDs. Defaults to false.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_invite(options))
           end
@@ -150,7 +151,7 @@ module Slack
         g.command 'list' do |c|
           c.flag 'cursor', desc: "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection. See pagination for more detail."
           c.flag 'exclude_archived', desc: 'Set to true to exclude archived channels from the list.'
-          c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached. Must be an integer no larger than 1000."
+          c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached. Must be an integer under 1000."
           c.flag 'team_id', desc: 'encoded team id to list channels in, required if token belongs to org-wide app.'
           c.flag 'types', desc: 'Mix and match channel types by providing a comma-separated list of any combination of public_channel, private_channel, mpim, im.'
           c.action do |_global_options, options, _args|