/files.info - Slack Web API

Gets information about a file.

{ "comments": [], "file": { "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": [], "has_rich_preview": false, "id": "F0S43PZDF", "image_exif_rotation": 1, "ims": [], "is_external": false, "is_public": true, "is_starred": false, "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, "shares": { "public": { "C0T8SE4AU": [ { "channel_name": "file-under", "latest_reply": "1531763348.000001", "reply_count": 1, "reply_users": [ "U061F7AUR" ], "reply_users_count": 1, "team_id": "T061EG9R6", "thread_ts": "1531763273.000015", "ts": "1531763348.000001" } ] } }, "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, "response_metadata": { "next_cursor": "dGVhbTpDMUg5UkVTR0w=" } }

Request

Query Params

token

string

optional

Authentication token. Requires scope: files:read

file

string

optional

Specify a file by providing its ID.

count

string

optional

page

string

optional

limit

integer

optional

The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached.

cursor

string

optional

Parameter for pagination. File comments are paginated for a single file. Set cursor equal to the next_cursor attribute returned by the previous request's response_metadata. This parameter is optional, but pagination is mandatory: the default value simply fetches the first "page" of the collection of comments. See pagination for more details.

Responses

🟢200Typical success response

application/json

Body

Schema for successful response from files.info method

comments

array

required

content_html

null

optional

editor

string

optional

Match pattern:

^[UW][A-Z0-9]{2,}$

file

object (file object)

required

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)

optional

count

integer

optional

page

integer

required

pages

integer

optional

per_page

integer

optional

spill

integer

optional

total

integer

required

response_metadata

array [anyOf]

optional

object

new paging style

optional

object

deprecation_warning

optional

object

deprecation_warning and paging style together

optional

🔴500Typical error response