/files.list - Slack Web API

List for a team, in a channel, or from a user with applied filters.

{ "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

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

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

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