feat: add support for apps.user.connection.update (#1561)

WilliamBergamin · web-flow · commit ab70b311ad78 · 2026-03-04T13:10:04.000-08:00
* chore: add AGENTS.md

* Improve the aganets.md

* feat: add support for apps.user.connection.update
diff --git a/json-logs/samples/api/apps.user.connection.update.json b/json-logs/samples/api/apps.user.connection.update.json
@@ -0,0 +1,7 @@
+{
+  "ok": false,
+  "error": "",
+  "needed": "",
+  "provided": "",
+  "warning": ""
+}
diff --git a/metadata/web-api/rate_limit_tiers.json b/metadata/web-api/rate_limit_tiers.json
@@ -113,6 +113,7 @@
   "apps.permissions.users.list": "Tier2",
   "apps.permissions.users.request": "Tier2",
   "apps.uninstall": "Tier1",
+  "apps.user.connection.update": "Tier2",
   "assistant.threads.setStatus": "SpecialTier_assistant_threads_setStatus",
   "assistant.threads.setSuggestedPrompts": "Tier3",
   "assistant.threads.setTitle": "Tier3",
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
@@ -42,6 +42,7 @@
 import com.slack.api.methods.request.apps.AppsUninstallRequest;
 import com.slack.api.methods.request.apps.connections.AppsConnectionsOpenRequest;
 import com.slack.api.methods.request.apps.event.authorizations.AppsEventAuthorizationsListRequest;
+import com.slack.api.methods.request.apps.user.connection.AppsUserConnectionUpdateRequest;
 import com.slack.api.methods.request.apps.manifest.*;
 import com.slack.api.methods.request.assistant.threads.AssistantThreadsSetStatusRequest;
 import com.slack.api.methods.request.assistant.threads.AssistantThreadsSetSuggestedPromptsRequest;
@@ -180,6 +181,7 @@
 import com.slack.api.methods.response.apps.AppsUninstallResponse;
 import com.slack.api.methods.response.apps.connections.AppsConnectionsOpenResponse;
 import com.slack.api.methods.response.apps.event.authorizations.AppsEventAuthorizationsListResponse;
+import com.slack.api.methods.response.apps.user.connection.AppsUserConnectionUpdateResponse;
 import com.slack.api.methods.response.apps.manifest.*;
 import com.slack.api.methods.response.asssistant.threads.AssistantThreadsSetStatusResponse;
 import com.slack.api.methods.response.asssistant.threads.AssistantThreadsSetSuggestedPromptsResponse;
@@ -816,6 +818,14 @@ CompletableFuture<AdminConversationsWhitelistListGroupsLinkedToChannelResponse>
 
     CompletableFuture<AppsConnectionsOpenResponse> appsConnectionsOpen(RequestConfigurator<AppsConnectionsOpenRequest.AppsConnectionsOpenRequestBuilder> req);
 
+    // ------------------------------
+    // apps.user.connection
+    // ------------------------------
+
+    CompletableFuture<AppsUserConnectionUpdateResponse> appsUserConnectionUpdate(AppsUserConnectionUpdateRequest req);
+
+    CompletableFuture<AppsUserConnectionUpdateResponse> appsUserConnectionUpdate(RequestConfigurator<AppsUserConnectionUpdateRequest.AppsUserConnectionUpdateRequestBuilder> req);
+
     // ------------------------------
     // apps.event.authorizations
     // ------------------------------
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
@@ -237,6 +237,12 @@ private Methods() {
 
     public static final String APPS_CONNECTIONS_OPEN = "apps.connections.open";
 
+    // ------------------------------
+    // apps.user.connection
+    // ------------------------------
+
+    public static final String APPS_USER_CONNECTION_UPDATE = "apps.user.connection.update";
+
     // ------------------------------
     // apps.manifest
     // ------------------------------
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
@@ -42,6 +42,7 @@
 import com.slack.api.methods.request.apps.AppsUninstallRequest;
 import com.slack.api.methods.request.apps.connections.AppsConnectionsOpenRequest;
 import com.slack.api.methods.request.apps.event.authorizations.AppsEventAuthorizationsListRequest;
+import com.slack.api.methods.request.apps.user.connection.AppsUserConnectionUpdateRequest;
 import com.slack.api.methods.request.apps.manifest.*;
 import com.slack.api.methods.request.apps.permissions.AppsPermissionsInfoRequest;
 import com.slack.api.methods.request.apps.permissions.AppsPermissionsRequestRequest;
@@ -193,6 +194,7 @@
 import com.slack.api.methods.response.apps.AppsUninstallResponse;
 import com.slack.api.methods.response.apps.connections.AppsConnectionsOpenResponse;
 import com.slack.api.methods.response.apps.event.authorizations.AppsEventAuthorizationsListResponse;
+import com.slack.api.methods.response.apps.user.connection.AppsUserConnectionUpdateResponse;
 import com.slack.api.methods.response.apps.manifest.*;
 import com.slack.api.methods.response.apps.permissions.AppsPermissionsInfoResponse;
 import com.slack.api.methods.response.apps.permissions.AppsPermissionsRequestResponse;
@@ -1158,6 +1160,17 @@ AppsConnectionsOpenResponse appsConnectionsOpen(
             RequestConfigurator<AppsConnectionsOpenRequest.AppsConnectionsOpenRequestBuilder> req)
             throws IOException, SlackApiException;
 
+    // ------------------------------
+    // apps.user.connection
+    // ------------------------------
+
+    AppsUserConnectionUpdateResponse appsUserConnectionUpdate(AppsUserConnectionUpdateRequest req)
+            throws IOException, SlackApiException;
+
+    AppsUserConnectionUpdateResponse appsUserConnectionUpdate(
+            RequestConfigurator<AppsUserConnectionUpdateRequest.AppsUserConnectionUpdateRequestBuilder> req)
+            throws IOException, SlackApiException;
+
     // ------------------------------
     // apps.event.authorizations
     // ------------------------------
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
@@ -227,6 +227,7 @@ public static void setRateLimitTier(String methodName, MethodsRateLimitTier tier
         setRateLimitTier(APPS_CONNECTIONS_OPEN, Tier1);
         setRateLimitTier(APPS_UNINSTALL, Tier1);
         setRateLimitTier(APPS_EVENT_AUTHORIZATIONS_LIST, Tier4);
+        setRateLimitTier(APPS_USER_CONNECTION_UPDATE, Tier2);
 
         setRateLimitTier(ASSISTANT_THREADS_SET_STATUS, SpecialTier_assistant_threads_setStatus);
         setRateLimitTier(ASSISTANT_THREADS_SET_SUGGESTED_PROMPTS, 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
@@ -43,6 +43,7 @@
 import com.slack.api.methods.request.apps.AppsUninstallRequest;
 import com.slack.api.methods.request.apps.connections.AppsConnectionsOpenRequest;
 import com.slack.api.methods.request.apps.event.authorizations.AppsEventAuthorizationsListRequest;
+import com.slack.api.methods.request.apps.user.connection.AppsUserConnectionUpdateRequest;
 import com.slack.api.methods.request.apps.manifest.*;
 import com.slack.api.methods.request.apps.permissions.AppsPermissionsInfoRequest;
 import com.slack.api.methods.request.apps.permissions.AppsPermissionsRequestRequest;
@@ -1063,6 +1064,13 @@ public static FormBody.Builder toForm(AppsConnectionsOpenRequest req) {
         return form;
     }
 
+    public static FormBody.Builder toForm(AppsUserConnectionUpdateRequest req) {
+        FormBody.Builder form = new FormBody.Builder();
+        setIfNotNull("user_id", req.getUserId(), form);
+        setIfNotNull("status", req.getStatus(), form);
+        return form;
+    }
+
     public static FormBody.Builder toForm(AppsEventAuthorizationsListRequest req) {
         FormBody.Builder form = new FormBody.Builder();
         setIfNotNull("event_context", req.getEventContext(), 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
@@ -48,6 +48,7 @@
 import com.slack.api.methods.request.apps.connections.AppsConnectionsOpenRequest;
 import com.slack.api.methods.request.apps.event.authorizations.AppsEventAuthorizationsListRequest;
 import com.slack.api.methods.request.apps.manifest.*;
+import com.slack.api.methods.request.apps.user.connection.AppsUserConnectionUpdateRequest;
 import com.slack.api.methods.request.assistant.threads.AssistantThreadsSetStatusRequest;
 import com.slack.api.methods.request.assistant.threads.AssistantThreadsSetSuggestedPromptsRequest;
 import com.slack.api.methods.request.assistant.threads.AssistantThreadsSetTitleRequest;
@@ -186,6 +187,7 @@
 import com.slack.api.methods.response.apps.connections.AppsConnectionsOpenResponse;
 import com.slack.api.methods.response.apps.event.authorizations.AppsEventAuthorizationsListResponse;
 import com.slack.api.methods.response.apps.manifest.*;
+import com.slack.api.methods.response.apps.user.connection.AppsUserConnectionUpdateResponse;
 import com.slack.api.methods.response.asssistant.threads.AssistantThreadsSetStatusResponse;
 import com.slack.api.methods.response.asssistant.threads.AssistantThreadsSetSuggestedPromptsResponse;
 import com.slack.api.methods.response.asssistant.threads.AssistantThreadsSetTitleResponse;
@@ -1345,6 +1347,16 @@ public CompletableFuture<AppsConnectionsOpenResponse> appsConnectionsOpen(Reques
         return appsConnectionsOpen(req.configure(AppsConnectionsOpenRequest.builder()).build());
     }
 
+    @Override
+    public CompletableFuture<AppsUserConnectionUpdateResponse> appsUserConnectionUpdate(AppsUserConnectionUpdateRequest req) {
+        return executor.execute(APPS_USER_CONNECTION_UPDATE, toMap(req), () -> methods.appsUserConnectionUpdate(req));
+    }
+
+    @Override
+    public CompletableFuture<AppsUserConnectionUpdateResponse> appsUserConnectionUpdate(RequestConfigurator<AppsUserConnectionUpdateRequest.AppsUserConnectionUpdateRequestBuilder> req) {
+        return appsUserConnectionUpdate(req.configure(AppsUserConnectionUpdateRequest.builder()).build());
+    }
+
     @Override
     public CompletableFuture<AppsEventAuthorizationsListResponse> appsEventAuthorizationsList(AppsEventAuthorizationsListRequest req) {
         return executor.execute(APPS_EVENT_AUTHORIZATIONS_LIST, toMap(req), () -> methods.appsEventAuthorizationsList(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
@@ -44,6 +44,7 @@
 import com.slack.api.methods.request.apps.AppsUninstallRequest;
 import com.slack.api.methods.request.apps.connections.AppsConnectionsOpenRequest;
 import com.slack.api.methods.request.apps.event.authorizations.AppsEventAuthorizationsListRequest;
+import com.slack.api.methods.request.apps.user.connection.AppsUserConnectionUpdateRequest;
 import com.slack.api.methods.request.apps.manifest.*;
 import com.slack.api.methods.request.apps.permissions.AppsPermissionsInfoRequest;
 import com.slack.api.methods.request.apps.permissions.AppsPermissionsRequestRequest;
@@ -195,6 +196,7 @@
 import com.slack.api.methods.response.apps.AppsUninstallResponse;
 import com.slack.api.methods.response.apps.connections.AppsConnectionsOpenResponse;
 import com.slack.api.methods.response.apps.event.authorizations.AppsEventAuthorizationsListResponse;
+import com.slack.api.methods.response.apps.user.connection.AppsUserConnectionUpdateResponse;
 import com.slack.api.methods.response.apps.manifest.*;
 import com.slack.api.methods.response.apps.permissions.AppsPermissionsInfoResponse;
 import com.slack.api.methods.response.apps.permissions.AppsPermissionsRequestResponse;
@@ -1386,6 +1388,16 @@ public AppsConnectionsOpenResponse appsConnectionsOpen(RequestConfigurator<AppsC
         return appsConnectionsOpen(req.configure(AppsConnectionsOpenRequest.builder()).build());
     }
 
+    @Override
+    public AppsUserConnectionUpdateResponse appsUserConnectionUpdate(AppsUserConnectionUpdateRequest req) throws IOException, SlackApiException {
+        return postFormWithTokenAndParseResponse(toForm(req), Methods.APPS_USER_CONNECTION_UPDATE, getToken(req), AppsUserConnectionUpdateResponse.class);
+    }
+
+    @Override
+    public AppsUserConnectionUpdateResponse appsUserConnectionUpdate(RequestConfigurator<AppsUserConnectionUpdateRequest.AppsUserConnectionUpdateRequestBuilder> req) throws IOException, SlackApiException {
+        return appsUserConnectionUpdate(req.configure(AppsUserConnectionUpdateRequest.builder()).build());
+    }
+
     @Override
     public AppsEventAuthorizationsListResponse appsEventAuthorizationsList(AppsEventAuthorizationsListRequest req) throws IOException, SlackApiException {
         return postFormWithTokenAndParseResponse(toForm(req), Methods.APPS_EVENT_AUTHORIZATIONS_LIST, getToken(req), AppsEventAuthorizationsListResponse.class);
diff --git a/slack-api-client/src/main/java/com/slack/api/methods/request/apps/user/connection/AppsUserConnectionUpdateRequest.java b/slack-api-client/src/main/java/com/slack/api/methods/request/apps/user/connection/AppsUserConnectionUpdateRequest.java
@@ -0,0 +1,25 @@
+package com.slack.api.methods.request.apps.user.connection;
+
+import com.slack.api.methods.SlackApiRequest;
+import lombok.Builder;
+import lombok.Data;
+
+/**
+ * https://docs.slack.dev/reference/methods/apps.user.connection.update
+ */
+@Data
+@Builder
+public class AppsUserConnectionUpdateRequest implements SlackApiRequest {
+
+    private String token;
+
+    /**
+     * The user ID to update the connection status for.
+     */
+    private String userId;
+
+    /**
+     * The connection status to set.
+     */
+    private String status;
+}
diff --git a/slack-api-client/src/main/java/com/slack/api/methods/response/apps/user/connection/AppsUserConnectionUpdateResponse.java b/slack-api-client/src/main/java/com/slack/api/methods/response/apps/user/connection/AppsUserConnectionUpdateResponse.java
@@ -0,0 +1,21 @@
+package com.slack.api.methods.response.apps.user.connection;
+
+import com.slack.api.methods.SlackApiTextResponse;
+import lombok.Data;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * https://docs.slack.dev/reference/methods/apps.user.connection.update
+ */
+@Data
+public class AppsUserConnectionUpdateResponse implements SlackApiTextResponse {
+
+    private boolean ok;
+    private String warning;
+    private String error;
+    private String needed;
+    private String provided;
+    private transient Map<String, List<String>> httpResponseHeaders;
+}
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/AppsTest.java b/slack-api-client/src/test/java/test_locally/api/methods/AppsTest.java
