Module: Slack::Web::Api::Endpoints::Files

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

Instance Method Summary collapse

Instance Method Details

#files_delete(options = {}) ⇒ Object

Deletes a file.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :file (file) —

    ID of file to delete.

See Also:



15
16
17
18
 
# File 'lib/slack/web/api/endpoints/files.rb', line 15

def files_delete(options = {})
  throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
  post('files.delete', options)
end

#files_edit(options = {}) ⇒ Object

Change the properties of a file (undocumented)

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :file (Object) —

    ID of the file to be edited

  • :title (Object) —

    New title of the file

  • :filetype (Object) —

    New filetype of the file. See api.slack.com/types/file#file_types for a list of all supported types.

See Also:



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

def files_edit(options = {})
  throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
  throw ArgumentError.new('Required arguments :title missing') if options[:title].nil?
  logger.warn('The files.edit method is undocumented.')
  post('files.edit', options)
end

#files_info(options = {}) ⇒ Object

Gets information about a team file.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :file (file) —

    Specify a file by providing its ID.

See Also:



44
45
46
47
 
# File 'lib/slack/web/api/endpoints/files.rb', line 44

def files_info(options = {})
  throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
  post('files.info', options)
end

#files_list(options = {}) ⇒ Object

Lists & filters team files.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :channel (channel) —

    Filter files appearing in a specific channel, indicated by its ID.

  • :ts_from (Object) —

    Filter files created after this timestamp (inclusive).

  • :ts_to (Object) —

    Filter files created before this timestamp (inclusive).

  • :types (Object) —

    Filter files by type:

    all - All files spaces - Posts snippets - Snippets images - Image files gdocs - Google docs zips - Zip files pdfs - PDF files

    You can pass multiple values in the types argument, like types=spaces,snippets.The default value is all, which does not filter the list. .

  • :user (user) —

    Filter files created by a single user.

See Also:



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

def files_list(options = {})
  options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
  options = options.merge(user: users_id(options)['user']['id']) if options[:user]
  post('files.list', options)
end

#files_revokePublicURL(options = {}) ⇒ Object

Revokes public/external sharing access for a file

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :file (file) —

    File to revoke.

See Also:



89
90
91
92
 
# File 'lib/slack/web/api/endpoints/files.rb', line 89

def files_revokePublicURL(options = {})
  throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
  post('files.revokePublicURL', options)
end

#files_share(options = {}) ⇒ Object

Share an existing file in a channel (undocumented)

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :file (Object) —

    ID of the file to be shared

  • :channel (channel) —

    Channel to share the file in. Works with both public (channel ID) and private channels (group ID).

See Also:



102
103
104
105
106
107
108
 
# File 'lib/slack/web/api/endpoints/files.rb', line 102

def files_share(options = {})
  throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
  throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
  options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
  logger.warn('The files.share method is undocumented.')
  post('files.share', options)
end

#files_sharedPublicURL(options = {}) ⇒ Object

Enables a file for public/external sharing.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :file (file) —

    File to share.

See Also:



117
118
119
120
 
# File 'lib/slack/web/api/endpoints/files.rb', line 117

def files_sharedPublicURL(options = {})
  throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
  post('files.sharedPublicURL', options)
end

#files_upload(options = {}) ⇒ Object

Uploads or creates a file.

Parameters:

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

    a customizable set of options

Options Hash (options):

  • :channels (Object) —

    Comma-separated list of channel names or IDs where the file will be shared.

  • :content (Object) —

    File contents via a POST variable. If omitting this parameter, you must provide a file.

  • :file (file) —

    File contents via multipart/form-data. If omitting this parameter, you must submit content.

  • :filename (Object) —

    Filename of file.

  • :filetype (Object) —

    A file type identifier.

  • :initial_comment (Object) —

    Initial comment to add to file.

  • :title (Object) —

    Title of file.

See Also:



141
142
143
 
# File 'lib/slack/web/api/endpoints/files.rb', line 141

def files_upload(options = {})
  post('files.upload', options)
end