Module: Slack::Web::Api::Endpoints::Pins

Included in:

Slack::Web::Api::Endpoints

Defined in:

lib/slack/web/api/endpoints/pins.rb

Instance Method Summary

• #pins_add(options = {}) ⇒ Object

  Pins an item to a channel.

• #pins_list(options = {}) ⇒ Object

  Lists items pinned to a channel.

• #pins_remove(options = {}) ⇒ Object

  Un-pins an item from a channel.

Instance Method Details

#pins_add(options = {}) ⇒ Object

Pins an item to a channel.

Parameters:

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

  a customizable set of options

Options Hash (options):

• :channel (channel) —

  Channel to pin the item in.

• :timestamp (Object) —

  Timestamp of the message to pin.

See Also:

• https://api.slack.com/methods/pins.add
• https://github.com/slack-ruby/slack-api-ref/blob/master/methods/pins/pins.add.json

# File 'lib/slack/web/api/endpoints/pins.rb', line 18

def pins_add(options = {})
  throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
  throw ArgumentError.new('Required arguments :timestamp missing') if options[:timestamp].nil?
  options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
  post('pins.add', options)
end

#pins_list(options = {}) ⇒ Object

Lists items pinned to a channel.

Parameters:

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

  a customizable set of options

Options Hash (options):

• :channel (channel) —

  Channel to get pinned items for.

See Also:

• https://api.slack.com/methods/pins.list
• https://github.com/slack-ruby/slack-api-ref/blob/master/methods/pins/pins.list.json

# File 'lib/slack/web/api/endpoints/pins.rb', line 32

def pins_list(options = {})
  throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
  options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
  post('pins.list', options)
end

#pins_remove(options = {}) ⇒ Object

Un-pins an item from a channel.

Parameters:

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

  a customizable set of options

Options Hash (options):

• :channel (channel) —

  Channel where the item is pinned to.

• :file (file) —

  File to un-pin.

• :file_comment (Object) —

  File comment to un-pin.

• :timestamp (Object) —

  Timestamp of the message to un-pin.

See Also:

• https://api.slack.com/methods/pins.remove
• https://github.com/slack-ruby/slack-api-ref/blob/master/methods/pins/pins.remove.json

# File 'lib/slack/web/api/endpoints/pins.rb', line 51

def pins_remove(options = {})
  throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
  options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
  post('pins.remove', options)
end