Sample - Slack Web API
GET/files.remote.list

List remote files

Lists remote files with optional channel and creation-time filters. Use channel, ts_from, and ts_to to narrow the collection, and use limit with cursor to paginate through results. The response confirms whether the request succeeded.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

6 parameters
tokenstringoptional
Authentication token with the `remote_files:read` scope.
channelstringoptional
Filter remote files appearing in a specific channel by channel ID.
ts_fromnumberoptional
Filter remote files created at or after this timestamp.
ts_tonumberoptional
Filter remote files created at or before this timestamp.
limitintegeroptional
The maximum number of remote files to return.
cursorstringoptional
Pagination cursor from a previous response's `next_cursor` value.

2 status codes
200Returns an object with `ok` set to true when the remote file list is retrieved.
okbooleanrequired
Allowed:true
defaultReturns an object with `ok` set to false when the remote file list cannot be retrieved or a filter is invalid.
okbooleanrequired
Allowed:false

Error handling

The authentication token must have the remote_files:read scope. Use numeric ts_from and ts_to values for timestamp filtering, and pass a previous response's next_cursor in cursor to continue pagination.