/files.upload - Slack Web API

Uploads or creates a file.

{ "file": { "channels": [], "comments_count": 0, "created": 1532293501, "display_as_bot": false, "editable": false, "external_type": "", "filetype": "gif", "groups": [], "has_rich_preview": false, "id": "F0TD00400", "image_exif_rotation": 1, "ims": [ "D0L4B9P0Q" ], "is_external": false, "is_public": false, "is_starred": false, "mimetype": "image/jpeg", "mode": "hosted", "name": "dramacat.gif", "original_h": 366, "original_w": 526, "permalink": "https://.../dramacat.gif", "permalink_public": "https://.../More-Path-Components", "pretty_type": "JPEG", "public_url_shared": false, "shares": { "private": { "D0L4B9P0Q": [ { "reply_count": 0, "reply_users": [], "reply_users_count": 0, "ts": "1532293503.000001" } ] } }, "size": 43518, "thumb_160": "https://.../dramacat_160.gif", "thumb_360": "https://.../dramacat_360.gif", "thumb_360_h": 250, "thumb_360_w": 360, "thumb_480": "https://.../dramacat_480.gif", "thumb_480_h": 334, "thumb_480_w": 480, "thumb_64": "https://.../dramacat_64.gif", "thumb_80": "https://.../dramacat_80.gif", "timestamp": 1532293501, "title": "dramacat", "url_private": "https://.../dramacat.gif", "url_private_download": "https://.../dramacat.gif", "user": "U0L4B9NSU", "username": "" }, "ok": true }

Request

Body Params application/x-www-form-urlencoded

channels

string

optional

Comma-separated list of channel names or IDs where the file will be shared.

content

string

optional

File contents via a POST variable. If omitting this parameter, you must provide a file.

file

string

optional

File contents via multipart/form-data. If omitting this parameter, you must submit content.

filename

string

optional

Filename of file.

filetype

string

optional

A file type identifier.

initial_comment

string

optional

The message text introducing the file in specified channels.

thread_ts

number

optional

Provide another message's ts value to upload this file as a reply. Never use a reply's ts value; use its parent instead.

title

string

optional

Title of file.

token

string

optional

Authentication token. Requires scope: files:write:user

Responses

🟢200Success response after uploading a file to a channel with an initial message

application/json

Body

Schema for successful response files.upload method

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

🔴500Typical error response