Module: Slack::Web::Api::Endpoints::Bookmarks

Included in:
Slack::Web::Api::Endpoints
Defined in:
lib/slack/web/api/endpoints/bookmarks.rb

Instance Method Summary collapse

Instance Method Details

#bookmarks_add(options = {}) ⇒ Object

Add bookmark to a channel.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :channel_id (string) —

    Channel to add bookmark in. Required for public channels.

  • :title (string) —

    Title for the bookmark.

  • :link (string) —

    Link to bookmark.

  • :type (string) —

    Type of the bookmark i.e link.

  • :emoji (string) —

    Emoji tag to apply to the link.

  • :entity_id (string) —

    ID of the entity being bookmarked. Only applies to message and file types.

  • :access_level (enum) —

    The level that we are setting the file's permission to (read or write).

  • :parent_id (string) —

    Id of this bookmark's parent.

Raises:

  • (ArgumentError)

See Also:



30
31
32
33
34
 
# File 'lib/slack/web/api/endpoints/bookmarks.rb', line 30

def bookmarks_add(options = {})
  raise ArgumentError, 'Required arguments :title missing' if options[:title].nil?
  raise ArgumentError, 'Required arguments :type missing' if options[:type].nil?
  post('bookmarks.add', options)
end

#bookmarks_edit(options = {}) ⇒ Object

Edit bookmark.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :channel_id (string) —

    Channel to update bookmark in. Required for public channels.

  • :bookmark_id (string) —

    Bookmark to update. Required for public channels.

  • :title (string) —

    Title for the bookmark.

  • :link (string) —

    Link to bookmark.

  • :emoji (string) —

    Emoji tag to apply to the link.

See Also:



51
52
53
 
# File 'lib/slack/web/api/endpoints/bookmarks.rb', line 51

def bookmarks_edit(options = {})
  post('bookmarks.edit', options)
end

#bookmarks_list(options = {}) ⇒ Object

List bookmark for the channel.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :channel_id (string) —

    Channel to list bookmarks in. Required for public channels.

See Also:



62
63
64
 
# File 'lib/slack/web/api/endpoints/bookmarks.rb', line 62

def bookmarks_list(options = {})
  post('bookmarks.list', options)
end

#bookmarks_remove(options = {}) ⇒ Object

Remove bookmark from the channel.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :channel_id (string) —

    Channel to remove bookmark. Required for public channels.

  • :bookmark_id (string) —

    Bookmark to remove. Required for public channels.

  • :quip_section_id (string) —

    Quip section ID to unbookmark.

See Also:



77
78
79
 
# File 'lib/slack/web/api/endpoints/bookmarks.rb', line 77

def bookmarks_remove(options = {})
  post('bookmarks.remove', options)
end