Slack Web API
  1. files
Slack Web API
  • admin.apps
    • /admin.apps.approve
      POST
    • /admin.apps.restrict
      POST
  • admin.apps.approved
    • /admin.apps.approved.list
      GET
  • admin.apps.requests
    • /admin.apps.requests.list
      GET
  • admin.apps.restricted
    • /admin.apps.restricted.list
      GET
  • admin.conversations
    • /admin.conversations.archive
      POST
    • /admin.conversations.convertToPrivate
      POST
    • /admin.conversations.create
      POST
    • /admin.conversations.delete
      POST
    • /admin.conversations.disconnectShared
      POST
    • /admin.conversations.getConversationPrefs
      GET
    • /admin.conversations.getTeams
      GET
    • /admin.conversations.invite
      POST
    • /admin.conversations.rename
      POST
    • /admin.conversations.search
      GET
    • /admin.conversations.setConversationPrefs
      POST
    • /admin.conversations.setTeams
      POST
    • /admin.conversations.unarchive
      POST
  • admin.conversations.ekm
    • /admin.conversations.ekm.listOriginalConnectedChannelInfo
  • admin.conversations.restrictAccess
    • /admin.conversations.restrictAccess.addGroup
    • /admin.conversations.restrictAccess.listGroups
    • /admin.conversations.restrictAccess.removeGroup
  • admin.emoji
    • /admin.emoji.add
    • /admin.emoji.addAlias
    • /admin.emoji.list
    • /admin.emoji.remove
    • /admin.emoji.rename
  • admin.inviteRequests
    • /admin.inviteRequests.approve
    • /admin.inviteRequests.deny
    • /admin.inviteRequests.list
  • admin.inviteRequests.approved
    • /admin.inviteRequests.approved.list
  • admin.inviteRequests.denied
    • /admin.inviteRequests.denied.list
  • admin.teams.admins
    • /admin.teams.admins.list
  • admin.teams
    • /admin.teams.create
    • /admin.teams.list
  • admin.teams.owners
    • /admin.teams.owners.list
  • admin.teams.settings
    • /admin.teams.settings.info
    • /admin.teams.settings.setDefaultChannels
    • /admin.teams.settings.setDescription
    • /admin.teams.settings.setDiscoverability
    • /admin.teams.settings.setIcon
    • /admin.teams.settings.setName
  • admin.usergroups
    • /admin.usergroups.addChannels
    • /admin.usergroups.addTeams
    • /admin.usergroups.listChannels
    • /admin.usergroups.removeChannels
  • admin.users
    • /admin.users.assign
    • /admin.users.invite
    • /admin.users.list
    • /admin.users.remove
    • /admin.users.setAdmin
    • /admin.users.setExpiration
    • /admin.users.setOwner
    • /admin.users.setRegular
  • admin.users.session
    • /admin.users.session.invalidate
    • /admin.users.session.reset
  • api
    • /api.test
  • apps.event.authorizations
    • /apps.event.authorizations.list
  • apps.permissions
    • /apps.permissions.info
    • /apps.permissions.request
  • apps.permissions.resources
    • /apps.permissions.resources.list
  • apps.permissions.scopes
    • /apps.permissions.scopes.list
  • apps.permissions.users
    • /apps.permissions.users.list
    • /apps.permissions.users.request
  • apps
    • /apps.uninstall
  • auth
    • /auth.revoke
    • /auth.test
  • bots
    • /bots.info
  • calls
    • /calls.add
    • /calls.end
    • /calls.info
    • /calls.update
  • calls.participants
    • /calls.participants.add
    • /calls.participants.remove
  • chat
    • /chat.delete
    • /chat.deleteScheduledMessage
    • /chat.getPermalink
    • /chat.meMessage
    • /chat.postEphemeral
    • /chat.postMessage
    • /chat.scheduleMessage
    • /chat.unfurl
    • /chat.update
  • chat.scheduledMessages
    • /chat.scheduledMessages.list
  • conversations
    • /conversations.archive
    • /conversations.close
    • /conversations.create
    • /conversations.history
    • /conversations.info
    • /conversations.invite
    • /conversations.join
    • /conversations.kick
    • /conversations.leave
    • /conversations.list
    • /conversations.mark
    • /conversations.members
    • /conversations.open
    • /conversations.rename
    • /conversations.replies
    • /conversations.setPurpose
    • /conversations.setTopic
    • /conversations.unarchive
  • dialog
    • /dialog.open
  • dnd
    • /dnd.endDnd
    • /dnd.endSnooze
    • /dnd.info
    • /dnd.setSnooze
    • /dnd.teamInfo
  • emoji
    • /emoji.list
  • files.comments
    • /files.comments.delete
  • files
    • /files.delete
      POST
    • /files.info
      GET
    • /files.list
      GET
    • /files.revokePublicURL
      POST
    • /files.sharedPublicURL
      POST
    • /files.upload
      POST
  • files.remote
    • /files.remote.add
    • /files.remote.info
    • /files.remote.list
    • /files.remote.remove
    • /files.remote.share
    • /files.remote.update
  • migration
    • /migration.exchange
  • oauth
    • /oauth.access
    • /oauth.token
  • oauth.v2
    • /oauth.v2.access
  • pins
    • /pins.add
    • /pins.list
    • /pins.remove
  • reactions
    • /reactions.add
    • /reactions.get
    • /reactions.list
    • /reactions.remove
  • reminders
    • /reminders.add
    • /reminders.complete
    • /reminders.delete
    • /reminders.info
    • /reminders.list
  • rtm
    • /rtm.connect
  • search
    • /search.messages
  • stars
    • /stars.add
    • /stars.list
    • /stars.remove
  • team
    • /team.accessLogs
    • /team.billableInfo
    • /team.info
    • /team.integrationLogs
  • team.profile
    • /team.profile.get
  • usergroups
    • /usergroups.create
    • /usergroups.disable
    • /usergroups.enable
    • /usergroups.list
    • /usergroups.update
  • usergroups.users
    • /usergroups.users.list
    • /usergroups.users.update
  • users
    • /users.conversations
    • /users.deletePhoto
    • /users.getPresence
    • /users.identity
    • /users.info
    • /users.list
    • /users.lookupByEmail
    • /users.setActive
    • /users.setPhoto
    • /users.setPresence
  • users.profile
    • /users.profile.get
    • /users.profile.set
  • views
    • /views.open
    • /views.publish
    • /views.push
    • /views.update
  • workflows
    • /workflows.stepCompleted
    • /workflows.stepFailed
    • /workflows.updateStep
  1. files

