From 6a2b2040a7430f69f6e7786b75a93725212fe5d1 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Tue, 17 Nov 2026 21:42:33 -0800 Subject: [PATCH] feat: add oauth.v2.completeShortTokenRotation method Co-Authored-By: Claude --- .../oauth.v2.completeShortTokenRotation.json | 13 +++++++ metadata/web-api/rate_limit_tiers.json | 1 + .../slack/api/methods/AsyncMethodsClient.java | 6 ++++ .../java/com/slack/api/methods/Methods.java | 1 + .../com/slack/api/methods/MethodsClient.java | 9 +++++ .../slack/api/methods/MethodsRateLimits.java | 1 + .../slack/api/methods/RequestFormBuilder.java | 9 +++++ .../methods/impl/AsyncMethodsClientImpl.java | 12 +++++++ .../api/methods/impl/MethodsClientImpl.java | 12 +++++++ ...thV2CompleteShortTokenRotationRequest.java | 34 +++++++++++++++++++ ...hV2CompleteShortTokenRotationResponse.java | 25 ++++++++++++++ .../java/test_locally/api/MethodsTest.java | 4 +-- .../test_locally/api/methods/OAuthTest.java | 18 ++++++++++ .../methods/oauth_Test.java | 13 +++++++ 14 files changed, 156 insertions(+), 2 deletions(-) create mode 100644 json-logs/samples/api/oauth.v2.completeShortTokenRotation.json create mode 100644 slack-api-client/src/main/java/com/slack/api/methods/request/oauth/OAuthV2CompleteShortTokenRotationRequest.java create mode 100644 slack-api-client/src/main/java/com/slack/api/methods/response/oauth/OAuthV2CompleteShortTokenRotationResponse.java diff --git a/json-logs/samples/api/oauth.v2.completeShortTokenRotation.json b/json-logs/samples/api/oauth.v2.completeShortTokenRotation.json new file mode 100644 index 000000000..01c39bcc9 --- /dev/null +++ b/json-logs/samples/api/oauth.v2.completeShortTokenRotation.json @@ -0,0 +1,13 @@ +{ + "ok": false, + "error": "", + "needed": "", + "provided": "", + "response_metadata": { + "messages": [ + "" + ] + }, + "token": "", + "warning": "" +} \ No newline at end of file diff --git a/metadata/web-api/rate_limit_tiers.json b/metadata/web-api/rate_limit_tiers.json index 9b6342e82..8c77a43f7 100644 --- a/metadata/web-api/rate_limit_tiers.json +++ b/metadata/web-api/rate_limit_tiers.json @@ -272,6 +272,7 @@ "oauth.token": "Tier4", "oauth.v2.access": "Tier4", "oauth.v2.beginShortTokenRotation": "Tier2", + "oauth.v2.completeShortTokenRotation": "Tier2", "oauth.v2.exchange": "Tier3", "openid.connect.token": "Tier4", "openid.connect.userInfo": "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 index f57ca1aa5..5bc9b2005 100644 --- 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 @@ -109,6 +109,7 @@ import com.slack.api.methods.request.oauth.OAuthTokenRequest; import com.slack.api.methods.request.oauth.OAuthV2AccessRequest; import com.slack.api.methods.request.oauth.OAuthV2BeginShortTokenRotationRequest; +import com.slack.api.methods.request.oauth.OAuthV2CompleteShortTokenRotationRequest; import com.slack.api.methods.request.oauth.OAuthV2ExchangeRequest; import com.slack.api.methods.request.openid.connect.OpenIDConnectTokenRequest; import com.slack.api.methods.request.openid.connect.OpenIDConnectUserInfoRequest; @@ -278,6 +279,7 @@ import com.slack.api.methods.response.oauth.OAuthTokenResponse; import com.slack.api.methods.response.oauth.OAuthV2AccessResponse; import com.slack.api.methods.response.oauth.OAuthV2BeginShortTokenRotationResponse; +import com.slack.api.methods.response.oauth.OAuthV2CompleteShortTokenRotationResponse; import com.slack.api.methods.response.oauth.OAuthV2ExchangeResponse; import com.slack.api.methods.response.openid.connect.OpenIDConnectTokenResponse; import com.slack.api.methods.response.openid.connect.OpenIDConnectUserInfoResponse; @@ -1487,6 +1489,10 @@ CompletableFuture CompletableFuture oauthV2BeginShortTokenRotation(RequestConfigurator req); + CompletableFuture oauthV2CompleteShortTokenRotation(OAuthV2CompleteShortTokenRotationRequest req); + + CompletableFuture oauthV2CompleteShortTokenRotation(RequestConfigurator req); + CompletableFuture oauthV2Exchange(OAuthV2ExchangeRequest req); CompletableFuture oauthV2Exchange(RequestConfigurator req); 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 index 85a8e774d..5c1fcd533 100644 --- 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 @@ -648,6 +648,7 @@ private Methods() { public static final String OAUTH_ACCESS = "oauth.access"; public static final String OAUTH_V2_ACCESS = "oauth.v2.access"; public static final String OAUTH_V2_BEGIN_SHORT_TOKEN_ROTATION = "oauth.v2.beginShortTokenRotation"; + public static final String OAUTH_V2_COMPLETE_SHORT_TOKEN_ROTATION = "oauth.v2.completeShortTokenRotation"; public static final String OAUTH_V2_EXCHANGE = "oauth.v2.exchange"; public static final String OAUTH_TOKEN = "oauth.token"; 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 index 3e0ef7356..bfe8a98cf 100644 --- 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 @@ -122,6 +122,7 @@ import com.slack.api.methods.request.oauth.OAuthTokenRequest; import com.slack.api.methods.request.oauth.OAuthV2AccessRequest; import com.slack.api.methods.request.oauth.OAuthV2BeginShortTokenRotationRequest; +import com.slack.api.methods.request.oauth.OAuthV2CompleteShortTokenRotationRequest; import com.slack.api.methods.request.oauth.OAuthV2ExchangeRequest; import com.slack.api.methods.request.openid.connect.OpenIDConnectTokenRequest; import com.slack.api.methods.request.openid.connect.OpenIDConnectUserInfoRequest; @@ -303,6 +304,7 @@ import com.slack.api.methods.response.oauth.OAuthTokenResponse; import com.slack.api.methods.response.oauth.OAuthV2AccessResponse; import com.slack.api.methods.response.oauth.OAuthV2BeginShortTokenRotationResponse; +import com.slack.api.methods.response.oauth.OAuthV2CompleteShortTokenRotationResponse; import com.slack.api.methods.response.oauth.OAuthV2ExchangeResponse; import com.slack.api.methods.response.openid.connect.OpenIDConnectTokenResponse; import com.slack.api.methods.response.openid.connect.OpenIDConnectUserInfoResponse; @@ -2602,6 +2604,13 @@ OAuthV2BeginShortTokenRotationResponse oauthV2BeginShortTokenRotation( RequestConfigurator req) throws IOException, SlackApiException; + OAuthV2CompleteShortTokenRotationResponse oauthV2CompleteShortTokenRotation(OAuthV2CompleteShortTokenRotationRequest req) + throws IOException, SlackApiException; + + OAuthV2CompleteShortTokenRotationResponse oauthV2CompleteShortTokenRotation( + RequestConfigurator req) + throws IOException, SlackApiException; + OAuthV2ExchangeResponse oauthV2Exchange(OAuthV2ExchangeRequest req) throws IOException, SlackApiException; OAuthV2ExchangeResponse oauthV2Exchange( 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 index 2c76c769d..75619a092 100644 --- 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 @@ -427,6 +427,7 @@ public static void setRateLimitTier(String methodName, MethodsRateLimitTier tier setRateLimitTier(OAUTH_TOKEN, Tier4); setRateLimitTier(OAUTH_V2_ACCESS, Tier4); setRateLimitTier(OAUTH_V2_BEGIN_SHORT_TOKEN_ROTATION, Tier2); + setRateLimitTier(OAUTH_V2_COMPLETE_SHORT_TOKEN_ROTATION, Tier2); setRateLimitTier(OAUTH_V2_EXCHANGE, Tier3); setRateLimitTier(OPENID_CONNECT_TOKEN, Tier4); 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 index adede501e..92fbeffa9 100644 --- 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 @@ -123,6 +123,7 @@ import com.slack.api.methods.request.oauth.OAuthAccessRequest; import com.slack.api.methods.request.oauth.OAuthTokenRequest; import com.slack.api.methods.request.oauth.OAuthV2BeginShortTokenRotationRequest; +import com.slack.api.methods.request.oauth.OAuthV2CompleteShortTokenRotationRequest; import com.slack.api.methods.request.oauth.OAuthV2ExchangeRequest; import com.slack.api.methods.request.openid.connect.OpenIDConnectUserInfoRequest; import com.slack.api.methods.request.pins.PinsAddRequest; @@ -2910,6 +2911,14 @@ public static FormBody.Builder toForm(OAuthV2BeginShortTokenRotationRequest req) return form; } + public static FormBody.Builder toForm(OAuthV2CompleteShortTokenRotationRequest req) { + FormBody.Builder form = new FormBody.Builder(); + setIfNotNull("client_id", req.getClientId(), form); + setIfNotNull("client_secret", req.getClientSecret(), form); + setIfNotNull("new_token", req.getNewToken(), form); + return form; + } + public static FormBody.Builder toForm(OAuthV2ExchangeRequest req) { FormBody.Builder form = new FormBody.Builder(); setIfNotNull("client_id", req.getClientId(), 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 index 45baf5376..cc42a94d3 100644 --- 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 @@ -113,6 +113,7 @@ import com.slack.api.methods.request.oauth.OAuthTokenRequest; import com.slack.api.methods.request.oauth.OAuthV2AccessRequest; import com.slack.api.methods.request.oauth.OAuthV2BeginShortTokenRotationRequest; +import com.slack.api.methods.request.oauth.OAuthV2CompleteShortTokenRotationRequest; import com.slack.api.methods.request.oauth.OAuthV2ExchangeRequest; import com.slack.api.methods.request.openid.connect.OpenIDConnectTokenRequest; import com.slack.api.methods.request.openid.connect.OpenIDConnectUserInfoRequest; @@ -282,6 +283,7 @@ import com.slack.api.methods.response.oauth.OAuthTokenResponse; import com.slack.api.methods.response.oauth.OAuthV2AccessResponse; import com.slack.api.methods.response.oauth.OAuthV2BeginShortTokenRotationResponse; +import com.slack.api.methods.response.oauth.OAuthV2CompleteShortTokenRotationResponse; import com.slack.api.methods.response.oauth.OAuthV2ExchangeResponse; import com.slack.api.methods.response.openid.connect.OpenIDConnectTokenResponse; import com.slack.api.methods.response.openid.connect.OpenIDConnectUserInfoResponse; @@ -2639,6 +2641,16 @@ public CompletableFuture oauthV2BeginSho return oauthV2BeginShortTokenRotation(req.configure(OAuthV2BeginShortTokenRotationRequest.builder()).build()); } + @Override + public CompletableFuture oauthV2CompleteShortTokenRotation(OAuthV2CompleteShortTokenRotationRequest req) { + return executor.execute(OAUTH_V2_COMPLETE_SHORT_TOKEN_ROTATION, toMap(req), () -> methods.oauthV2CompleteShortTokenRotation(req)); + } + + @Override + public CompletableFuture oauthV2CompleteShortTokenRotation(RequestConfigurator req) { + return oauthV2CompleteShortTokenRotation(req.configure(OAuthV2CompleteShortTokenRotationRequest.builder()).build()); + } + @Override public CompletableFuture oauthV2Exchange(OAuthV2ExchangeRequest req) { return executor.execute(OAUTH_V2_EXCHANGE, toMap(req), () -> methods.oauthV2Exchange(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 index a336d393c..7d1f0a0d9 100644 --- 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 @@ -123,6 +123,7 @@ import com.slack.api.methods.request.oauth.OAuthTokenRequest; import com.slack.api.methods.request.oauth.OAuthV2AccessRequest; import com.slack.api.methods.request.oauth.OAuthV2BeginShortTokenRotationRequest; +import com.slack.api.methods.request.oauth.OAuthV2CompleteShortTokenRotationRequest; import com.slack.api.methods.request.oauth.OAuthV2ExchangeRequest; import com.slack.api.methods.request.openid.connect.OpenIDConnectTokenRequest; import com.slack.api.methods.request.openid.connect.OpenIDConnectUserInfoRequest; @@ -305,6 +306,7 @@ import com.slack.api.methods.response.oauth.OAuthTokenResponse; import com.slack.api.methods.response.oauth.OAuthV2AccessResponse; import com.slack.api.methods.response.oauth.OAuthV2BeginShortTokenRotationResponse; +import com.slack.api.methods.response.oauth.OAuthV2CompleteShortTokenRotationResponse; import com.slack.api.methods.response.oauth.OAuthV2ExchangeResponse; import com.slack.api.methods.response.openid.connect.OpenIDConnectTokenResponse; import com.slack.api.methods.response.openid.connect.OpenIDConnectUserInfoResponse; @@ -3291,6 +3293,16 @@ public OAuthV2BeginShortTokenRotationResponse oauthV2BeginShortTokenRotation(Req return oauthV2BeginShortTokenRotation(req.configure(OAuthV2BeginShortTokenRotationRequest.builder()).build()); } + @Override + public OAuthV2CompleteShortTokenRotationResponse oauthV2CompleteShortTokenRotation(OAuthV2CompleteShortTokenRotationRequest req) throws IOException, SlackApiException { + return postFormWithTokenAndParseResponse(toForm(req), Methods.OAUTH_V2_COMPLETE_SHORT_TOKEN_ROTATION, getToken(req), OAuthV2CompleteShortTokenRotationResponse.class); + } + + @Override + public OAuthV2CompleteShortTokenRotationResponse oauthV2CompleteShortTokenRotation(RequestConfigurator req) throws IOException, SlackApiException { + return oauthV2CompleteShortTokenRotation(req.configure(OAuthV2CompleteShortTokenRotationRequest.builder()).build()); + } + @Override public OAuthV2ExchangeResponse oauthV2Exchange(OAuthV2ExchangeRequest req) throws IOException, SlackApiException { return postFormAndParseResponse(toForm(req), Methods.OAUTH_V2_EXCHANGE, OAuthV2ExchangeResponse.class); diff --git a/slack-api-client/src/main/java/com/slack/api/methods/request/oauth/OAuthV2CompleteShortTokenRotationRequest.java b/slack-api-client/src/main/java/com/slack/api/methods/request/oauth/OAuthV2CompleteShortTokenRotationRequest.java new file mode 100644 index 000000000..f25987edd --- /dev/null +++ b/slack-api-client/src/main/java/com/slack/api/methods/request/oauth/OAuthV2CompleteShortTokenRotationRequest.java @@ -0,0 +1,34 @@ +package com.slack.api.methods.request.oauth; + +import com.slack.api.methods.SlackApiRequest; +import lombok.Builder; +import lombok.Data; + +/** + * https://docs.slack.dev/reference/methods/oauth.v2.completeShortTokenRotation + */ +@Data +@Builder +public class OAuthV2CompleteShortTokenRotationRequest implements SlackApiRequest { + + /** + * Issued when you created your application. Must be the app the token being rotated was issued to. + */ + private String clientId; + + /** + * Issued when you created your application. + */ + private String clientSecret; + + /** + * The original short xoxp token being rotated (the one passed to oauth.v2.beginShortTokenRotation). Authenticates the request. + */ + private String token; + + /** + * The new xoxp token returned by oauth.v2.beginShortTokenRotation. + */ + private String newToken; + +} diff --git a/slack-api-client/src/main/java/com/slack/api/methods/response/oauth/OAuthV2CompleteShortTokenRotationResponse.java b/slack-api-client/src/main/java/com/slack/api/methods/response/oauth/OAuthV2CompleteShortTokenRotationResponse.java new file mode 100644 index 000000000..2838cb8d9 --- /dev/null +++ b/slack-api-client/src/main/java/com/slack/api/methods/response/oauth/OAuthV2CompleteShortTokenRotationResponse.java @@ -0,0 +1,25 @@ +package com.slack.api.methods.response.oauth; + +import com.slack.api.methods.SlackApiTextResponse; +import com.slack.api.model.ErrorResponseMetadata; +import lombok.Data; + +import java.util.List; +import java.util.Map; + +/** + * https://docs.slack.dev/reference/methods/oauth.v2.completeShortTokenRotation + */ +@Data +public class OAuthV2CompleteShortTokenRotationResponse implements SlackApiTextResponse { + + private boolean ok; + private String warning; + private String error; + private String needed; + private String provided; + private transient Map> httpResponseHeaders; + + private String token; + private ErrorResponseMetadata responseMetadata; +} 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 index 6cf7ade29..7d82f8d92 100644 --- a/slack-api-client/src/test/java/test_locally/api/MethodsTest.java +++ b/slack-api-client/src/test/java/test_locally/api/MethodsTest.java @@ -19,8 +19,8 @@ public class MethodsTest { public void verifyTheCoverage() { // https://docs.slack.dev/reference/methods // var methodNames = [].slice.call(document.getElementsByClassName('apiReferenceFilterableList__listItemLink')).map(e => e.href.replace("https://docs.slack.dev/reference/methods/", ""));console.log(methodNames.toString());console.log(methodNames.length); - // 328 endpoints as of November 12, 2026 (apps.user.connection.bulkUpdate and requestAuth added ahead of their docs.slack.dev pages) - String methods = "admin.analytics.getFile,admin.apps.activities.list,admin.apps.approve,admin.apps.clearResolution,admin.apps.restrict,admin.apps.uninstall,admin.apps.approved.list,admin.apps.config.lookup,admin.apps.config.set,admin.apps.mcp.servers.list,admin.apps.mcp.servers.permissions.list,admin.apps.mcp.servers.permissions.set,admin.apps.requests.cancel,admin.apps.requests.list,admin.apps.restricted.list,admin.audit.anomaly.allow.getItem,admin.audit.anomaly.allow.updateItem,admin.auth.policy.assignEntities,admin.auth.policy.getEntities,admin.auth.policy.removeEntities,admin.barriers.create,admin.barriers.delete,admin.barriers.list,admin.barriers.update,admin.conversations.archive,admin.conversations.bulkArchive,admin.conversations.bulkDelete,admin.conversations.bulkMove,admin.conversations.convertToPrivate,admin.conversations.convertToPublic,admin.conversations.create,admin.conversations.createForObjects,admin.conversations.delete,admin.conversations.disconnectShared,admin.conversations.getConversationPrefs,admin.conversations.getCustomRetention,admin.conversations.getTeams,admin.conversations.invite,admin.conversations.linkObjects,admin.conversations.lookup,admin.conversations.removeCustomRetention,admin.conversations.rename,admin.conversations.search,admin.conversations.setConversationPrefs,admin.conversations.setCustomRetention,admin.conversations.setTeams,admin.conversations.unarchive,admin.conversations.unlinkObjects,admin.conversations.ekm.listOriginalConnectedChannelInfo,admin.conversations.restrictAccess.addGroup,admin.conversations.restrictAccess.listGroups,admin.conversations.restrictAccess.removeGroup,admin.emoji.add,admin.emoji.addAlias,admin.emoji.list,admin.emoji.remove,admin.emoji.rename,admin.functions.list,admin.functions.permissions.lookup,admin.functions.permissions.set,admin.inviteRequests.approve,admin.inviteRequests.deny,admin.inviteRequests.list,admin.inviteRequests.approved.list,admin.inviteRequests.denied.list,admin.roles.addAssignments,admin.roles.listAssignments,admin.roles.removeAssignments,admin.slackbot.skills.list,admin.slackbot.skills.publish,admin.slackbot.skills.setAutoEnabled,admin.slackbot.skills.unpublish,admin.teams.admins.list,admin.teams.create,admin.teams.list,admin.teams.owners.list,admin.teams.settings.info,admin.teams.settings.setDefaultChannels,admin.teams.settings.setDescription,admin.teams.settings.setDiscoverability,admin.teams.settings.setIcon,admin.teams.settings.setName,admin.usergroups.addChannels,admin.usergroups.addTeams,admin.usergroups.listChannels,admin.usergroups.removeChannels,admin.users.assign,admin.users.getExpiration,admin.users.invite,admin.users.list,admin.users.remove,admin.users.setAdmin,admin.users.setExpiration,admin.users.setOwner,admin.users.setRegular,admin.users.session.clearSettings,admin.users.session.getSettings,admin.users.session.invalidate,admin.users.session.list,admin.users.session.reset,admin.users.session.resetBulk,admin.users.session.setSettings,admin.users.unsupportedVersions.export,admin.workflows.collaborators.add,admin.workflows.collaborators.remove,admin.workflows.permissions.lookup,admin.workflows.search,admin.workflows.unpublish,admin.workflows.triggers.types.permissions.lookup,admin.workflows.triggers.types.permissions.set,api.test,apps.activities.list,apps.auth.external.delete,apps.auth.external.get,apps.connections.open,apps.datastore.bulkDelete,apps.datastore.bulkGet,apps.datastore.bulkPut,apps.datastore.count,apps.datastore.delete,apps.datastore.get,apps.datastore.put,apps.datastore.query,apps.datastore.update,apps.event.authorizations.list,apps.manifest.create,apps.manifest.delete,apps.manifest.export,apps.manifest.update,apps.manifest.validate,apps.uninstall,apps.user.connection.bulkUpdate,apps.user.connection.requestAuth,apps.user.connection.update,assistant.search.context,assistant.threads.setStatus,assistant.threads.setSuggestedPrompts,assistant.threads.setTitle,auth.revoke,auth.test,auth.teams.list,blocks.validate,bookmarks.add,bookmarks.edit,bookmarks.list,bookmarks.remove,bots.info,calls.add,calls.end,calls.info,calls.update,calls.participants.add,calls.participants.remove,canvases.access.delete,canvases.access.set,canvases.create,canvases.delete,canvases.edit,canvases.getContent,canvases.sections.lookup,channels.mark,chat.appendStream,chat.delete,chat.deleteScheduledMessage,chat.getPermalink,chat.meMessage,chat.postEphemeral,chat.postMessage,chat.scheduleMessage,chat.startStream,chat.stopStream,chat.unfurl,chat.update,chat.scheduledMessages.list,conversations.acceptSharedInvite,conversations.approveSharedInvite,conversations.archive,conversations.close,conversations.create,conversations.declineSharedInvite,conversations.history,conversations.info,conversations.invite,conversations.inviteShared,conversations.join,conversations.kick,conversations.leave,conversations.list,conversations.listConnectInvites,conversations.mark,conversations.members,conversations.open,conversations.rename,conversations.replies,conversations.setPurpose,conversations.setTopic,conversations.unarchive,conversations.canvases.create,conversations.externalInvitePermissions.set,conversations.requestSharedInvite.approve,conversations.requestSharedInvite.deny,conversations.requestSharedInvite.list,dialog.open,dnd.endDnd,dnd.endSnooze,dnd.info,dnd.setSnooze,dnd.teamInfo,emoji.list,files.comments.delete,files.completeUploadExternal,files.delete,files.getUploadURLExternal,files.info,files.list,files.revokePublicURL,files.sharedPublicURL,files.upload,files.remote.add,files.remote.info,files.remote.list,files.remote.remove,files.remote.share,files.remote.update,functions.completeError,functions.completeSuccess,functions.distributions.permissions.add,functions.distributions.permissions.list,functions.distributions.permissions.remove,functions.distributions.permissions.set,functions.workflows.steps.list,functions.workflows.steps.responses.export,groups.mark,migration.exchange,oauth.access,oauth.v2.access,oauth.v2.beginShortTokenRotation,oauth.v2.exchange,openid.connect.token,openid.connect.userInfo,pins.add,pins.list,pins.remove,reactions.add,reactions.get,reactions.list,reactions.remove,reminders.add,reminders.complete,reminders.delete,reminders.info,reminders.list,rtm.connect,rtm.start,search.all,search.files,search.messages,slackLists.access.delete,slackLists.access.set,slackLists.create,slackLists.download.get,slackLists.download.start,slackLists.items.create,slackLists.items.delete,slackLists.items.deleteMultiple,slackLists.items.info,slackLists.items.list,slackLists.items.update,slackLists.update,slackbot.skills.create,slackbot.skills.delete,slackbot.skills.info,slackbot.skills.library.add,slackbot.skills.library.remove,slackbot.skills.list,slackbot.skills.update,stars.add,stars.list,stars.remove,team.accessLogs,team.billableInfo,team.info,team.integrationLogs,team.billing.info,team.externalTeams.disconnect,team.externalTeams.list,team.preferences.list,team.profile.get,tooling.tokens.rotate,usergroups.create,usergroups.disable,usergroups.enable,usergroups.list,usergroups.update,usergroups.users.list,usergroups.users.update,users.conversations,users.deletePhoto,users.getPresence,users.identity,users.info,users.list,users.lookupByEmail,users.setActive,users.setPhoto,users.setPresence,users.discoverableContacts.lookup,users.profile.get,users.profile.set,views.open,views.publish,views.push,views.update,workflows.featured.add,workflows.featured.list,workflows.featured.remove,workflows.featured.set,workflows.stepCompleted,workflows.stepFailed,workflows.updateStep,workflows.triggers.permissions.add,workflows.triggers.permissions.list,workflows.triggers.permissions.remove,workflows.triggers.permissions.set,im.list,im.mark,mpim.list,mpim.mark"; + // 329 endpoints as of November 12, 2026 (apps.user.connection.bulkUpdate and requestAuth added ahead of their docs.slack.dev pages) + String methods = "admin.analytics.getFile,admin.apps.activities.list,admin.apps.approve,admin.apps.clearResolution,admin.apps.restrict,admin.apps.uninstall,admin.apps.approved.list,admin.apps.config.lookup,admin.apps.config.set,admin.apps.mcp.servers.list,admin.apps.mcp.servers.permissions.list,admin.apps.mcp.servers.permissions.set,admin.apps.requests.cancel,admin.apps.requests.list,admin.apps.restricted.list,admin.audit.anomaly.allow.getItem,admin.audit.anomaly.allow.updateItem,admin.auth.policy.assignEntities,admin.auth.policy.getEntities,admin.auth.policy.removeEntities,admin.barriers.create,admin.barriers.delete,admin.barriers.list,admin.barriers.update,admin.conversations.archive,admin.conversations.bulkArchive,admin.conversations.bulkDelete,admin.conversations.bulkMove,admin.conversations.convertToPrivate,admin.conversations.convertToPublic,admin.conversations.create,admin.conversations.createForObjects,admin.conversations.delete,admin.conversations.disconnectShared,admin.conversations.getConversationPrefs,admin.conversations.getCustomRetention,admin.conversations.getTeams,admin.conversations.invite,admin.conversations.linkObjects,admin.conversations.lookup,admin.conversations.removeCustomRetention,admin.conversations.rename,admin.conversations.search,admin.conversations.setConversationPrefs,admin.conversations.setCustomRetention,admin.conversations.setTeams,admin.conversations.unarchive,admin.conversations.unlinkObjects,admin.conversations.ekm.listOriginalConnectedChannelInfo,admin.conversations.restrictAccess.addGroup,admin.conversations.restrictAccess.listGroups,admin.conversations.restrictAccess.removeGroup,admin.emoji.add,admin.emoji.addAlias,admin.emoji.list,admin.emoji.remove,admin.emoji.rename,admin.functions.list,admin.functions.permissions.lookup,admin.functions.permissions.set,admin.inviteRequests.approve,admin.inviteRequests.deny,admin.inviteRequests.list,admin.inviteRequests.approved.list,admin.inviteRequests.denied.list,admin.roles.addAssignments,admin.roles.listAssignments,admin.roles.removeAssignments,admin.slackbot.skills.list,admin.slackbot.skills.publish,admin.slackbot.skills.setAutoEnabled,admin.slackbot.skills.unpublish,admin.teams.admins.list,admin.teams.create,admin.teams.list,admin.teams.owners.list,admin.teams.settings.info,admin.teams.settings.setDefaultChannels,admin.teams.settings.setDescription,admin.teams.settings.setDiscoverability,admin.teams.settings.setIcon,admin.teams.settings.setName,admin.usergroups.addChannels,admin.usergroups.addTeams,admin.usergroups.listChannels,admin.usergroups.removeChannels,admin.users.assign,admin.users.getExpiration,admin.users.invite,admin.users.list,admin.users.remove,admin.users.setAdmin,admin.users.setExpiration,admin.users.setOwner,admin.users.setRegular,admin.users.session.clearSettings,admin.users.session.getSettings,admin.users.session.invalidate,admin.users.session.list,admin.users.session.reset,admin.users.session.resetBulk,admin.users.session.setSettings,admin.users.unsupportedVersions.export,admin.workflows.collaborators.add,admin.workflows.collaborators.remove,admin.workflows.permissions.lookup,admin.workflows.search,admin.workflows.unpublish,admin.workflows.triggers.types.permissions.lookup,admin.workflows.triggers.types.permissions.set,api.test,apps.activities.list,apps.auth.external.delete,apps.auth.external.get,apps.connections.open,apps.datastore.bulkDelete,apps.datastore.bulkGet,apps.datastore.bulkPut,apps.datastore.count,apps.datastore.delete,apps.datastore.get,apps.datastore.put,apps.datastore.query,apps.datastore.update,apps.event.authorizations.list,apps.manifest.create,apps.manifest.delete,apps.manifest.export,apps.manifest.update,apps.manifest.validate,apps.uninstall,apps.user.connection.bulkUpdate,apps.user.connection.requestAuth,apps.user.connection.update,assistant.search.context,assistant.threads.setStatus,assistant.threads.setSuggestedPrompts,assistant.threads.setTitle,auth.revoke,auth.test,auth.teams.list,blocks.validate,bookmarks.add,bookmarks.edit,bookmarks.list,bookmarks.remove,bots.info,calls.add,calls.end,calls.info,calls.update,calls.participants.add,calls.participants.remove,canvases.access.delete,canvases.access.set,canvases.create,canvases.delete,canvases.edit,canvases.getContent,canvases.sections.lookup,channels.mark,chat.appendStream,chat.delete,chat.deleteScheduledMessage,chat.getPermalink,chat.meMessage,chat.postEphemeral,chat.postMessage,chat.scheduleMessage,chat.startStream,chat.stopStream,chat.unfurl,chat.update,chat.scheduledMessages.list,conversations.acceptSharedInvite,conversations.approveSharedInvite,conversations.archive,conversations.close,conversations.create,conversations.declineSharedInvite,conversations.history,conversations.info,conversations.invite,conversations.inviteShared,conversations.join,conversations.kick,conversations.leave,conversations.list,conversations.listConnectInvites,conversations.mark,conversations.members,conversations.open,conversations.rename,conversations.replies,conversations.setPurpose,conversations.setTopic,conversations.unarchive,conversations.canvases.create,conversations.externalInvitePermissions.set,conversations.requestSharedInvite.approve,conversations.requestSharedInvite.deny,conversations.requestSharedInvite.list,dialog.open,dnd.endDnd,dnd.endSnooze,dnd.info,dnd.setSnooze,dnd.teamInfo,emoji.list,files.comments.delete,files.completeUploadExternal,files.delete,files.getUploadURLExternal,files.info,files.list,files.revokePublicURL,files.sharedPublicURL,files.upload,files.remote.add,files.remote.info,files.remote.list,files.remote.remove,files.remote.share,files.remote.update,functions.completeError,functions.completeSuccess,functions.distributions.permissions.add,functions.distributions.permissions.list,functions.distributions.permissions.remove,functions.distributions.permissions.set,functions.workflows.steps.list,functions.workflows.steps.responses.export,groups.mark,migration.exchange,oauth.access,oauth.v2.access,oauth.v2.beginShortTokenRotation,oauth.v2.completeShortTokenRotation,oauth.v2.exchange,openid.connect.token,openid.connect.userInfo,pins.add,pins.list,pins.remove,reactions.add,reactions.get,reactions.list,reactions.remove,reminders.add,reminders.complete,reminders.delete,reminders.info,reminders.list,rtm.connect,rtm.start,search.all,search.files,search.messages,slackLists.access.delete,slackLists.access.set,slackLists.create,slackLists.download.get,slackLists.download.start,slackLists.items.create,slackLists.items.delete,slackLists.items.deleteMultiple,slackLists.items.info,slackLists.items.list,slackLists.items.update,slackLists.update,slackbot.skills.create,slackbot.skills.delete,slackbot.skills.info,slackbot.skills.library.add,slackbot.skills.library.remove,slackbot.skills.list,slackbot.skills.update,stars.add,stars.list,stars.remove,team.accessLogs,team.billableInfo,team.info,team.integrationLogs,team.billing.info,team.externalTeams.disconnect,team.externalTeams.list,team.preferences.list,team.profile.get,tooling.tokens.rotate,usergroups.create,usergroups.disable,usergroups.enable,usergroups.list,usergroups.update,usergroups.users.list,usergroups.users.update,users.conversations,users.deletePhoto,users.getPresence,users.identity,users.info,users.list,users.lookupByEmail,users.setActive,users.setPhoto,users.setPresence,users.discoverableContacts.lookup,users.profile.get,users.profile.set,views.open,views.publish,views.push,views.update,workflows.featured.add,workflows.featured.list,workflows.featured.remove,workflows.featured.set,workflows.stepCompleted,workflows.stepFailed,workflows.updateStep,workflows.triggers.permissions.add,workflows.triggers.permissions.list,workflows.triggers.permissions.remove,workflows.triggers.permissions.set,im.list,im.mark,mpim.list,mpim.mark"; final List existingMethods = new ArrayList<>(); for (Field f : Methods.class.getDeclaredFields()) { int modifiers = f.getModifiers(); diff --git a/slack-api-client/src/test/java/test_locally/api/methods/OAuthTest.java b/slack-api-client/src/test/java/test_locally/api/methods/OAuthTest.java index 5ed9226a4..870d649e8 100644 --- a/slack-api-client/src/test/java/test_locally/api/methods/OAuthTest.java +++ b/slack-api-client/src/test/java/test_locally/api/methods/OAuthTest.java @@ -153,4 +153,22 @@ public void beginShortTokenRotation_async() throws Exception { .token("xoxp-12345-67890-1928471-abcdefg")).get().isOk(), is(true)); } + @Test + public void completeShortTokenRotation() throws Exception { + assertThat(slack.methods().oauthV2CompleteShortTokenRotation(r -> r + .clientId("4123121235.9872358710") + .clientSecret("e1b9e11dfcd19c1982d5de12921e17e8c") + .token("xoxp-12345-67890-1928471-abcdefg") + .newToken("xoxp-12345-67890-1928471-qemwiiwglagjacakvqbvbfkmvbsvsuzn")).isOk(), is(true)); + } + + @Test + public void completeShortTokenRotation_async() throws Exception { + assertThat(slack.methodsAsync().oauthV2CompleteShortTokenRotation(r -> r + .clientId("4123121235.9872358710") + .clientSecret("e1b9e11dfcd19c1982d5de12921e17e8c") + .token("xoxp-12345-67890-1928471-abcdefg") + .newToken("xoxp-12345-67890-1928471-qemwiiwglagjacakvqbvbfkmvbsvsuzn")).get().isOk(), is(true)); + } + } diff --git a/slack-api-client/src/test/java/test_with_remote_apis/methods/oauth_Test.java b/slack-api-client/src/test/java/test_with_remote_apis/methods/oauth_Test.java index 23afbde0f..159c7911c 100644 --- a/slack-api-client/src/test/java/test_with_remote_apis/methods/oauth_Test.java +++ b/slack-api-client/src/test/java/test_with_remote_apis/methods/oauth_Test.java @@ -6,6 +6,7 @@ import com.slack.api.methods.response.oauth.OAuthTokenResponse; import com.slack.api.methods.response.oauth.OAuthV2AccessResponse; import com.slack.api.methods.response.oauth.OAuthV2BeginShortTokenRotationResponse; +import com.slack.api.methods.response.oauth.OAuthV2CompleteShortTokenRotationResponse; import com.slack.api.methods.response.oauth.OAuthV2ExchangeResponse; import com.slack.api.model.ErrorResponseMetadata; import config.Constants; @@ -92,6 +93,18 @@ public void beginShortTokenRotation() throws IOException, SlackApiException { assertThat(response.isOk(), is(false)); } + @Test + public void completeShortTokenRotation() throws IOException, SlackApiException { + // The example client_id from the docs is not the app this token was issued to + OAuthV2CompleteShortTokenRotationResponse response = slack.methods().oauthV2CompleteShortTokenRotation(r -> r + .clientId("4123121235.9872358710") + .clientSecret("e1b9e11dfcd19c1982d5de12921e17e8c") + .token(userToken) + .newToken("xoxp-12345-67890-1928471-qemwiiwglagjacakvqbvbfkmvbsvsuzn")); + assertThat(response.getError(), is("invalid_client_id")); + assertThat(response.isOk(), is(false)); + } + // TODO: valid test; currently just checking the API access @Test @Ignore