Current section
Files
Jump to
Current section
Files
priv/docs/methods/files.list.json
{
"args": {
"channel": {
"desc": "Filter files appearing in a specific channel, indicated by its ID.",
"required": false,
"type": "string"
},
"count": {
"default": "100",
"desc": "",
"required": false
},
"page": {
"default": "1",
"desc": "",
"required": false
},
"show_files_hidden_by_limit": {
"desc": "Show truncated file info for files hidden due to being too old, and the team who owns the file being over the file limit.",
"example": "true",
"required": false,
"type": "boolean"
},
"team_id": {
"desc": "encoded team id to list files in, required if org token is used",
"required": false,
"type": "string"
},
"ts_from": {
"desc": "Filter files created after this timestamp (inclusive).",
"example": "123456789",
"required": false,
"type": "string"
},
"ts_to": {
"desc": "Filter files created before this timestamp (inclusive).",
"example": "123456789",
"required": false,
"type": "string"
},
"types": {
"default": "all",
"desc": "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.",
"example": "images",
"required": false,
"type": "string"
},
"user": {
"desc": "Filter files created by a single user.",
"required": false,
"type": "string"
}
},
"desc": "List files for a team, in a channel, or from a user with applied filters.",
"errors": {
"missing_argument": "A required argument is missing.",
"slack_connect_canvas_sharing_blocked": "Admin has disabled sharing of Canvas links in all Slack Connect communications",
"unknown_type": "Value passed for `types` was invalid",
"user_not_found": "Value passed for `user` was invalid"
},
"rate_limit": {
"label": "Tier 3: 50+ per minute",
"url": "https://docs.slack.dev/apis/web-api/rate-limits"
},
"scopes": {
"bot": [
{
"name": "files:read",
"url": "https://docs.slack.dev/reference/scopes/files.read"
}
],
"user": [
{
"name": "files:read",
"url": "https://docs.slack.dev/reference/scopes/files.read"
}
]
}
}