feat(web-api): add slackLists methods

srtaalej · srtaalej · commit 111d3343ab96 · 2025-11-18T11:35:17.000-05:00
diff --git a/json-logs/samples/api/slackLists.create.json b/json-logs/samples/api/slackLists.create.json
@@ -0,0 +1,8 @@
+{
+    "channel": "",
+    "error": "",
+    "needed": "",
+    "ok": false,
+    "provided": "",
+    "ts": ""
+}
diff --git a/metadata/web-api/rate_limit_tiers.json b/metadata/web-api/rate_limit_tiers.json
@@ -267,6 +267,7 @@
   "search.all": "Tier2",
   "search.files": "Tier2",
   "search.messages": "Tier2",
+  "slackLists.create": "Tier2",
   "stars.add": "Tier2",
   "stars.list": "Tier3",
   "stars.remove": "Tier2",
diff --git a/slack-api-client/src/main/java/com/slack/api/methods/AsyncMethodsClient.java b/slack-api-client/src/main/java/com/slack/api/methods/AsyncMethodsClient.java
@@ -104,6 +104,7 @@
 import com.slack.api.methods.request.stars.StarsAddRequest;
 import com.slack.api.methods.request.stars.StarsListRequest;
 import com.slack.api.methods.request.stars.StarsRemoveRequest;
+import com.slack.api.methods.request.slacklists.SlackListsCreateRequest;
 import com.slack.api.methods.request.team.*;
 import com.slack.api.methods.request.team.external_teams.TeamExternalTeamsDisconnectRequest;
 import com.slack.api.methods.request.team.external_teams.TeamExternalTeamsListRequest;
@@ -1411,6 +1412,14 @@ CompletableFuture<AdminConversationsWhitelistListGroupsLinkedToChannelResponse>
         // https://docs.slack.dev/changelog/2023-07-its-later-already-for-stars-and-reminders
     CompletableFuture<StarsRemoveResponse> starsRemove(RequestConfigurator<StarsRemoveRequest.StarsRemoveRequestBuilder> req);
 
+    // ------------------------------
+    // slackLists
+    // ------------------------------
+    
+    CompletableFuture<SlackListsCreateResponse> slackListsCreate(SlackListsCreateRequest req);
+
+    CompletableFuture<SlackListsCreateResponse> slackListsCreate(RequestConfigurator<SlackListsCreateRequest.SlackListsCreateRequestBuilder> req);
+
     // ------------------------------
     // team
     // ------------------------------
