Current section
Files
Jump to
Current section
Files
priv/docs/methods/files.remote.add.json
{
"args": {
"external_id": {
"desc": "Creator defined GUID for the file.",
"example": "123456",
"required": true,
"type": "string"
},
"external_url": {
"desc": "URL of the remote file.",
"example": "http://example.com/my_cloud_service_file/abc123",
"required": true,
"type": "string"
},
"filetype": {
"desc": "type of file",
"example": "doc",
"required": false,
"type": "string"
},
"indexable_file_contents": {
"desc": "A text file (txt, pdf, doc, etc.) containing textual search terms that are used to improve discovery of the remote file.",
"example": "...",
"required": false
},
"preview_image": {
"desc": "Preview of the document via `multipart/form-data`.",
"example": "...",
"required": false
},
"title": {
"desc": "Title of the file being shared.",
"example": "Danger, High Voltage!",
"required": true,
"type": "string"
}
},
"desc": "Adds a file from a remote service",
"errors": {
"bad_image": "The uploaded image could not be processed - try passing a JPG or PNG",
"bad_title": "The title provided is too long.",
"bot_user_required": "bot user token is required",
"invalid_external_id": "The external\\_id provided is too long.",
"too_large": "The uploaded image had excessive dimensions"
},
"rate_limit": {
"label": "Tier 2: 20+ per minute",
"url": "https://docs.slack.dev/apis/web-api/rate-limits"
},
"scopes": {
"bot": [
{
"name": "remote_files:write",
"url": "https://docs.slack.dev/reference/scopes/remote_files.write"
}
]
}
}