Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
### 3.3.1 (Next)

* [#609](https://github.com/slack-ruby/slack-ruby-client/pull/609): Add admin.conversations.kick for bulk user removal and admin.users.deactivate for enterprise-wide deactivation - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
* [#609](https://github.com/slack-ruby/slack-ruby-client/pull/609): Expose admin.analytics.slackbot, admin.slackbot.skills, slackbot.skills, and slackbot.skills.library endpoint groups - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
* [#609](https://github.com/slack-ruby/slack-ruby-client/pull/609): Expose the admin.users.access endpoint group - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
* [#609](https://github.com/slack-ruby/slack-ruby-client/pull/609): Expose the agents.conversations endpoint group - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
* [#609](https://github.com/slack-ruby/slack-ruby-client/pull/609): Add an include_archived argument to slackLists.download.get - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
* [#609](https://github.com/slack-ruby/slack-ruby-client/pull/609): Add an include_slackbot_availability argument to team.info - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
* [#609](https://github.com/slack-ruby/slack-ruby-client/pull/609): Remove require_sc_channel_for_sc_dm from the documented slack_connect_pref_filter values for team.externalTeams.list - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
* Your contribution here.

### 3.3.0 (2026/10/09)
Expand Down
4 changes: 2 additions & 2 deletions bin/commands/admin_analytics_messages.rb
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ module Cli
class App
desc 'AdminAnalyticsMessages methods.'
command 'admin_analytics_messages' do |g|
g.desc 'Retrieves activity metrics for messages from a given channel.'
g.long_desc %( Retrieves activity metrics for messages from a given channel. )
g.desc 'Retrieves activity metrics for messages from a given channel, created between oldest_ts and latest_ts'
g.long_desc %( Retrieves activity metrics for messages from a given channel, created between oldest_ts and latest_ts )
g.command 'activity' do |c|
c.flag 'channel', desc: 'Channel ID for channel of the message activity to query.'
c.flag 'oldest_ts', desc: 'Oldest timestamp to include in the results. Defaults to 7 days before current time. If not passed while still passing the latest_ts parameter, defaults to 7 days before latest_ts.'
Expand Down
33 changes: 33 additions & 0 deletions bin/commands/admin_analytics_slackbot.rb
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# frozen_string_literal: true
# This file was auto-generated by lib/tasks/web.rake

module Slack
module Cli
class App
desc 'AdminAnalyticsSlackbot methods.'
command 'admin_analytics_slackbot' do |g|
g.desc 'Retrieve per-user Slackbot skill usage for an Enterprise organization on a single date, returned as paginated JSON.'
g.long_desc %( Retrieve per-user Slackbot skill usage for an Enterprise organization on a single date, returned as paginated JSON. )
g.command 'skills' do |c|
c.flag 'date', desc: "The date to retrieve the analytics data for, expressed as YYYY-MM-DD in UTC. If not provided, defaults to the latest date with available data. The response's available_date_range gives the earliest and latest dates you can request."
c.flag 'cursor', desc: "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection."
c.flag 'limit', desc: 'Maximum number of skill entries to return per page, counted across all rows. Defaults to 500. Max allowed is 1000.'
c.action do |_global_options, options, _args|
puts JSON.dump(@client.admin_analytics_slackbot_skills(options))
end
end

g.desc 'Retrieve per-user Slackbot tool usage for an Enterprise organization on a single date, returned as paginated JSON.'
g.long_desc %( Retrieve per-user Slackbot tool usage for an Enterprise organization on a single date, returned as paginated JSON. )
g.command 'tools' do |c|
c.flag 'date', desc: "The date to retrieve the analytics data for, expressed as YYYY-MM-DD in UTC. If not provided, defaults to the latest date with available data. The response's available_date_range gives the earliest and latest dates you can request."
c.flag 'cursor', desc: "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection."
c.flag 'limit', desc: 'Maximum number of tool entries to return per page, counted across all rows. Defaults to 500. Max allowed is 1000.'
c.action do |_global_options, options, _args|
puts JSON.dump(@client.admin_analytics_slackbot_tools(options))
end
end
end
end
end
end
2 changes: 1 addition & 1 deletion bin/commands/admin_apps_permissions.rb
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ class App
c.flag 'app_id', desc: 'Encoded ID of the app.'
c.flag 'permission_type', desc: 'The type of permission that defines who can access the app.'
c.flag 'user_ids', desc: 'List of user IDs to allow for named_entities visibility.'
c.flag 'usergroup_ids', desc: 'List of encoded usergroup IDs.'
c.flag 'usergroup_ids', desc: 'List of encoded usergroup IDs the permission applies to. With named_entities the listed groups may access the app; with named_entities_exclude they may not.'
c.flag 'channel_restriction_mode', desc: 'The mode that defines where the app can be used in channels.'
c.flag 'channel_ids', desc: 'List of encoded channel IDs for channel restrictions. Semantics depend on channel_restriction_mode: allowlist for specific_channels, exclusion list for all_channels_except.'
c.action do |_global_options, options, _args|
Expand Down
12 changes: 11 additions & 1 deletion bin/commands/admin_conversations.rb
Original file line number Diff line number Diff line change
Expand Up @@ -164,6 +164,16 @@ class App
end
end

g.desc 'Remove multiple users from a conversation. Admin version of conversations.kick with support for bulk user removal.'
g.long_desc %( Remove multiple users from a conversation. Admin version of conversations.kick with support for bulk user removal. )
g.command 'kick' do |c|
c.flag 'channel_id', desc: 'ID of conversation to remove users from.'
c.flag 'user_ids', desc: 'The users to remove from the channel.'
c.action do |_global_options, options, _args|
puts JSON.dump(@client.admin_conversations_kick(options))
end
end

g.desc 'Link a Salesforce record to a channel'
g.long_desc %( Link a Salesforce record to a channel )
g.command 'linkObjects' do |c|
Expand Down Expand Up @@ -212,7 +222,7 @@ class App
g.command 'search' do |c|
c.flag 'team_ids', desc: 'Comma separated string of team IDs, signifying the internal workspaces to search through.'
c.flag 'connected_team_ids', desc: 'Array of encoded team IDs, signifying the external orgs to search through.'
c.flag 'query', desc: 'Name of the the channel to query by.'
c.flag 'query', desc: 'Name of the channel to query by.'
c.flag 'limit', desc: 'Maximum number of items to be returned. Must be between 1 - 20 both inclusive. Default is 10.'
c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
c.flag 'search_channel_types', desc: 'The type of channel to include or exclude in the search. For example private will search private channels, while private_exclude will exclude them. For a full list of types, check the Types section.'
Expand Down
56 changes: 56 additions & 0 deletions bin/commands/admin_slackbot_skills.rb
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# frozen_string_literal: true
# This file was auto-generated by lib/tasks/web.rake

module Slack
module Cli
class App
desc 'AdminSlackbotSkills methods.'
command 'admin_slackbot_skills' do |g|
g.desc 'Lists metadata for skills owned by the organization, including invite-only skills.'
g.long_desc %( Lists metadata for skills owned by the organization, including invite-only skills. )
g.command 'list' do |c|
c.flag 'category', desc: 'Only return skills in this category.'
c.flag 'cursor', desc: 'Continuation from the previous page. Keep all filters and sorting unchanged. Pages can be empty while a continuation remains; continue until next_cursor is empty. Changes during traversal may move results; pagination is not a snapshot.'
c.flag 'limit', desc: 'The maximum number of skills to return. Fewer may be returned even when more remain.'
c.flag 'creator_ids', desc: 'Only return skills created by these users. Accepts U or W user IDs.'
c.flag 'publish_status', desc: 'Filter by publication to the org catalog.'
c.flag 'auto_enabled_status', desc: 'Filter by org deployment, independently of publication.'
c.flag 'sort', desc: 'Sort across the inventory. Name uses case-insensitive ordering. Unedited skills use their creation date for date_updated sorting.'
c.flag 'sort_dir', desc: 'Sort direction; file ID breaks ties.'
c.action do |_global_options, options, _args|
puts JSON.dump(@client.admin_slackbot_skills_list(options))
end
end

g.desc "Publishes Slackbot skills to an organization's catalog."
g.long_desc %( Publishes Slackbot skills to an organization's catalog. )
g.command 'publish' do |c|
c.flag 'skill_ids', desc: 'One to 50 skill IDs. Successful items are not rolled back if other items fail.'
c.action do |_global_options, options, _args|
puts JSON.dump(@client.admin_slackbot_skills_publish(options))
end
end

g.desc 'Sets who a Slackbot skill is automatically turned on for.'
g.long_desc %( Sets who a Slackbot skill is automatically turned on for. )
g.command 'setAutoEnabled' do |c|
c.flag 'skill_id', desc: 'Canvas skill to deploy.'
c.flag 'permission_type', desc: 'Deployment audience.'
c.flag 'usergroup_ids', desc: 'One to 100 user groups for named_entities. Duplicates count toward the input limit and are stored once. Omit for other permission types.'
c.action do |_global_options, options, _args|
puts JSON.dump(@client.admin_slackbot_skills_setAutoEnabled(options))
end
end

g.desc 'Removes Slackbot skills from the org catalog, preserving access, libraries, and deployments.'
g.long_desc %( Removes Slackbot skills from the org catalog, preserving access, libraries, and deployments. )
g.command 'unpublish' do |c|
c.flag 'skill_ids', desc: 'One to 50 skill IDs. Successful items are not rolled back if other items fail.'
c.action do |_global_options, options, _args|
puts JSON.dump(@client.admin_slackbot_skills_unpublish(options))
end
end
end
end
end
end
9 changes: 9 additions & 0 deletions bin/commands/admin_users.rb
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,15 @@ class App
end
end

g.desc 'Deactivate a user from an enterprise organization and all its workspaces.'
g.long_desc %( Deactivate a user from an enterprise organization and all its workspaces. )
g.command 'deactivate' do |c|
c.flag 'user_id', desc: 'The ID of the user to deactivate.'
c.action do |_global_options, options, _args|
puts JSON.dump(@client.admin_users_deactivate(options))
end
end

g.desc 'Fetches the expiration timestamp for a guest'
g.long_desc %( Fetches the expiration timestamp for a guest )
g.command 'getExpiration' do |c|
Expand Down
31 changes: 31 additions & 0 deletions bin/commands/admin_users_access.rb
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# frozen_string_literal: true
# This file was auto-generated by lib/tasks/web.rake

module Slack
module Cli
class App
desc 'AdminUsersAccess methods.'
command 'admin_users_access' do |g|
g.desc 'Pause access across the organization for up to 1,000 frontline members. Success means the request was queued, not that all updates have completed.'
g.long_desc %( Pause access across the organization for up to 1,000 frontline members. Success means the request was queued, not that all updates have completed. )
g.command 'pause' do |c|
c.flag 'user_ids', desc: 'IDs of frontline members in the authenticated organization. Valid users are queued; rejected IDs are returned in invalid_users.'
c.flag 'reason', desc: 'Optional explanation for the access change.'
c.action do |_global_options, options, _args|
puts JSON.dump(@client.admin_users_access_pause(options))
end
end

g.desc 'Resume access across the organization for up to 1,000 frontline members. Success means the request was queued, not that all updates have completed.'
g.long_desc %( Resume access across the organization for up to 1,000 frontline members. Success means the request was queued, not that all updates have completed. )
g.command 'resume' do |c|
c.flag 'user_ids', desc: 'IDs of frontline members in the authenticated organization. Valid users are queued; rejected IDs are returned in invalid_users.'
c.flag 'reason', desc: 'Optional explanation for the access change.'
c.action do |_global_options, options, _args|
puts JSON.dump(@client.admin_users_access_resume(options))
end
end
end
end
end
end
Loading