Module: Slack::Endpoint::Channels

Included in:

Slack::Endpoint

Defined in:

lib/slack/endpoint/channels.rb

Instance Method Summary

• #channels_archive(options = {}) ⇒ Object

  This method archives a channel.

• #channels_create(options = {}) ⇒ Object

  This method is used to create a channel.

• #channels_history(options = {}) ⇒ Object

  This method returns a portion of messages/events from the specified channel.

• #channels_info(options = {}) ⇒ Object

  This method returns information about a team channel.

• #channels_invite(options = {}) ⇒ Object

  This method is used to invite a user to a channel.

• #channels_join(options = {}) ⇒ Object

  This method is used to join a channel.

• #channels_kick(options = {}) ⇒ Object

  This method allows a user to remove another member from a team channel.

• #channels_leave(options = {}) ⇒ Object

  This method is used to leave a channel.

• #channels_list(options = {}) ⇒ Object

  This method returns a list of all channels in the team.

• #channels_mark(options = {}) ⇒ Object

  This method moves the read cursor in a channel.

• #channels_rename(options = {}) ⇒ Object

  This method renames a team channel.

• #channels_setPurpose(options = {}) ⇒ Object

  This method is used to change the purpose of a channel.

• #channels_setTopic(options = {}) ⇒ Object

  This method is used to change the topic of a channel.

• #channels_unarchive(options = {}) ⇒ Object

  This method unarchives a channel.

Instance Method Details

#channels_archive(options = {}) ⇒ Object

This method archives a channel.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :channel (Object) —

  Channel to archive

See Also:

• https://api.slack.com/methods/channels.archive
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.archive.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.archive.json

# File 'lib/slack/endpoint/channels.rb', line 14

def channels_archive(options={})
  throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil?
  options[:attachments] = options[:attachments].to_json if Hash === options[:attachments]
  post("channels.archive", options)
end

#channels_create(options = {}) ⇒ Object

This method is used to create a channel.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :name (Object) —

  Name of channel to create

See Also:

• https://api.slack.com/methods/channels.create
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.create.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.create.json

# File 'lib/slack/endpoint/channels.rb', line 28

def channels_create(options={})
  throw ArgumentError.new("Required arguments :name missing") if options[:name].nil?
  options[:attachments] = options[:attachments].to_json if Hash === options[:attachments]
  post("channels.create", options)
end

#channels_history(options = {}) ⇒ Object

This method returns a portion of messages/events from the specified channel. To read the entire history for a channel, call the method with no latest or oldest arguments, and then continue paging using the instructions below.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :channel (Object) —

  Channel to fetch history for.

• :latest (Object) —

  End of time range of messages to include in results.

• :oldest (Object) —

  Start of time range of messages to include in results.

• :inclusive (Object) —

  Include messages with latest or oldest timestamp in results.

• :count (Object) —

  Number of messages to return, between 1 and 1000.

• :unreads (Object) —

  Include unread_count_display in the output?

See Also:

• https://api.slack.com/methods/channels.history
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.history.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.history.json

# File 'lib/slack/endpoint/channels.rb', line 54

def channels_history(options={})
  throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil?
  options[:attachments] = options[:attachments].to_json if Hash === options[:attachments]
  post("channels.history", options)
end

#channels_info(options = {}) ⇒ Object

This method returns information about a team channel.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :channel (Object) —

  Channel to get info on

See Also:

• https://api.slack.com/methods/channels.info
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.info.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.info.json

# File 'lib/slack/endpoint/channels.rb', line 68

def channels_info(options={})
  throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil?
  options[:attachments] = options[:attachments].to_json if Hash === options[:attachments]
  post("channels.info", options)
end

#channels_invite(options = {}) ⇒ Object

This method is used to invite a user to a channel. The calling user must be a member of the channel.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :channel (Object) —

  Channel to invite user to.

• :user (Object) —

  User to invite to channel.

See Also:

• https://api.slack.com/methods/channels.invite
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.invite.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.invite.json

# File 'lib/slack/endpoint/channels.rb', line 84

def channels_invite(options={})
  throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil?
  throw ArgumentError.new("Required arguments :user missing") if options[:user].nil?
  options[:attachments] = options[:attachments].to_json if Hash === options[:attachments]
  post("channels.invite", options)
end

#channels_join(options = {}) ⇒ Object

This method is used to join a channel. If the channel does not exist, it is created.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :name (Object) —

  Name of channel to join

See Also:

• https://api.slack.com/methods/channels.join
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.join.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.join.json

# File 'lib/slack/endpoint/channels.rb', line 100

def channels_join(options={})
  throw ArgumentError.new("Required arguments :name missing") if options[:name].nil?
  options[:attachments] = options[:attachments].to_json if Hash === options[:attachments]
  post("channels.join", options)
