diff --git a/json-logs/samples/api/admin.analytics.members.metadata.json b/json-logs/samples/api/admin.analytics.members.metadata.json new file mode 100644 index 000000000..b6273a4fe --- /dev/null +++ b/json-logs/samples/api/admin.analytics.members.metadata.json @@ -0,0 +1,50 @@ +{ + "ok": false, + "members": [ + { + "user_id": "U00000000", + "team_id": "T00000000", + "enterprise_id": "E00000000", + "date_created": 12345, + "date_deleted": 12345, + "username": "", + "real_name": "", + "display_name": "", + "user_title": "", + "email": "", + "alternate_email": "", + "workspaces": { + "0": "", + "1": "" + }, + "department": "", + "cost_center": "", + "division": "", + "primary_phone": "", + "mobile_phone": "", + "role": "", + "user_type": "", + "employee_number": "", + "locale": "", + "honorific_prefix": "", + "manager_id": "U00000000", + "organization": "", + "preferred_language": "", + "street_address": "", + "country": "", + "city": "", + "zip_code": "" + } + ], + "total_count": 12345, + "response_metadata": { + "messages": [ + "" + ], + "next_cursor": "" + }, + "error": "", + "needed": "", + "provided": "", + "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 8099b81e4..429288845 100644 --- a/metadata/web-api/rate_limit_tiers.json +++ b/metadata/web-api/rate_limit_tiers.json @@ -1,5 +1,6 @@ { "admin.analytics.getFile": "Tier2", + "admin.analytics.members.metadata": "Tier2", "admin.apps.activities.list": "Tier3", "admin.apps.approve": "Tier2", "admin.apps.approved.list": "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 index cd1712249..b38354290 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 @@ -2,6 +2,7 @@ import com.slack.api.RequestConfigurator; import com.slack.api.methods.request.admin.analytics.AdminAnalyticsGetFileRequest; +import com.slack.api.methods.request.admin.analytics.members.AdminAnalyticsMembersMetadataRequest; import com.slack.api.methods.request.admin.apps.*; import com.slack.api.methods.request.admin.apps.mcp.servers.AdminAppsMcpServersListRequest; import com.slack.api.methods.request.admin.apps.mcp.servers.permissions.AdminAppsMcpServersPermissionsListRequest; @@ -171,6 +172,7 @@ import com.slack.api.methods.request.workflows.WorkflowsStepFailedRequest; import com.slack.api.methods.request.workflows.WorkflowsUpdateStepRequest; import com.slack.api.methods.response.admin.analytics.AdminAnalyticsGetFileResponse; +import com.slack.api.methods.response.admin.analytics.members.AdminAnalyticsMembersMetadataResponse; import com.slack.api.methods.response.admin.apps.*; import com.slack.api.methods.response.admin.apps.mcp.servers.AdminAppsMcpServersListResponse; import com.slack.api.methods.response.admin.apps.mcp.servers.permissions.AdminAppsMcpServersPermissionsListResponse; @@ -360,6 +362,14 @@ public interface AsyncMethodsClient { CompletableFuture adminAnalyticsGetFile(RequestConfigurator req); + // ------------------------------ + // admin.analytics.members + // ------------------------------ + + CompletableFuture adminAnalyticsMembersMetadata(AdminAnalyticsMembersMetadataRequest req); + + CompletableFuture adminAnalyticsMembersMetadata(RequestConfigurator req); + // ------------------------------ // admin.apps // ------------------------------ 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 491f254e6..aad677c01 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 @@ -12,6 +12,12 @@ private Methods() { public static final String ADMIN_ANALYTICS_GET_FILE = "admin.analytics.getFile"; + // ------------------------------ + // admin.analytics.members + // ------------------------------ + + public static final String ADMIN_ANALYTICS_MEMBERS_METADATA = "admin.analytics.members.metadata"; + // ------------------------------ // admin.apps // ------------------------------ 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 cbe8ded29..baa3b9a2b 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 @@ -2,6 +2,7 @@ import com.slack.api.RequestConfigurator; import com.slack.api.methods.request.admin.analytics.AdminAnalyticsGetFileRequest; +import com.slack.api.methods.request.admin.analytics.members.AdminAnalyticsMembersMetadataRequest; import com.slack.api.methods.request.admin.apps.*; import com.slack.api.methods.request.admin.apps.mcp.servers.AdminAppsMcpServersListRequest; import com.slack.api.methods.request.admin.apps.mcp.servers.permissions.AdminAppsMcpServersPermissionsListRequest; @@ -184,6 +185,7 @@ import com.slack.api.methods.request.workflows.WorkflowsStepFailedRequest; import com.slack.api.methods.request.workflows.WorkflowsUpdateStepRequest; import com.slack.api.methods.response.admin.analytics.AdminAnalyticsGetFileResponse; +import com.slack.api.methods.response.admin.analytics.members.AdminAnalyticsMembersMetadataResponse; import com.slack.api.methods.response.admin.apps.*; import com.slack.api.methods.response.admin.apps.mcp.servers.AdminAppsMcpServersListResponse; import com.slack.api.methods.response.admin.apps.mcp.servers.permissions.AdminAppsMcpServersPermissionsListResponse; @@ -439,6 +441,15 @@ AdminAnalyticsGetFileResponse adminAnalyticsGetFile( RequestConfigurator req) throws IOException, SlackApiException; + // ------------------------------ + // admin.analytics.members + // ------------------------------ + + AdminAnalyticsMembersMetadataResponse adminAnalyticsMembersMetadata(AdminAnalyticsMembersMetadataRequest req) throws IOException, SlackApiException; + + AdminAnalyticsMembersMetadataResponse adminAnalyticsMembersMetadata(RequestConfigurator req) + throws IOException, SlackApiException; + // ------------------------------ // admin.apps // ------------------------------ 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 5d01f3a10..e785e028a 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 @@ -69,6 +69,7 @@ public static void setRateLimitTier(String methodName, MethodsRateLimitTier tier // Tier2 final List adminApiMethods_Tier2 = Arrays.asList( ADMIN_ANALYTICS_GET_FILE, + ADMIN_ANALYTICS_MEMBERS_METADATA, ADMIN_APPS_APPROVE, ADMIN_APPS_CLEAR_RESOLUTION, 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 778f97c7c..1c152482d 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 @@ -3,6 +3,7 @@ import com.google.gson.Gson; import com.google.gson.JsonElement; import com.slack.api.methods.request.admin.analytics.AdminAnalyticsGetFileRequest; +import com.slack.api.methods.request.admin.analytics.members.AdminAnalyticsMembersMetadataRequest; import com.slack.api.methods.request.admin.apps.*; import com.slack.api.methods.request.admin.apps.mcp.servers.AdminAppsMcpServersListRequest; import com.slack.api.methods.request.admin.apps.mcp.servers.permissions.AdminAppsMcpServersPermissionsListRequest; @@ -219,6 +220,19 @@ public static FormBody.Builder toForm(AdminAnalyticsGetFileRequest req) { return form; } + public static FormBody.Builder toForm(AdminAnalyticsMembersMetadataRequest req) { + FormBody.Builder form = new FormBody.Builder(); + setIfNotNull("include_deactivated_since", req.getIncludeDeactivatedSince(), form); + setIfNotNull("team_id", req.getTeamId(), form); + if (req.getMemberTypes() != null) { + setIfNotNull("member_types", req.getMemberTypes().stream().collect(joining(",")), form); + } + setIfNotNull("query", req.getQuery(), form); + setIfNotNull("cursor", req.getCursor(), form); + setIfNotNull("limit", req.getLimit(), form); + return form; + } + public static FormBody.Builder toForm(AdminUsersSessionResetRequest req) { FormBody.Builder form = new FormBody.Builder(); setIfNotNull("user_id", req.getUserId(), 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 54051a7c3..c6625958d 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 @@ -6,6 +6,7 @@ import com.slack.api.methods.MethodsClient; import com.slack.api.methods.SlackApiRequest; import com.slack.api.methods.request.admin.analytics.AdminAnalyticsGetFileRequest; +import com.slack.api.methods.request.admin.analytics.members.AdminAnalyticsMembersMetadataRequest; import com.slack.api.methods.request.admin.apps.*; import com.slack.api.methods.request.admin.apps.mcp.servers.AdminAppsMcpServersListRequest; import com.slack.api.methods.request.admin.apps.mcp.servers.permissions.AdminAppsMcpServersPermissionsListRequest; @@ -175,6 +176,7 @@ import com.slack.api.methods.request.workflows.WorkflowsStepFailedRequest; import com.slack.api.methods.request.workflows.WorkflowsUpdateStepRequest; import com.slack.api.methods.response.admin.analytics.AdminAnalyticsGetFileResponse; +import com.slack.api.methods.response.admin.analytics.members.AdminAnalyticsMembersMetadataResponse; import com.slack.api.methods.response.admin.apps.*; import com.slack.api.methods.response.admin.apps.mcp.servers.AdminAppsMcpServersListResponse; import com.slack.api.methods.response.admin.apps.mcp.servers.permissions.AdminAppsMcpServersPermissionsListResponse; @@ -397,6 +399,16 @@ public CompletableFuture adminAnalyticsGetFile(Re return adminAnalyticsGetFile(req.configure(AdminAnalyticsGetFileRequest.builder()).build()); } + @Override + public CompletableFuture adminAnalyticsMembersMetadata(AdminAnalyticsMembersMetadataRequest req) { + return executor.execute(ADMIN_ANALYTICS_MEMBERS_METADATA, toMap(req), () -> methods.adminAnalyticsMembersMetadata(req)); + } + + @Override + public CompletableFuture adminAnalyticsMembersMetadata(RequestConfigurator req) { + return adminAnalyticsMembersMetadata(req.configure(AdminAnalyticsMembersMetadataRequest.builder()).build()); + } + @Override public CompletableFuture adminAppsApprove(AdminAppsApproveRequest req) { return executor.execute(ADMIN_APPS_APPROVE, toMap(req), () -> methods.adminAppsApprove(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 e0a53a2ef..718dc4750 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 @@ -3,6 +3,7 @@ import com.slack.api.RequestConfigurator; import com.slack.api.methods.*; import com.slack.api.methods.request.admin.analytics.AdminAnalyticsGetFileRequest; +import com.slack.api.methods.request.admin.analytics.members.AdminAnalyticsMembersMetadataRequest; import com.slack.api.methods.request.admin.apps.*; import com.slack.api.methods.request.admin.apps.mcp.servers.AdminAppsMcpServersListRequest; import com.slack.api.methods.request.admin.apps.mcp.servers.permissions.AdminAppsMcpServersPermissionsListRequest; @@ -185,6 +186,7 @@ import com.slack.api.methods.request.workflows.WorkflowsStepFailedRequest; import com.slack.api.methods.request.workflows.WorkflowsUpdateStepRequest; import com.slack.api.methods.response.admin.analytics.AdminAnalyticsGetFileResponse; +import com.slack.api.methods.response.admin.analytics.members.AdminAnalyticsMembersMetadataResponse; import com.slack.api.methods.response.admin.apps.*; import com.slack.api.methods.response.admin.apps.mcp.servers.AdminAppsMcpServersListResponse; import com.slack.api.methods.response.admin.apps.mcp.servers.permissions.AdminAppsMcpServersPermissionsListResponse; @@ -4269,6 +4271,16 @@ public AdminAnalyticsGetFileResponse adminAnalyticsGetFile(RequestConfigurator req) throws IOException, SlackApiException { + return adminAnalyticsMembersMetadata(req.configure(AdminAnalyticsMembersMetadataRequest.builder()).build()); + } + @Override public T postFormWithTokenAndParseResponse( RequestConfigurator form, diff --git a/slack-api-client/src/main/java/com/slack/api/methods/request/admin/analytics/members/AdminAnalyticsMembersMetadataRequest.java b/slack-api-client/src/main/java/com/slack/api/methods/request/admin/analytics/members/AdminAnalyticsMembersMetadataRequest.java new file mode 100644 index 000000000..e49ef6cc7 --- /dev/null +++ b/slack-api-client/src/main/java/com/slack/api/methods/request/admin/analytics/members/AdminAnalyticsMembersMetadataRequest.java @@ -0,0 +1,52 @@ +package com.slack.api.methods.request.admin.analytics.members; + +import com.slack.api.methods.SlackApiRequest; +import lombok.Builder; +import lombok.Data; + +import java.util.List; + +/** + * https://docs.slack.dev/reference/methods/admin.analytics.members.metadata + */ +@Data +@Builder +public class AdminAnalyticsMembersMetadataRequest 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; + + /** + * Also return members deactivated on or after this day, as `YYYY-MM-DD` in UTC. + */ + private String includeDeactivatedSince; + + /** + * Workspace ID to scope the results to. With an organization-level token, omit it for organization-wide results. + */ + private String teamId; + + /** + * Member types to include: `regular_members`, `single_channel_guests`, `multi_channel_guests`, `frontline_members`, + * `org_owners`, `org_admins`, `workspace_owners`, `workspace_admins`, or `invited`. Omit to include every member type. + */ + private List memberTypes; + + /** + * Space-delimited search terms matched against member names, and against email addresses when the organization shows them. + */ + private String query; + + /** + * Set `cursor` to `next_cursor` returned by the previous call to list items in the next page. + */ + private String cursor; + + /** + * Maximum number of members to return. Max allowed is 500. + */ + private Integer limit; + +} diff --git a/slack-api-client/src/main/java/com/slack/api/methods/response/admin/analytics/members/AdminAnalyticsMembersMetadataResponse.java b/slack-api-client/src/main/java/com/slack/api/methods/response/admin/analytics/members/AdminAnalyticsMembersMetadataResponse.java new file mode 100644 index 000000000..68f736a5b --- /dev/null +++ b/slack-api-client/src/main/java/com/slack/api/methods/response/admin/analytics/members/AdminAnalyticsMembersMetadataResponse.java @@ -0,0 +1,56 @@ +package com.slack.api.methods.response.admin.analytics.members; + +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 AdminAnalyticsMembersMetadataResponse implements SlackApiTextResponse { + + private boolean ok; + private String warning; + private String error; + private String needed; + private String provided; + private transient Map> httpResponseHeaders; + + private List members; + private Integer totalCount; + private ResponseMetadata responseMetadata; + + @Data + public static class Member { + private String userId; + private String teamId; + private String enterpriseId; + private Integer dateCreated; + private Integer dateDeleted; + private String username; + private String realName; + private String displayName; + private String userTitle; + private String email; + private String alternateEmail; + private Map workspaces; + private String department; + private String costCenter; + private String division; + private String primaryPhone; + private String mobilePhone; + private String role; + private String userType; + private String employeeNumber; + private String locale; + private String honorificPrefix; + private String managerId; + private String organization; + private String preferredLanguage; + private String streetAddress; + private String country; + private String city; + private String zipCode; + } +} 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 b44906a11..3ef7e0ae3 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.icon.set,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.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 18, 2026 (apps.user.connection.bulkUpdate and requestAuth added ahead of their docs.slack.dev pages) + String methods = "admin.analytics.getFile,admin.analytics.members.metadata,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.icon.set,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.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_admin_api/AdminApiAsyncTest.java b/slack-api-client/src/test/java/test_locally/api/methods_admin_api/AdminApiAsyncTest.java index 3eb919741..38a3d7835 100644 --- a/slack-api-client/src/test/java/test_locally/api/methods_admin_api/AdminApiAsyncTest.java +++ b/slack-api-client/src/test/java/test_locally/api/methods_admin_api/AdminApiAsyncTest.java @@ -77,6 +77,19 @@ public void adminApps() throws Exception { assertThat(methods.adminAppsConfigSet(r -> r.appId("A111").domainRestrictions(new AppConfig.DomainRestrictions())).get().isOk(), is(true)); } + @Test + public void adminAnalyticsMembersMetadata() throws Exception { + AsyncMethodsClient methods = slack.methodsAsync(ValidToken); + + assertThat(methods.adminAnalyticsMembersMetadata(r -> r + .includeDeactivatedSince("2026-09-30") + .memberTypes(Arrays.asList("regular_members", "single_channel_guests")) + .query("alex") + .limit(100) + .cursor("xxx")) + .get().isOk(), is(true)); + } + @Test public void adminAppsMcpServers() throws Exception { AsyncMethodsClient methods = slack.methodsAsync(ValidToken); diff --git a/slack-api-client/src/test/java/test_locally/api/methods_admin_api/AdminApiTest.java b/slack-api-client/src/test/java/test_locally/api/methods_admin_api/AdminApiTest.java index d5a4bd978..410ddf8d8 100644 --- a/slack-api-client/src/test/java/test_locally/api/methods_admin_api/AdminApiTest.java +++ b/slack-api-client/src/test/java/test_locally/api/methods_admin_api/AdminApiTest.java @@ -5,6 +5,7 @@ import com.slack.api.SlackConfig; import com.slack.api.methods.MethodsClient; import com.slack.api.methods.response.admin.analytics.AdminAnalyticsGetFileResponse; +import com.slack.api.methods.response.admin.analytics.members.AdminAnalyticsMembersMetadataResponse; import com.slack.api.methods.response.admin.apps.mcp.servers.AdminAppsMcpServersListResponse; import com.slack.api.methods.response.admin.apps.mcp.servers.permissions.AdminAppsMcpServersPermissionsListResponse; import com.slack.api.methods.response.admin.apps.mcp.servers.permissions.AdminAppsMcpServersPermissionsSetResponse; @@ -96,6 +97,53 @@ public void adminApps() throws Exception { .isOk(), is(true)); } + @Test + public void adminAnalyticsMembersMetadata() throws Exception { + MethodsClient methods = slack.methods(ValidToken); + + assertThat(methods.adminAnalyticsMembersMetadata(r -> r + .includeDeactivatedSince("2026-09-30") + .memberTypes(Arrays.asList("regular_members", "single_channel_guests")) + .query("alex") + .limit(100) + .cursor("xxx")).isOk(), is(true)); + } + + @Test + public void adminAnalyticsMembersMetadataResponse() { + SlackTestConfig testConfig = SlackTestConfig.getInstance(); + Gson gson = GsonFactory.createSnakeCase(testConfig.getConfig()); + + String json = "{\n" + + " \"ok\": true,\n" + + " \"members\": [\n" + + " {\n" + + " \"user_id\": \"U0123ABCD\",\n" + + " \"team_id\": \"E0123ABCD\",\n" + + " \"username\": \"alex\",\n" + + " \"real_name\": \"Alex Smith\",\n" + + " \"email\": \"alex@example.com\",\n" + + " \"workspaces\": {\n" + + " \"T0123ABCD\": \"Example Workspace\"\n" + + " }\n" + + " }\n" + + " ],\n" + + " \"total_count\": 1250,\n" + + " \"response_metadata\": {\n" + + " \"next_cursor\": \"Y3Vyc29yX21hcms6QW9JSUtqWTA=\"\n" + + " }\n" + + "}\n"; + AdminAnalyticsMembersMetadataResponse response = gson.fromJson(json, AdminAnalyticsMembersMetadataResponse.class); + assertThat(response.isOk(), is(true)); + assertThat(response.getMembers().get(0).getUserId(), is("U0123ABCD")); + assertThat(response.getMembers().get(0).getUsername(), is("alex")); + assertThat(response.getMembers().get(0).getRealName(), is("Alex Smith")); + assertThat(response.getMembers().get(0).getEmail(), is("alex@example.com")); + assertThat(response.getMembers().get(0).getWorkspaces().get("T0123ABCD"), is("Example Workspace")); + assertThat(response.getTotalCount(), is(1250)); + assertThat(response.getResponseMetadata().getNextCursor(), is("Y3Vyc29yX21hcms6QW9JSUtqWTA=")); + } + @Test public void adminAppsMcpServers() throws Exception { MethodsClient methods = slack.methods(ValidToken); diff --git a/slack-api-client/src/test/java/test_with_remote_apis/methods_admin_api/AdminApi_analytics_members_metadata_Test.java b/slack-api-client/src/test/java/test_with_remote_apis/methods_admin_api/AdminApi_analytics_members_metadata_Test.java new file mode 100644 index 000000000..8899c8d90 --- /dev/null +++ b/slack-api-client/src/test/java/test_with_remote_apis/methods_admin_api/AdminApi_analytics_members_metadata_Test.java @@ -0,0 +1,49 @@ +package test_with_remote_apis.methods_admin_api; + +import com.slack.api.Slack; +import com.slack.api.methods.MethodsClient; +import com.slack.api.methods.response.admin.analytics.members.AdminAnalyticsMembersMetadataResponse; +import config.Constants; +import config.SlackTestConfig; +import lombok.extern.slf4j.Slf4j; +import org.junit.AfterClass; +import org.junit.BeforeClass; +import org.junit.Test; + +import static org.hamcrest.CoreMatchers.is; +import static org.hamcrest.CoreMatchers.notNullValue; +import static org.hamcrest.CoreMatchers.nullValue; +import static org.hamcrest.MatcherAssert.assertThat; + +@Slf4j +public class AdminApi_analytics_members_metadata_Test { + + static SlackTestConfig testConfig = SlackTestConfig.getInstance(); + static Slack slack = Slack.getInstance(testConfig.getConfig()); + + @BeforeClass + public static void setUp() throws Exception { + SlackTestConfig.initializeRawJSONDataFiles("admin.analytics.members.metadata"); + } + + @AfterClass + public static void tearDown() throws InterruptedException { + SlackTestConfig.awaitCompletion(testConfig); + } + + static String orgAdminUserToken = System.getenv(Constants.SLACK_SDK_TEST_GRID_ORG_ADMIN_USER_TOKEN); + + @Test + public void list() throws Exception { + if (orgAdminUserToken != null) { + MethodsClient client = slack.methods(orgAdminUserToken); + AdminAnalyticsMembersMetadataResponse first = client.adminAnalyticsMembersMetadata(r -> r.limit(1)); + assertThat(first.getError(), is(nullValue())); + assertThat(first.getMembers(), is(notNullValue())); + String cursor = first.getResponseMetadata().getNextCursor(); + AdminAnalyticsMembersMetadataResponse next = client.adminAnalyticsMembersMetadata(r -> r.limit(1).cursor(cursor)); + assertThat(next.getError(), is(nullValue())); + assertThat(next.getMembers(), is(notNullValue())); + } + } +}