Slack Web API

/files.sharedPublicURL

POST

/files.sharedPublicURL

files

Enables a file for public/external sharing.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://slack.com/api/files.sharedPublicURL'

Response Example

200 - response

{
    "ok": true
}

Request

Header Params

token

string

optional

Authentication token. Requires scope: files:write:user

Body Params application/x-www-form-urlencoded

file

string

optional

File to share

Responses

🟢200Typical success response

application/json

Body

Schema for successful response from files.sharedPublicURL 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

id

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

shares

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

ok

enum<boolean>

required

Allowed value:

true

🔴500Typical error response

/files.revokePublicURL