Current section
Files
Jump to
Current section
Files
priv/docs/methods/files.completeUploadExternal.json
{
"args": {
"blocks": {
"desc": "A JSON-based array of structured rich text blocks, presented as a URL-encoded string. If the `initial_comment` field is provided, the `blocks` field is ignored",
"example": "[{\"type\": \"section\", \"text\": {\"type\": \"plain_text\", \"text\": \"Hello world\"}}]",
"required": false,
"type": "string"
},
"channel_id": {
"desc": "Channel ID where the file will be shared. If not specified the file will be private.",
"example": "C0NF841BK",
"required": false
},
"channels": {
"desc": "Comma-separated string of channel IDs or user IDs where the file will be shared.",
"example": "C0NF841BK,C2AW648GH",
"required": false,
"type": "string"
},
"files": {
"desc": "Array of file ids and their corresponding (optional) titles.",
"example": "[{\"id\":\"F044GKUHN9Z\", \"title\":\"slack-test\", \"highlight_type\":\"png\"}]",
"required": true,
"type": "array"
},
"initial_comment": {
"desc": "The message text introducing the file in specified channels.",
"required": false,
"type": "string"
},
"thread_ts": {
"desc": "Provide another message's `ts` value to upload this file as a reply. Never use a reply's `ts` value; use its parent instead. Also make sure to provide only one channel when using 'thread\\_ts'",
"example": "1524523204.000192",
"required": false,
"type": "string"
}
},
"desc": "Finishes an upload started with files.getUploadURLExternal",
"errors": {
"channel_not_found": "Value passed for `channel_id` was invalid.",
"channels_limit_exceeded": "Exceeded the channel limit. A maximum of 100 channels is allowed per request.",
"file_not_found": "Could not find the file from the upload ticket.",
"file_type_not_allowed": "The file type is not permitted based on the team's allowed\\_file\\_upload\\_types preference.",
"file_update_failed": "Failure occurred when attempting to update the file.",
"file_uploads_except_images_disabled": "Only image file uploads are permitted for this team.",
"invalid_blocks": "Provided blocks are in the incorrect format.",
"invalid_channel": "Channel could not be found or channel specified is invalid.",
"not_in_channel": "User/bot membership is required for the specified channel.",
"posting_to_channel_denied": "User is not authorized to post to channel."
},
"rate_limit": {
"label": "Tier 4: 100+ per minute",
"url": "https://docs.slack.dev/apis/web-api/rate-limits"
},
"scopes": {
"bot": [
{
"name": "files:write",
"url": "https://docs.slack.dev/reference/scopes/files.write"
}
],
"user": [
{
"name": "files:write",
"url": "https://docs.slack.dev/reference/scopes/files.write"
}
]
}
}