feat: Add support for 'blocks' in 'files_upload_v2'

Author: childish-sambino

CHANGELOG.md

@@ -1,6 +1,7 @@
 ### 3.0.1 (Next)
 
 * Your contribution here.
+* [#576](https://github.com/slack-ruby/slack-ruby-client/pull/576): Add support for `blocks` in `files_upload_v2` - [@childish-sambino](https://github.com/childish-sambino).
 
 ### 3.0.0 (2025/09/22)
 

examples/oauth_v2/README.md

@@ -1,11 +1,11 @@
 Obtain a user OAuth token from Slack.
 
-Create a Slack app [here](https://api.slack.com/tutorials/tracks/getting-a-token). 
+Create a Slack app [here](https://api.slack.com/tutorials/tracks/getting-a-token).
 
 The new app has a pre-configured User OAuth Token which you can use for most of the examples.
 However you may want to obtain a token for a different user, which can be accomplished as follows.
 
-To test locally use [ngrok](https://ngrok.com/) to expose your local server to the internet. 
+To test locally use [ngrok](https://ngrok.com/) to expose your local server to the internet.
 
 ```sh
 ngrok http 4242
@@ -27,7 +27,7 @@ Run the example.
 
 ```sh
 bundle install
-bundle exec dotenv ruby oauth_v2.rb 
+bundle exec dotenv ruby oauth_v2.rb
 ```
 
 A browser window will open to complete the OAuth flow.

lib/slack/web/api/helpers/files.rb

@@ -29,6 +29,8 @@ module Files
           #   Comma-separated string of channel IDs where the file will be shared. If not specified the file will be private.
           # @option params [string] :initial_comment
           #   The message text introducing the file in specified channels.
+          # @option params [string] :blocks
+          #   A JSON-based array of structured rich text blocks, presented as a URL-encoded string. If the initial_comment field is provided, the blocks field is ignored.
           # @option params [string] :thread_ts
           #   Provide another message's ts value to upload this file as a reply.
           #   Never use a reply's ts value; use its parent instead.
@@ -49,7 +51,7 @@ def files_upload_v2(params = {})
             channel_params = %i[channel channels channel_id].map { |param| params[param] }.compact
             raise ArgumentError, 'Only one of :channel, :channels, or :channel_id is required' if channel_params.size > 1
 
-            complete_upload_request_params = params.slice(:initial_comment, :thread_ts)
+            complete_upload_request_params = params.slice(:initial_comment, :blocks, :thread_ts)
 
             if params[:channels]
               complete_upload_request_params[:channels] = Array(params[:channels]).map do |channel|

spec/fixtures/slack/web/files_upload_v2_with_blocks.yml

@@ -121,6 +121,27 @@
     end
   end
 
+  context 'when blocks parameter is specified', vcr: { cassette_name: 'web/files_upload_v2_with_blocks' } do
+    it 'completes the upload with blocks' do
+      blocks = [
+        {
+          type: 'section',
+          text: {
+            type: 'mrkdwn',
+            text: 'This is a test file upload with blocks'
+          }
+        }
+      ]
+
+      expect(client.files_upload_v2(
+        filename: 'test.txt',
+        content: 'Test File Contents',
+        channel_id: 'C07GQLY5Q3Z',
+        blocks: blocks
+      ).files.size).to eq 1
+    end
+  end
+
   context 'with an array of channels', vcr: { cassette_name: 'web/files_upload_v2_with_channels_list' } do
     before do
       allow(client).to receive(:conversations_list).and_yield(