feat(methods): add blocks.validate method

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;
+}

slack-api-client/src/main/java/com/slack/api/methods/response/blocks/BlocksValidateResponse.java

@@ -0,0 +1,30 @@
+package com.slack.api.methods.response.blocks;
+
+import com.slack.api.methods.SlackApiTextResponse;
+import com.slack.api.model.ResponseMetadata;
+import lombok.Data;
+
+import java.util.List;
+import java.util.Map;
+
+@Data
+public class BlocksValidateResponse implements SlackApiTextResponse {
+
+    private boolean ok;
+    private String warning;
+    private String error;
+    private String needed;
+    private String provided;
+    private transient Map<String, List<String>> httpResponseHeaders;
+
+    private ResponseMetadata responseMetadata;
+    private List<Error> errors;
+
+    @Data
+    public static class Error {
+        private String code;
+        private String message;
+        private String pointer;
+        private String relatedComponent;
+    }
+}