Files

Files List

GET
/files.list

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

Authorization

slackAuth files:read
AuthorizationBearer <token>

In: header

Scope: files:read

Query Parameters

token?string

Authentication token. Requires scope: files:read

user?string

Filter files created by a single user.

channel?string

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

ts_from?number

Filter files created after this timestamp (inclusive).

Formatdouble
ts_to?number

Filter files created before this timestamp (inclusive).

Formatdouble
types?string

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
page?string
show_files_hidden_by_limit?boolean

Show truncated file info for files hidden due to being too old, and the team who owns the file being over the file limit.

Header Parameters

Content-Type*"application/x-www-form-urlencoded"

Value in

  • "application/x-www-form-urlencoded"

Response Body

application/json

application/json

curl -X GET "https://example.com/files.list" \  -H "Content-Type: application/x-www-form-urlencoded"
{  "files": [],  "ok": "True",  "paging": {    "count": 0,    "page": 0,    "pages": 0,    "per_page": 0,    "spill": 0,    "total": 0  }}