diff --git a/slack-api-client/src/main/java/com/slack/api/methods/Methods.java b/slack-api-client/src/main/java/com/slack/api/methods/Methods.java
@@ -654,6 +654,12 @@ private Methods() {
     public static final String STARS_ADD = "stars.add";
     public static final String STARS_LIST = "stars.list";
     public static final String STARS_REMOVE = "stars.remove";
+    
+    // ------------------------------
+    // slackLists
+    // ------------------------------
+
+    public static final String SLACKLISTS_CREATE = "slackLists.create"
 
     // ------------------------------
     // team
diff --git a/slack-api-client/src/main/java/com/slack/api/methods/MethodsClient.java b/slack-api-client/src/main/java/com/slack/api/methods/MethodsClient.java
@@ -117,6 +117,7 @@
 import com.slack.api.methods.request.stars.StarsAddRequest;
 import com.slack.api.methods.request.stars.StarsListRequest;
 import com.slack.api.methods.request.stars.StarsRemoveRequest;
+import com.slack.api.methods.request.slacklists.SlackListsCreateRequest;
 import com.slack.api.methods.request.team.*;
 import com.slack.api.methods.request.team.external_teams.TeamExternalTeamsDisconnectRequest;
 import com.slack.api.methods.request.team.external_teams.TeamExternalTeamsListRequest;
@@ -2499,11 +2500,20 @@ StarsListResponse starsList(RequestConfigurator<StarsListRequest.StarsListReques
     // https://docs.slack.dev/changelog/2023-07-its-later-already-for-stars-and-reminders
     StarsRemoveResponse starsRemove(RequestConfigurator<StarsRemoveRequest.StarsRemoveRequestBuilder> req)
             throws IOException, SlackApiException;
-
+    
     // ------------------------------
-    // team
+    // slackLists
     // ------------------------------
+    
+    SlackListsCreateResponse slackListsCreate(SlackListsCreateRequest req) throws IOException, SlackApiException;
+
+    SlackListsCreateResponse slackListsCreate(RequestConfigurator<SlackListsCreateRequest.SlackListsCreateRequestBuilder> req)
+            throws IOException, SlackApiException;
 
+    // ------------------------------å
+    // team
+    // ------------------------------
+å
     TeamAccessLogsResponse teamAccessLogs(TeamAccessLogsRequest req) throws IOException, SlackApiException;
 
     TeamAccessLogsResponse teamAccessLogs(RequestConfigurator<TeamAccessLogsRequest.TeamAccessLogsRequestBuilder> req)
diff --git a/slack-api-client/src/main/java/com/slack/api/methods/MethodsRateLimits.java b/slack-api-client/src/main/java/com/slack/api/methods/MethodsRateLimits.java
@@ -428,6 +428,8 @@ public static void setRateLimitTier(String methodName, MethodsRateLimitTier tier
         setRateLimitTier(STARS_LIST, Tier3);
         setRateLimitTier(STARS_REMOVE, Tier2);
 
+        setRateLimitTier(SLACKLISTS_CREATE, Tier2);
+
         setRateLimitTier(TEAM_ACCESS_LOGS, Tier2);
         setRateLimitTier(TEAM_BILLABLE_INFO, Tier2);
         setRateLimitTier(TEAM_INFO, Tier3);
diff --git a/slack-api-client/src/main/java/com/slack/api/methods/RequestFormBuilder.java b/slack-api-client/src/main/java/com/slack/api/methods/RequestFormBuilder.java
@@ -117,6 +117,7 @@
 import com.slack.api.methods.request.stars.StarsAddRequest;
 import com.slack.api.methods.request.stars.StarsListRequest;
 import com.slack.api.methods.request.stars.StarsRemoveRequest;
+import com.slack.api.methods.request.slacklists.SlackListsCreateRequest;
 import com.slack.api.methods.request.team.*;
 import com.slack.api.methods.request.team.external_teams.TeamExternalTeamsDisconnectRequest;
 import com.slack.api.methods.request.team.external_teams.TeamExternalTeamsListRequest;
@@ -2776,6 +2777,23 @@ public static FormBody.Builder toForm(StarsRemoveRequest req) {
         return form;
     }
 
+    public static FormBody.Builder toForm(SlackListsCreateRequest req) {
+        FormBody.Builder form = new FormBody.Builder();
+        setIfNotNull("name", req.getName(), form);
+        if (req.getDescriptionBlocks() != null) {
+            String json = getJsonWithGsonAnonymInnerClassHandling(req.getDescriptionBlocks());
+            form.add("description_blocks", json);
+        }
+        if (req.getSchema() != null) {
+            String json = getJsonWithGsonAnonymInnerClassHandling(req.getSchema());
+            form.add("schema", json);
+        }
+        setIfNotNull("copy_from_list_id", req.getCopyFromListId(), form);
+        setIfNotNull("include_copied_list_records", req.getIncludeCopiedListRecords(), form);
+        setIfNotNull("todo_mode", req.getTodoMode(), form);
+        return form;
+    }
+
     public static FormBody.Builder toForm(TeamAccessLogsRequest req) {
         FormBody.Builder form = new FormBody.Builder();
         setIfNotNull("before", req.getBefore(), form);
diff --git a/slack-api-client/src/main/java/com/slack/api/methods/impl/AsyncMethodsClientImpl.java b/slack-api-client/src/main/java/com/slack/api/methods/impl/AsyncMethodsClientImpl.java
@@ -108,6 +108,7 @@
 import com.slack.api.methods.request.stars.StarsAddRequest;
 import com.slack.api.methods.request.stars.StarsListRequest;
 import com.slack.api.methods.request.stars.StarsRemoveRequest;
+import com.slack.api.methods.request.slacklists.SlackListsCreateRequest;
 import com.slack.api.methods.request.team.*;
 import com.slack.api.methods.request.team.external_teams.TeamExternalTeamsDisconnectRequest;
 import com.slack.api.methods.request.team.external_teams.TeamExternalTeamsListRequest;
@@ -2545,6 +2546,11 @@ public CompletableFuture<StarsRemoveResponse> starsRemove(RequestConfigurator<St
         return starsRemove(req.configure(StarsRemoveRequest.builder()).build());
     }
 
+   @Override
+   public CompletableFuture<SlackListsCreateResponse> slackListsCreate(RequestConfigurator<SlackListsCreateRequest.SlackListsCreateRequestBuilder> req) {
+        return slackListsCreate(req.configure(SlackListsCreateRequest.builder()).build());
+   } 
+
     @Override
     public CompletableFuture<TeamAccessLogsResponse> teamAccessLogs(TeamAccessLogsRequest req) {
         return executor.execute(TEAM_ACCESS_LOGS, toMap(req), () -> methods.teamAccessLogs(req));
diff --git a/slack-api-client/src/main/java/com/slack/api/methods/impl/MethodsClientImpl.java b/slack-api-client/src/main/java/com/slack/api/methods/impl/MethodsClientImpl.java
@@ -119,6 +119,7 @@
 import com.slack.api.methods.request.stars.StarsAddRequest;
 import com.slack.api.methods.request.stars.StarsListRequest;
 import com.slack.api.methods.request.stars.StarsRemoveRequest;
+import com.slack.api.methods.request.slacklists.SlackListsCreateRequest;
 import com.slack.api.methods.request.team.*;
 import com.slack.api.methods.request.team.external_teams.TeamExternalTeamsDisconnectRequest;
 import com.slack.api.methods.request.team.external_teams.TeamExternalTeamsListRequest;
@@ -3221,6 +3222,16 @@ public StarsRemoveResponse starsRemove(RequestConfigurator<StarsRemoveRequest.St
         return starsRemove(req.configure(StarsRemoveRequest.builder()).build());
     }
 
+    @Override
+    public SlackListsCreateResponse slackListsCreate(SlackListsCreateRequest req) throws IOException, SlackApiException {
+        return postFormWithTokenAndParseResponse(toForm(req), Methods.SLACKLISTS_CREATE, getToken(req), SlackListsCreateResponse.class);
+    }
+
+    @Override
+    public SlackListsCreateResponse slackListsCreate(RequestConfigurator<SlackListsCreateRequest.SlackListsCreateRequestBuilder> req) throws IOException, SlackApiException {
+        return slackListsCreate(req.configure(SlackListsCreateRequest.builder()).build());
+    }
+
     @Override
     public TeamAccessLogsResponse teamAccessLogs(TeamAccessLogsRequest req) throws IOException, SlackApiException {
         this.teamId.ifPresent(currentTeamId -> {
diff --git a/slack-api-client/src/main/java/com/slack/api/methods/request/slacklists/SlackListsCreateRequest.java b/slack-api-client/src/main/java/com/slack/api/methods/request/slacklists/SlackListsCreateRequest.java
@@ -0,0 +1,54 @@
+package com.slack.api.methods.request.slacklists;
+
+import java.util.List;
+import java.util.Map;
+
+import com.slack.api.model.block.RichTextBlock;
+
+import com.slack.api.methods.SlackApiRequest;
+import lombok.Builder;
+import lombok.Data;
+
+/**
+ * https://docs.slack.dev/reference/methods/search.all
+ */
+@Data
+@Builder
+public class SlackListsCreateRequest implements SlackApiRequest {
+
+    /**
+     * Authentication token bearing required scopes. Tokens should be passed as an HTTP Authorization header or alternatively, as a POST parameter.`
+     */
+    private String token;
+
+    /**
+     * Name of the List.
+     */
+    private String name;
+
+    /**
+     * A rich text description of the List. (Optional)
+     */
+    private List<RichTextBlock> descriptionBlocks;
+
+    /**
+     * Column definition for the List. (Optional)
+     */
+    private List<Map<String, Object>> schema;
+
+    /**
+     * ID of the List to copy. (Optional)
+     */
+    private String copyFromListId;
+
+    /**
+     * Boolean indicating whether to include records when a List is copied. (Optional)
+     */
+    private Boolean includeCopiedListRecords;
+
+    /**
+     * Boolean indicating whether the List should be used to track todo tasks. (Optional)
+     */
+    private Boolean todoMode;
+
+}
diff --git a/slack-api-client/src/main/java/com/slack/api/methods/response/slacklists/SlackListsCreateResponse.java b/slack-api-client/src/main/java/com/slack/api/methods/response/slacklists/SlackListsCreateResponse.java
@@ -0,0 +1,28 @@
+package com.slack.api.methods.response.slacklists;
+
+import java.util.List;
+import java.util.Map;
+
+import com.google.gson.annotations.SerializedName;
+import com.slack.api.model.list.ListMetadata;
+import com.slack.api.methods.SlackApiTextResponse;
+
+import lombok.Data;
+
+@Data
+
+public class SlackListsCreateResponse implements SlackApiTextResponse {
+    
+    private boolean ok;
+    private String warning;
+    private String error;
+    private String needed;
+    private String provided;
+    private transient Map<String, List<String>> httpResponseHeaders;
+
+    @SerializedName("list_id")
+    private String listId;
+    
+    @SerializedName("list_metadata")
+    private ListMetadata listMetadata;
+}
diff --git a/slack-api-client/src/test/java/test_locally/api/MethodsTest.java b/slack-api-client/src/test/java/test_locally/api/MethodsTest.java
diff --git a/slack-api-client/src/test/java/test_locally/api/methods/SlackListsTest.java b/slack-api-client/src/test/java/test_locally/api/methods/SlackListsTest.java
diff --git a/slack-api-client/src/test/java/test_with_remote_apis/methods/slacklists_Test.java b/slack-api-client/src/test/java/test_with_remote_apis/methods/slacklists_Test.java
diff --git a/slack-api-model/src/main/java/com/slack/api/model/list/ListMetadata.java b/slack-api-model/src/main/java/com/slack/api/model/list/ListMetadata.java
