feat(methods): add blocks.validate method

Add the blocks.validate Web API method to the Slack API client. Callers
can validate Block Kit payloads via methods().blocksValidate(req) (and the
async equivalent), passing blocks, message, or view as JSON-encoded
strings. No scopes are required.

Adds the endpoint constant, sync and async interface methods and impls,
the request form builder, the request/response model classes (with an
errors[] list of code/message/pointer/relatedComponent), the Tier3 rate
limit, a local test, and a response sample for type generation.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>

Author: zimeg

json-logs/samples/api/blocks.validate.json

@@ -0,0 +1,20 @@
+{
+  "ok": false,
+  "error": "",
+  "response_metadata": {
+    "messages": [
+      ""
+    ]
+  },
+  "needed": "",
+  "provided": "",
+  "errors": [
+    {
+      "code": "",
+      "message": "",
+      "pointer": "",
+      "related_component": ""
+    }
+  ],
+  "warning": ""
+}

metadata/web-api/rate_limit_tiers.json

@@ -124,6 +124,7 @@
   "bookmarks.edit": "Tier2",
   "bookmarks.list": "Tier3",
   "bookmarks.remove": "Tier2",
+  "blocks.validate": "Tier3",
   "bots.info": "Tier3",
   "calls.add": "Tier2",
   "calls.end": "Tier2",

slack-api-client/src/main/java/com/slack/api/methods/AsyncMethodsClient.java

@@ -54,6 +54,7 @@
 import com.slack.api.methods.request.bookmarks.BookmarksEditRequest;
 import com.slack.api.methods.request.bookmarks.BookmarksListRequest;
 import com.slack.api.methods.request.bookmarks.BookmarksRemoveRequest;
+import com.slack.api.methods.request.blocks.BlocksValidateRequest;
 import com.slack.api.methods.request.bots.BotsInfoRequest;
 import com.slack.api.methods.request.calls.CallsAddRequest;
 import com.slack.api.methods.request.calls.CallsEndRequest;
@@ -193,6 +194,7 @@
 import com.slack.api.methods.response.bookmarks.BookmarksEditResponse;
 import com.slack.api.methods.response.bookmarks.BookmarksListResponse;
 import com.slack.api.methods.response.bookmarks.BookmarksRemoveResponse;
+import com.slack.api.methods.response.blocks.BlocksValidateResponse;
 import com.slack.api.methods.response.bots.BotsInfoResponse;
 import com.slack.api.methods.response.calls.CallsAddResponse;
 import com.slack.api.methods.response.calls.CallsEndResponse;
@@ -915,6 +917,14 @@ CompletableFuture<AdminConversationsWhitelistListGroupsLinkedToChannelResponse>
 
     CompletableFuture<BookmarksRemoveResponse> bookmarksRemove(RequestConfigurator<BookmarksRemoveRequest.BookmarksRemoveRequestBuilder> req);
 
+    // ------------------------------
+    // blocks
+    // ------------------------------
+
+    CompletableFuture<BlocksValidateResponse> blocksValidate(BlocksValidateRequest req);
+
+    CompletableFuture<BlocksValidateResponse> blocksValidate(RequestConfigurator<BlocksValidateRequest.BlocksValidateRequestBuilder> req);
+
     // ------------------------------
     // bots
     // ------------------------------

slack-api-client/src/main/java/com/slack/api/methods/Methods.java