/files.list

GET
/files.list
files
List for a team, in a channel, or from a user with applied filters.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://slack.com/api/files.list'
Response Response Example
200 - response
{
    "files": [
        {
            "channels": [
                "C0T8SE4AU"
            ],
            "comments_count": 0,
            "created": 1531763254,
            "deanimate_gif": "https://.../billair_deanimate_gif.png",
            "display_as_bot": false,
            "editable": false,
            "external_type": "",
            "filetype": "gif",
            "groups": [],
            "id": "F0S43P1CZ",
            "image_exif_rotation": 1,
            "ims": [],
            "is_external": false,
            "is_public": true,
            "mimetype": "image/gif",
            "mode": "hosted",
            "name": "billair.gif",
            "original_h": 226,
            "original_w": 176,
            "permalink": "https://.../billair.gif",
            "permalink_public": "https://.../...",
            "pjpeg": "https://.../billair_pjpeg.jpg",
            "pretty_type": "GIF",
            "public_url_shared": false,
            "size": 144538,
            "thumb_160": "https://.../billair_=_160.png",
            "thumb_360": "https://.../billair_360.png",
            "thumb_360_gif": "https://.../billair_360.gif",
            "thumb_360_h": 226,
            "thumb_360_w": 176,
            "thumb_64": "https://.../billair_64.png",
            "thumb_80": "https://.../billair_80.png",
            "timestamp": 1531763254,
            "title": "billair.gif",
            "url_private": "https://.../billair.gif",
            "url_private_download": "https://.../billair.gif",
            "user": "U061F7AUR",
            "username": ""
        },
        {
            "channels": [
                "C0T8SE4AU"
            ],
            "comments_count": 0,
            "created": 1531763342,
            "deanimate_gif": "https://.../tedair_deanimate_gif.png",
            "display_as_bot": false,
            "editable": false,
            "external_type": "",
            "filetype": "gif",
            "groups": [],
            "id": "F0S43PZDF",
            "image_exif_rotation": 1,
            "ims": [],
            "is_external": false,
            "is_public": true,
            "mimetype": "image/gif",
            "mode": "hosted",
            "name": "tedair.gif",
            "original_h": 226,
            "original_w": 176,
            "permalink": "https://.../tedair.gif",
            "permalink_public": "https://.../...",
            "pjpeg": "https://.../tedair_pjpeg.jpg",
            "pretty_type": "GIF",
            "public_url_shared": false,
            "size": 137531,
            "thumb_160": "https://.../tedair_=_160.png",
            "thumb_360": "https://.../tedair_360.png",
            "thumb_360_gif": "https://.../tedair_360.gif",
            "thumb_360_h": 226,
            "thumb_360_w": 176,
            "thumb_64": "https://.../tedair_64.png",
            "thumb_80": "https://.../tedair_80.png",
            "timestamp": 1531763342,
            "title": "tedair.gif",
            "url_private": "https://.../tedair.gif",
            "url_private_download": "https://.../tedair.gif",
            "user": "U061F7AUR",
            "username": ""
        }
    ],
    "ok": true,
    "paging": {
        "count": 100,
        "page": 1,
        "pages": 1,
        "total": 2
    }
}