end

#channels_kick(options = {}) ⇒ Object

This method allows a user to remove another member from a team channel.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :channel (Object) —

  Channel to remove user from.

• :user (Object) —

  User to remove from channel.

See Also:

• https://api.slack.com/methods/channels.kick
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.kick.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.kick.json

# File 'lib/slack/endpoint/channels.rb', line 116

def channels_kick(options={})
  throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil?
  throw ArgumentError.new("Required arguments :user missing") if options[:user].nil?
  options[:attachments] = options[:attachments].to_json if Hash === options[:attachments]
  post("channels.kick", options)
end

#channels_leave(options = {}) ⇒ Object

This method is used to leave a channel.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :channel (Object) —

  Channel to leave

See Also:

• https://api.slack.com/methods/channels.leave
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.leave.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.leave.json

# File 'lib/slack/endpoint/channels.rb', line 131

def channels_leave(options={})
  throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil?
  options[:attachments] = options[:attachments].to_json if Hash === options[:attachments]
  post("channels.leave", options)
end

#channels_list(options = {}) ⇒ Object

This method returns a list of all channels in the team. This includes channels the caller is in, channels they are not currently in, and archived channels. The number of (non-deactivated) members in each channel is also returned.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :exclude_archived (Object) —

  Don’t return archived channels.

See Also:

• https://api.slack.com/methods/channels.list
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.list.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.list.json

# File 'lib/slack/endpoint/channels.rb', line 147

def channels_list(options={})
  options[:attachments] = options[:attachments].to_json if Hash === options[:attachments]
  post("channels.list", options)
end

#channels_mark(options = {}) ⇒ Object

This method moves the read cursor in a channel.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :channel (Object) —

  Channel to set reading cursor in.

• :ts (Object) —

  Timestamp of the most recently seen message.

See Also:

• https://api.slack.com/methods/channels.mark
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.mark.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.mark.json

# File 'lib/slack/endpoint/channels.rb', line 162

def channels_mark(options={})
  throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil?
  throw ArgumentError.new("Required arguments :ts missing") if options[:ts].nil?
  options[:attachments] = options[:attachments].to_json if Hash === options[:attachments]
  post("channels.mark", options)
end

#channels_rename(options = {}) ⇒ Object

This method renames a team channel.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :channel (Object) —

  Channel to rename

• :name (Object) —

  New name for channel.

See Also:

• https://api.slack.com/methods/channels.rename
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.rename.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.rename.json

# File 'lib/slack/endpoint/channels.rb', line 179

def channels_rename(options={})
  throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil?
  throw ArgumentError.new("Required arguments :name missing") if options[:name].nil?
  options[:attachments] = options[:attachments].to_json if Hash === options[:attachments]
  post("channels.rename", options)
end

#channels_setPurpose(options = {}) ⇒ Object

This method is used to change the purpose of a channel. The calling user must be a member of the channel.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :channel (Object) —

  Channel to set the purpose of

• :purpose (Object) —

  The new purpose

See Also:

• https://api.slack.com/methods/channels.setPurpose
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.setPurpose.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.setPurpose.json

# File 'lib/slack/endpoint/channels.rb', line 196

def channels_setPurpose(options={})
  throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil?
  throw ArgumentError.new("Required arguments :purpose missing") if options[:purpose].nil?
  options[:attachments] = options[:attachments].to_json if Hash === options[:attachments]
  post("channels.setPurpose", options)
end

#channels_setTopic(options = {}) ⇒ Object

This method is used to change the topic of a channel. The calling user must be a member of the channel.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :channel (Object) —

  Channel to set the topic of

• :topic (Object) —

  The new topic

See Also:

• https://api.slack.com/methods/channels.setTopic
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.setTopic.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.setTopic.json

# File 'lib/slack/endpoint/channels.rb', line 213

def channels_setTopic(options={})
  throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil?
  throw ArgumentError.new("Required arguments :topic missing") if options[:topic].nil?
  options[:attachments] = options[:attachments].to_json if Hash === options[:attachments]
  post("channels.setTopic", options)
end

#channels_unarchive(options = {}) ⇒ Object

This method unarchives a channel. The calling user is added to the channel.

Parameters:

• options (Hash) (defaults to: {}) —

  a customizable set of options

Options Hash (options):

• :channel (Object) —

  Channel to unarchive

See Also:

• https://api.slack.com/methods/channels.unarchive
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.unarchive.md
• https://github.com/aki017/slack-api-docs/blob/master/methods/channels.unarchive.json

# File 'lib/slack/endpoint/channels.rb', line 228

def channels_unarchive(options={})
  throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil?
  options[:attachments] = options[:attachments].to_json if Hash === options[:attachments]
  post("channels.unarchive", options)
end