@@ -304,6 +304,12 @@ private Methods() {
 
     public static final String AUTH_TEAMS_LIST = "auth.teams.list";
 
+    // ------------------------------
+    // blocks
+    // ------------------------------
+
+    public static final String BLOCKS_VALIDATE = "blocks.validate";
+
     // ------------------------------
     // bookmarks
     // ------------------------------

slack-api-client/src/main/java/com/slack/api/methods/MethodsClient.java

@@ -60,6 +60,7 @@
 import com.slack.api.methods.request.bookmarks.BookmarksEditRequest;
 import com.slack.api.methods.request.bookmarks.BookmarksListRequest;
 import com.slack.api.methods.request.bookmarks.BookmarksRemoveRequest;
+import com.slack.api.methods.request.blocks.BlocksValidateRequest;
 import com.slack.api.methods.request.bots.BotsInfoRequest;
 import com.slack.api.methods.request.calls.CallsAddRequest;
 import com.slack.api.methods.request.calls.CallsEndRequest;
@@ -212,6 +213,7 @@
 import com.slack.api.methods.response.bookmarks.BookmarksEditResponse;
 import com.slack.api.methods.response.bookmarks.BookmarksListResponse;
 import com.slack.api.methods.response.bookmarks.BookmarksRemoveResponse;
+import com.slack.api.methods.response.blocks.BlocksValidateResponse;
 import com.slack.api.methods.response.bots.BotsInfoResponse;
 import com.slack.api.methods.response.calls.CallsAddResponse;
 import com.slack.api.methods.response.calls.CallsEndResponse;
@@ -1355,6 +1357,16 @@ AuthTestResponse authTest(RequestConfigurator<AuthTestRequest.AuthTestRequestBui
     AuthTeamsListResponse authTeamsList(RequestConfigurator<AuthTeamsListRequest.AuthTeamsListRequestBuilder> req)
             throws IOException, SlackApiException;
 
+    // ------------------------------
+    // blocks
+    // ------------------------------
+
+    BlocksValidateResponse blocksValidate(BlocksValidateRequest req) throws IOException, SlackApiException;
+
+    BlocksValidateResponse blocksValidate(
+            RequestConfigurator<BlocksValidateRequest.BlocksValidateRequestBuilder> req)
+            throws IOException, SlackApiException;
+
     // ------------------------------
     // bookmarks
     // ------------------------------

slack-api-client/src/main/java/com/slack/api/methods/MethodsRateLimits.java

@@ -242,6 +242,8 @@ public static void setRateLimitTier(String methodName, MethodsRateLimitTier tier
         setRateLimitTier(BOOKMARKS_LIST, Tier3);
         setRateLimitTier(BOOKMARKS_REMOVE, Tier2);
 
+        setRateLimitTier(BLOCKS_VALIDATE, Tier3);
+
         setRateLimitTier(BOTS_INFO, Tier3);
 
         setRateLimitTier(CALLS_ADD, Tier2);

slack-api-client/src/main/java/com/slack/api/methods/RequestFormBuilder.java

@@ -61,6 +61,7 @@
 import com.slack.api.methods.request.bookmarks.BookmarksEditRequest;
 import com.slack.api.methods.request.bookmarks.BookmarksListRequest;
 import com.slack.api.methods.request.bookmarks.BookmarksRemoveRequest;
+import com.slack.api.methods.request.blocks.BlocksValidateRequest;
 import com.slack.api.methods.request.bots.BotsInfoRequest;
 import com.slack.api.methods.request.calls.CallsAddRequest;
 import com.slack.api.methods.request.calls.CallsEndRequest;
@@ -1251,6 +1252,14 @@ public static FormBody.Builder toForm(BookmarksRemoveRequest req) {
         return form;
     }
 
+    public static FormBody.Builder toForm(BlocksValidateRequest req) {
+        FormBody.Builder form = new FormBody.Builder();
+        setIfNotNull("blocks", req.getBlocks(), form);
+        setIfNotNull("message", req.getMessage(), form);
+        setIfNotNull("view", req.getView(), form);
+        return form;
+    }
+
     public static FormBody.Builder toForm(BotsInfoRequest req) {
         FormBody.Builder form = new FormBody.Builder();
         setIfNotNull("bot", req.getBot(), form);

slack-api-client/src/main/java/com/slack/api/methods/impl/AsyncMethodsClientImpl.java

@@ -59,6 +59,7 @@
 import com.slack.api.methods.request.bookmarks.BookmarksEditRequest;
 import com.slack.api.methods.request.bookmarks.BookmarksListRequest;
 import com.slack.api.methods.request.bookmarks.BookmarksRemoveRequest;
+import com.slack.api.methods.request.blocks.BlocksValidateRequest;
 import com.slack.api.methods.request.bots.BotsInfoRequest;
 import com.slack.api.methods.request.calls.CallsAddRequest;
 import com.slack.api.methods.request.calls.CallsEndRequest;
@@ -198,6 +199,7 @@
 import com.slack.api.methods.response.bookmarks.BookmarksEditResponse;
 import com.slack.api.methods.response.bookmarks.BookmarksListResponse;
 import com.slack.api.methods.response.bookmarks.BookmarksRemoveResponse;
+import com.slack.api.methods.response.blocks.BlocksValidateResponse;
 import com.slack.api.methods.response.bots.BotsInfoResponse;
 import com.slack.api.methods.response.calls.CallsAddResponse;
 import com.slack.api.methods.response.calls.CallsEndResponse;
@@ -1520,6 +1522,16 @@ public CompletableFuture<BookmarksRemoveResponse> bookmarksRemove(RequestConfigu
         return bookmarksRemove(req.configure(BookmarksRemoveRequest.builder()).build());
     }
 
+    @Override
+    public CompletableFuture<BlocksValidateResponse> blocksValidate(BlocksValidateRequest req) {
+        return executor.execute(BLOCKS_VALIDATE, toMap(req), () -> methods.blocksValidate(req));
+    }
+
+    @Override
+    public CompletableFuture<BlocksValidateResponse> blocksValidate(RequestConfigurator<BlocksValidateRequest.BlocksValidateRequestBuilder> req) {
+        return blocksValidate(req.configure(BlocksValidateRequest.builder()).build());
+    }
+
     @Override
     public CompletableFuture<BotsInfoResponse> botsInfo(BotsInfoRequest req) {
         return executor.execute(BOTS_INFO, toMap(req), () -> methods.botsInfo(req));

slack-api-client/src/main/java/com/slack/api/methods/impl/MethodsClientImpl.java

@@ -62,6 +62,7 @@
 import com.slack.api.methods.request.bookmarks.BookmarksEditRequest;
 import com.slack.api.methods.request.bookmarks.BookmarksListRequest;
 import com.slack.api.methods.request.bookmarks.BookmarksRemoveRequest;
+import com.slack.api.methods.request.blocks.BlocksValidateRequest;
 import com.slack.api.methods.request.bots.BotsInfoRequest;
 import com.slack.api.methods.request.calls.CallsAddRequest;
 import com.slack.api.methods.request.calls.CallsEndRequest;
@@ -214,6 +215,7 @@
 import com.slack.api.methods.response.bookmarks.BookmarksEditResponse;
 import com.slack.api.methods.response.bookmarks.BookmarksListResponse;
 import com.slack.api.methods.response.bookmarks.BookmarksRemoveResponse;
+import com.slack.api.methods.response.blocks.BlocksValidateResponse;
 import com.slack.api.methods.response.bots.BotsInfoResponse;
 import com.slack.api.methods.response.calls.CallsAddResponse;
 import com.slack.api.methods.response.calls.CallsEndResponse;
@@ -1598,6 +1600,16 @@ public BookmarksRemoveResponse bookmarksRemove(RequestConfigurator<BookmarksRemo
         return bookmarksRemove(req.configure(BookmarksRemoveRequest.builder()).build());
     }
 
+    @Override
+    public BlocksValidateResponse blocksValidate(BlocksValidateRequest req) throws IOException, SlackApiException {
+        return postFormWithTokenAndParseResponse(toForm(req), Methods.BLOCKS_VALIDATE, getToken(req), BlocksValidateResponse.class);
+    }
+
+    @Override
+    public BlocksValidateResponse blocksValidate(RequestConfigurator<BlocksValidateRequest.BlocksValidateRequestBuilder> req) throws IOException, SlackApiException {
+        return blocksValidate(req.configure(BlocksValidateRequest.builder()).build());
+    }
+
     @Override
     public BotsInfoResponse botsInfo(BotsInfoRequest req) throws IOException, SlackApiException {
         this.teamId.ifPresent(currentTeamId -> {

slack-api-client/src/main/java/com/slack/api/methods/request/blocks/BlocksValidateRequest.java

@@ -0,0 +1,27 @@
+package com.slack.api.methods.request.blocks;
+
+import com.slack.api.methods.SlackApiRequest;
+import lombok.Builder;
+import lombok.Data;
+
+@Data
+@Builder
+public class BlocksValidateRequest implements SlackApiRequest {
+
+    private String token;
+
+    /**
+     * A JSON-encoded string of an array of blocks to validate.
+     */
+    private String blocks;
+
+    /**
+     * A JSON-encoded string of a message payload to validate.
+     */
+    private String message;
+
+    /**
+     * A JSON-encoded string of a view payload to validate.
+     */
+    private String view;
+}