Request

Query Params
token
string 
optional
Authentication token. Requires scope: files:read
user
string 
optional
Filter files created by a single user.
channel
string 
optional
Filter files appearing in a specific channel, indicated by its ID.
ts_from
number 
optional
Filter files created after this timestamp (inclusive).
ts_to
number 
optional
Filter files created before this timestamp (inclusive).
types
string 
optional
Filter files by type (see below). You can pass multiple values in the types argument, like types=spaces,snippets.The default value is all, which does not filter the list.
count
string 
optional
page
string 
optional
show_files_hidden_by_limit
string 
optional
Show truncated file info for files hidden due to being too old, and the team who owns the file being over the file limit.

Responses

🟢200Typical success response
application/json
Body
Schema for successful response from files.list method
files
array[object (file object) {70}] 
required
>= 0 items
channels
array[string]
optional
comments_count
integer 
optional
created
integer 
optional
date_delete
integer 
optional
display_as_bot
boolean 
optional
editable
boolean 
optional
editor
string 
optional
Match pattern:
^[UW][A-Z0-9]{2,}$
external_id
string 
optional
external_type
string 
optional
external_url
string <uri>
optional
filetype
string 
optional
groups
array[string]
optional
has_rich_preview
boolean 
optional
id
string 
optional
Match pattern:
^[F][A-Z0-9]{8,}$
image_exif_rotation
integer 
optional
ims
array[string]
optional
is_external
boolean 
optional
is_public
boolean 
optional
is_starred
boolean 
optional
is_tombstoned
boolean 
optional
last_editor
string 
optional
Match pattern:
^[UW][A-Z0-9]{2,}$
mimetype
string 
optional
mode
string 
optional
name
string 
optional
non_owner_editable
boolean 
optional
num_stars
integer 
optional
original_h
integer 
optional
original_w
integer 
optional
permalink
string <uri>
optional
permalink_public
string <uri>
optional
pinned_info
object (Info for a pinned item) 
optional
pinned_to
array[string]
optional
pretty_type
string 
optional
preview
string 
optional
public_url_shared
boolean 
optional
reactions
array[object (Reaction object) {4}] 
optional
shares
object 
optional
size
integer 
optional
source_team
string 
optional
Match pattern:
^[T][A-Z0-9]{2,}$
state
string 
optional
thumb_1024
string <uri>
optional
thumb_1024_h
integer 
optional
thumb_1024_w
integer 
optional
thumb_160
string <uri>
optional
thumb_360
string <uri>
optional
thumb_360_h
integer 
optional
thumb_360_w
integer 
optional
thumb_480
string <uri>
optional
thumb_480_h
integer 
optional
thumb_480_w
integer 
optional
thumb_64
string <uri>
optional
thumb_720
string <uri>
optional
thumb_720_h
integer 
optional
thumb_720_w
integer 
optional
thumb_80
string <uri>
optional
thumb_800
string <uri>
optional
thumb_800_h
integer 
optional
thumb_800_w
integer 
optional
thumb_960
string <uri>
optional
thumb_960_h
integer 
optional
thumb_960_w
integer 
optional
thumb_tiny
string 
optional
timestamp
integer 
optional
title
string 
optional
updated
integer 
optional
url_private
string <uri>
optional
url_private_download
string <uri>
optional
user
string 
optional
user_team
string 
optional
Match pattern:
^[T][A-Z0-9]{2,}$
username
string 
optional
ok
enum<boolean> 
required
Allowed value:
true
paging
object (paging object) 
required
count
integer 
optional
page
integer 
required
pages
integer 
optional
per_page
integer 
optional
spill
integer 
optional
total
integer 
required
🔴500Typical error response
Previous
/files.info
Next
/files.revokePublicURL
Built with